XGameStreamingShowTouchControlLayoutOnClient
단일 클라이언트에 요청된 터치 컨트롤 세트를 표시합니다.구문
매개 변수
client _In_형식: XGameStreamingClientId 터치 컨트롤을 표시할 스트리밍 클라이언트 장치입니다. layout _In_opt_z_
형식: char* 표시할 터치 컨트롤 레이아웃의 이름 또는 기본 레이아웃을 표시하려면 nullptr입니다. 스트리밍 클라이언트 장치에 표시되어야 하는 터치 컨트롤 레이아웃의 ID입니다. 레이아웃 ID는 타이틀별로 다르며, 터치 적응 키트(Touch Adaptation Kit)의 일부로 XBOX Game Streaming에 제공되는 레이아웃의 ID에 해당합니다. 이 문자열은 UTF-8로 인코딩되어야 합니다.
nullptr이 제공되면 기본 터치 컨트롤 세트가 표시됩니다.
타이틀의 터치 컨트롤 레이아웃 ID와 일치하지 않는 문자열은 클라이언트 장치의 터치 컨트롤 상태를 변경하지 않고 그대로 유지되도록 합니다. Content Test Application은 이러한 경우 진단 정보를 제공할 수 있습니다.
반환 값
형식: void설명
이 API는 지정한 게임 스트리밍 클라이언트가 플레이어의 클라이언트 장치에 특정 터치 컨트롤 레이아웃을 표시하도록 요청합니다. 플레이어가 게임을 스트리밍하고 있지 않거나 스트리밍 클라이언트에서 터치가 활성화되지 않은 경우, 이 함수는 아무 작업도 수행하지 않습니다. 플레이어가 터치 컨트롤 대신 물리적 컨트롤러를 사용하고 있다면 이 함수는 해당 장치에 터치 컨트롤을 강제로 표시하지 않습니다. 대신 플레이어가 다음에 터치 컨트롤을 사용할 때 마지막으로 요청된 레이아웃을 클라이언트가 사용합니다. 이 함수는 플레이어가 터치 컨트롤을 사용하는 경우 현재 게임 상태에 가장 적합한 터치 컨트롤 레이아웃이 무엇인지 클라이언트 장치에 알려주는 힌트로 생각할 수 있습니다. 그러면 클라이언트 장치는 해당 컨트롤을 플레이어의 화면에 배치할 최적의 시점을 관리합니다.XGameStreamingShowTouchControlLayoutOnClient를 호출할 때마다 네트워크를 통해 메시지가 전송되므로 매 프레임마다 호출해서는 안 됩니다. 대신 게임에서 서로 다른 터치 컨트롤 레이아웃 간에 전환해야 할 때에만 이 API를 호출하세요.
연결된 모든 스트리밍 클라이언트 장치에 터치 컨트롤 레이아웃을 표시하려는 경우에는 대신 XGameStreamingShowTouchControlLayout을 사용하는 것을 고려하세요.
예제
요구 사항
헤더: xgamestreaming.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔함께 보기
XGameStreamingHideTouchControlsOnClientXGameStreamingShowTouchControlLayout
XGameStreaming
