Cookie の設定を選択する

当社は、当社のサイトおよびサービスを提供するために必要な必須 Cookie および類似のツールを使用しています。当社は、パフォーマンス Cookie を使用して匿名の統計情報を収集することで、お客様が当社のサイトをどのように利用しているかを把握し、改善に役立てています。必須 Cookie は無効化できませんが、[カスタマイズ] または [拒否] をクリックしてパフォーマンス Cookie を拒否することはできます。

お客様が同意した場合、AWS および承認された第三者は、Cookie を使用して便利なサイト機能を提供したり、お客様の選択を記憶したり、関連する広告を含む関連コンテンツを表示したりします。すべての必須ではない Cookie を受け入れるか拒否するには、[受け入れる] または [拒否] をクリックしてください。より詳細な選択を行うには、[カスタマイズ] をクリックしてください。

設定
お問い合わせ
フィードバック
AWS Documentation
今すぐ無料サインアップ »

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

PDF
RSS
フォーカスモード
埋め込み Amazon AppStream 2.0 ストリーミングセッションの定数、関数、イベント - Amazon AppStream 2.0
「HIDDEN_ELEMENTS」 の使用AppStream.Embed オブジェクトの関数埋め込み AppStream 2.0 ストリーミングセッションのイベントイベントリスナーの追加例と埋め込み 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 つの要素は、定数としてではなく、文字列として HIDDEN_ELEMENTS に渡すことができます。

String 説明
'adminCommandsButton' AppStream 2.0 Image Builder に接続すると、AppStream 2.0 ツールバーの右上隅に [Admin Commands (管理者コマンド)] ボタンが表示されます。この文字列を 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();

このページの内容

プライバシーサイト規約Cookie の設定
© 2025, Amazon Web Services, Inc. or its affiliates.All rights reserved.