메인 콘텐츠로 건너뛰기
플레이테스트를 사용하면 선택한 플레이어 그룹이 출시 전에 게임을 체험해 볼 수 있습니다. playtest 명령은 Partner Center에서 게임의 플레이테스트를 읽고, 생성, 업데이트, 게시 및 삭제합니다. create, update, publish, delete는 변경하기 전에 묻습니다. create, update, publish, delete는 실험적 기능입니다. 옵션과 출력이 변경되거나 제거될 수 있습니다. 실험적 명령을 참조하세요.

명령

인수 및 옵션

예제

플레이테스트를 나열하고, 하나를 가져오고, 두 플레이테스트를 비교합니다.
대상 그룹에 대한 플레이테스트를 생성합니다.
플레이테스트의 종료 날짜를 변경합니다.
플레이테스트를 게시합니다.
플레이테스트를 삭제합니다.

플레이테스트 읽기

playtest list는 playtests 배열을 씁니다. 테이블에는 PLAYTEST ID, NAME, STATUS, TYPE, START, END 열이 있습니다. 일부 발췌:
playtest get은 서비스가 반환한 그대로 플레이테스트를 씁니다. etag는 update --if-match에 전달할 버전이고, audiences.audienceIds는 참여할 수 있는 대상 그룹을 나열합니다. 테이블에는 FIELD 및 VALUE 행이 있습니다. playtest diff는 hasDiffData, current, compared를 씁니다. hasDiffData가 false이면 비교할 것이 없으며 compared는 생략됩니다. 테이블에는 다른 필드만 FIELD, CURRENT, COMPARED 열로 표시됩니다. 이미지는 비교하지 않습니다.

플레이테스트 생성

playtest create는 비공개 초안 플레이테스트를 만들고 playtest get과 같은 방식으로 씁니다. 다시 실행하면 플레이테스트가 하나 더 생성됩니다. 원하지 않는 플레이테스트는 playtest delete로 제거하세요. 각 생성 요청은 멱등성 키를 보내며, --idempotency-key를 전달하지 않으면 새 GUID를 사용합니다. 키를 반복하는 생성 요청은 그 키로 생성된 플레이테스트를 반환하며, 다른 옵션이 달라도 무시합니다. 시간 초과 후처럼 결과를 알 수 없으면 명령은 3으로 종료하고, 같은 키로 다시 시도하는 명령을 출력합니다.
다시 시도하면 첫 번째 요청이 플레이테스트를 생성한 경우 그 플레이테스트를 반환하고, 그렇지 않으면 생성합니다. 옵션에 줄 바꿈이 있으면 키만 출력되므로, 같은 명령을 --idempotency-key와 그 키로 실행하세요. 종료 날짜가 지났다는 등의 이유로 다시 시도가 거부되면, 새 키로 플레이테스트를 생성하기 전에 playtest list를 확인하세요.

패키지

플레이테스트에는 PC 패키지 하나와 콘솔 패키지 하나를 포함할 수 있습니다. xbox package list에서 플레이테스트에 사용할 준비가 된 패키지를 선택하고, 해당 플랫폼의 옵션에 그 id를 전달하세요.
update에서 생략한 패키지 옵션은 기존 패키지를 유지하고, 새 ID는 패키지를 대체하며, ""는 패키지를 제거합니다.

플레이테스트 업데이트

Partner Center에서 편집할 때와 마찬가지로, 업데이트하면 게시된 플레이테스트가 초안으로 돌아갑니다. 플레이어가 사용할 수 있게 하려면 playtest publish로 다시 게시하세요.
playtest update는 전달한 옵션만 변경하며, 옵션이 하나 이상 필요합니다. 업데이트된 플레이테스트를 playtest get과 같은 방식으로 씁니다. Partner Center에서 구성한 게임 아트는 유지되며, 플레이테스트에 연결된 그 밖의 아트는 자리 표시자로 대체됩니다. 다른 사람의 변경 내용을 덮어쓰지 않으려면 playtest get에서 얻은 etag를 --if-match에 전달하세요. 값을 감싸는 큰따옴표는 선택 사항이며, *, 약한(W/) etag, etag 목록은 거부됩니다.
결과를 알 수 없으면 명령은 3으로 종료합니다. 다시 시도하기 전에 playtest get으로 플레이테스트를 확인하세요.

대상 그룹 선택

대상 그룹은 판매자가 Partner Center에서 관리하는 테스터 같은 플레이어 그룹입니다. audience list에서 얻은 id를 --audience-id에 전달하고, 더 추가하려면 반복하세요.
--audience-id가 없으면 create는 대상 그룹이 없는 플레이테스트를 만들고, update는 기존 대상 그룹을 유지합니다. update에서는 전달한 ID가 플레이테스트의 모든 대상 그룹을 대체합니다. 모든 대상 그룹을 제거하려면 ""만 전달하세요.
""는 대상 그룹 ID와 함께 사용할 수 없으며, create는 이를 거부합니다. 플레이테스트를 게시하려면 대상 그룹이 하나 이상 있어야 합니다.

플레이테스트 게시

게임이 XBOX 서비스를 사용하는 경우 게시하기 전에 해당 구성과 엠바고를 설정하세요. 플레이테스트에서 XBOX 서비스 사용을 참조하세요.
게시하면 시작 날짜부터 대상 그룹에 플레이테스트가 제공됩니다. 명령은 처음 읽은 버전을 게시하며, 그사이에 플레이테스트가 변경되면 게시가 412로 실패하고 아무것도 변경되지 않습니다. 확인을 요청하기 전에 명령은 엠바고 날짜가 플레이테스트 종료 날짜 이후인지와 같은 게임의 XBOX 서비스 설정을 검사하고, 검토할 항목을 stderr에 나열합니다. 이 검사는 권고일 뿐이며, --confirm을 사용하면 묻지 않고 게시합니다. 그런 다음 서비스가 자체 검사를 실행합니다. 검사 중 하나가 게시를 차단하면 아무것도 큐에 추가되지 않으며, 명령은 각 검사를 stderr에 나열하고 1로 종료합니다. 오류를 수정하고 다시 게시하세요. 연령 등급 누락으로 차단된 플레이테스트는 Partner Center에서 연령 등급 설문을 완료해야 합니다. 게시가 큐에 추가되면 명령은 플레이테스트가 Scheduled, Live 또는 PublishFailed가 될 때까지 기다린 다음 playtest get과 같은 방식으로 씁니다. Ctrl+C를 누르면 대기는 멈추지만 게시는 계속됩니다. --no-wait를 사용하면 게시가 큐에 추가되는 즉시 publishJobId와 warnings(있는 경우)를 씁니다. 이후 playtest get으로 추적하세요.

플레이테스트 삭제

playtest delete는 처음 읽은 버전의 플레이테스트를 삭제합니다. 플레이테스트가 Deleted가 되거나 없어질 때까지 기다린 다음, status가 포함된 서비스의 응답을 씁니다. Ctrl+C를 누르면 대기는 멈추지만 삭제는 계속됩니다. --no-wait를 사용하면 삭제가 큐에 추가되는 즉시 응답을 씁니다. 412 후에는 삭제가 이미 큐에 추가되었을 수 있으므로, 1분 정도 기다렸다가 다시 삭제하기 전에 playtest get으로 확인하세요.

날짜

--start와 --end는 2026-11-01T09:00:00-07:00 또는 2026-11-01T16:00:00Z와 같은 ISO 8601 날짜 및 시간을 허용합니다. 시간이 없는 날짜는 UTC 자정을 의미하고, 오프셋이 없는 시간은 UTC입니다. 업데이트에서 날짜를 하나만 전달하면 서비스가 그 날짜를 플레이테스트의 다른 날짜와 비교하여 검사합니다.

오류

위의 종료 코드 표에서 달리 명시하지 않는 한, 실패는 stderr로 출력되고 1로 종료합니다. create와 update는 결과를 알 수 없으면 3으로 종료합니다. 서비스가 반환하는 실패에는 HTTP 상태가 포함되며, --verbose를 사용하면 서비스의 응답이 추가됩니다. 응답의 code 필드는 다음과 같습니다. 그 밖의 실패에 대해서는 명령이 서비스의 메시지를 표시합니다. 429는 요청을 너무 많이 보냈다는 뜻입니다. 다시 시도하기 전에 메시지에 표시된 시간만큼 기다리세요.
마지막 수정일 2026년 11월 19일