​

XR-074: Pérdida de conectividad con XBOX y los servicios de asociados *

Versión 2.0, 11/01/2025 Los títulos deben controlar correctamente los errores de conectividad con XBOX y los servicios de asociados. Los títulos deben respetar las directivas de reintento establecidas por XBOX al intentar reintentar una solicitud al servicio de XBOX después de que se haya producido un error. Los títulos deben administrar adecuadamente los mensajes al usuario cuando los servicios no estén disponibles. Si un servicio de asociado no está disponible, el juego no debe indicar que hay un problema con la red de XBOX. Los títulos no deben bloquearse ni colgarse si los servicios de red se ralentizan o están disponibles de forma intermitente.

​

Más información

Los títulos deben reaccionar al rendimiento de sus propias operaciones de red o usar las API de calidad de red de Windows.Xbox.Networking para determinar las condiciones de red actuales. También deben degradarse correctamente transfiriendo menos datos, eligiendo roles de usuario adecuados o aprovechando los servicios en la nube.

​

Control de problemas con servicios que no son de XBOX

Los títulos que encuentren problemas con los servicios de asociados, como tiempos de espera no transitorios, errores de API de red o falta de configuración del servicio que afecte a la experiencia del usuario, deben alertar al usuario sobre la característica o el servicio específico que no está disponible. Los títulos deben degradarse correctamente a un estado seguro mientras el usuario soluciona el problema, o a un estado en el que el usuario pueda reintentar manualmente. Un ejemplo de mensaje fácil de entender para el usuario es:

“Lo sentimos, servicio ajeno a Microsoft no está disponible actualmente. Vuelva a intentarlo más tarde. Para obtener más información, póngase en contacto con información de contacto del soporte técnico ajeno a Microsoft”.

​

Control de problemas con los servicios de XBOX

Es posible que algunas funcionalidades dejen de estar disponibles si se pierde la conectividad con un servicio de XBOX. En tales casos, los títulos deben usar mensajes claros y fáciles de entender para comunicárselo a los usuarios. Si un servicio no está disponible, los títulos pueden reintentar su solicitud, pero solo pueden hacerlo dentro de los parámetros permitidos por XBOX. Para obtener más información sobre la resiliencia de los servicios para los títulos de consola XBOX, incluida la lógica obligatoria de reintento HTTP y retroceso, así como la guía de interacción con el usuario para servicios individuales, consulte la documentación sobre resiliencia ante interrupciones del servicio para títulos en el GDK.

​

Exigir conectividad con XBOX

Al desarrollar para consolas XBOX, los títulos que requieran conectividad a Internet (o a XBOX, en particular) para la mayoría de su funcionalidad pueden incluir la marca booleana RequireXboxLive en su manifiesto AppX. Esto impedirá que el título se inicie en la consola XBOX cuando XBOX no esté disponible, y suspenderá y, posteriormente, finalizará el título si se pierde la conectividad. Para obtener información sobre las redes con el GDK, lea la sección de redes de la documentación del GDK.

​

Casos de prueba de certificación

​

074-01 Desconexión de WAN de los servicios de XBOX

Pasos de la prueba

1. Inicie sesión en un perfil de XBOX.
2. Mientras realiza las siguientes acciones, desconecte la red WAN. Si usa un conmutador o concentrador Ethernet, desconecte el cable de subida del dispositivo de red. Si el dispositivo está conectado por Wi-Fi, desconecte el cable de subida de la conexión del punto de acceso inalámbrico:
   • Crear un nuevo punto de guardado
   • Cargar un punto de guardado
   • Alcanzar un punto de guardado automático
   • Enumerar una lista de partidas guardadas
   • Buscar una sesión en línea y unirse a ella
   • Intentar crear una sesión en línea
   • Ver una tabla de clasificación (si procede)
   • Jugar sin conexión

Resultado esperado En caso de que la consola no pueda conectarse a los servicios de XBOX, el título debe responder con un mensaje de error fácil de entender para el usuario. Ejemplos de aprobado

1. El título muestra un mensaje de error que indica la pérdida de conexión de red con los servicios de XBOX.
2. El título no muestra un mensaje de error mientras se juega en un modo de juego local que no requiere los servicios de XBOX.
3. Un título con RequireXboxLive en el manifiesto AppX se suspende y, a continuación, finaliza cuando se pierde la conectividad.

Ejemplos de error

1. El usuario no puede completar una sesión de juego de XBOX que no es en línea.
2. El título entra en un estado sin respuesta o inestable.

​

074-02 Desconexión directa

Pasos de la prueba

1. Inicie el título e inicie sesión en un perfil de XBOX.
2. Mientras realiza las siguientes acciones en el título, desconecte el cable de red del dispositivo o apague el WAP o el enrutador inalámbrico:
   • Crear un nuevo punto de guardado.
   • Cargar un punto de guardado.
   • Alcanzar un punto de guardado automático.
   • Enumerar una lista de partidas guardadas.
   • Buscar una sesión en línea y unirse a ella.
   • Intentar crear una sesión en línea.
   • Ver una tabla de clasificación (si procede).
   • Jugar sin conexión.

Resultado esperado En caso de que el dispositivo pierda la conexión con los servicios de XBOX, el título debe responder con un mensaje de error fácil de entender para el usuario. Ejemplos de aprobado

1. El título muestra un mensaje fácil de entender mientras está en el modo de juego en línea.
2. El título no interrumpe el juego durante el modo de juego sin conexión.
3. Un título con RequireXboxLive en el manifiesto AppX se suspende y, a continuación, finaliza cuando se pierde la conectividad.

Ejemplos de error

1. Se muestra un mensaje de error durante el modo de juego sin conexión.
2. El título entra en un estado sin respuesta o inestable.
3. El usuario puede ver menús en línea o contenido multimedia almacenado en búfer después de que la red se desconecte.

​

074-03 Desconexión de los servicios de XBOX durante la suspensión

En las consolas comerciales, un juego se suspenderá en las siguientes condiciones:

• Cuando la consola entre en modo de espera conectado al apagarla con el modo de energía establecido en encendido instantáneo.
• Cuando el juego permanezca fuera del foco durante diez minutos. Por ejemplo, al iniciar una aplicación como Configuración y mantenerla en el foco durante diez minutos.

Para los fines de este caso de prueba, deben comprobarse ambos métodos en el paso 3. Pasos de la prueba

1. Inicie sesión en un perfil de XBOX con el modo de energía de la consola establecido en encendido instantáneo.
2. Inicie el juego y progrese hasta el juego activo.
3. En varios puntos a lo largo del juego, suspenda el juego.
4. Reanude el juego y compruebe que el juego controla la desconexión correctamente.
5. Repita los pasos 3 y 4 a lo largo del juego.

Resultado esperado En caso de que la consola no pueda conectarse a los servicios de XBOX después de haber sido suspendida, el título debe reanudarse correctamente, controlar la situación adecuadamente y responder con un mensaje de error fácil de entender cuando proceda. Ejemplos de aprobado

1. Durante una sesión multijugador en línea de XBOX, el título muestra un mensaje de error que indica la pérdida de conexión de red con los servicios de XBOX.
2. El título no muestra un mensaje de error mientras se juega en un modo de juego local que no requiere los servicios de XBOX.

Ejemplos de error

1. El usuario no puede completar una sesión de juego de XBOX que no es en línea.
2. El título entra en un estado sin respuesta o inestable.
3. El título muestra un mensaje de error engañoso o incorrecto después de reanudarse.

​

074-04 Reconexión al servicio de XBOX durante la suspensión

En las consolas comerciales, un juego se suspenderá en las siguientes condiciones:

• Cuando la consola entre en modo de espera conectado al apagarla con el modo de energía establecido en encendido instantáneo.
• Cuando el juego permanezca fuera del foco durante diez minutos. Por ejemplo, al iniciar una aplicación como Configuración y mantenerla en el foco durante diez minutos.

Para los fines de este caso de prueba, deben comprobarse ambos métodos en el paso 3. Pasos de la prueba

1. Inicie sesión en un perfil de XBOX con el modo de energía de la consola establecido en encendido instantáneo y asegúrese de que la consola esté en Inicio.
2. Sin conexión a XBOX pero conservando una conexión de red local, inicie el título.
   • Si usa un conmutador o concentrador Ethernet, desconecte el cable de subida del dispositivo de red.
   • Si el dispositivo está conectado por Wi-Fi, desconecte el cable de subida del punto de acceso inalámbrico.
3. En varios puntos a lo largo del juego, suspenda el juego.
4. Vuelva a conectar el cable de subida y espere a que la consola se vuelva a conectar a los servicios de XBOX.
5. Reanude el juego y compruebe que el juego controla la reconexión correctamente.
6. Repita los pasos 2 a 5 a lo largo del juego.

Resultado esperado En caso de que la consola no pueda conectarse a los servicios de XBOX después de haber sido suspendida, el título debe reanudarse correctamente, controlar la situación adecuadamente y responder con un mensaje de error fácil de entender cuando proceda. Ejemplos de aprobado

1. El usuario puede reanudar el título y completar una sesión de juego de XBOX sin conexión y sin interrupciones.
2. El título se mantiene estable y no se bloquea.

Ejemplos de error

1. El usuario no puede completar una sesión de juego de XBOX que no es en línea.
2. El título entra en un estado sin respuesta o inestable.
3. El título muestra un mensaje de error engañoso o incorrecto después de reanudarse.

​

074-05 Ancho de banda bajo constante

Herramientas necesarias

• xbstress.exe del GDK/XDK.

Configuración La simulación de red se controla mediante la herramienta de esfuerzo de línea de comandos xbstress.exe. Esta herramienta configura diversos factores de esfuerzo de la consola, incluida la simulación de red. Para fines de red, xbstress.exe controla un controlador especializado en el dispositivo XBOX que descarta paquetes, inyecta latencia y limita el rendimiento. xbstress.exe tiene tres perfiles de simulación preconfigurados que le permiten simular fácilmente escenarios de red importantes: mínimo, medio y excelente. El perfil mínimo corresponde a este XR. Pasos de la prueba

1. Con el perfil mínimo, limite la conectividad a los requisitos operativos mínimos del dispositivo XBOX.
2. Realice acciones en línea relacionadas con el título, incluidas, entre otras:
   • Navegar por todos los menús.
   • Jugar una sesión de juego en línea.

Resultado esperado Los títulos no deben bloquearse ni provocar la pérdida de datos del usuario cuando la conexión a Internet de un usuario cae por debajo de 192 Kbps. Ejemplos de aprobado

1. Se muestra un mensaje fácil de entender que indica el posible impacto en el juego en línea debido al ancho de banda bajo.
2. El título no se bloquea y no provoca una pérdida de datos del usuario.

Ejemplos de error

1. El título se bloquea o provoca la pérdida de datos del usuario.

​

074-06 Ancho de banda bajo variable

Herramientas necesarias

• xbstress.exe del GDK/XDK.

Configuración La simulación de red se controla mediante la herramienta de esfuerzo de línea de comandos xbstress.exe. Esta herramienta configura diversos factores de esfuerzo de la consola, incluida la simulación de red. Para fines de red, xbstress.exe controla un controlador especializado en el dispositivo XBOX que descarta paquetes, inyecta latencia y limita el rendimiento. xbstress.exe tiene tres perfiles de simulación preconfigurados que le permiten simular fácilmente escenarios de red importantes: mínimo, medio y excelente. El perfil mínimo corresponde a este XR. Pasos de la prueba

1. Deshabilite todas las restricciones de red en xbstress.exe.
2. Realice acciones en línea relacionadas con el título, incluidas, entre otras:
   • Navegar por todos los menús.
   • Jugar una sesión de juego en línea.
3. Mientras realiza el paso 2, habilite el perfil mínimo de xbstress.

Resultado esperado Los títulos no deben bloquearse ni provocar la pérdida de datos del usuario cuando la conexión a Internet de un usuario cae por debajo de 192 Kbps. Ejemplos de aprobado

1. Se muestra un mensaje fácil de entender que indica el posible impacto en el juego en línea debido al ancho de banda bajo.
2. El título no se bloquea y no provoca una pérdida de datos del usuario.

Ejemplos de error

1. El título se bloquea o provoca la pérdida de datos del usuario.

​

074-07 Pérdida de conectividad dinámica

Herramientas necesarias

• Fiddler Classic con el complemento Content Blocking.

Configure Fiddler Classic para bloquear los servicios de asociados mediante el complemento Content Blocking

• En la consola, configure Fiddler para depurar las llamadas a servicios web.
• En el PC, configure Fiddler para depurar las llamadas a servicios web.
• Instale el complemento Content Blocking para Fiddler.
• En Fiddler, seleccione el menú ContentBlock y “Enabled”.

Pasos de la prueba

1. Inicie sesión en un perfil de XBOX e inicie el título.
2. Complete una sesión multijugador, cargue todos los modos de juego y navegue por todas las áreas del título, incluidas, entre otras:
   • Menús
   • Tablas de clasificación
   • Servidores (cree uno y únase al de otra persona)
   • Lista de amigos
   • Tienda dentro del título
   • Eventos por tiempo limitado
3. Compruebe que el título no muestra un mensaje de error que indique un problema con la red de XBOX.

Resultado esperado El título controla correctamente las desconexiones de los servicios ajenos a Microsoft. Ejemplos de aprobado

1. El título no se cuelga ni se bloquea al perder la conectividad con los servicios hospedados por asociados.

Ejemplos de error

1. El mensaje mostrado da a entender que hay problemas con los servicios de Microsoft.
2. Se muestra un mensaje de error no descriptivo.
3. El título se bloquea, se vuelve inestable o provoca el reinicio de la consola.

​

074-08 Tiempo de inactividad previo al inicio

Herramientas necesarias

• xbstress.exe del GDK/XDK.
• Para Windows 10, Fiddler Classic.

Pasos de la prueba

1. En las consolas, cree un canal de red interrumpido con xbstress.exe para el tráfico ajeno a Microsoft mediante el comando: xbstress set channel=0 network=broken addresses=[semicolon delimited list of addresses]
2. Inicie la simulación de red con el comando: xbstress simulate network=channels.
3. Si realiza las pruebas en Windows 10, use Fiddler para emular el tiempo de inactividad.
4. Inicie sesión en un perfil de XBOX.
5. Inicie el título.
6. Acceda a una característica en línea ajena a Microsoft.

Resultado esperado Los títulos deben proporcionar un mensaje de error fácil de entender que indique que hay un problema para conectarse al servicio ajeno a Microsoft y deben ofrecer la oportunidad de reintentar la conexión. Ejemplos de aprobado

1. El título no se cuelga ni se bloquea al perder la conectividad con el servicio hospedado por el asociado.

Ejemplos de error

1. El error mostrado da a entender que hay problemas con el servicio de Microsoft.
2. Se muestra un mensaje de error no descriptivo.
3. El título se bloquea, se vuelve inestable o provoca el reinicio de la consola.