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
型: voidRemarks
この API は、現在のすべてのゲーム ストリーミング クライアントに対し、プレイヤーのクライアント デバイス上で特定のタッチ コントロール レイアウトを表示するよう要求します。プレイヤーがゲームをストリーミングしていない場合、またはタッチが有効ではないデバイスにストリーミングしている場合、この関数は何も行いません。 プレイヤーがタッチ コントロールではなく物理コントローラーを使用している場合、この関数はデバイス上にタッチ コントロールを強制的に表示しません。代わりに、次にプレイヤーがタッチ コントロールを使い始めた際に、最後に要求されたレイアウトがクライアントで使用されます。 この関数は、プレイヤーがタッチ コントロールを使用している場合に、現在のゲーム状態にどのタッチ コントロール レイアウトが最も適しているかをクライアント デバイスに伝えるヒントと考えることができます。実際にこれらのコントロールをプレイヤーの画面に表示する最適なタイミングは、クライアント デバイスが管理します。XGameStreamingShowTouchControlLayout を呼び出すたびにネットワーク経由でメッセージが送信されるため、フレームごとに呼び出さないでください。代わりに、異なるタッチ コントロール レイアウト間で遷移する必要がある場合にのみこの API を呼び出してください。
XGameStreamingShowTouchControlLayout を呼び出したときにクライアント デバイスが接続されていない場合、クライアントが接続すると、最後に要求されたタッチ コントロール レイアウトを受け取ります。
特定の 接続されているストリーミング クライアント デバイスにタッチ コントロール レイアウトを表示したい場合は、代わりに XGameStreamingShowTouchControlLayoutOnClient の使用を検討してください。
Examples
Requirements
ヘッダー: xgamestreaming.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体See also
XGameStreamingHideTouchControlsXGameStreamingShowTouchControlLayoutOnClient
XGameStreaming
