XGameStreamingHideTouchControlsOnClient

指定したストリーミング クライアント デバイスに対して、タッチ レイアウトが表示されている場合は非表示にするように要求します。

構文

void XGameStreamingHideTouchControlsOnClient(  
         XGameStreamingClientId client  
)  

パラメーター

client _In_
型: XGameStreamingClientId

タッチ コントロールを非表示にするストリーミング クライアント デバイス。

戻り値

型: void

解説

この API は、指定したゲーム ストリーミング クライアントに対して、表示されているタッチ オーバーレイ コントロールをすべて削除するように要求します。 プレイヤーがゲームをストリーミングしていない場合、またはストリーミング先のデバイスにタッチ オーバーレイ コントロールが表示されていない場合、この関数は何も行いません。

指定のタッチ コントロール レイアウトを表示するには、XGameStreamingShowTouchControlLayoutOnClient を呼び出します。

XGameStreamingHideTouchControlsOnClient を呼び出すと、そのたびにネットワーク経由でメッセージが送信されます。このため、フレームごとに呼び出すことは避ける必要があります。 この API は、ゲームでタッチ コントロールが表示された画面から遷移する必要がある場合にのみ呼び出してください。

接続されている すべて のストリーミング クライアント デバイスでタッチ コントロール レイアウトを非表示にする場合は、代わりに XGameStreamingHideTouchControls の使用を検討してください。

例

void OnShowMenu(XGameStreamingClientId client)
{
    // This game has native touch support for the menu system, so hide touch overlay controls
    XGameStreamingHideTouchControlsOnClient(client);
}

void OnDismissMenu(XGameStreamingClientId client)
{
    // Show the touch overlay controls which were previously on the screen before we hid them
    // due to bringing up the menu.
    XGameStreamingShowTouchControlsOnClient(client);
}

要件

ヘッダー: xgamestreaming.h

ライブラリ: xgameruntime.lib

サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体

関連項目

XGameStreamingShowTouchControlLayoutOnClient
XGameStreamingHideTouchControls
XGameStreaming