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

# Aplicativo de Teste de Conteúdo (CTA) para Web no xbox.com/play

> Descreve como usar as ferramentas de desenvolvedor do Aplicativo de Teste de Conteúdo para Web no xbox.com/play.

As ferramentas de desenvolvedor do Aplicativo de Teste de Conteúdo (CTA) para Web estão disponíveis em [xbox.com/play](https://www.xbox.com/play), a experiência atual na Web do XBOX Cloud Gaming. Essas ferramentas foram projetadas para o Edge e o Chrome no Windows e para o Safari no Mac, iOS e iPadOS.

Este artigo aborda o xbox.com/play. Uma nova experiência está em versão prévia em [play.xbox.com](https://play.xbox.com/). Para usar as ferramentas de desenvolvedor dela, confira [Visão geral do Aplicativo de Teste de Conteúdo (CTA) para Web](https://docs.xbox.com/pt-BR/build/core-features/common/game-streaming/game-streaming-web-content-test-application.md).

* [Escolher uma experiência](#choose-an-experience)
* [Abrir as ferramentas de desenvolvedor](#open-developer-tools)
* [Selecionar uma oferta](#select-an-offering)
* [IP Connect](#ip-connect)
* [Remote Connect](#remote-connect)
* [Configurações de desenvolvedor](#developer-settings)
* [Sideload do TAK](#tak-sideload)
* [Alternar layouts do TAK durante um stream](#switch-tak-layouts-during-a-stream)
* [Mouse e teclado](#mouse-and-keyboard)
* [Experimentar a nova experiência](#try-the-new-experience)

## Escolher uma experiência

O CTA para Web é executado em duas experiências na Web do XBOX Cloud Gaming: xbox.com/play e play.xbox.com, que está em versão prévia. Use esta tabela para escolher uma delas para o seu cenário:

| Cenário | xbox.com/play | play.xbox.com |
| :- | :- | :- |
| IP Connect com um XBOX Development Kit | Compatível somente com uma conta de teste de sandbox | Compatível |
| Sideload do TAK a partir do mesmo PC | Compatível | Compatível |
| Sideload do TAK para um telefone ou tablet a partir de um PC | Compatível via HTTPS | Ainda não compatível |
| Alternar layouts durante um stream | Compatível | Compatível |
| Remote Connect | Compatível | Compatível |

As duas experiências são compatíveis com ofertas privadas, contas de teste de sandbox, seleção de região e mouse e teclado.

## Abrir as ferramentas de desenvolvedor

Para começar a usar as ferramentas de desenvolvedor, acesse [xbox.com/play/dev-tools](https://www.xbox.com/play/dev-tools). Se você não tiver entrado, a página solicitará que você entre e incluirá um campo de sandbox.

* Para contas de varejo, deixe o sandbox em branco e entre com a mesma conta conectada ao XBOX Development Kit ou configurada para acessar uma oferta privada.
* Para contas de teste de sandbox, insira a ID do sandbox antes de entrar.

Um sandbox é um ambiente de desenvolvimento isolado para o seu título, e cada conta de teste de sandbox pertence a um deles. A ID do sandbox não é a ID da sua oferta; obtenha-a com quem criou suas contas de teste. Para obter mais informações, confira [Visão geral dos sandboxes dos serviços do XBOX](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md).

> [!NOTE]
>
> Se você entrar com uma conta de teste de sandbox sem a ID do sandbox correspondente, alguns recursos poderão não funcionar, porque essas contas não têm acesso aos recursos de varejo.

Se você entrou sem a ID do sandbox, saia visitando outro site da Microsoft, como [outlook.com](https://www.outlook.com). Em seguida, entre novamente com a ID do sandbox correta.

Você também pode abrir as configurações de desenvolvedor a partir do catálogo do xbox.com/play. Selecione sua foto de perfil e, em seguida, selecione **Settings** > **Developer**. Se **Developer** não for exibido, selecione **Account** 10 vezes em rápida sucessão para revelá-lo. Nas configurações de desenvolvedor, **Developer Tools Home** retorna à página de ferramentas de desenvolvedor.

> [!NOTE]
>
> No iOS ou iPadOS, você pode salvar a página como um aplicativo Web progressivo (PWA). Selecione o botão de compartilhamento e, em seguida, selecione **Add to Home Screen**.
>
> O PWA lembra sua conta e sua configuração, para que você possa voltar a testar mais tarde.

## Selecionar uma oferta

As ofertas são os ambientes de teste privados usados para validar jogos em execução no hardware do datacenter. Para obter mais informações sobre ofertas, confira [Visão geral do Game Streaming](https://docs.xbox.com/pt-BR/build/core-features/common/game-streaming/game-streaming-overview.md#what-are-private-offerings).

Para usar uma oferta específica:

1. Acesse [xbox.com/play/dev-tools/select-offering](https://www.xbox.com/play/dev-tools/select-offering).
2. Selecione a oferta na lista suspensa ou selecione **Custom offering ID** e insira a ID da oferta em **Enter offering ID for cloud connection**.
3. Selecione **Connect**.

O catálogo da sua oferta é aberto e a página mostra **Using custom offering** seguido da ID da oferta. Se você não conseguir acessar a oferta, verifique se entrou com uma conta autorizada a usar essa oferta específica.

### Regiões de oferta

As ofertas não encaminham você automaticamente para o datacenter mais próximo. Para testar em uma região diferente, abra **Settings** > **Developer** e escolha uma região em **Streaming Region**. Escolha-a antes de iniciar um stream. **Current region** mostra sua seleção. As regiões disponíveis devem ser configuradas com antecedência. Entre em contato com seu representante de conta da Microsoft para ajustar as regiões disponíveis para sua oferta.

## IP Connect

Use o IP Connect para fazer streaming diretamente de um XBOX Development Kit por endereço IP. No xbox.com/play, o IP Connect exige uma conta de teste de sandbox, e a página de ferramentas de desenvolvedor não tem um link para ele.

Antes de usar o IP Connect, conclua estes pré-requisitos:

1. Configure seu XBOX Development Kit para streaming. Para obter mais informações, confira [Configurar um XBOX Development Kit](https://docs.xbox.com/pt-BR/build/core-features/common/game-streaming/game-streaming-setup-xbox-developer-kit.md).
2. Em **Dev Home** > **Streaming**, verifique se o **Direct Connect** está escutando. Ele para de escutar sempre que o kit é reiniciado.
3. Verifique se o dispositivo cliente está na mesma rede que o XBOX Development Kit ou conectado por meio de uma VPN.
4. Verifique se a sua rede permite tráfego TCP e UDP para a porta 9002 no XBOX Development Kit. O navegador usa uma conexão WebSocket para sinalização e UDP para o stream.

Para se conectar por endereço IP:

1. Acesse [xbox.com/play/dev-tools](https://www.xbox.com/play/dev-tools). Insira a ID do sandbox e, em seguida, entre com uma conta de teste desse sandbox.
2. Acesse [xbox.com/play/dev-tools/ip-connect](https://www.xbox.com/play/dev-tools/ip-connect).
3. Insira o endereço IP e a porta do XBOX Development Kit, por exemplo, `192.168.1.10:9002`.
4. Selecione **Connect**.
5. Se o navegador solicitar permissão para acessar dispositivos na sua rede local, selecione **Allow**.

Quando a conexão for bem-sucedida, o aplicativo em execução no XBOX Development Kit aparecerá no navegador. Se você tiver entrado com uma conta de varejo, o endereço do IP Connect retornará você à página de ferramentas de desenvolvedor.

## Remote Connect

O Remote Connect faz streaming do seu XBOX Development Kit pela Internet por meio dos serviços de jogo remoto do XBOX. Ele encontra o kit por meio da sua conta conectada, portanto você não precisa inserir um endereço IP.

Primeiro, configure o XBOX Development Kit:

1. Entre no XBOX Development Kit com a conta que você usará no xbox.com/play. A conta deve ser permitida no sandbox do kit.
2. Acesse **Dev Home** > **Streaming**. Em **Remote Connect**, selecione sua conta.
3. Em **Dev Home** > **Streaming**, verifique se o **Direct Connect** não está escutando. O Direct Connect é um modo de conexão separado para o IP Connect e bloqueia o Remote Connect enquanto está escutando.

Em seguida, conecte-se a partir do xbox.com/play:

1. Acesse [xbox.com/play/dev-tools](https://www.xbox.com/play/dev-tools) e entre com a mesma conta. Para uma conta de teste de sandbox, insira a ID do sandbox antes de entrar.
2. Selecione **Remote Connect**. Essa opção está disponível quando a conta conectada tem um kit de desenvolvimento configurado para o Remote Connect ou quando você entrou com uma conta de teste de sandbox.
3. Encontre seu XBOX Development Kit na lista e selecione **Connect**.

> [!NOTE]
>
> Tanto o XBOX Development Kit quanto o dispositivo a partir do qual você está se conectando precisam de uma conexão com a Internet.
>
> Ao contrário do IP Connect, o Remote Connect não exige que os dois dispositivos estejam na mesma rede.

## Configurações de desenvolvedor

Para abrir as configurações de desenvolvedor, selecione sua foto de perfil e, em seguida, selecione **Settings** > **Developer**.

As configurações de desenvolvedor incluem a oferta atual e as configurações de stream. A [Visão geral da configuração de stream](https://docs.xbox.com/pt-BR/build/core-features/common/game-streaming/game-streaming-content-test-application-stream-config.md) inclui mais informações sobre as configurações de stream específicas que podem ser substituídas.

Em **Stream Configuration** > **Touch adaptation**, você pode definir:

* **Enable sideload**: carrega layouts de toque a partir do comando `serve` da [CLI do TAK](https://docs.xbox.com/pt-BR/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line.md), em vez dos layouts publicados para o seu título.
* **Sideload server address**: o endereço do servidor de sideload.
* **Enable automatic refresh**: atualiza os layouts no seu dispositivo quando você os altera no servidor de sideload.
* **Emulate touch with mouse**: trata os cliques do mouse como toque.

## Sideload do TAK

Estas etapas abordam o streaming a partir de uma oferta personalizada ou de um XBOX Development Kit. Para usar uma oferta, confira [Selecionar uma oferta](#select-an-offering).

Antes de começar, execute [`tak serve`](https://docs.xbox.com/pt-BR/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-serve-command) no PC que fornece seus layouts.

Para fazer sideload a partir do mesmo PC que o navegador:

1. Abra **Settings** > **Developer** e encontre **Touch adaptation**.
2. Ative **Enable sideload**.
3. Em **Sideload server address**, insira o endereço do seu servidor de sideload, por exemplo, `http://localhost:9269`. Qualquer endereço diferente de `localhost` deve usar `https`, conforme descrito em [Fazer sideload a partir de outro dispositivo](#sideload-from-another-device).
4. Em **Network Status**, verifique **Network Permission**. Se for exibido **Required**, selecione **Request Permission**. Quando o navegador solicitar que o site tenha permissão para **Access other apps and services on this device**, selecione **Allow**.
5. Em um PC sem tela sensível ao toque, ative **Emulate touch with mouse**. Sem essa opção, o stream não mostra controles de toque e o menu **TAK** não fica disponível.
6. Quando **Server Connection** mostrar **Connected**, inicie um stream. Se for exibido **Not Reachable**, verifique se `tak serve` está em execução e selecione **Recheck**.

Alterar **Enable sideload** ou **Emulate touch with mouse** durante um stream solicitará que você troque de jogo.

Para confirmar que o stream usa seus layouts, procure-os em **Bundle layouts**, conforme descrito em [Alternar layouts do TAK durante um stream](#switch-tak-layouts-during-a-stream).

### Fazer sideload a partir de outro dispositivo

Para testar em um telefone ou tablet, execute `tak serve` em um PC que o dispositivo consiga acessar na sua rede local. O servidor deve usar `https`:

1. Crie um certificado. Para obter mais informações, confira [Instruções de geração de certificado](https://docs.xbox.com/pt-BR/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-serve-command.md#certificate-generation-instructions).
2. No PC, execute `tak serve` com as opções `--certificate-file` e `--certificate-password`.
3. Instale o certificado no telefone ou tablet e confie nele. Para ver as etapas, confira [Confiar no certificado em diferentes clientes](https://docs.xbox.com/pt-BR/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-serve-command.md#trusting-the-certificate-on-different-clients).
4. No telefone ou tablet, abra **Settings** > **Developer**, ative **Enable sideload** e insira `https://<your PC's IP address>:9269` em **Sideload server address**.
5. Verifique **Network Permission** e **Server Connection**, conforme descrito nas etapas 4 e 6 de [Sideload do TAK](#tak-sideload).

Para exigir uma senha, use a opção `--password` e insira a mesma senha nas configurações de desenvolvedor do dispositivo. Para obter mais informações, confira [Comando serve](https://docs.xbox.com/pt-BR/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-serve-command.md).

## Alternar layouts do TAK durante um stream

No modo de desenvolvedor, você pode alternar o layout ativo durante o streaming:

1. No stream, abra **Developer Tools Menu** no canto inferior esquerdo e selecione **TAK**.
2. Em **Select touch controls layout**, selecione um layout em **Bundle layouts** ou **System layouts**. **Bundle layouts** mostra os layouts carregados para este stream. Quando o sideload funciona, esses são os seus layouts.
3. Selecione **Close**.

Os **System layouts** são **Standard** e **Native Touch Only (Blank)**. **Standard** mostra a sobreposição de controle padrão. **Native Touch Only (Blank)** remove os controles de toque.

## Mouse e teclado

Antes de começar, abra as ferramentas de desenvolvedor conforme descrito em [Abrir as ferramentas de desenvolvedor](#open-developer-tools).

1. Em **Settings** > **Developer**, em **Stream Configuration** > **Enabled input types**, ative **Mouse and keyboard**. Altere essa configuração antes de iniciar um stream.
2. Em **Touch adaptation**, desative **Emulate touch with mouse**. Quando as duas opções estão ativadas, os cliques do mouse são tratados como toques.
3. Inicie um stream.
4. Se uma faixa exibir **Enter fullscreen mode to play with mouse and keyboard**, selecione **Enter fullscreen**.

Para liberar o mouse, pressione a tecla mostrada na notificação **Press *key* to release your mouse**.

## Experimentar a nova experiência

Para mudar para a nova experiência em play.xbox.com, selecione sua foto de perfil e, em seguida, selecione **Try the new experience** > **Try now**. Para voltar ao xbox.com/play, abra **Account settings** no seu perfil e selecione **Exit preview**.


## Related topics

- [Visão geral do Aplicativo de Teste de Conteúdo (CTA) para Web](https://docs.xbox.com/pt-BR/build/core-features/common/game-streaming/game-streaming-web-content-test-application.md)
- [Visão geral do Aplicativo de Teste de Conteúdo (CTA) para Windows (Preterido)](https://docs.xbox.com/pt-BR/build/core-features/common/game-streaming/game-streaming-windows-pc-content-test-application.md)
- [Visão geral do Aplicativo de Teste de Conteúdo (CTA) para Android (Preterido)](https://docs.xbox.com/pt-BR/build/core-features/common/game-streaming/game-streaming-android-content-test-application.md)
- [Visão geral da configuração de stream do Aplicativo de Teste de Conteúdo (CTA)](https://docs.xbox.com/pt-BR/build/core-features/common/game-streaming/game-streaming-content-test-application-stream-config.md)
- [Implantando layouts de controles por toque usando a CLI do TAK](https://docs.xbox.com/pt-BR/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-touch-deploying-touch-layout.md)