埋め込み Amazon AppStream 2.0 ストリーミングセッションの定数、関数、イベント - Amazon AppStream 2.0
HIDDEN_ELEMENTS の使用AppStream.Embed オブジェクトの関数埋め込み AppStream 2.0 ストリーミングセッションのイベントイベントリスナーの追加と埋め込み AppStream 2.0 ストリーミングセッションの終了の例

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

埋め込み Amazon AppStream 2.0 ストリーミングセッションの定数、関数、イベント

以下のトピックでは、埋め込み AppStream 2.0 ストリーミングセッションの設定に使用できる定数、関数、イベントのリファレンス情報を提供します。

埋め込み AppStream 2.0 ストリーミングセッションが初期化されると、次の AppStream 2.0 ユーザーインターフェイス要素を設定HIDDEN_ELEMENTSオプションに渡すことができます。

HIDDEN_ELEMENTS の使用

埋め込み AppStream 2.0 ストリーミングセッションが初期化されると、次の AppStream 2.0 ユーザーインターフェイス要素を定数としてHIDDEN_ELEMENTS設定オプションに渡すことができます。

AppStream.Embed.Elements.TOOLBAR
AppStream.Embed.Elements.FULLSCREEN_BUTTON
AppStream.Embed.Elements.END_SESSION_BUTTON
AppStream.Embed.Elements.TOOLBAR
AppStream.Embed.Elements.CATALOG_BUTTON
AppStream.Embed.Elements.WINDOW_SWITCHER_BUTTON
AppStream.Embed.Elements.FILES_BUTTON
AppStream.Embed.Elements.CLIPBOARD_BUTTON
AppStream.Embed.Elements.COPY_LOCAL_BUTTON
AppStream.Embed.Elements.PASTE_REMOTE_BUTTON
AppStream.Embed.Elements.SETTINGS_BUTTON
AppStream.Embed.Elements.STREAMING_MODE_BUTTON
AppStream.Embed.Elements.SCREEN_RESOLUTION_BUTTON
AppStream.Embed.Elements.REGIONAL_SETTINGS_BUTTON
AppStream.Embed.Elements.FULLSCREEN_BUTTON
AppStream.Embed.Elements.END_SESSION_BUTTON

次の 3 つの要素はELEMENTS、定数ではなく文字列として HIDDEN_ に渡すことができます。

文字列 説明
'adminCommandsButton' AppStream 2.0 Image Builder に接続すると、Admin Commands ボタンが AppStream 2.0 ツールバーの右上隅に表示されます。この文字列を HIDDEN_ELEMENTS に渡すと、[Admin Commands] ボタンが非表示になります。
'softKeyboardButton' タッチ対応デバイスの AppStream 2.0 ストリーミングセッション中、ユーザーは AppStream 2.0 ツールバーのキーボードアイコンをタップすると、画面上のキーボードを表示できます。この文字列を HIDDEN_ELEMENTS に渡すと、キーボードアイコンが非表示になります。
'keyboardShortcutsButton' タッチ対応デバイスの AppStream 2.0 ストリーミングセッション中、ユーザーは AppStream 2.0 ツールバーの Fn アイコンをタップするとキーボードショートカットを表示できます。この文字列を HIDDEN_ELEMENTS に渡すと、Fn アイコンが非表示になります。

AppStream.Embed オブジェクトの関数

以下の表では、AppStream.Embed オブジェクトで実行できる関数を示しています。

機能 説明
AppStream.Embed(containerId:string, options:object) AppStream.Embed オブジェクトコンストラクタ。このコンストラクタは AppStream.Embed オブジェクトを初期化し、このオブジェクトとやり取りします。また、div コンテナ ID を使用します。ID は iframe を注入するために使用されます。また、 appstreamOptions (sessionURL および HIDDEN_ELEMENTS）。
endSession() この関数は、ストリーミングセッションを終了しますが、iframe は破棄しません。リダイレクト を指定するとURL、iframe は のロードを試みますURL。ページのCORSヘッダーによっては、 がロードされないURL場合があります。
launchApp(appId:string) この関数は、イメージの作成中に指定されたアプリケーション ID に対応するアプリケーションをプログラムで起動します。
launchAppSwitcher() この関数は、 AppSwitcher コマンドを AppStream 2.0 ポータルに送信します。これにより、インスタンスに対して AppSwitcher コマンドがトリガーされます。
getSessionState() この関数は、sessionStatus のオブジェクトを返します。詳細については、「埋め込み AppStream 2.0 ストリーミングセッションのイベント」を参照してください。
getUserInterfaceState()

この関数は、UserInterfaceState のオブジェクトを返します。オブジェクトには、以下のキーと値のペアが含まれます。

sessionStatus: 状態の列挙

sessionTerminationReason: 文字列

sessionDisconnectionReason: 文字列

詳細については、「埋め込み AppStream 2.0 ストリーミングセッションのイベント」を参照してください。
addEventListener(name, callback) この関数は、指定されたイベントのトリガー時に呼び出すコールバック関数を追加します。トリガーできるイベントのリストについては、「埋め込み AppStream 2.0 ストリーミングセッションのイベント」を参照してください。
removeEventListener(name, callback) この関数は、指定されたイベントのコールバックを削除します。
destroy() この関数は、iframe を削除し、リソースをクリーンアップします。この関数は、進行中のストリーミングセッションには影響しません。

埋め込み AppStream 2.0 ストリーミングセッションのイベント

次の表に、埋め込み AppStream 2.0 ストリーミングセッション中にトリガーできるイベントを示します。

イベント [データ] 説明
AppStream.Embed.Events.SESSION_STATE_CHANGE

sessionStatus: State enumeration

sessionTerminationReason: 文字列

sessionDisconnectionReason: 文字列

このイベントは、セッション状態の変更が生じたときにトリガーされます。このイベントには、変更された状態のマップが含まれます。完全なセッション状態を取得するには、getSessionState() 関数を使用します。

セッション状態は以下のとおりです。

AppStream.Embed.SessionStatus.Unknown — セッションは開始されておらず、予約されていません

AppStream.Embed.SessionStatus.Reserved — セッションは予約されていますが、開始されていません。

AppStream.Embed.SessionStatus.Started — ユーザーがセッションに接続し、ストリーミングを開始しました。

AppStream.Embed.SessionStatus Disconnected — ユーザーがセッションから切断されました。

AppStream.Embed.SessionStatus.Ended — セッションが終了または期限切れとしてマークされました。
AppStream.Embed.Events.SESSION_INTERFACE_STATE_CHANGE

hiddenElements: 文字列の配列

isFullscreen: ブール値

isSoftKeyboardVisible: ブール値

 このイベントは、セッション状態の変更が生じたときにトリガーされます。このイベントには、変更された状態のマップが含まれます。完全なセッション状態を取得するには、getSessionState() 関数を使用します。
AppStream.Embed.Events.SESSION_ERROR

errorCode: 番号

errorMessage: 文字列

 このイベントは、セッション中にエラーが発生するとトリガーされます。

イベントリスナーの追加と埋め込み AppStream 2.0 ストリーミングセッションの終了の例

このセクションの例では、次の操作を行う方法を示します。

  • 埋め込み AppStream 2.0 ストリーミングセッションのイベントリスナーを追加します。

  • 埋め込み AppStream 2.0 ストリーミングセッションをプログラムで終了します。

例 1: 埋め込み AppStream 2.0 ストリーミングセッションにイベントリスナーを追加する

埋め込みストリーミングセッション中のセッションの状態の変更、セッションインターフェイスの状態の変更、セッションエラーに対するイベントリスナーを追加するには、以下のコードを使用します。

appstreamEmbed.addEventListener(AppStream.Embed.Events.SESSION_STATE_CHANGE, updateSessionStateCallback);

appstreamEmbed.addEventListener(AppStream.Embed.Events.SESSION_INTERFACE_STATE_CHANGE, updateUserInterfaceStateCallback);

appstreamEmbed.addEventListener(AppStream.Embed.Events.SESSION_ERROR, errorCallback);

この例では、AppStream.Embed.Events.SESSION_STATE_CHANGE、AppStream.Embed.Events.SESSION_INTERFACE_STATE_CHANGE、AppStream.Embed.Events.SESSION_ERROR はイベント名です。

updateSessionStateCallback、updateUserInterfaceStateCallback、errorCallback は実装する関数です。これらの関数は addEventListener 関数に渡され、イベントがトリガーされると呼び出されます。

例 2: 埋め込み AppStream 2.0 ストリーミングセッションをプログラムで終了する

埋め込み AppStream 2.0 ストリーミングセッションを終了するには、次の関数を使用します。

appstreamEmbed.endSession();