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

웹 Content Test Application(CTA) 개발자 도구는 현재 XBOX Cloud Gaming 웹 환경인 xbox.com/play에서 사용할 수 있습니다. 이 도구는 Windows의 Edge와 Chrome 및 Mac, iOS, iPadOS의 Safari에서 사용할 수 있도록 설계되었습니다. 이 문서에서는 xbox.com/play를 다룹니다. 새 환경은 play.xbox.com에서 미리 보기로 제공됩니다. 해당 환경의 개발자 도구를 사용하려면 웹 Content Test Application(CTA) 개요를 참조하세요.

• 환경 선택
• 개발자 도구 열기
• 오퍼링 선택
• IP Connect
• 원격 연결
• 개발자 설정
• TAK 사이드로드
• 스트림 중 TAK 레이아웃 전환
• 마우스 및 키보드
• 새 환경 사용해 보기

​

환경 선택

웹 CTA는 xbox.com/play와 미리 보기 상태인 play.xbox.com이라는 두 가지 XBOX Cloud Gaming 웹 환경에서 실행됩니다. 다음 표를 사용하여 시나리오에 맞는 환경을 선택하세요. 두 환경 모두 비공개 오퍼링, 샌드박스 테스트 계정, 지역 선택, 마우스 및 키보드를 지원합니다.

​

개발자 도구 열기

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

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

샌드박스는 타이틀을 위한 격리된 개발 환경이며, 각 샌드박스 테스트 계정은 하나의 샌드박스에 속합니다. 샌드박스 ID는 오퍼링 ID가 아닙니다. 테스트 계정을 만든 사람에게서 받으세요. 자세한 내용은 XBOX 서비스 샌드박스 개요를 참조하세요. 샌드박스 ID 없이 로그인한 경우 outlook.com과 같은 다른 Microsoft 웹 사이트를 방문하여 로그아웃합니다. 그런 다음 올바른 샌드박스 ID로 다시 로그인합니다. xbox.com/play 카탈로그에서 개발자 설정을 열 수도 있습니다. 프로필 사진을 선택한 다음 Settings > Developer를 선택합니다. Developer가 표시되지 않으면 Account를 빠르게 10번 연속으로 선택하여 표시합니다. 개발자 설정에서 Developer Tools Home을 선택하면 개발자 도구 페이지로 돌아갑니다.

​

오퍼링 선택

오퍼링은 데이터센터 하드웨어에서 실행되는 게임을 검증하는 데 사용되는 비공개 테스트 환경입니다. 오퍼링에 대한 자세한 내용은 게임 스트리밍 개요를 참조하세요. 특정 오퍼링을 사용하려면 다음을 수행합니다.

1. 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 설정을 참조하세요.
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로 이동합니다. 샌드박스 ID를 입력한 다음 해당 샌드박스의 테스트 계정으로 로그인합니다.
2. 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로 이동하여 동일한 계정으로 로그인합니다. 샌드박스 테스트 계정의 경우 로그인하기 전에 샌드박스 ID를 입력합니다.
2. Remote Connect를 선택합니다. 이 옵션은 로그인한 계정에 원격 연결용으로 설정된 개발 키트가 있거나 샌드박스 테스트 계정으로 로그인한 경우에 사용할 수 있습니다.
3. 목록에서 XBOX Development Kit를 찾은 다음 Connect를 선택합니다.

​

개발자 설정

개발자 설정을 열려면 프로필 사진을 선택한 다음 Settings > Developer를 선택합니다. 개발자 설정에는 현재 오퍼링 및 스트림 구성 설정이 포함됩니다. 재정의할 수 있는 특정 스트림 구성 설정에 대한 자세한 내용은 스트림 구성 개요를 참조하세요. Stream Configuration > Touch adaptation 아래에서 다음을 설정할 수 있습니다.

• Enable sideload: 타이틀에 게시된 레이아웃 대신 TAK CLI serve 명령에서 터치 레이아웃을 로드합니다.
• Sideload server address: 사이드로드 서버의 주소입니다.
• Enable automatic refresh: 사이드로드 서버에서 레이아웃을 변경하면 디바이스의 레이아웃을 업데이트합니다.
• Emulate touch with mouse: 마우스 클릭을 터치로 처리합니다.

​

TAK 사이드로드

이 단계는 사용자 지정 오퍼링 또는 XBOX Development Kit에서 스트리밍하는 경우를 다룹니다. 오퍼링을 사용하려면 오퍼링 선택을 참조하세요. 시작하기 전에 레이아웃을 제공하는 PC에서 tak serve를 실행하세요. 브라우저와 같은 PC에서 사이드로드하려면 다음을 수행합니다.

1. Settings > Developer를 열고 Touch adaptation을 찾습니다.
2. Enable sideload를 켭니다.
3. Sideload server address에 사이드로드 서버의 주소(예: http://localhost:9269)를 입력합니다. 다른 디바이스에서 사이드로드에 설명된 대로 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 레이아웃 전환에 설명된 대로 Bundle layouts 아래에 레이아웃이 있는지 확인하세요.

​

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

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

1. 인증서를 만듭니다. 자세한 내용은 인증서 생성 지침을 참조하세요.
2. PC에서 --certificate-file 및 --certificate-password 옵션을 사용하여 tak serve를 실행합니다.
3. 휴대폰이나 태블릿에 인증서를 설치하고 신뢰하도록 설정합니다. 단계는 다른 클라이언트에서 인증서 신뢰를 참조하세요.
4. 휴대폰이나 태블릿에서 Settings > Developer를 열고 Enable sideload를 켠 다음 Sideload server address에 https://<your PC's IP address>:9269를 입력합니다.
5. TAK 사이드로드의 4단계와 6단계에 설명된 대로 Network Permission 및 Server Connection을 확인합니다.

암호를 요구하려면 --password 옵션을 사용하고 디바이스의 개발자 설정에 동일한 암호를 입력합니다. 자세한 내용은 Serve 명령을 참조하세요.

​

스트림 중 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)**는 터치 컨트롤을 제거합니다.

​

마우스 및 키보드

시작하기 전에 개발자 도구 열기에 설명된 대로 개발자 도구를 엽니다.

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를 선택합니다.