Pular para o conteúdo principal
Um playtest permite que um grupo escolhido de jogadores instale um build do seu jogo em consoles XBOX e PCs, antes ou depois do lançamento, sem certificação nem listagem na Microsoft Store. Esta página leva você do carregamento de um build até o compartilhamento do playtest com os testadores. A Visão geral do Playtest explica como os playtests funcionam. A maioria dos comandos desta página é Experimental; portanto, suas opções e sua saída podem mudar. Consulte Comandos experimentais.

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 package e playtest falham com 403 package_permission_denied. Peça essa permissão a um gerente da sua conta do Partner Center ou passe --seller-id se o jogo pertencer a outro vendedor.
  • Entre com xbox auth login e escolha um vendedor, como em Introdução.
Um playtest é executado na sandbox RETAIL. Se o build usar o login do XBOX ou outros serviços do XBOX, siga primeiro Usar os serviços do XBOX em um playtest. Os exemplos usam a ID da Store 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 o makepkg do XBOX Game Development Kit (GDK) de outubro de 2026 ou posterior. Para um jogo para PC cujo build está na pasta layout:
A referência do makepkg abrange os outros formatos de pacote. Em seguida, o Partner Center processa o pacote, o que pode levar algum tempo. Para verificar:
O pacote está pronto quando 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:
Se 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 em testers.txt, um por linha, e crie o público com o comando Experimental audience create:
Anote a id do público para quando você o adicionar ao playtest.

3. Criar o playtest

Se você criou o público com audience create, use a id que ele imprimiu. Se você criou o grupo no Partner Center, encontre a ID dele:
Se 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-id recebe a ID do pacote da etapa 1. Use --console-package-id para um pacote de console.
  • --audience-id recebe a ID do público. Repita-a para adicionar mais públicos.
  • Os testadores podem instalar o playtest de --start até --end. Uma data sem hora significa meia-noite UTC.
O comando pergunta antes de criar o playtest e, em seguida, o imprime como JSON. Anote a ID do playtest, que é 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:
O comando aguarda até que o playtest esteja 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.
Os testadores recém-adicionados precisam sair e entrar novamente primeiro. Você também pode enviar um link aos testadores. Na página Playtest do jogo no Partner Center, selecione Share no playtest e copie o link, que começa com 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 comandos xbox 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.
Última modificação em 19 de novembro de 2026