XGameStreamingGetTouchBundleVersion
指定されたデバイスで現在使用されているタッチ アダプテーション バンドルのバージョンを取得します。Syntax
Parameters
client _In_型: XGameStreamingClientId 照会するストリーミング クライアント。 version _Out_opt_
型: XVersion* 指定されたクライアントで現在使用されているバンドルのバージョン番号。バンドルにバージョン番号が指定されていない場合、0.0.0.0 が返されます。 versionNameSize _In_
型: size_t 返される
versionName の最大サイズ (バイト単位)。指定するサイズは、XGameStreamingGetTouchBundleVersionNameSize を呼び出すことで取得できます。
versionName _Out_writes_opt_z_型: char* 指定されたクライアントで現在使用されているバンドルのバージョン名。バンドルにバージョン名が指定されていない場合、
null が返されます。
Return value
型: HRESULT 成功した場合は S_OK を返します。それ以外の場合はエラー コードを返します。想定されるエラー
エラー コードの一覧については、Error Codes を参照してください。
Remarks
ゲーム ストリーミング中にプレイヤーに提示されるタッチ レイアウトは、タッチ アダプテーション バンドルの一部として Microsoft にアップロードされた事前定義済みのレイアウトを使用します。XGameStreamingGetTouchBundleVersion を使用すると、特定のクライアントで使用されているタッチ コントロールのセットに基づいて、ゲームが実行時に判断を行えます。これが利用されるいくつかの例:
- プレイヤーがタッチを使用しており、要素がタッチ オーバーレイ コントロールを介して利用可能な場合、その要素を HUD から取り除く。
- 表示されるタッチ レイアウトに基づいて、ゲーム内に表示するグラフィカルなヒントを決定する。
version は、サービスにアップロードされるバージョンごとに一意です。すべての更新には新しいバージョン番号が必要です。
versionName は、特定のバージョン番号に固定するのではなく、セマンティック バージョン (たとえば、これは DLC2 をサポートする一連のレイアウトです) を提供するために使用できます。たとえば、バージョン番号がビルド システムによって自動的に割り当てられる場合、実行時に表示されるタッチ アダプテーション バンドルの正確なバージョン番号をゲーム コード側で把握することが難しい場合があります。バンドルの正確なバージョンを知らなくてもコードでその存在を検出できるようにするため、バージョン番号による比較ではなくバージョン名を使用することを選択できます。
Example
Requirements
ヘッダー: XGameStreaming.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体See also
XGameStreamingXGameStreamingGetTouchBundleVersionNameSize
