ステップ 4. Amazon AppStream 2.0 との統合のためにウェブサイトを設定する - Amazon AppStream 2.0
Appstream 埋め込み JavaScript ファイルをインポートするAppStream.Embed インターフェイスオブジェクトを初期化して設定する AppStream 2.0 ユーザーインターフェイスで項目を非表示にする例

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

ステップ 4. Amazon AppStream 2.0 との統合のためにウェブサイトを設定する

以下のセクションでは、埋め込み AppStream 2.0 ストリーミングセッションをホストするようにウェブページを設定する方法について説明します。

Appstream 埋め込み JavaScript ファイルをインポートする

  1. AppStream 2.0 ストリーミングセッションを埋め込む予定のウェブページで、次のコードを追加して Appstream-embed.js ファイルをウェブページにインポートします。

    <script type="text/javascript" src="./appstream_embed.js"> </script>

  2. 次に、空のコンテナ div を作成します。設定した div の ID は、 AppStream 2.0 埋め込みコンストラクターに渡されます。その後、ストリーミングセッションの iframe を注入するために使用されます。div を作成するには、以下のコードを追加します。

    <div id="appstream-container"> </div>

AppStream.Embed インターフェイスオブジェクトを初期化して設定する

でAppStream.Embedインターフェイスオブジェクトを初期化するには JavaScript、ストリーミングURLとユーザーインターフェイス設定のオプションを使用してAppStream.Embedオブジェクトを作成するコードを追加する必要があります。これらのオプション、および作成した div ID は、appstreamOptions というオブジェクトに保存されます。

以下のサンプルコードでは、AppStream.Embed インターフェイスオブジェクトを初期化する方法を示しています。

var appstreamOptions = {
     sessionURL: 'https://appstream2.region.aws.amazon.com/authenticate?parameters=authenticationcode...',
     userInterfaceConfig:{[AppStream.Embed.Options.HIDDEN_ELEMENTS]:[AppStream.Embed.Elements.TOOLBAR]}
 };
 appstreamEmbed = new AppStream.Embed("appstream-container", appstreamOptions);

コードで、 を置き換えます。sessionURL また、userInterfaceConfig 独自の値を使用します。

注記

に指定された値 userInterfaceConfig は AppStream 2.0 ツールバー全体を非表示にします。この値は例として含まれており、オプションです。

sessionUrl

AppStream 2.0 コンソール、 CreateStreamingURLAPIアクション、または create-streaming-url AWS CLI コマンドを使用してURL作成したストリーミング。このパラメータは大文字と小文字が区別されます。

型: 文字列

必須: はい

userInterfaceConfig

ユーザーインターフェイス要素の初期状態を生成する設定。この設定はキーと値のペアです。

キー はAppStream.Embed.Options.HIDDEN_ELEMENTS、埋め込み AppStream 2.0 ストリーミングセッションが初期化されたときに最初に非表示になるユーザーインターフェイスオブジェクトを指定します。後で、getInterfaceState パラメータを使用して、非表示オブジェクトと表示オブジェクトの両方を返すことができます。

値は、定数 (ツールバーボタン) の配列です。使用できる定数のリストについては、「HIDDEN_ELEMENTS の使用」を参照してください。

タイプ : Map (key:value)

必須: いいえ

AppStream 2.0 ユーザーインターフェイスで項目を非表示にする例

このセクションの例は、埋め込み AppStream 2.0 ストリーミングセッション中に AppStream 2.0 ユーザーインターフェイスの項目をユーザーから非表示にする方法を示しています。

例 1: AppStream 2.0 ツールバー全体を非表示にする

埋め込みストリーミングセッション中にユーザーが AppStream 2.0 ツールバーのボタンにアクセスできないようにするには、AppStream.Embed.Elements.TOOLBAR定数を使用します。この定数を使用すると、すべての AppStream 2.0 ツールバーボタンを非表示にできます。

var appstreamOptions = {
     sessionURL: 'https://appstream2.region.aws.amazon.com/authenticate?parameters=authenticationcode...',
     userInterfaceConfig:{[AppStream.Embed.Options.HIDDEN_ELEMENTS]:[AppStream.Embed.Elements.TOOLBAR]}
 };

例 2: AppStream 2.0 ツールバーで特定のボタンを非表示にする

埋め込みストリーミングセッション中にユーザーが特定のツールバーボタンにアクセスできないようにしながら、 AppStream 2.0 ツールバーを表示できます。そのためには、非表示にするボタンの定数を指定します。以下のコードは、AppStream.Embed.Elements.FILES_BUTTON 定数を使用して [My Files] ボタンを非表示にします。これにより、ユーザーは埋め込みストリーミングセッション中に永続的ストレージオプションにアクセスできなくなります。

var appstreamOptions = {
     sessionURL: 'https://appstream2.region.aws.amazon.com/authenticate?parameters=authenticationcode...',
     userInterfaceConfig:{[AppStream.Embed.Options.HIDDEN_ELEMENTS]:[AppStream.Embed.Elements.FILES_BUTTON]}
 };

例 3: AppStream 2.0 ツールバーで複数のボタンを非表示にする

埋め込みストリーミングセッション中にユーザーが複数のツールバーボタンにアクセスできないようにしながら、 AppStream 2.0 ツールバーを表示できます。そのためには、非表示にするボタンの定数を指定します。以下のコードは、AppStream.Embed.Elements.END_SESSION_BUTTON および AppStream.Embed.Elements.FULLSCREEN_BUTTON 定数を使用して、[End Session] および [Fullscreen] ボタンを非表示にします。

注記

各定数は、前後にスペースを入れずにカンマで区切ります。

var appstreamOptions = {
     sessionURL: 'https://appstream2.region.aws.amazon.com/authenticate?parameters=authenticationcode... (https://appstream2.region.aws.amazon.com/#/)',
     userInterfaceConfig:{[AppStream.Embed.Options.HIDDEN_ELEMENTS]:[AppStream.Embed.Elements.END_SESSION_BUTTON,AppStream.Embed.Elements.FULLSCREEN_BUTTON]}
 };