Skip to main content

XGameStreamingShowTouchControlLayout

接続されているすべてのストリーミング クライアント デバイスに指定されたタッチ レイアウトを表示するよう要求します。

Syntax

Parameters

layout   _In_opt_z_
型: char*
表示するタッチ コントロール レイアウトの名前。または、標準の XBOX コントローラー レイアウトを表示する場合は nullptr ストリーミング クライアント デバイスに表示するタッチ コントロール レイアウトの ID。レイアウト ID はタイトル固有であり、Touch Adaptation Kit の一部として XBOX Game Streaming サービスに提供されるレイアウトの ID に対応します。この文字列は UTF-8 でエンコードされている必要があります。 nullptr を指定すると、既定のタッチ コントロール セットが表示されます。 タイトルのタッチ コントロール レイアウト ID に一致しない文字列は、クライアント デバイス上のタッチ コントロールの状態を変更しません。このような場合、Content Test Application では診断情報が提供されることがあります。

Return Value

型: void

Remarks

この API は、現在のすべてのゲーム ストリーミング クライアントに対し、プレイヤーのクライアント デバイス上で特定のタッチ コントロール レイアウトを表示するよう要求します。プレイヤーがゲームをストリーミングしていない場合、またはタッチが有効ではないデバイスにストリーミングしている場合、この関数は何も行いません。 プレイヤーがタッチ コントロールではなく物理コントローラーを使用している場合、この関数はデバイス上にタッチ コントロールを強制的に表示しません。代わりに、次にプレイヤーがタッチ コントロールを使い始めた際に、最後に要求されたレイアウトがクライアントで使用されます。 この関数は、プレイヤーがタッチ コントロールを使用している場合に、現在のゲーム状態にどのタッチ コントロール レイアウトが最も適しているかをクライアント デバイスに伝えるヒントと考えることができます。実際にこれらのコントロールをプレイヤーの画面に表示する最適なタイミングは、クライアント デバイスが管理します。 XGameStreamingShowTouchControlLayout を呼び出すたびにネットワーク経由でメッセージが送信されるため、フレームごとに呼び出さないでください。代わりに、異なるタッチ コントロール レイアウト間で遷移する必要がある場合にのみこの API を呼び出してください。 XGameStreamingShowTouchControlLayout を呼び出したときにクライアント デバイスが接続されていない場合、クライアントが接続すると、最後に要求されたタッチ コントロール レイアウトを受け取ります。 特定の 接続されているストリーミング クライアント デバイスにタッチ コントロール レイアウトを表示したい場合は、代わりに XGameStreamingShowTouchControlLayoutOnClient の使用を検討してください。

Examples

Requirements

ヘッダー: xgamestreaming.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体

See also

XGameStreamingHideTouchControls
XGameStreamingShowTouchControlLayoutOnClient
XGameStreaming
最終更新日 2026年8月24日