시작하기 전에
- XBOX 게임을 개발하도록 설정되어 있고 게임이 포함된 Partner Center 계정. 플레이테스트에는 별도의 액세스 요청이 필요하지 않습니다.
- 게임의 연령 등급. Partner Center에 있는 게임의 Age ratings 페이지에서 IARC(International Age Rating Coalition) 설문지를 한 번 작성하세요. 연령 등급이 없으면 플레이테스트를 게시할 수 없습니다.
- Partner Center에서 게임의 패키지를 관리할 수 있는 권한. 이 권한이 없으면
package및playtest명령이 403package_permission_denied로 실패합니다. Partner Center 계정의 관리자에게 권한을 요청하거나, 게임이 다른 판매자에게 속한 경우--seller-id를 전달하세요. - 시작하기에 설명된 대로
xbox auth login으로 로그인하고 판매자를 선택합니다.
9N0000000000을 사용합니다. 게임의 Store ID는
xbox game list --output table로 찾을 수 있습니다.
1. 패키지 업로드
CLI는 패키지를 업로드하지 않습니다. 2026년 10월 XBOX GDK(Game Development Kit) 이상의makepkg로 빌드를 업로드하세요. 빌드가 layout 폴더에 있는 PC 게임의 경우 다음과 같습니다.
STATE가 Processed이고 PLAYTEST가 true이면 패키지가 준비된 것입니다. 해당 PACKAGE ID를 기록해 두세요.
표에는 유효성 검사 결과가 표시되지 않으므로, JSON에서 validationItems에 심각도가 Error인
항목이 없는지 확인하세요.
STATE가 ProcessFailed이거나, PLAYTEST가 false로 유지되거나, Error 항목이 있는 경우
플레이테스트의 필수 구성 요소에서 패키지 요구 사항을 확인하세요.
2. 대상 그룹 만들기
대상 그룹은 플레이테스트를 설치할 수 있는 사용자를 결정합니다. Partner Center에서는 이를 고객 그룹이라고 합니다. Partner Center의 Apps and games 작업 영역에서 Customer groups를 선택한 다음 Create new group을 선택합니다. Known user group을 선택하고, 테스터를 추가하고, 저장합니다. 또는 테스터의 이메일 주소를 한 줄에 하나씩testers.txt에 나열하고, 실험적
audience create 명령으로 대상 그룹을 만듭니다.
id를 기록해 두세요.
3. 플레이테스트 만들기
audience create로 대상 그룹을 만든 경우 출력된 id를 사용하세요. Partner Center에서
그룹을 만든 경우 해당 ID를 찾습니다.
xbox audience list가 시간 초과되면
플레이테스트를 만들 때 --audience-id를 생략하세요. 그런 다음 Partner Center의 Services 아래에 있는
게임의 Playtest 페이지에서 플레이테스트를 열고, 2단계의 그룹을 선택한 다음, 게시하지 않고
저장합니다.
플레이테스트를 만듭니다.
--pc-package-id는 1단계의 패키지 ID를 받습니다. 본체 패키지에는--console-package-id를 사용하세요.--audience-id는 대상 그룹의 ID를 받습니다. 대상 그룹을 더 추가하려면 이 옵션을 반복하세요.- 테스터는
--start부터--end까지 플레이테스트를 설치할 수 있습니다. 시간이 없는 날짜는 UTC 자정을 의미합니다.
details 아래의
playtestId인 플레이테스트 ID를 기록해 두세요.
명령이 3으로 종료되면 플레이테스트가 만들어졌는지 여부를 확인할 수 없었던 것입니다. 명령이 출력하는
명령으로 다시 시도하세요. 이 명령은 두 번째 플레이테스트를 만들지 않습니다.
4. 게시
3단계의 ID로 플레이테스트를 게시합니다.Live 상태가 되거나 시작 날짜가 아직 되지 않은 경우 Scheduled 상태가 될 때까지
기다린 후 0으로 종료합니다. 다른 종료 코드는 플레이테스트가 아직 게시되지 않았음을 의미합니다.
플레이테스트 게시를 참조하세요.
5. 공유
플레이테스트가 라이브 상태가 되면 해당 대상 그룹의 테스터가 라이브러리에서 플레이테스트를 찾을 수 있습니다.- 본체에서는 Full Library의 Playtest 필터 아래에 있습니다.
- PC에서는 XBOX 앱 라이브러리의 Access 필터 아래에 있습니다.
msxbox://playtest/로 시작하는 링크를 복사합니다. CLI는 아직 이 링크를
표시할 수 없습니다. 이 링크는 플레이테스트 대상 그룹에 속한 사용자에게만 작동하며, PC에서는 XBOX 앱에서
플레이테스트를 엽니다.
테스터와 플레이테스트 공유를 참조하세요.
스크립트 및 연속 통합
서비스 주체를 사용하여 CI(연속 통합) 파이프라인에서 패키지를 업로드할 수 있습니다. 패키지 업로드를 참조하세요.xbox package 및
xbox playtest 명령은 아직 서비스 주체를 허용하지 않으므로 로그인한 사용자가 필요합니다.
자동화(서비스 주체) 인증을 참조하세요.
로그인한 상태에서 실행되는 스크립트에서는 playtest create 및 playtest publish에 --confirm을
전달하세요. 터미널이 없으면 확인을 요청할 수 없어 아무것도 변경하지 않기 때문입니다. 출력되는
JSON을 읽고 종료 코드를 확인하세요. 게시를 5분보다 오래 기다리려면
--timeout을 전달하세요.