Travaillez avec les fonctionnalités d'Amazon DCV

La disponibilité des fonctionnalités Amazon DCV dépend des autorisations configurées pour la session Amazon DCV et des fonctionnalités du navigateur Web du client.

Les fonctionnalités disponibles dans une session Amazon DCV sont gérées par les autorisations spécifiées pour la session. Cela signifie que même si une fonctionnalité est prise en charge par le SDK Amazon DCV Web Client, l'accès à cette fonctionnalité peut être empêché en fonction des autorisations définies par l'administrateur de session. Pour plus d'informations, consultez la section Configuration de l'autorisation Amazon DCV dans le guide de l'administrateur Amazon DCV.

Comprendre la fonction de rappel FeaturesUpdate

Lorsque la disponibilité d'une fonctionnalité dans une session Amazon DCV change, le SDK du client Web Amazon DCV vous en informe à l'aide de la fonction de featuresUpdate rappel que vous spécifiez au moment de l'établissement de la connexion. Par exemple :

featuresUpdate: function (connection, list) {
  ...
},

La fonction de rappel ne vous informe que des fonctionnalités dont la disponibilité a changé. Le list paramètre est un tableau de chaînes qui inclut uniquement les noms des fonctionnalités mises à jour. Par exemple, si la disponibilité de la fonctionnalité d'entrée audio change au cours de la session, le paramètre inclut uniquement["audio-in"]. Si, ultérieurement, la disponibilité des fonctionnalités de copier-coller du presse-papiers change au cours de la session, le paramètre inclut uniquement["clipboard-copy", "clipboard-paste"].

Gestion des mises à jour des fonctionnalités

La fonction de featuresUpdate rappel vous indique uniquement que la disponibilité d'une ou de plusieurs fonctionnalités a changé. Pour savoir quelles fonctionnalités ont été mises à jour, vous devez interroger la fonctionnalité à l'aide de la connection.queryFeature méthode. Cela peut être fait à tout moment après réception de la notification de modification. Cette méthode renvoie un Promise qui correspond à l'état mis à jour de la fonctionnalité demandée. La status valeur est toujours associée et possède une propriété booléenne (true|false) appelée. enabled Certaines fonctionnalités peuvent avoir des propriétés supplémentaires dans la status valeur. Si la disponibilité de la fonctionnalité n'a pas été mise à jour, elle est rejetée.

L'exemple de code suivant montre comment procéder.

// Connection callback called
function featuresUpdate (_, list) {
  if (list.length > 0) {
    list.forEach((feat) => {
      connection.queryFeature(feat).then(status => console.log(feat, "is", status.enabled)));
    });
  }
}