XGameStreamingShowTouchControlLayoutOnClient

단일 클라이언트에서 요청된 터치 컨트롤 집합을 표시합니다.

구문

void XGameStreamingShowTouchControlLayoutOnClient(  
         XGameStreamingClientId client,  
         const char* layout  
)  

매개 변수

client _In_
형식: XGameStreamingClientId

터치 컨트롤을 표시할 스트리밍 클라이언트 장치

layout _In_opt_z_
형식: char*

표시할 터치 컨트롤 레이아웃의 이름 또는 기본 레이아웃을 표시하는 nullptr

스트리밍 클라이언트 장치에 표시해야 하는 터치 컨트롤 레이아웃의 ID 레이아웃 ID는 타이틀별로 다르며 터치 적응 키트의 일부로 Xbox 게임 스트리밍 서비스에 제공되는 레이아웃의 ID에 해당합니다. 이 문자열은 UTF-8 인코딩되어 있어야 합니다.

nullptr이 제공된 경우 기본 터치 컨트롤 집합이 표시됩니다.

타이틀에 대한 터치 컨트롤 레이아웃 ID에 해당하지 않는 모든 문자열은 클라이언트 장치의 터치 컨트롤의 상태를 변경하지 않습니다. 콘텐츠 테스트 애플리케이션에서는 이러한 경우에 대한 진단을 제공할 수 있습니다.

반환 값

형식: void

설명

이 API는 지정된 게임 스트리밍 클라이언트가 플레이어의 클라이언트 장치에서 특정 터치 컨트롤 레이아웃을 표시하도록 요청합니다. 플레이어가 게임을 스트리밍하지 않거나 스트리밍 클라이언트가 터치를 사용하지 않는 경우 아무 작업도 수행하지 않습니다.

플레이어가 터치 컨트롤을 사용하는 대신 실제 컨트롤러를 사용하는 경우 이 함수를 통해 터치 컨트롤이 디바이스에 표시되지 않습니다. 대신 클라이언트는 다음에 플레이어가 터치 컨트롤을 사용할 때 요청한 마지막 레이아웃을 사용합니다.

이 함수를 클라이언트 장치에 대한 힌트로 생각할 수 있습니다. 플레이어가 터치 컨트롤을 사용하는 경우 현재 게임 상태에 가장 적합한 터치 컨트롤 레이아웃을 알려 줍니다. 그러면 클라이언트 장치는 이러한 컨트롤을 플레이어 화면에 배치하는 것이 가장 좋은 시기를 관리합니다.

XGameStreamingShowTouchControlLayoutOnClient를 호출할 때마다 네트워크를 통해 메시지가 전송되므로 모든 프레임이 호출되지 않아야 합니다. 대신, 게임에서 다른 터치 컨트롤 레이아웃 간에 전환해야 하는 경우에만 이 API를 호출합니다.

게임에서 연결된 모든 스트리밍 클라이언트 장치의 터치 제어 레이아웃을 표시하려는 경우 대신 XGameStreamingShowTouchControlLayout을 사용하는 것이 좋습니다.

예

void OnGameStateChanged(GameState newState, XGameStreamingClientId client)
{
    // Toggle to the set of touch overlay controls which best match the new state of the game
    switch (newState)
    {
    case GameState::FirstPersonAction:
        XGameStreamingShowTouchControlLayoutOnClient(client, "FirstPersonAction");
        break;
    case GameState::Driving:
        XGameStreamingShowTouchControlLayoutOnClient(client, "Driving");
        break;
    case GameState::CutScene:
        // Don't show any touch overlay controls while the cut scene is rendering
        XGameStreamingHideTouchControlsOnClient(client);
        break;
    }
}

요건

헤더: xgamestreaming.h

라이브러리: xgameruntime.lib

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

XGameStreamingHideTouchControlsOnClient
XGameStreamingShowTouchControlLayout
XGameStreaming