웹 CTA(콘텐츠 테스트 애플리케이션) 개요

이 항목에서는 xbox.com/play/dev-tools에서 사용할 수 있는 개발자 도구 목록에 대해 설명합니다. 이러한 도구는 Windows의 Edge 및 Chrome 브라우저와 Mac, iOS 및 iPadOS의 Safari에서 사용하도록 설계되었습니다.

• 방문 페이지
• 제품 선택
• 원격 연결
• 개발자 설정 메뉴
• 개발자 도구 메뉴

개발자 홈페이지

개발자 도구 사용을 시작하려면 xbox.com/play/dev-tools에 방문하세요.

iOS 또는 iPad OS에서 공유 버튼을 클릭하고 ”홈 화면에 추가”를 선택하여 이 페이지를 PWA(프로그레시브 웹앱)로 저장할 수 있습니다. 일단 설정되면, 이 PWA가 사용자의 계정과 구성을 기억하므로 나중에 돌아가 테스트를 계속할 수 있습니다.

• 소매 계정의 경우 샌드박스를 비워두고 Xbox Development Kit에 로그인하거나 개인 제품에 액세스하도록 구성된 동일한 계정을 사용하여 로그인하기만 하면 됩니다.

로그인하면 이 랜딩 페이지에는 원격 재생 및 개인 제품 선택에 빠르게 액세스할 수 있는 링크가 있습니다. 로그인한 계정이 Xbox 개발 키트와 연결되어 있는지 또는 개인 제품에 대한 액세스 권한이 부여되었는지 여부에 따라 일부 옵션이 비활성화될 수 있습니다. 계정이 개발자 시나리오에 액세스할 수 없는 경우 설정 방법에 대한 정보와 함께 오류 메시지가 표시됩니다. 아래 섹션에서는 특정 계정 설정 요구 사항에 대해 자세히 설명합니다.

제품 선택

특정 제품을 사용하려면 xbox.com/play/dev-tools/select-offering으로 이동하거나 개발자 홈페이지에서 "제품 선택"을 클릭하세요. 제품 선택 페이지에서 액세스 권한이 있는 제품은 드롭다운 목록에 미리 채워집니다. 그러면 제품을 선택하고 연결을 클릭할 수 있습니다. 어떤 이유로 원하는 제품이 드롭다운 목록에 없는 경우에는 위의 입력 상자에 수동으로 입력하고 “제품 추가”를 클릭할 수 있습니다.

연결을 클릭하면 개설에 대해 구성된 기본 카탈로그 페이지로 이동합니다. 이제 사용자 지정 제품을 사용하고 있음을 나타내는 텍스트가 페이지에 표시됩니다. 제품에 액세스할 수 없는 경우 해당 특정 제품을 사용할 수 있는 권한이 있는 계정에 로그인했는지 확인합니다.

원격 연결

Xbox 개발 키트 설정

• 원격 연결 웹 사이트에 로그인하기 전에 이 부분을 수행해야 합니다. 계정에서 원격으로 사용하기 위해 Xbox 개발 키트를 아직 구성하지 않은 경우 원격 연결 페이지에서 xbox.com/play 방문 페이지로 다시 리디렉션됩니다.
• 웹 사이트에서 사용할 계정(샌드박스 계정 포함)으로 Xbox 개발 키트에 로그인합니다.
• 원하는 경우 쉽게 식별할 수 있도록 Xbox 개발 키트에 이름을 지정합니다.
• "원격 연결" 아래에서 개발자 홈 -> 스트리밍->으로 이동하여 계정을 선택합니다.
  • 또는 소비자 설정을 통해 원격 연결을 사용하도록 설정할 수도 있습니다. 개발자 홈으로 이동 - 설정 -> 설정 시작 ->> 디바이스 & 연결 - 원격 기능 ->> 원격 기능을 사용하도록 설정하여 원격 연결을 사용하도록 설정

원격 장치에서 시작하기

계속하기 전에 위의 Xbox 개발 키트 설정 단계를 완료했는지 확인합니다. Xbox 개발 키트에서 원격 기능을 사용 설정하지 않은 경우 원격 연결 페이지 대신 xbox.com/play 페이지로 다시 리디렉션됩니다.

Xbox 개발 키트에 연결되는 클라이언트 장치가 Xbox 개발 키트와 동일한 네트워크에 있는지 확인합니다. 연결은 VPN을 통해서도 작동합니다. Xbox 개발 키트에 대한 네트워크 트래픽은 UDP 포트 9002에서 이루어지므로 이 포트도 네트워크 구성을 통해 차단 해제해야 합니다.

• 샌드박스 계정의 경우에는 Xbox 개발 키트에 로그인한 계정의 샌드박스 ID를 다음 URL에 추가합니다. xbox.com/play/dev-tools/direct-connect?sandboxId=. 예를 들어 샌드박스 ID가 TestSandbox인 경우 URL은 xbox.com/play/dev-tools/direct-connect?sandboxId=TestSandbox입니다. 생성한 연결 문자열로 이동하고, 자격 증명을 묻는 메시지가 표시되면 연결하려는 Xbox 개발 키트에 현재 로그인된 샌드박스 계정으로 로그인합니다. 회사 계정과 개인 계정 중에서 선택하라는 메시지가 표시되면 개인 계정을 선택합니다.
• 소매 계정의 경우, xbox.com/play/dev-tools/direct-connect로 이동하거나 개발자 홈페이지에서 "원격 연결"을 클릭합니다. 자격 증명을 묻는 메시지가 표시되면 Xbox 개발 키트에 로그인한 것과 동일한 계정을 사용하여 로그인합니다.

iOS 및 iPad OS에서 공유 버튼을 클릭하고 ”홈 화면에 추가”를 선택하여 이 페이지를 PWA(프로그레시브 웹앱)로 저장할 수 있습니다. 이 PWA는 시작할 때 샌드박스 ID를 기억합니다.

직접 연결 페이지에서 연결하려는 Xbox 개발 키트를 선택하고 아이콘 아래의 "연결"을 클릭하여 스트리밍 세션을 시작할 수 있습니다.

개발자 설정 메뉴

사용자 지정 제품을 사용하거나 원격 Xbox 개발 키트에 연결하는 경우 xbox.com/play 페이지의 오른쪽 위에 있는 기어 아이콘에서 액세스할 수 있는 개발자 설정 집합을 찾을 수 있습니다. 이러한 개발자 설정에는 개발자 도구 홈페이지로 돌아가서 비공개 제품을 변경하고 스트림 구성 설정을 조정하는 기능이 포함됩니다. 스트림 구성 개요에는 재정의할 수 있는 특정 스트림 구성 설정에 대한 자세한 정보가 포함되어 있습니다.

• TAK 사이드로드 사용
• 사이드로드 서버 주소
• 자동 새로 고침 사용: TAK 사이드로드에 대해 자동 새로 고침 사용
• 마우스 상호 작용 허용: 스트리밍할 때 TAK와의 마우스 상호 작용 허용

이 개발자 설정 메뉴는 추가로 xbox.com/play/dev-tools/select-offering 및 xbox.com/play/dev-tools/direct-connect 페이지에서 항상 사용하도록 설정됩니다.

개발자 도구 메뉴

사용자 지정 제품 또는 Xbox 개발 키트에서 스트리밍할 때는 스트림의 왼쪽 아래 모서리에 있는 개발자 메뉴에 액세스할 수 있습니다. 이 메뉴를 클릭하면 TAK CLI를 사용하여 레이아웃을 사이드로드하는 경우 활성 TAK 레이아웃을 전환할 수 있습니다.

마우스 및 키보드

마우스 및 키보드는 사용자에게 익숙한 게임 플레이 환경을 제공하고 사용자에게 마우스 및 키보드만 지원하는 게임을 플레이할 수 있는 기회를 제공합니다. 또한 이 기능을 통해 컨트롤러가 없는 사용자도 마우스 및 키보드 지원 타이틀을 플레이할 수 있습니다. 개발자의 경우 키보드를 지원하면 내부 디버깅 명령에 액세스할 수 있습니다.

테스트를 위해 CTA가 설정되었는지 확인합니다. 웹 CTA 구성의 지침을 따를 수 있습니다.

마우스 및 키보드를 테스트하는 방법

CTA(콘텐츠 테스트 애플리케이션)가 설정되면 다음 스크린샷과 같이 계정 아이콘으로 이동한 후 개발자 탭으로 이동하여 마우스 및 키보드 구현을 테스트할 수 있습니다.

개발자 탭으로 이동한 후 “마우스 및 키보드”의 토글 버튼을 눌러 기능을 사용하도록 설정합니다.

마우스 및 키보드 모드로 전환하려면 스트림이 시작된 후 화면을 마우스 왼쪽 단추로 클릭하거나 F9 키를 누릅니다. 마우스 및 키보드 모드를 종료하려면 F9를 탭합니다.

테스트를 완료하고 모든 사용자에 대해 마우스 및 키보드를 사용하도록 설정할 준비가 되면 Microsoft 계정 담당자에게 연락하세요.