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

# Usar os serviços do XBOX em um playtest

> Prepare a configuração dos serviços do XBOX de um jogo para um playtest, desde os XBOX services completos e as conquistas até o embargo e a publicação em RETAIL.

Um playtest é executado na sandbox RETAIL, o ambiente ativo que os jogadores usam. Quando o build usa
o login do XBOX, conquistas, presença ou outros serviços do XBOX, o jogo precisa dos XBOX services completos,
e a configuração dos serviços do XBOX dele precisa ser publicada em RETAIL. Assim, os testadores usam os mesmos
serviços do XBOX ativos que os jogadores de um jogo lançado. Consulte
[XBOX services e Playtest](https://docs.xbox.com/publishing/game-publishing/concepts/playtest-preview.md#xbox-services-and-playtest).

Execute estas etapas uma vez, antes de [criar o playtest](https://docs.xbox.com/pt-BR/tools/xbox-cli/first-playtest.md):

1. [Obter os XBOX services completos](#1-get-full-xbox-services).
2. [Escolher o que acontece com as conquistas](#2-choose-what-happens-to-achievements).
3. [Definir o embargo](#3-set-the-embargo).
4. [Publicar a configuração em RETAIL](#4-publish-the-configuration-to-retail).

Os exemplos usam a ID de título do XBOX `1234ABCD` e uma sandbox de desenvolvimento, `XDKS.1`, que contém
a configuração com a qual o build foi testado.

## 1. Obter os XBOX services completos

Um novo jogo começa com os serviços do XBOX desabilitados. Os XBOX services limitados funcionam somente em sandboxes
de desenvolvimento e não incluem conquistas nem estatísticas. Depois que o conceito do seu jogo for aprovado, envie a
ID da Store do jogo ao seu representante do XBOX e peça que ele faça a integração do produto. Em seguida, selecione
**Enable full XBOX services** na página **Game setup** do jogo no Partner Center. Consulte
[Habilitar os XBOX services](https://docs.xbox.com/publishing/game-publishing/concepts/xbox-services.md#enable-xbox-services).

Até lá, uma configuração com conquistas falha na validação:

```text theme={null}
XblLimited products do not support achievements or stats2013/stats2015 configuration.
```

## 2. Escolher o que acontece com as conquistas

As conquistas publicadas em RETAIL são permanentes. Você ainda pode alterar os nomes, as descrições
e a arte delas, mas não pode removê-las nem alterar as regras de desbloqueio ou o gamerscore. As estatísticas publicadas em
RETAIL também não podem ser excluídas. O sistema de conquistas do jogo, gerenciado pelo título ou baseado em eventos, é
fixado pela primeira publicação em RETAIL. Antes dessa publicação, escolha uma destas opções:

| Opção | Use quando | Como |
| - | - | - |
| Publicar as conquistas finais | As conquistas são finais. | Publique normalmente. Para um jogo ainda não lançado, o embargo da próxima etapa as oculta de outros jogadores. |
| Solicitar uma substituição de validação | O design das conquistas precisa mudar durante o playtest. | Peça ao seu representante do XBOX uma substituição de validação para o período de desenvolvimento. Remova-a antes de enviar o jogo para certificação. |

Um jogo para PC ou para consoles XBOX não pode deixar de publicar as conquistas em RETAIL. No Partner
Center, responder **No** a **Publish Achievements to Retail?** falha com:

```text theme={null}
The specified Platform:Windows can be used only when game is configured to Publish Achievements.
```

Todas as conquistas publicadas precisam atender aos Requisitos do XBOX para conquistas e gamerscore. Consulte
[Conquistas](https://docs.xbox.com/publishing/game-publishing/concepts/playtest-preview.md#achievements).

## 3. Definir o embargo

O embargo oculta as conquistas, a presença e outros dados dos serviços do XBOX do jogo para os jogadores no
aplicativo XBOX e na interface do usuário do console até uma data que você escolher, além de bloquear capturas de tela e de vídeo.
Sem ele, os jogadores fora do playtest podem ver a configuração do jogo.

Defina um embargo somente para um jogo que ainda não foi lançado. Em um jogo lançado, um novo embargo oculta
os dados dos serviços do XBOX dele para os jogadores.

No Partner Center, abra **XBOX services** > **XBOX settings**, acesse **Embargo date** e defina
uma data e hora UTC posteriores ao término do playtest e não posteriores ao lançamento público do jogo.
Se o playtest se estender além do lançamento, termine o embargo no lançamento. Selecione
**Allow Multiplayer Invites in Embargo** se os testadores convidarem uns aos outros para sessões multijogador.
Consulte [Configurar a data de embargo](https://docs.xbox.com/publishing/game-publishing/tutorial-xbox-managed/how-to-configure-xbox-services.md#configure-embargo-date).

O embargo é uma configuração de todo o título, armazenada na sandbox `ALL`, e se aplica a todas as sandboxes.
Para verificá-lo, baixe `ALL`:

```bash theme={null}
xbox xbl config download --title-id 1234ABCD --sandbox-id ALL --view draft --dest xbox-config-all
```

`productdeveloper.xml` contém o embargo:

```xml theme={null}
<XboxLiveEmbargoDate>2027-03-01T17:00:00Z</XboxLiveEmbargoDate>
<EmbargoInvitesEnabled>true</EmbargoInvitesEnabled>
```

O embargo entra em vigor quando a configuração de todo o título é publicada. Se o Partner Center mostrar
alterações não publicadas, publique-as lá ou com `--sandbox-id HIDDEN`:

> [!WARNING]
>
> Uma publicação de todo o título publica todas as alterações pendentes de todo o título, não apenas o embargo, e essas
> alterações também chegam a RETAIL. Revise as alterações pendentes primeiro.

```bash theme={null}
xbox xbl config publish --title-id 1234ABCD --sandbox-id HIDDEN
```

O comando pergunta antes de publicar. Consulte
[Seleção da origem](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/xbl.md#source-selection).

A publicação é assíncrona. Antes de publicar em RETAIL, verifique se `lastPublish` mostra que a
publicação de todo o título foi bem-sucedida:

```bash theme={null}
xbox xbl config status --title-id 1234ABCD --sandbox-id HIDDEN
```

## 4. Publicar a configuração em RETAIL

Publique a configuração da sandbox de desenvolvimento diretamente em RETAIL. RETAIL não exige uma
publicação prévia em CERT nem certificação.

> [!WARNING]
>
> Uma publicação em RETAIL fica ativa para os jogadores assim que termina, e as conquistas publicadas não podem
> ser removidas. Consulte [Segurança e operações destrutivas](https://docs.xbox.com/pt-BR/tools/xbox-cli/safety.md).

Valide primeiro. A validação não altera nada e lista as conquistas que a publicação adiciona:

```bash theme={null}
xbox xbl config publish --title-id 1234ABCD \
  --source-sandbox-id XDKS.1 --sandbox-id RETAIL --validate-only
```

Se a validação mostrar o aviso `FirstRetailPublishWithoutEffectiveEmbargo`, ainda não há nenhum embargo em
vigor. Conclua a [etapa 3](#3-set-the-embargo), incluindo a publicação de todo o título.

Publicar a partir de `XDKS.1` substitui os documentos de trabalho de RETAIL que têm os mesmos nomes e os
arquivos globais do Title Storage de RETAIL, excluindo os arquivos que somente RETAIL contém. Consulte
[Publicação entre sandboxes](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/xbl.md#cross-sandbox-publishing-replaces-global-title-storage-files).

Quando a validação não apresentar problemas, publique. O comando descreve a publicação e pergunta primeiro:

```bash theme={null}
xbox xbl config publish --title-id 1234ABCD --source-sandbox-id XDKS.1 --sandbox-id RETAIL
```

Verifique `lastPublish` até que a publicação termine:

```bash theme={null}
xbox xbl config status --title-id 1234ABCD --sandbox-id RETAIL
```

Em seguida, [crie e publique o playtest](https://docs.xbox.com/pt-BR/tools/xbox-cli/first-playtest.md).


## Related topics

- [Playtest](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/playtest.md)
- [Seu primeiro playtest](https://docs.xbox.com/pt-BR/tools/xbox-cli/first-playtest.md)
- [XBOX CLI](https://docs.xbox.com/pt-BR/tools/xbox-cli/index.md)
- [Visão geral da API dos serviços do XBOX](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/xbox-services-api/live-introduction-to-xbox-live-apis.md)
- [Visão geral dos Dados do jogador do XBOX](https://docs.xbox.com/pt-BR/services/xbox-services/player-data/live-playerdata-overview.md)
