> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tak CLI를 사용하여 터치 컨트롤 레이아웃 배포

> 터치 컨트롤 레이아웃 배포하기

## 개요

[터치 레이아웃을 빌드](https://docs.xbox.com/ko/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-touch-building-touch-layout.md)한 후에는, 게임에서 이 레이아웃과 상호작용해 보고 싶을 것입니다.

## 사전 요구 사항

레이아웃을 배포하고 확인하려면 다음이 필요합니다.

* [Touch Adaptation Kit 명령줄 도구(tak.exe)](https://docs.xbox.com/ko/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line.md)가 설치된 Windows PC.
* [웹 Content Test Application](https://docs.xbox.com/ko/build/core-features/common/game-streaming/game-streaming-web-content-test-application.md), [Android Content Test Application(사용되지 않음)](https://docs.xbox.com/ko/build/core-features/common/game-streaming/game-streaming-android-content-test-application.md) 또는 [Windows PC Content Test Application(사용되지 않음)](https://docs.xbox.com/ko/build/core-features/common/game-streaming/game-streaming-windows-pc-content-test-application.md)이 설치된 디바이스.
* 배포하고 확인할 레이아웃 세트.

## 레이아웃 배포하기

### 1. 레이아웃 제공(Serve)

[Touch Adaptation Kit 명령줄 도구(tak.exe)](https://docs.xbox.com/ko/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line.md)가 설치된 Windows PC에서 [Serve 명령](https://docs.xbox.com/ko/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-serve-command.md)을 사용하여 레이아웃을 요청하는 디바이스에서 사용할 수 있도록 만듭니다.

```pwsh theme={null}
C:\Program Files (x86)\Microsoft GDK\bin>tak serve --layout-path C:\MyGameLayouts
Verifying touch adaptation bundle 'C:\MyGameLayouts '.
Now listening on: http://0.0.0.0:9269
Application started. Press Ctrl+C to shut down.
Hosting environment: Production
Content root path: C:\MyGameLayouts
```

### 2. Content Test Application 로드 구성

Content Test Application의 설정에서 터치 적응 설정(Developer 섹션 내)에 대한 구성을 입력합니다.

* **Enable sideload**가 켜져 있는지 확인합니다.
* 레이아웃을 제공하는 PC의 주소(포트 포함)를 입력합니다.

> [!NOTE]
>
> **Safari**로 [웹 Content Test Application](https://docs.xbox.com/ko/build/core-features/common/game-streaming/game-streaming-web-content-test-application.md)을 사용하거나 serve 명령을 실행하는 **원격 PC**에 연결하는 경우, 사이드로드 주소가 `https`로 시작하고 `--certificate-file` 옵션이 사용되었는지 확인하세요. 보안(HTTPS) 사이드로드 서버 시작에 대한 자세한 내용은 [Serve 명령](https://docs.xbox.com/ko/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-serve-command.md)을 참조하세요.

* 레이아웃에 대한 변경 사항이 연결된 모든 클라이언트에 즉시 반영되도록 하려면 autorefresh를 활성화하세요(그렇지 않으면 새 스트리밍 연결이 시작될 때만 업데이트가 발생합니다).

![개발자 설정](https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/game-streaming-cta-android-developer-settings.png?fit=max\&auto=format\&n=sIrPFR_ir_sNKVEv\&q=85\&s=9256baca111dbef55c2b30943854da88).

### 3. 게임 스트리밍

각 스트리밍 연결 시, CTA는 TAK 서버에 연결하여 최신 레이아웃을 다운로드합니다.

![다운로드된 레이아웃](https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/game-streaming-cta-android-layout-download.png?fit=max\&auto=format\&n=sIrPFR_ir_sNKVEv\&q=85\&s=19d0d50c10717892e8456150b0afb598).

레이아웃이 요청되면, `serve` 명령을 호스팅하는 PC에서 요청과 다운로드를 확인할 수 있습니다.

```
C:\Program Files (x86)\Microsoft GDK\bin>tak serve --layout-path C:\MyGame\layouts
Verifying touch adaptation bundle 'C:\MyGame\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:\MyGame\layouts
Request starting HTTP/1.1 POST http://192.168.1.1:9269/connection/negotiate?negotiateVersion=1  0
Request finished in 1.6283ms 200 application/json
Request starting HTTP/1.1 GET http://192.168.1.1:9269/connection?id=3u0Xs_Dlwn-J1mREHTcG5w
Request starting HTTP/1.1 GET http://192.168.1.1:9269/v1/tabs/active/download
Request finished in 3.9865ms 200 application/octet-stream
```

### 4. 레이아웃 선택

스트리밍 세션이 시작된 후, 왼쪽 상단 모서리의 `...` 버튼을 선택하여 인스트림 오버레이에서 Developer 및 TAK를 선택하면 사용할 터치 레이아웃을 선택할 수 있습니다.

![레이아웃 선택.](https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/game-streaming-cta-android-select-layout.gif?s=17361970f8265532f37be519fab3ad4e)


## Related topics

- [터치 시작하기](https://docs.xbox.com/ko/build/core-features/common/game-streaming/game-streaming-getting-started-with-touch.md)
- [터치 레이아웃 게시](https://docs.xbox.com/ko/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-touch-publishing-layouts.md)
- [터치 컨트롤 레이아웃 구축](https://docs.xbox.com/ko/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-touch-building-touch-layout.md)
- [터치 컨트롤을 구축하기 위한 디자이너 가이드](https://docs.xbox.com/ko/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-designers-guide.md)
- [용어집](https://docs.xbox.com/ko/publishing/game-publishing/glossary.md)