Pular para o conteúdo principal
Um playtest permite que um grupo escolhido de jogadores experimente um jogo antes do lançamento. Os comandos playtest leem os playtests de um jogo no Partner Center e os criam, atualizam, publicam e excluem. create, update, publish e delete pedem confirmação antes de fazer uma alteração. create, update, publish e delete são Experimentais: suas opções e sua saída podem mudar ou ser removidas. Consulte Comandos experimentais.

Comandos

Argumentos e opções

Exemplos

Liste playtests, obtenha um e compare dois:
Crie um playtest para um público:
Altere a data de término de um playtest:
Publique um playtest:
Exclua um playtest:

Ler playtests

playtest list grava uma matriz playtests. Sua tabela tem as colunas PLAYTEST ID, NAME, STATUS, TYPE, START e END. Um trecho:
playtest get grava o playtest da forma como o serviço o retorna. etag é a versão a ser passada para update --if-match, e audiences.audienceIds lista os públicos que podem participar. Sua tabela tem linhas FIELD e VALUE. playtest diff grava hasDiffData, current e compared. Quando hasDiffData é false, não há nada a comparar, e compared é omitido. Sua tabela mostra somente os campos que diferem, nas colunas FIELD, CURRENT e COMPARED. As imagens não são comparadas.

Criar um playtest

playtest create cria um playtest privado em rascunho e o grava como playtest get faz. Executá-lo novamente cria outro playtest; remova um que você não queira com playtest delete. Cada criação envia uma chave de idempotência, um novo GUID, a menos que você passe --idempotency-key. Uma criação que repete uma chave retorna o playtest que essa chave criou e ignora todas as opções diferentes. Quando o resultado é desconhecido, como após um tempo limite, o comando sai com 3 e imprime um comando que tenta novamente com a mesma chave:
A nova tentativa retorna o playtest se a primeira solicitação o criou e, caso contrário, o cria. Quando uma opção contém uma quebra de linha, somente a chave é impressa; execute o mesmo comando com --idempotency-key e essa chave. Se a nova tentativa for recusada, por exemplo porque a data de término já passou, verifique playtest list antes de criar o playtest com uma nova chave.

Pacotes

Um playtest pode ter um pacote para PC e um pacote para console. Escolha um pacote pronto para um playtest em xbox package list e passe seu id para a opção da plataforma correspondente:
Em update, uma opção de pacote que você omite mantém seu pacote, uma nova ID o substitui e "" o remove:

Atualizar um playtest

Qualquer atualização retorna um playtest publicado para rascunho, assim como editá-lo no Partner Center. Publique-o novamente com playtest publish para disponibilizá-lo aos jogadores.
playtest update altera somente as opções que você passa e exige pelo menos uma. Ele grava o playtest atualizado como playtest get faz. A arte do jogo configurada no Partner Center é mantida; outras artes vinculadas ao playtest são substituídas por um espaço reservado. Para evitar substituir a alteração de outra pessoa, passe a etag de playtest get em --if-match. As aspas duplas ao redor dela são opcionais, e *, etags fracas (W/) e listas de etags são recusadas:
Quando o resultado é desconhecido, o comando sai com 3. Verifique o playtest com playtest get antes de tentar novamente.

Escolher públicos

Um público é um grupo de jogadores, como testadores, que o vendedor gerencia no Partner Center. Passe uma id de audience list para --audience-id e repita-a para adicionar mais:
Sem --audience-id, create cria um playtest sem públicos, e update os mantém. Em update, as IDs que você passa substituem todos os públicos do playtest. Para remover todos os públicos, passe somente "":
"" não pode ser combinado com IDs de público, e create o recusa. Um playtest precisa de pelo menos um público para ser publicado.

Publicar um playtest

Se o jogo usar os serviços do XBOX, defina a configuração e o embargo deles antes de publicar. Consulte Usar os serviços do XBOX em um playtest.
A publicação oferece o playtest aos seus públicos a partir da data de início. O comando publica a versão que lê primeiro; se o playtest mudar nesse intervalo, a publicação falha com 412 e não altera nada. Antes de pedir sua confirmação, o comando verifica a configuração dos serviços do XBOX do jogo, por exemplo se a data de embargo é posterior à data de término do playtest, e lista em stderr tudo o que deve ser revisado. Essas verificações são apenas consultivas; --confirm publica sem pedir confirmação. Em seguida, o serviço executa as próprias verificações. Quando uma delas bloqueia a publicação, nada entra na fila, e o comando lista cada verificação em stderr e sai com 1. Corrija os erros e publique novamente. Um playtest bloqueado por falta de classificações etárias precisa que o questionário de classificação etária seja concluído no Partner Center. Depois que a publicação entra na fila, o comando aguarda até que o playtest esteja Scheduled, Live ou PublishFailed e o grava como playtest get faz. Ctrl+C interrompe a espera, mas a publicação continua. Com --no-wait, o comando grava publishJobId e eventuais warnings assim que a publicação entra na fila; acompanhe-a com playtest get.

Excluir um playtest

playtest delete exclui a versão do playtest que lê primeiro. Ele aguarda até que o playtest esteja Deleted ou não exista mais e, em seguida, grava a resposta do serviço, com status. Ctrl+C interrompe a espera, mas a exclusão continua. Com --no-wait, ele grava a resposta assim que a exclusão entra na fila. Após um 412, a exclusão pode já estar na fila; portanto, aguarde um minuto e verifique com playtest get antes de excluir novamente.

Datas

--start e --end aceitam datas e horas no formato ISO 8601, como 2026-11-01T09:00:00-07:00 ou 2026-11-01T16:00:00Z. Uma data sem hora significa meia-noite UTC, e uma hora sem deslocamento está em UTC. Quando uma atualização passa somente uma data, o serviço a verifica em relação à outra data do playtest.

Erros

As falhas vão para stderr e saem com 1, a menos que as tabelas de códigos de saída acima indiquem o contrário. create e update saem com 3 quando o resultado é desconhecido. Uma falha que o serviço retorna inclui seu status HTTP, e --verbose adiciona a resposta do serviço, cujo campo code é mostrado aqui: Para outras falhas, o comando mostra a mensagem do serviço. Um 429 significa que você enviou solicitações demais; aguarde o tempo indicado pela mensagem antes de tentar novamente.
Última modificação em 19 de novembro de 2026