Share via

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

  • 아티클

이 항목을 사용하여 TAK(터치 적응 키트)를 사용하여 터치 컨트롤 레이아웃을 만들고 유효성을 검사합니다.

takxconfig.json 및 .takx 파일

tak.exe 명령줄 도구가 작동하는 기본 파일 형식은 압축을 풀고 번들 구성 파일(takxconfig.json) 또는 패키지 번들(.takx) 파일입니다. 실행 중인 명령에 따라 이러한 파일 유형 중 하나를 항상 사용할 수 있으며 전체 터치 번들을 나타냅니다. 이전 버전과의 호환성과 일부 내부 루프 시나리오를 더 쉽게 만들기 위해 --layout-path과 같은 레거시 인수가 계속 지원되며 takxconfig.json의 콘텐츠를 재정의합니다.

속성

$schema - 문자열. 터치 번들 구성 파일의 JSON 스키마입니다. 선택한 스키마 버전에 따라 https://raw.githubusercontent.com/microsoft/xbox-game-streaming-tools/main/touch-adaptation-kit/schemas/takxconfig/v1/takxconfig.json과(와) 유사해야 합니다.

version - 문자열. 번들에 대한 네 부분(예: 1.0.0.0) 버전 번호입니다.

versionName - 문자열, 선택적. 번들 버전을 설명하는 이름입니다.

layouts - 개체. 번들에 대한 레이아웃 옵션을 정의하는 개체입니다. 이 항목 내의 path 속성은 레이아웃이 있는 상대 경로를 지정합니다.

assets - 개체, 선택적. 번들에 대한 자산 옵션을 정의하는 개체입니다. 이 항목 내의 path 속성은 자산이 있는 상대 경로를 지정합니다.

context - 개체, 선택적. 번들에 대한 컨텍스트 옵션을 정의하는 개체입니다. 이 항목 내의 path 속성은 컨텍스트 파일이 있는 상대 경로를 지정합니다.

languages - 개체, 선택적. 번들에 대한 컨텍스트 옵션을 정의하는 개체입니다. 이 항목 내의 items 속성은 번들에서 지원하는 언어를 지정하는 배열입니다.

샘플

{
  "$schema": "https://raw.githubusercontent.com/microsoft/xbox-game-streaming-tools/main/touch-adaptation-kit/schemas/takxconfig/v1/takxconfig.json",
  "layouts": {
    "path": "./layouts"
  },
  "assets": {
    "path": "./assets"
  },
  "context": {
    "path": "./context.json"
  },
  "languages": [
    "en",
    "en-US"
  ],
  "version": "2.0.0.0"
}

takxconfig.json 파일을 사용하는 전체 샘플은 GitHub를 참조하세요.

요구 사항

파일 버전은 json 파일의 $schema 속성으로 지정됩니다. 사용 가능한 특정 속성 집합을 지정하고 일부 편집기에서 IntelliSense를 활성화합니다.

위에 설명된 속성은 지원되는 최신 스키마 버전에 대해 유효합니다. 이전 스키마 속성은 GitHub를 참조하세요.

명령

다음 표에 나와 있는 명령을 사용하여 Xbox 게임 스트리밍을 사용하여 타이틀을 플레이할 때 터치 컨트롤이 의도한 대로 작동하도록 합니다.

명령 설명
create 터치 적응 번들의 원본 콘텐츠를 만들거나 기존 번들에 레이아웃을 추가합니다.
pack 원본 콘텐츠 집합에서 터치 적응 번들을 빌드합니다.
serve 터치 적응 번들을 제공하여 클라이언트 응용프로그램에서 다운로드하고 사용할 수 있도록 합니다.
verify 터치 적응 번들의 콘텐츠가 유효한지 확인합니다.
takx-version 포함된 레이아웃의 터치 적응 번들과 최대 스키마 버전 양측의 버전을 결정합니다.
unpack 구성 요소 파일에 기존 터치 적응 번들의 압축을 풉니다.

옵션

다음 표의 정보를 사용하여 모든 명령에 적절한 플래그를 적용합니다.

옵션 설명
-v, --verbosity 명령의 결과에 대한 자세한 정보를 설정합니다. 이러한 플래그의 유효한 값은 Critical, Debug, Error, Information, None, Trace, Warning입니다. 기본 상세정보는 Information입니다.
--version 버전 정보를 표시합니다.
-?, -h, --help 도움말 및 사용 정보를 표시합니다.

참고 항목

터치 시작하기
Android CTA(콘텐츠 테스트 응용 프로그램)
Windows PC 콘텐츠 테스트 응용 프로그램(CTA)