> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Seu primeiro playtest

> Carregue um build de um jogo do XBOX e, em seguida, crie, publique e compartilhe um playtest dele com a XBOX CLI e o Partner Center.

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](https://learn.microsoft.com/gaming/game-publishing/concepts/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](https://docs.xbox.com/pt-BR/tools/xbox-cli/cli-command-lifecycle.md).

## 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](https://docs.xbox.com/pt-BR/tools/xbox-cli/getting-started.md).

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](https://docs.xbox.com/pt-BR/tools/xbox-cli/xbox-services-in-a-playtest.md).

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`:

```text theme={null}
makepkg upload /d layout /msixvc2 /pc /storeid 9N0000000000 /branch Main
```

A [referência do makepkg](https://learn.microsoft.com/gaming/gdk/docs/features/common/packaging/deployment/makepkg)
abrange os outros formatos de pacote. Em seguida, o Partner Center processa o pacote, o que pode levar
algum tempo. Para verificar:

```bash theme={null}
xbox package list --store-id 9N0000000000 --output table
```

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`:

```bash theme={null}
xbox package list --store-id 9N0000000000
```

Se `STATE` for `ProcessFailed`, `PLAYTEST` continuar `false` ou houver um item `Error`, verifique os
requisitos de pacote em [Pré-requisitos para um playtest](https://learn.microsoft.com/gaming/game-publishing/concepts/playtest-preview#prerequisites-for-a-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`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/audience#creating-an-audience):

```bash theme={null}
xbox audience create --name "Nod Arena testers" --members-file testers.txt
```

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:

```bash theme={null}
xbox audience list --output table
```

Se `xbox audience list` atingir o tempo limite, um [problema conhecido](https://docs.xbox.com/pt-BR/tools/xbox-cli/known-issues.md#xbox-audience-list-can-time-out),
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:

```bash theme={null}
xbox playtest create --store-id 9N0000000000 --name "Nod Arena playtest" --start 2026-12-01 --end 2026-12-15 --pc-package-id 11111111-2222-3333-4444-555555555555 --audience-id 1152921504606846976
```

* `--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:

```bash theme={null}
xbox playtest publish 11111111-2222-3333-4444-555555555555 --store-id 9N0000000000
```

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:

| Código de saída | Significado |
| - | - |
| 1 | As verificações do Partner Center falharam, por exemplo, porque o playtest não tem pacote, público ou classificações etárias. Nada é publicado. Corrija as verificações que o comando lista e publique novamente. |
| 2 | A publicação falhou. |
| 3 | O resultado é desconhecido. Verifique o playtest com `xbox playtest get` antes de publicar novamente. |
| 4 | O playtest ainda está sendo publicado após 5 minutos. Verifique mais tarde com `xbox playtest get`. |

Consulte [Publicar um playtest](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/playtest.md#publishing-a-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](https://learn.microsoft.com/gaming/game-publishing/concepts/playtest-preview#share-a-playtest-with-testers).

## 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](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/package.md#uploading-packages). 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)](https://docs.xbox.com/pt-BR/tools/xbox-cli/authentication.md#automation-service-principal-authentication).

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`.


## Related topics

- [Usar o Playtest](https://docs.xbox.com/pt-BR/publishing/game-publishing/concepts/playtest-preview.md)
- [Etiqueta sobre deficiência](https://docs.xbox.com/pt-BR/build/game-principles/accessibility/etiquette.md)
- [Introdução](https://docs.xbox.com/pt-BR/tools/xbox-cli/getting-started.md)
- [XBOX CLI](https://docs.xbox.com/pt-BR/tools/xbox-cli/index.md)
- [Criar seu primeiro servidor](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/servers/create-your-first-server.md)
