Amazon DCV 機能の操作 - Amazon DCV
FeatureUpdate コールバック関数について機能更新の処理

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon DCV 機能の操作

Amazon DCV 機能の可用性は、Amazon DCV セッションに対して設定されたアクセス許可と、クライアントのウェブブラウザの機能に左右されます。

Amazon DCV セッションで使用できる機能は、そのセッションに対して指定されたアクセス許可によって管理されます。機能が Amazon DCV ウェブクライアント SDK でサポートされていても、セッション管理者が定義したアクセス許可に基づいて、その機能へのアクセスが妨げられることがあります。詳細については、「Amazon DCV 管理者ガイド」の「Amazon DCV 認可の設定」を参照してください。

FeatureUpdate コールバック関数について

Amazon DCV セッションの機能の可用性が変わると、接続の確立時に指定した featuresUpdate コールバック関数により、Amazon DCV ウェブクライアント SDK から通知を受けます。例えば、次のようになります。

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

コールバック関数は、可用性が変化した機能のみを通知します。list パラメータは一連の文字列で、更新された機能の名前のみが含まれます。例えば、セッションでオーディオ入力機能の可用性が変化した場合、パラメータには ["audio-in"] のみが含まれます。後に、セッションでクリップボードのコピー/貼り付け機能の可用性が変わった場合は、パラメータに ["clipboard-copy", "clipboard-paste"] のみが含まれます。

機能更新の処理

featuresUpdate コールバック関数は、可用性が変化した機能のみを通知します。どの機能が更新されたかを知るには、connection.queryFeature メソッドを使用して機能のクエリを行う必要があります。これは、変更通知の受信後にいつでも実行できます。このメソッドでは、解決を行う Promise が、リクエストされた機能の更新ステータスに返されます。status 値は常に関連付けられ、enabled というブール値 (true|false) プロパティを含みます。場合によっては、status 値に追加のプロパティがある機能もあります。機能の可用性が更新されていない場合は、拒否されます。

次のコード例では、その実行方法を説明しています。

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