웹 CTA(콘텐츠 테스트 애플리케이션) 개요
이 항목에서는 xbox.com/play/dev-tools에서 사용할 수 있는 개발자 도구 목록에 대해 설명합니다. 이러한 도구는 Windows의 Edge 및 Chrome 브라우저와 Mac, iOS 및 iPadOS의 Safari에서 사용하도록 설계되었습니다.
개발자 홈페이지
개발자 도구 사용을 시작하려면 xbox.com/play/dev-tools 방문하거나 xbox.com/play 같은 웹 기반 스트리밍 환경을 시작하고 다음 단계에 따라 개발자 모드로 전환하면 됩니다.
설정
빠른 연속으로 "계정"을 10번 클릭하거나 탭하여 클릭
개발자 설정 탭을 표시합니다."개발자 도구 홈" 단추를 클릭합니다. 로그인 상태 및 계정 액세스에 따라 개발자 탭에서 다양한 옵션을 사용할 수 있습니다.
참고 항목
iOS 또는 iPad OS에서 공유 버튼을 클릭하고 ”홈 화면에 추가”를 선택하여 이 페이지를 PWA(프로그레시브 웹앱)로 저장할 수 있습니다. 일단 설정되면, 이 PWA가 사용자의 계정과 구성을 기억하므로 나중에 돌아가 테스트를 계속할 수 있습니다.
- 소매 계정의 경우 샌드박스를 비워두고 Xbox Development Kit에 로그인하거나 개인 제품에 액세스하도록 구성된 동일한 계정을 사용하여 로그인하기만 하면 됩니다.
참고 항목
샌드박스 테스트 계정의 경우 로그인하기 전에 샌드박스 ID를 입력해야 합니다. 이렇게 하지 않으면 일부 기능이 제대로 작동하지 않을 수 있습니다. 이러한 계정은 소매 기능에 액세스할 수 없기 때문입니다. 이 경우 outlook.com과 같은 다른 Microsoft 웹 사이트를 방문하여 계정에서 수동으로 로그아웃한 다음 올바른 샌드박스 ID로 다시 시도해야 할 수 있습니다.
로그인하면 이 랜딩 페이지에는 원격 재생 및 개인 제품 선택에 빠르게 액세스할 수 있는 링크가 있습니다. 로그인한 계정이 Xbox 개발 키트와 연결되어 있는지 또는 개인 제품에 대한 액세스 권한이 부여되었는지 여부에 따라 일부 옵션이 비활성화될 수 있습니다. 계정이 개발자 시나리오에 액세스할 수 없는 경우 설정 방법에 대한 정보와 함께 오류 메시지가 표시됩니다. 아래 섹션에서는 특정 계정 설정 요구 사항에 대해 자세히 설명합니다.
제품 선택
제품은 데이터 센터 하드웨어에서 실행되는 게임의 유효성을 검사하는 데 사용되는 프라이빗 테스트 환경입니다. 제품에 대한 자세한 내용은 게임 스트리밍 개요의 정보를 검사.
특정 제품을 사용하려면 xbox.com/play/dev-tools/select-offering으로 이동하거나 개발자 홈페이지에서 "제품 선택"을 클릭하세요. 제품 선택 페이지에서 액세스 권한이 있는 제품은 드롭다운 목록에 미리 채워집니다. 그러면 제품을 선택하고 연결을 클릭할 수 있습니다. 어떤 이유로 원하는 제품이 드롭다운 목록에 없는 경우에는 위의 입력 상자에 수동으로 입력하고 “제품 추가”를 클릭할 수 있습니다.
연결을 클릭하면 개설에 대해 구성된 기본 카탈로그 페이지로 이동합니다. 이제 사용자 지정 제품을 사용하고 있음을 나타내는 텍스트가 페이지에 표시됩니다. 제품에 액세스할 수 없는 경우 해당 특정 제품을 사용할 수 있는 권한이 있는 계정에 로그인했는지 확인합니다.
지역 제공
제품은 실제 데이터 센터에 연결되므로 다른 지역에서 테스트하고 해당 지역에서 대표적인 스트리밍 환경을 경험할 수 있어야 합니다. 현재 제품은 사용자를 사용 가능한 가장 가까운 데이터 센터로 자동으로 라우팅하지 않습니다. 대신 개발자 설정 메뉴 또는 쿼리 매개 변수의 스트리밍 지역 드롭다운을 사용하여 수동으로 제어할 user.region 수 있습니다. 사용 가능한 지역은 미리 구성해야 합니다. 제품에 사용 가능한 지역을 조정하려면 Microsoft 계정 담당자에게 문의하세요.
원격 연결
원격 연결을 사용하면 사용자가 해당 사용자의 원격 기능에 대해 사용하도록 설정된 Xbox 개발 키트에 원격으로 연결할 수 있습니다. 이 환경을 사용하려면 먼저 Xbox 개발 키트에서 단계를 수행해야 합니다.
Xbox 개발 키트 설정
- 원격 연결 웹 사이트에 로그인을 시도하기 전에 이 부분을 수행해야 합니다. 사용자 계정으로 원격 사용하도록 Xbox 개발 키트를 아직 구성하지 않은 경우에는 원격 연결 페이지에서 xbox.com/play 랜딩 페이지로 다시 리디렉션됩니다.
- 웹 사이트에서 사용할 계정(샌드박스 계정 포함)으로 Xbox 개발 키트에 로그인합니다.
- 원하는 경우 쉽게 식별할 수 있도록 Xbox 개발 키트에 이름을 지정합니다.
- "원격 연결" 아래에서 개발자 홈 -> 스트리밍->으로 이동하여 계정을 선택합니다.
- 또는 다음과 같은 소비자 설정을 통해 원격 연결을 활성화할 수도 있습니다. 개발자 홈 -> 설정 -> 시작 설정 -> 장치 및 연결 -> 원격 기능 -> 원격 기능 사용으로 이동하여 원격 연결을 사용 설정합니다.
웹 콘텐츠 테스트 앱 설정
계속하기 전에 위의 Xbox 개발 키트 설정 단계를 완료했는지 확인합니다. Xbox 개발 키트에서 원격 기능을 사용하도록 설정하지 않은 경우 개발자 도구 홈페이지에서 원격 연결 기능을 사용하지 않도록 설정할 수 있습니다.
Xbox 개발 키트에서 원격 플레이를 위해 설정되었던 동일한 계정으로 로그인하려면 이 페이지 맨 위에 있는 단계를 수행합니다. 샌드박스 테스트 계정의 샌드박스 ID를 입력해야 합니다.
개발자 도구 홈에 로그인하고 나면 원격 연결 옵션을 선택하여 사용자가 연결할 수 있는 디바이스 목록을 확인합니다. 새 장치를 추가하기 위한 지침은 "새 Xbox 설정" 단추를 클릭하여 이 페이지에서 찾을 수도 있습니다.
참고 항목
Xbox 개발 키트에 연결되는 클라이언트 장치가 Xbox 개발 키트와 동일한 네트워크에 있는지 확인합니다. 연결은 VPN을 통해서도 작동합니다. Xbox 개발 키트에 대한 네트워크 트래픽은 UDP 포트 9002에서 이루어지므로 이 포트도 네트워크 구성을 통해 차단 해제해야 합니다.
개발자 설정 메뉴
사용자 지정 제품을 사용하거나 원격 Xbox 개발 키트에 연결하는 경우 설정 메뉴에서 액세스할 수 있는 개발자 설정 집합을 찾을 수 있습니다. 오른쪽 위 모서리에서 사용자 프로필 사진 클릭하고 설정을 선택하여 설정 메뉴에 연결할 수 있습니다. 이러한 개발자 설정에는 개발자 도구 홈페이지로 돌아가서 비공개 제품을 변경하고 스트림 구성 설정을 조정하는 기능이 포함됩니다. 스트림 구성 개요에는 재정의할 수 있는 특정 스트림 구성 설정에 대한 자세한 정보가 포함되어 있습니다.
- 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)를 사용하여 키보드 모드를 시작하고 종료할 수 있습니다. 플레이어가 이 키를 다시 매핑할 수 있지만, 가능한 경우 중요한 게임 기능에 F9를 사용하지 않도록 하거나 플레이어가 게임 내에서 키를 다시 매핑하도록 허용하세요.
마우스 및 키보드 모드로 전환하려면 스트림이 시작된 후 화면을 마우스 왼쪽 단추로 클릭하거나 F9 키를 누릅니다. 마우스 및 키보드 모드를 종료하려면 F9를 탭합니다.
테스트를 완료하고 모든 사용자에 대해 마우스 및 키보드를 사용하도록 설정할 준비가 되면 Microsoft 계정 담당자에게 연락하세요.