다음을 통해 공유

Serve 명령

  • 아티클

serve 명령은 유효성 검사 환경을 위해 CTA에서 지정된 레이아웃을 사용하도록 설정하는 데 사용됩니다.

패키지화된 터치 적응 번들(pack 명령으로 생성된) 중 하나를 제공하거나 패키지화되지 않은 레이아웃을 집합을 제공합니다.

다음 표에서는 serve 명령과 사용할 수 있는 다른 옵션을 보여줍니다.

옵션 설명
--takx, --takx-file <takx-file> 제공하려는 터치 적응 번들의 경로입니다. 이 매개 변수 또는 --layout-path 또는 --takxconfig 매개 변수가 필요합니다.
--takxconfig, --takx-config-file <takx-config-file> 제공하려는 번들을 나타내는 takxconfig.json 파일의 경로입니다. 이 매개 변수 또는 --layout-path 또는 --takx 매개 변수가 필요합니다.
--layout-path <layout-path> 제공되는 번들에 포함할 루트 레이아웃 디렉터리의 경로입니다. 이 매개 변수 또는 --takx-file 또는 --takxconfig 매개 변수가 필요합니다. --takxconfig이(가) 지정되면 이 인수는 takxconfig.json 파일에 지정된 경로를 재정의합니다.
--asset-path <asset-path> 제공되는 번들에 포함할 루트 자산 디렉터리의 경로입니다. 번들에 자산이 없는 경우 이 매개 변수는 필요하지 않습니다. --takxconfig이(가) 지정되면 이 인수는 takxconfig.json 파일에 지정된 경로를 재정의합니다.
--context file <context-file> 번들에 포함할 컨텍스트 파일의 경로입니다. 번들에 컨텍스트가 없으면 이 매개 변수가 필요하지 않습니다. --takxconfig이(가) 지정되면 이 인수는 takxconfig.json 파일에 지정된 경로를 재정의합니다.
--default-layout <default-layout> 기본 레이아웃의 이름입니다. 레이아웃 경로에 있는 파일 중 하나의 이름과 일치해야 합니다. --takxconfig이(가) 지정되면 이 인수는 takxconfig.json 파일에 지정된 기본값을 재정의합니다.
--version <version> 1.0.0.0과 같은 터치 적응 번들의 콘텐츠 버전. 타이틀을 위해 Microsoft에 제출된 각 터치 적응 번들에는 제출된 이전 터치 적응 번들보다 의미상 더 큰 버전 번호가 있어야 합니다. 게임이 스트리밍되는 동안 사용 중인 터치 적응 번들의 버전 번호는 XGameStreamingGetTouchBundleVersion을(를) 호출하여 얻을 수 있습니다. --takxconfig이(가) 지정되면 이 인수는 takxconfig.json 파일에 지정된 버전을 재정의합니다.
--version-name <version-name> "DLC 1"과 같은 터치 적응 번들의 콘텐츠 버전 이름입니다. 버전 번호와 달리 버전 이름은 선택 사항이며 형식에 대한 요구 사항이 없습니다. 게임이 스트리밍되는 동안 사용 중인 터치 적응 번들의 버전 이름은 XGameStreamingGetTouchBundleVersion을(를) 호출하여 얻을 수 있습니다. --takxconfig이(가) 지정되면 이 인수는 takxconfig.json 파일에 지정된 버전 이름을 재정의합니다.
--no-asset-optimization 효율적인 저장소 및 통신에 자산을 최적화하지 않도록 합니다. 설정된 경우 자산이 수정되지 않습니다.
--no-verify 제작된 터치 적응 번들이 유효한지와 확인되지 않았는지 확인합니다.
--language <language> 제공되는 번들에 포함할 언어의 IETF 언어 태그를 제공합니다. 이 매개 변수를 여러 번 지정하면 제공된 모든 언어가 포함됩니다. 매개 변수가 지정되지 않은 경우, 원본 디렉터리에 있는 모든 레이아웃과 자산이 제공되는 번들에 포함됩니다. --takxconfig이(가) 지정되면 이 인수는 takxconfig.json 파일에 지정된 언어를 재정의합니다.
--port <port> 터치 적응 번들을 제공하는 포트입니다. 기본 포트는 9269입니다.
--host <host> 터치 적응 번들을 제공하는 호스트입니다. 기본 호스트는 모든 네트워크 인터페이스에서 번들을 사용하도록 설정하는 0.0.0.0입니다. localhost을(를) 사용하여 서버에서 어떤 인터페이스를 사용할 수 있는지 제어하는 루프백 또는 특정한 IP로만 서버를 사용할 수 있도록 합니다.
--certificate-file <certificate-file> 보안 HTTPS 요청에 대해 서버를 인증하기 위한 .pfx 인증서 파일의 경로입니다. 이 플래그는 도구가 인증된 HTTPS 서버를 호스트하는 데 필요합니다.

⚠️ 참고:CTA(웹 콘텐츠 테스트 애플리케이션)는 https 및 이 옵션을 사용하는 원격 사이드로드 서버에만 연결할 수 있습니다.
--certificate-password <certificate-password> 인증서 데이터에 액세스하는 데 필요한 암호입니다.
--password <password> 클라이언트를 인증하기 위한 암호입니다. https를 통해 테스트용으로 로드할 때 터치 적응 번들에 대한 클라이언트 액세스를 제한하는 선택적 플래그입니다. 클라이언트를 성공적으로 인증하려면 제공된 암호가 GameStreaming 앱의 클라이언트 개발자 설정에 제공된 암호와 일치해야 합니다.

예제

다음 코드 예제를 사용하여 호스트에서 터치 적응 번들을 제공하세요.

기본 포트 및 호스트의 layout-path에 있는 모든 레이아웃을 제공하고 특정 버전/버전 이름을 선언합니다.

C:\>tak serve --layout-path C:\tmp\layouts --version 1.0.0.2 --versionName DLC2
Verifying touch adaptation bundle 'C:\tmp\layouts'.
Now listening on: http://0.0.0.0:9269
Application started. Press Ctrl+C to shut down.
Hosting environment: Production
Content root path: C:\tmp

localhost를 통해서만 지정된 터치 적응 번들을 제공합니다.

C:\>tak serve --takx-file C:\tmp\MyGameLayouts.takx --host localhost
Now listening on: http://localhost:9269
Application started. Press Ctrl+C to shut down.
Hosting environment: Production
Content root path: C:\tmp

인증서 생성 지침

터치 번들을 사이드로드하기 위해 인증된 보안 서버를 호스트하려면 인증서가 필요합니다. 적절한 아무 SSL 인증서나 사용할 수도 있지만 아래 지침을 사용해서 인증서를 만들 수도 있습니다.

  1. Xbox 게임 스트리밍 도구 GitHub에서 자체 서명된 인증서를 생성하는 스크립트 가져오기

    a. 위의 링크로 이동하여 '원시'를 선택하고 스크립트 내용을 복사하여 로컬 컴퓨터의 문서에 붙여넣습니다.

    b. 아니면 Powershell에서 다음 명령을 실행하여 스크립트를 다운로드합니다.

    Invoke-WebRequest -Uri https://raw.githubusercontent.com/microsoft/xbox-game-streaming-tools/main/touch-adaptation-kit/scripts/Create-SelfSignedCertificate.ps1 -Out ./Create-SelfSignedCertificate.ps1

참고 항목

Create-SelfSignedCertificate.ps1 스크립트는 Windows에서만 작동합니다. 유효한 자체 서명된 인증서를 생성하기 위한 도구가 다른 운영 체제에 있을 수 있습니다.

  1. Powershell에서 다운로드한 스크립트를 실행합니다.
  2. 스크립트에서 인증서를 보호하기 위한 암호를 묻는 메시지를 표시합니다. 여기에 암호를 입력하여 설정합니다. 이 암호는 serve 명령의 -certificate-password 플래그에 대한 입력으로 사용됩니다. 이렇게 하면 sideload.pfx 및 sideload.cer 두 개의 파일이 생성됩니다. sideload.pfx 인증서 파일의 경로는 serve 명령의 -certificate-file 플래그에 대한 입력으로 전달됩니다.

다른 클라이언트에서 인증서 신뢰

.cer 파일을 장치에 로드합니다. 이 작업은 전자 메일, OneDrive, USB, ADB, AirDrop 등을 통해 수행할 수 있습니다. 지정한 장치에 적합한 일반적인 방식으로 인증서를 신뢰합니다.

Windows

  1. sideload.cer 파일을 두 번 클릭합니다.
  2. ‘인증서 설치’를 선택합니다. 이렇게 하면 인증서 가져오기 마법사가 열립니다.
  3. 저장 위치로 '현재 사용자'를 선택합니다.
  4. 다음 창에서 '다음 저장소에 모든 인증서 배치'를 선택한 다음, '신뢰할 수 있는 루트 인증 기관 찾아보기'를 선택합니다.

Android

  1. Android 디바이스에서 스토리지에서 설정 > 보안 > 고급 > 암호화 & 자격 증명 > 설치로 이동합니다.

  2. CA 인증서를 선택하여 인증서를 설치한 다음 이전 섹션에서 다운로드한 파일을 찾 sideload.cer 습니다.

    설치가 완료되면 신뢰할 수 있는 자격 증명 > 사용자에서 이 인증서를 볼 수 있습니다.

자세한 내용은 Google의 설명서를 참조하세요.

iOS

  1. iOS 디바이스의 파일 애플리케이션으로 이동하여 디바이스 프로필에 .cer 파일을 설치합니다.
  2. .cer 파일 프로필 이름에 따라 새 프로필을 생성해야 합니다. 설정 > 일반 > 프로필 및 장치 관리에서 찾을 수 있습니다.
  3. 인증서를 설치합니다. 이러면 인증서 서명이 확인된 것으로 표시됩니다.
  4. 설치된 인증서를 테스트하려면 설정 > 일반 > 정보 > 인증서 신뢰 설정으로 이동합니다. 방금 설치한 루트 인증서에 완전 신뢰를 사용하도록 설정합니다.

자세한 내용은 Apple의 설명서를 참조하세요.

예제

다음 코드 예제를 사용하여 호스트에서 터치 적응 번들을 안전하게 제공합니다.

https를 통해 기본 호스트 및 포트의 레이아웃 경로에 있는 모든 레이아웃 제공

C:\>  tak serve --layout-path C:\tmp\layouts --certificate-file C:\tmp\sideload.pfx --certificate-password "password"
Adding local loopback exemption for PC app connections.
OK.
Hosting starting
Now listening on: https://0.0.0.0:9269
Application started. Press Ctrl+C to shut down.
Hosting environment: Production
Content root path: C:\tmp
Hosting started

클라이언트를 인증할 때 기본 호스트 및 포트의 레이아웃 경로에 있는 모든 레이아웃을 안전하게 제공합니다.

C:\>  tak serve --layout-path C:\tmp\layouts --certificate-file C:\tmp\sideload.pfx --certificate-password "certificatePassword" -password "password"
Adding local loopback exemption for PC app connections.
OK.
Hosting starting
User profile is available. Using 'AppData\Local\ASP.NET\DataProtection-Keys' as key repository and Windows DPAPI to encrypt keys at rest.
Now listening on: https://0.0.0.0:9269
Application started. Press Ctrl+C to shut down.
Hosting environment: Production

참고 항목

터치 적응 키트 명령줄 도구(tak.exe)