Pular para o conteúdo principal
As ferramentas de desenvolvedor do Aplicativo de Teste de Conteúdo (CTA) para Web estão disponíveis em 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. Para usar as ferramentas de desenvolvedor dela, confira Visão geral do Aplicativo de Teste de Conteúdo (CTA) para Web.

​
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: 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. 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.
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. 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.
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. Para usar uma oferta específica:
  1. Acesse 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.
  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. 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.
  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 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.
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 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, 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. Antes de começar, execute tak serve 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.
  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.

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

​
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.
  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.
Última modificação em 6 de novembro de 2026