Antes de começar
- Uma conta do Partner Center configurada para desenvolver jogos para XBOX, com um jogo nela. Os playtests não precisam de solicitação de acesso separada.
- Classificações etárias para o jogo. Preencha o questionário da International Age Rating Coalition (IARC) uma vez, na página Age ratings do jogo no Partner Center. Um playtest não pode ser publicado sem elas.
- Permissão para gerenciar os pacotes do jogo no Partner Center. Sem ela, os comandos
packageeplaytestfalham com 403package_permission_denied. Peça essa permissão a um gerente da sua conta do Partner Center ou passe--seller-idse o jogo pertencer a outro vendedor. - Entre com
xbox auth logine escolha um vendedor, como em Introdução.
9N0000000000. Encontre a ID da Store do seu jogo com
xbox game list --output table.
1. Carregar um pacote
A CLI não carrega pacotes. Carregue o build com omakepkg do XBOX Game Development Kit (GDK) de outubro de 2026
ou posterior. Para um jogo para PC cujo build está na pasta layout:
STATE é Processed e PLAYTEST é true. Anote o PACKAGE ID dele.
A tabela não mostra os resultados da validação; portanto, verifique no JSON se os validationItems dele não contêm
nenhum item com gravidade Error:
STATE for ProcessFailed, PLAYTEST continuar false ou houver um item Error, verifique os
requisitos de pacote em Pré-requisitos para um playtest.
2. Criar um público
Um público decide quem pode instalar o playtest. O Partner Center o chama de grupo de clientes. No workspace Apps and games do Partner Center, selecione Customer groups e, em seguida, Create new group. Escolha Known user group, adicione seus testadores e salve. Ou liste os endereços de email dos seus testadores emtesters.txt, um por linha, e crie o público com o
comando Experimental audience create:
id do público para quando você o adicionar ao playtest.
3. Criar o playtest
Se você criou o público comaudience create, use a id que ele imprimiu. Se você criou o
grupo no Partner Center, encontre a ID dele:
xbox audience list atingir o tempo limite, um problema conhecido,
omita --audience-id ao criar o playtest. Depois, no Partner Center, abra o
playtest na página Playtest do jogo em Services, escolha o grupo da etapa 2 e salve-o
sem publicar.
Crie o playtest:
--pc-package-idrecebe a ID do pacote da etapa 1. Use--console-package-idpara um pacote de console.--audience-idrecebe a ID do público. Repita-a para adicionar mais públicos.- Os testadores podem instalar o playtest de
--startaté--end. Uma data sem hora significa meia-noite UTC.
playtestId em details.
Se o comando sair com 3, ele não conseguiu determinar se o playtest foi criado. Tente novamente com o
comando que ele imprime, o que não criará um segundo playtest.
4. Publicá-lo
Publique o playtest com a ID da etapa 3:Live, ou Scheduled se a data de início ainda não tiver chegado,
e sai com 0. Outros códigos de saída significam que o playtest ainda não foi publicado:
Consulte Publicar um playtest.
5. Compartilhá-lo
Quando o playtest estiver ativo, os testadores do público dele poderão encontrá-lo na biblioteca:- No console, em Full Library, no filtro Playtest.
- No PC, em Library do aplicativo XBOX, no filtro Access.
msxbox://playtest/. A CLI ainda não consegue
mostrar esse link. Ele funciona somente para pessoas do público do playtest e, no PC, abre o
playtest no aplicativo XBOX. Consulte
Compartilhar um playtest com os testadores.
Scripts e integração contínua
Você pode carregar pacotes a partir de pipelines de integração contínua (CI) com uma entidade de serviço. Consulte Carregar pacotes. Os comandosxbox package e
xbox playtest ainda não aceitam entidades de serviço; portanto, eles precisam de um usuário conectado. Consulte
Autenticação de automação (entidade de serviço).
Em um script executado enquanto você está conectado, passe --confirm para playtest create e
playtest publish, porque, sem um terminal, eles não conseguem perguntar a você e não fazem nenhuma alteração. Leia o
JSON que eles imprimem e verifique os códigos de saída. Para aguardar mais de 5 minutos por uma publicação, passe
--timeout.