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: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:
--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 emxbox package list e passe seu id para a opção
da plataforma correspondente:
update, uma opção de pacote que você omite mantém seu pacote, uma nova ID o substitui e ""
o remove:
Atualizar um playtest
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:
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 umaid de audience list para --audience-id e repita-a para adicionar mais:
--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.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 com1, 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.
