Aplicación de prueba de contenido web (CTA) en xbox.com/play

Las herramientas de desarrollo de la aplicación de prueba de contenido web (CTA) están disponibles en xbox.com/play, la experiencia web actual de XBOX Cloud Gaming. Estas herramientas se han diseñado para Edge y Chrome en Windows, y para Safari en Mac, iOS y iPadOS. En este artículo se trata xbox.com/play. Hay una nueva experiencia en versión preliminar en play.xbox.com. Para usar sus herramientas de desarrollo, consulte Información general sobre la aplicación de prueba de contenido web (CTA).

• Elegir una experiencia
• Abrir las herramientas de desarrollo
• Seleccionar una oferta
• IP Connect
• Conexión remota
• Configuración de desarrollador
• Instalación local de TAK
• Cambiar los diseños de TAK durante una transmisión
• Mouse y teclado
• Probar la nueva experiencia

​

Elegir una experiencia

La CTA web se ejecuta en dos experiencias web de XBOX Cloud Gaming: xbox.com/play y play.xbox.com, que está en versión preliminar. Use esta tabla para elegir una para su escenario: Ambas experiencias admiten ofertas privadas, cuentas de prueba de sandbox, selección de región y mouse y teclado.

​

Abrir las herramientas de desarrollo

Para empezar a usar las herramientas de desarrollo, vaya a xbox.com/play/dev-tools. Si no ha iniciado sesión, la página le pide que inicie sesión e incluye un campo de sandbox.

• Para las cuentas comerciales, deje el sandbox en blanco e inicie sesión con la misma cuenta con la que se ha iniciado sesión en el kit de desarrollo de XBOX o que está configurada para acceder a una oferta privada.
• Para las cuentas de prueba de sandbox, introduzca el identificador de sandbox antes de iniciar sesión.

Un sandbox es un entorno de desarrollo aislado para su título, y cada cuenta de prueba de sandbox pertenece a uno. El identificador de sandbox no es el identificador de su oferta; obténgalo de quien haya creado sus cuentas de prueba. Para obtener más información, consulte Información general sobre los sandboxes de los servicios de XBOX. Si inició sesión sin el identificador de sandbox, cierre la sesión visitando otro sitio web de Microsoft, como outlook.com. A continuación, vuelva a iniciar sesión con el identificador de sandbox correcto. También puede abrir la configuración de desarrollador desde el catálogo de xbox.com/play. Seleccione su foto de perfil y, a continuación, seleccione Settings > Developer. Si no se muestra Developer, seleccione Account 10 veces en rápida sucesión para que aparezca. En la configuración de desarrollador, Developer Tools Home le devuelve a la página de herramientas de desarrollo.

​

Seleccionar una oferta

Las ofertas son los entornos de prueba privados que se usan para validar los juegos que se ejecutan en hardware de centros de datos. Para obtener más información sobre las ofertas, consulte Información general sobre el streaming de juegos. Para usar una oferta específica:

1. Vaya a xbox.com/play/dev-tools/select-offering.
2. Seleccione la oferta en la lista desplegable, o seleccione Custom offering ID e introduzca el identificador de la oferta en Enter offering ID for cloud connection.
3. Seleccione Connect.

Se abre el catálogo de su oferta y la página muestra Using custom offering seguido del identificador de la oferta. Si no puede acceder a la oferta, asegúrese de haber iniciado sesión con una cuenta que esté autorizada para usar esa oferta específica.

​

Regiones de las ofertas

Las ofertas no le enrutan automáticamente al centro de datos más cercano. Para realizar pruebas en otra región, abra Settings > Developer y elija una región en Streaming Region. Elíjala antes de iniciar una transmisión. Current region muestra su selección. Las regiones disponibles deben configurarse con antelación. Póngase en contacto con su representante de cuenta de Microsoft para ajustar las regiones disponibles de su oferta.

​

IP Connect

Use IP Connect para transmitir directamente desde un kit de desarrollo de XBOX mediante su dirección IP. En xbox.com/play, IP Connect requiere una cuenta de prueba de sandbox, y la página de herramientas de desarrollo no incluye un vínculo a esta característica. Antes de usar IP Connect, complete estos requisitos previos:

1. Configure su kit de desarrollo de XBOX para el streaming. Para obtener más información, consulte Configurar un kit de desarrollo de XBOX.
2. En Dev Home > Streaming, asegúrese de que Direct Connect esté escuchando. Deja de escuchar cada vez que se reinicia el kit.
3. Asegúrese de que su dispositivo cliente esté en la misma red que su kit de desarrollo de XBOX, o conectado a través de una VPN.
4. Asegúrese de que su red permita el tráfico TCP y UDP al puerto 9002 del kit de desarrollo de XBOX. El explorador usa una conexión WebSocket para la señalización y UDP para la transmisión.

Para conectarse mediante la dirección IP:

1. Vaya a xbox.com/play/dev-tools. Introduzca el identificador de sandbox y, a continuación, inicie sesión con una cuenta de prueba de ese sandbox.
2. Vaya a xbox.com/play/dev-tools/ip-connect.
3. Introduzca la dirección IP y el puerto del kit de desarrollo de XBOX, por ejemplo, 192.168.1.10:9002.
4. Seleccione Connect.
5. Si el explorador solicita permiso para acceder a dispositivos de su red local, seleccione Allow.

Cuando la conexión se realiza correctamente, la aplicación que se ejecuta en el kit de desarrollo de XBOX aparece en el explorador. Si ha iniciado sesión con una cuenta comercial, la dirección de IP Connect le devuelve a la página de herramientas de desarrollo.

​

Conexión remota

La conexión remota (Remote Connect) transmite desde su kit de desarrollo de XBOX a través de Internet mediante los servicios de juego remoto de XBOX. Encuentra el kit a través de la cuenta con la que ha iniciado sesión, por lo que no es necesario introducir una dirección IP. En primer lugar, configure el kit de desarrollo de XBOX:

1. Inicie sesión en el kit de desarrollo de XBOX con la cuenta que usará en xbox.com/play. La cuenta debe estar permitida en el sandbox del kit.
2. Vaya a Dev Home > Streaming. En Remote Connect, seleccione su cuenta.
3. En Dev Home > Streaming, asegúrese de que Direct Connect no esté escuchando. Direct Connect es un modo de conexión independiente para IP Connect y bloquea la conexión remota mientras está escuchando.

A continuación, conéctese desde xbox.com/play:

1. Vaya a xbox.com/play/dev-tools e inicie sesión con la misma cuenta. Para una cuenta de prueba de sandbox, introduzca el identificador de sandbox antes de iniciar sesión.
2. Seleccione Remote Connect. Está disponible cuando la cuenta con la que ha iniciado sesión tiene un kit de desarrollo configurado para la conexión remota, o cuando ha iniciado sesión con una cuenta de prueba de sandbox.
3. Busque su kit de desarrollo de XBOX en la lista y, a continuación, seleccione Connect.

​

Configuración de desarrollador

Para abrir la configuración de desarrollador, seleccione su foto de perfil y, a continuación, seleccione Settings > Developer. La configuración de desarrollador incluye la oferta actual y los valores de configuración de la transmisión. Información general sobre la configuración de la transmisión incluye más información sobre los valores de configuración de la transmisión específicos que se pueden invalidar. En Stream Configuration > Touch adaptation, puede establecer:

• Enable sideload: carga los diseños táctiles desde el comando serve de la CLI de TAK en lugar de los diseños publicados para su título.
• Sideload server address: la dirección del servidor de instalación local.
• Enable automatic refresh: actualiza los diseños en su dispositivo cuando los cambia en el servidor de instalación local.
• Emulate touch with mouse: trata los clics del mouse como toques.

​

Instalación local de TAK

Estos pasos tratan el streaming desde una oferta personalizada o un kit de desarrollo de XBOX. Para usar una oferta, consulte Seleccionar una oferta. Antes de empezar, ejecute tak serve en el PC que sirve sus diseños. Para realizar la instalación local desde el mismo PC que el explorador:

1. Abra Settings > Developer y busque Touch adaptation.
2. Active Enable sideload.
3. En Sideload server address, introduzca la dirección de su servidor de instalación local, por ejemplo, http://localhost:9269. Cualquier dirección distinta de localhost debe usar https, como se describe en Instalación local desde otro dispositivo.
4. En Network Status, compruebe Network Permission. Si muestra Required, seleccione Request Permission. Cuando el explorador le pida que permita al sitio Access other apps and services on this device, seleccione Allow.
5. En un PC sin pantalla táctil, active Emulate touch with mouse. Sin esta opción, la transmisión no muestra controles táctiles y el menú TAK no está disponible.
6. Cuando Server Connection muestre Connected, inicie una transmisión. Si muestra Not Reachable, asegúrese de que tak serve se esté ejecutando y, a continuación, seleccione Recheck.

Si cambia Enable sideload o Emulate touch with mouse durante una transmisión, se le pedirá que cambie de juego. Para confirmar que la transmisión usa sus diseños, búsquelos en Bundle layouts, como se describe en Cambiar los diseños de TAK durante una transmisión.

​

Instalación local desde otro dispositivo

Para realizar pruebas en un teléfono o una tableta, ejecute tak serve en un PC al que el dispositivo pueda acceder en su red local. El servidor debe usar https:

1. Cree un certificado. Para obtener más información, consulte Instrucciones para generar certificados.
2. En el PC, ejecute tak serve con las opciones --certificate-file y --certificate-password.
3. Instale el certificado en el teléfono o la tableta y márquelo como de confianza. Para ver los pasos, consulte Confiar en el certificado en distintos clientes.
4. En el teléfono o la tableta, abra Settings > Developer, active Enable sideload e introduzca https://<your PC's IP address>:9269 en Sideload server address.
5. Compruebe Network Permission y Server Connection, como se describe en los pasos 4 y 6 de Instalación local de TAK.

Para exigir una contraseña, use la opción --password e introduzca la misma contraseña en la configuración de desarrollador del dispositivo. Para obtener más información, consulte Comando serve.

​

Cambiar los diseños de TAK durante una transmisión

En el modo de desarrollador, puede cambiar el diseño activo mientras transmite:

1. En la transmisión, abra Developer Tools Menu en la esquina inferior izquierda y, a continuación, seleccione TAK.
2. En Select touch controls layout, seleccione un diseño en Bundle layouts o System layouts. Bundle layouts muestra los diseños cargados para esta transmisión. Cuando la instalación local funciona, esos son sus diseños.
3. Seleccione Close.

Los System layouts son Standard y Native Touch Only (Blank). Standard muestra la superposición del mando estándar. Native Touch Only (Blank) quita los controles táctiles.

​

Mouse y teclado

Antes de empezar, abra las herramientas de desarrollo tal como se describe en Abrir las herramientas de desarrollo.

1. En Settings > Developer, en Stream Configuration > Enabled input types, active Mouse and keyboard. Cambie esta configuración antes de iniciar una transmisión.
2. En Touch adaptation, desactive Emulate touch with mouse. Cuando ambas opciones están activadas, los clics del mouse se tratan como toques.
3. Inicie una transmisión.
4. Si aparece un banner con el texto Enter fullscreen mode to play with mouse and keyboard, seleccione Enter fullscreen.

Para liberar el mouse, pulse la tecla que se muestra en la notificación Press key to release your mouse.

​

Probar la nueva experiencia

Para cambiar a la nueva experiencia en play.xbox.com, seleccione su foto de perfil y, a continuación, seleccione Try the new experience > Try now. Para volver a xbox.com/play, abra Account settings desde su perfil y seleccione Exit preview.