> ## 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.

# xbox.com/play의 웹 Content Test Application(CTA)

> xbox.com/play에서 웹 Content Test Application 개발자 도구를 사용하는 방법을 설명합니다.

웹 Content Test Application(CTA) 개발자 도구는 현재 XBOX Cloud Gaming 웹 환경인 [xbox.com/play](https://www.xbox.com/play)에서 사용할 수 있습니다. 이 도구는 Windows의 Edge와 Chrome 및 Mac, iOS, iPadOS의 Safari에서 사용할 수 있도록 설계되었습니다.

이 문서에서는 xbox.com/play를 다룹니다. 새 환경은 [play.xbox.com](https://play.xbox.com/)에서 미리 보기로 제공됩니다. 해당 환경의 개발자 도구를 사용하려면 [웹 Content Test Application(CTA) 개요](https://docs.xbox.com/ko/build/core-features/common/game-streaming/game-streaming-web-content-test-application.md)를 참조하세요.

* [환경 선택](#choose-an-experience)
* [개발자 도구 열기](#open-developer-tools)
* [오퍼링 선택](#select-an-offering)
* [IP Connect](#ip-connect)
* [원격 연결](#remote-connect)
* [개발자 설정](#developer-settings)
* [TAK 사이드로드](#tak-sideload)
* [스트림 중 TAK 레이아웃 전환](#switch-tak-layouts-during-a-stream)
* [마우스 및 키보드](#mouse-and-keyboard)
* [새 환경 사용해 보기](#try-the-new-experience)

## 환경 선택

웹 CTA는 xbox.com/play와 미리 보기 상태인 play.xbox.com이라는 두 가지 XBOX Cloud Gaming 웹 환경에서 실행됩니다. 다음 표를 사용하여 시나리오에 맞는 환경을 선택하세요.

| 시나리오 | xbox.com/play | play.xbox.com |
| :- | :- | :- |
| XBOX Development Kit에 IP Connect | 샌드박스 테스트 계정에서만 지원됨 | 지원됨 |
| 같은 PC에서 TAK 사이드로드 | 지원됨 | 지원됨 |
| PC에서 휴대폰 또는 태블릿으로 TAK 사이드로드 | HTTPS를 통해 지원됨 | 아직 지원되지 않음 |
| 스트림 중 레이아웃 전환 | 지원됨 | 지원됨 |
| 원격 연결 | 지원됨 | 지원됨 |

두 환경 모두 비공개 오퍼링, 샌드박스 테스트 계정, 지역 선택, 마우스 및 키보드를 지원합니다.

## 개발자 도구 열기

개발자 도구 사용을 시작하려면 [xbox.com/play/dev-tools](https://www.xbox.com/play/dev-tools)로 이동합니다. 로그인하지 않은 경우 페이지에서 로그인을 요청하며 샌드박스 필드가 포함되어 있습니다.

* 리테일 계정의 경우 샌드박스를 비워 두고, XBOX Development Kit에 로그인된 계정 또는 비공개 오퍼링에 액세스하도록 구성된 계정과 동일한 계정으로 로그인합니다.
* 샌드박스 테스트 계정의 경우 로그인하기 전에 샌드박스 ID를 입력합니다.

샌드박스는 타이틀을 위한 격리된 개발 환경이며, 각 샌드박스 테스트 계정은 하나의 샌드박스에 속합니다. 샌드박스 ID는 오퍼링 ID가 아닙니다. 테스트 계정을 만든 사람에게서 받으세요. 자세한 내용은 [XBOX 서비스 샌드박스 개요](https://docs.xbox.com/ko/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)를 참조하세요.

> [!NOTE]
>
> 샌드박스 ID 없이 샌드박스 테스트 계정에 로그인하면 이러한 계정은 리테일 기능에 액세스할 수 없으므로 일부 기능이 작동하지 않을 수 있습니다.

샌드박스 ID 없이 로그인한 경우 [outlook.com](https://www.outlook.com)과 같은 다른 Microsoft 웹 사이트를 방문하여 로그아웃합니다. 그런 다음 올바른 샌드박스 ID로 다시 로그인합니다.

xbox.com/play 카탈로그에서 개발자 설정을 열 수도 있습니다. 프로필 사진을 선택한 다음 **Settings** > **Developer**를 선택합니다. **Developer**가 표시되지 않으면 **Account**를 빠르게 10번 연속으로 선택하여 표시합니다. 개발자 설정에서 **Developer Tools Home**을 선택하면 개발자 도구 페이지로 돌아갑니다.

> [!NOTE]
>
> iOS 또는 iPadOS에서는 페이지를 PWA(프로그레시브 웹앱)로 저장할 수 있습니다. 공유 버튼을 선택한 다음 **Add to Home Screen**을 선택합니다.
>
> PWA는 계정과 구성을 기억하므로 나중에 다시 테스트할 수 있습니다.

## 오퍼링 선택

오퍼링은 데이터센터 하드웨어에서 실행되는 게임을 검증하는 데 사용되는 비공개 테스트 환경입니다. 오퍼링에 대한 자세한 내용은 [게임 스트리밍 개요](https://docs.xbox.com/ko/build/core-features/common/game-streaming/game-streaming-overview.md#what-are-private-offerings)를 참조하세요.

특정 오퍼링을 사용하려면 다음을 수행합니다.

1. [xbox.com/play/dev-tools/select-offering](https://www.xbox.com/play/dev-tools/select-offering)으로 이동합니다.
2. 드롭다운 목록에서 오퍼링을 선택하거나, **Custom offering ID**를 선택하고 **Enter offering ID for cloud connection**에 오퍼링 ID를 입력합니다.
3. **Connect**를 선택합니다.

오퍼링의 카탈로그가 열리고 페이지에 **Using custom offering**과 함께 오퍼링 ID가 표시됩니다. 오퍼링에 액세스할 수 없는 경우 해당 오퍼링을 사용할 권한이 있는 계정에 로그인되어 있는지 확인하세요.

### 오퍼링 지역

오퍼링은 사용자를 가장 가까운 데이터센터로 자동으로 라우팅하지 않습니다. 다른 지역에서 테스트하려면 **Settings** > **Developer**를 열고 **Streaming Region** 아래에서 지역을 선택합니다. 스트림을 시작하기 전에 선택해야 합니다. **Current region**에 선택한 지역이 표시됩니다. 사용 가능한 지역은 미리 구성해야 합니다. 오퍼링의 사용 가능한 지역을 조정하려면 Microsoft 계정 담당자에게 문의하세요.

## IP Connect

IP Connect를 사용하여 IP 주소로 XBOX Development Kit에서 직접 스트리밍할 수 있습니다. xbox.com/play에서 IP Connect를 사용하려면 샌드박스 테스트 계정이 필요하며, 개발자 도구 페이지에는 IP Connect 링크가 없습니다.

IP Connect를 사용하기 전에 다음 필수 구성 요소를 완료하세요.

1. 스트리밍을 위해 XBOX Development Kit를 설정합니다. 자세한 내용은 [XBOX Development Kit 설정](https://docs.xbox.com/ko/build/core-features/common/game-streaming/game-streaming-setup-xbox-developer-kit.md)을 참조하세요.
2. **Dev Home** > **Streaming**에서 **Direct Connect**가 수신 대기 중인지 확인합니다. 키트가 다시 시작될 때마다 수신 대기가 중지됩니다.
3. 클라이언트 디바이스가 XBOX Development Kit와 같은 네트워크에 있거나 VPN을 통해 연결되어 있는지 확인합니다.
4. 네트워크에서 XBOX Development Kit의 포트 9002로 향하는 TCP 및 UDP 트래픽을 허용하는지 확인합니다. 브라우저는 신호에 WebSocket 연결을 사용하고 스트림에 UDP를 사용합니다.

IP 주소로 연결하려면 다음을 수행합니다.

1. [xbox.com/play/dev-tools](https://www.xbox.com/play/dev-tools)로 이동합니다. 샌드박스 ID를 입력한 다음 해당 샌드박스의 테스트 계정으로 로그인합니다.
2. [xbox.com/play/dev-tools/ip-connect](https://www.xbox.com/play/dev-tools/ip-connect)로 이동합니다.
3. XBOX Development Kit의 IP 주소와 포트(예: `192.168.1.10:9002`)를 입력합니다.
4. **Connect**를 선택합니다.
5. 브라우저에서 로컬 네트워크의 디바이스에 액세스할 수 있는 권한을 요청하면 **Allow**를 선택합니다.

연결에 성공하면 XBOX Development Kit에서 실행 중인 앱이 브라우저에 나타납니다. 리테일 계정으로 로그인한 경우 IP Connect 주소로 이동하면 개발자 도구 페이지로 돌아갑니다.

## 원격 연결

원격 연결은 XBOX 원격 플레이 서비스를 통해 인터넷으로 XBOX Development Kit에서 스트리밍합니다. 로그인한 계정을 통해 키트를 찾으므로 IP 주소를 입력할 필요가 없습니다.

먼저 XBOX Development Kit를 설정합니다.

1. xbox.com/play에서 사용할 계정으로 XBOX Development Kit에 로그인합니다. 해당 계정은 키트의 샌드박스에서 허용되어야 합니다.
2. **Dev Home** > **Streaming**으로 이동합니다. **Remote Connect** 아래에서 계정을 선택합니다.
3. **Dev Home** > **Streaming**에서 **Direct Connect**가 수신 대기 중이 아닌지 확인합니다. Direct Connect는 IP Connect를 위한 별도의 연결 모드이며, 수신 대기 중에는 원격 연결을 차단합니다.

그런 다음 xbox.com/play에서 연결합니다.

1. [xbox.com/play/dev-tools](https://www.xbox.com/play/dev-tools)로 이동하여 동일한 계정으로 로그인합니다. 샌드박스 테스트 계정의 경우 로그인하기 전에 샌드박스 ID를 입력합니다.
2. **Remote Connect**를 선택합니다. 이 옵션은 로그인한 계정에 원격 연결용으로 설정된 개발 키트가 있거나 샌드박스 테스트 계정으로 로그인한 경우에 사용할 수 있습니다.
3. 목록에서 XBOX Development Kit를 찾은 다음 **Connect**를 선택합니다.

> [!NOTE]
>
> XBOX Development Kit와 연결하는 디바이스 모두 인터넷 연결이 필요합니다.
>
> IP Connect와 달리 원격 연결에서는 두 디바이스가 같은 네트워크에 있을 필요가 없습니다.

## 개발자 설정

개발자 설정을 열려면 프로필 사진을 선택한 다음 **Settings** > **Developer**를 선택합니다.

개발자 설정에는 현재 오퍼링 및 스트림 구성 설정이 포함됩니다. 재정의할 수 있는 특정 스트림 구성 설정에 대한 자세한 내용은 [스트림 구성 개요](https://docs.xbox.com/ko/build/core-features/common/game-streaming/game-streaming-content-test-application-stream-config.md)를 참조하세요.

**Stream Configuration** > **Touch adaptation** 아래에서 다음을 설정할 수 있습니다.

* **Enable sideload**: 타이틀에 게시된 레이아웃 대신 [TAK CLI](https://docs.xbox.com/ko/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line.md) `serve` 명령에서 터치 레이아웃을 로드합니다.
* **Sideload server address**: 사이드로드 서버의 주소입니다.
* **Enable automatic refresh**: 사이드로드 서버에서 레이아웃을 변경하면 디바이스의 레이아웃을 업데이트합니다.
* **Emulate touch with mouse**: 마우스 클릭을 터치로 처리합니다.

## TAK 사이드로드

이 단계는 사용자 지정 오퍼링 또는 XBOX Development Kit에서 스트리밍하는 경우를 다룹니다. 오퍼링을 사용하려면 [오퍼링 선택](#select-an-offering)을 참조하세요.

시작하기 전에 레이아웃을 제공하는 PC에서 [`tak serve`](https://docs.xbox.com/ko/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-serve-command)를 실행하세요.

브라우저와 같은 PC에서 사이드로드하려면 다음을 수행합니다.

1. **Settings** > **Developer**를 열고 **Touch adaptation**을 찾습니다.
2. **Enable sideload**를 켭니다.
3. **Sideload server address**에 사이드로드 서버의 주소(예: `http://localhost:9269`)를 입력합니다. [다른 디바이스에서 사이드로드](#sideload-from-another-device)에 설명된 대로 `localhost` 이외의 주소는 `https`를 사용해야 합니다.
4. **Network Status** 아래에서 **Network Permission**을 확인합니다. **Required**가 표시되면 **Request Permission**을 선택합니다. 브라우저에서 사이트가 **Access other apps and services on this device**하도록 허용할지 물으면 **Allow**를 선택합니다.
5. 터치 스크린이 없는 PC에서는 **Emulate touch with mouse**를 켭니다. 이 설정을 켜지 않으면 스트림에 터치 컨트롤이 표시되지 않으며 **TAK** 메뉴를 사용할 수 없습니다.
6. **Server Connection**에 **Connected**가 표시되면 스트림을 시작합니다. **Not Reachable**이 표시되면 `tak serve`가 실행 중인지 확인한 다음 **Recheck**를 선택합니다.

스트림 중에 **Enable sideload** 또는 **Emulate touch with mouse**를 변경하면 게임을 전환하라는 메시지가 표시됩니다.

스트림에서 사용자의 레이아웃을 사용하고 있는지 확인하려면 [스트림 중 TAK 레이아웃 전환](#switch-tak-layouts-during-a-stream)에 설명된 대로 **Bundle layouts** 아래에 레이아웃이 있는지 확인하세요.

### 다른 디바이스에서 사이드로드

휴대폰이나 태블릿에서 테스트하려면 로컬 네트워크에서 해당 디바이스가 연결할 수 있는 PC에서 `tak serve`를 실행합니다. 서버는 `https`를 사용해야 합니다.

1. 인증서를 만듭니다. 자세한 내용은 [인증서 생성 지침](https://docs.xbox.com/ko/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-serve-command.md#certificate-generation-instructions)을 참조하세요.
2. PC에서 `--certificate-file` 및 `--certificate-password` 옵션을 사용하여 `tak serve`를 실행합니다.
3. 휴대폰이나 태블릿에 인증서를 설치하고 신뢰하도록 설정합니다. 단계는 [다른 클라이언트에서 인증서 신뢰](https://docs.xbox.com/ko/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-serve-command.md#trusting-the-certificate-on-different-clients)를 참조하세요.
4. 휴대폰이나 태블릿에서 **Settings** > **Developer**를 열고 **Enable sideload**를 켠 다음 **Sideload server address**에 `https://<your PC's IP address>:9269`를 입력합니다.
5. [TAK 사이드로드](#tak-sideload)의 4단계와 6단계에 설명된 대로 **Network Permission** 및 **Server Connection**을 확인합니다.

암호를 요구하려면 `--password` 옵션을 사용하고 디바이스의 개발자 설정에 동일한 암호를 입력합니다. 자세한 내용은 [Serve 명령](https://docs.xbox.com/ko/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-serve-command.md)을 참조하세요.

## 스트림 중 TAK 레이아웃 전환

개발자 모드에서는 스트리밍하는 동안 활성 레이아웃을 전환할 수 있습니다.

1. 스트림에서 왼쪽 하단의 **Developer Tools Menu**를 열고 **TAK**를 선택합니다.
2. **Select touch controls layout** 아래의 **Bundle layouts** 또는 **System layouts**에서 레이아웃을 선택합니다. **Bundle layouts**에는 이 스트림에 로드된 레이아웃이 표시됩니다. 사이드로드가 작동하면 이 레이아웃이 사용자의 레이아웃입니다.
3. **Close**를 선택합니다.

**System layouts**는 **Standard**와 \*\*Native Touch Only (Blank)\*\*입니다. **Standard**는 표준 컨트롤러 오버레이를 표시합니다. \*\*Native Touch Only (Blank)\*\*는 터치 컨트롤을 제거합니다.

## 마우스 및 키보드

시작하기 전에 [개발자 도구 열기](#open-developer-tools)에 설명된 대로 개발자 도구를 엽니다.

1. **Settings** > **Developer**의 **Stream Configuration** > **Enabled input types** 아래에서 **Mouse and keyboard**를 켭니다. 이 설정은 스트림을 시작하기 전에 변경하세요.
2. **Touch adaptation** 아래에서 **Emulate touch with mouse**를 끕니다. 둘 다 켜져 있으면 마우스 클릭이 터치로 처리됩니다.
3. 스트림을 시작합니다.
4. **Enter fullscreen mode to play with mouse and keyboard**라는 배너가 표시되면 **Enter fullscreen**을 선택합니다.

마우스를 해제하려면 **Press *key* to release your mouse** 알림에 표시된 키를 누릅니다.

## 새 환경 사용해 보기

play.xbox.com의 새 환경으로 전환하려면 프로필 사진을 선택한 다음 **Try the new experience** > **Try now**를 선택합니다. xbox.com/play로 돌아가려면 프로필에서 **Account settings**를 열고 **Exit preview**를 선택합니다.


## Related topics

- [웹 Content Test Application(CTA) 개요](https://docs.xbox.com/ko/build/core-features/common/game-streaming/game-streaming-web-content-test-application.md)
- [Content Test Application(CTA) 스트림 구성](https://docs.xbox.com/ko/build/core-features/common/game-streaming/game-streaming-content-test-application-stream-config.md)
- [추가 독립 실행형 도구](https://docs.xbox.com/ko/tools/additional-tools.md)
- [TAK CLI를 사용하여 터치 컨트롤 레이아웃 배포](https://docs.xbox.com/ko/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-touch-deploying-touch-layout.md)
- [Android Content Test Application(CTA) 개요(사용되지 않음)](https://docs.xbox.com/ko/build/core-features/common/game-streaming/game-streaming-android-content-test-application.md)