Saltar al contenido principal
Versión 2.0, 1/11/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 dejar de responder 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 usando los servicios en la nube.

Control de problemas con servicios que no son de XBOX

Los títulos que encuentren problemas con servicios de asociados, como tiempos de espera no transitorios, errores de la API de red o una configuración de servicio que falta y que afecta a la experiencia del usuario, deben avisar al usuario de la característica o el servicio concreto que no está disponible. Los títulos deben pasar correctamente a un estado seguro mientras el usuario soluciona el problema, o a un estado en el que el usuario pueda reintentarlo manualmente. Un ejemplo de mensaje fácil de entender es:
“Lo sentimos, servicio que no es de Microsoft no está disponible en este momento. Inténtelo de nuevo más tarde. Para obtener más información, póngase en contacto con información de contacto del soporte técnico que no es de Microsoft.”

Control de problemas con los servicios de XBOX

Algunas funcionalidades podrían dejar de estar disponibles si se pierde la conectividad con un servicio de XBOX. En esos casos, los títulos deben usar mensajes claros y fáciles de entender para comunicarlo a los usuarios. Si un servicio no está disponible, los títulos pueden reintentar su solicitud, pero solo dentro de los parámetros permitidos por XBOX. Para obtener más información sobre la resistencia del servicio para los títulos de consolas XBOX, incluida la lógica obligatoria de reintento y retroceso HTTP, así como instrucciones de interacción con el usuario para servicios individuales, consulte Resistencia de los títulos ante interrupciones del servicio

Requerir conectividad con XBOX

Al desarrollar para consolas XBOX, los títulos que requieren conectividad a Internet (o a XBOX, en concreto) para la mayor parte de su funcionalidad pueden incluir la marca booleana RequireXboxLive en su manifiesto de 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 Redes.

Casos de prueba de certificación

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

Pasos de prueba
  1. Inicie sesión con 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 enlace ascendente del dispositivo de red. Si el dispositivo está conectado mediante Wi-Fi, desconecte el cable de enlace ascendente de la conexión del punto de acceso inalámbrico:
    • Crear un nuevo punto de guardado
    • Cargar un punto de guardado
    • Llegar a 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 acceder a los servicios de XBOX, el título debe responder con un mensaje de error fácil de entender.
Ejemplos de aprobación
  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 de 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 sin conexión.
  2. El título entra en un estado inestable o deja de responder.

074-02 Desconexión directa

Pasos de prueba
  1. Inicie el título e inicie sesión con 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.
    • Llegar a 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.
Ejemplos de aprobación
  1. El título muestra un mensaje fácil de entender mientras está en un 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 de 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 inestable o deja de responder.
  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 suspende en las siguientes condiciones:
  • Cuando la consola entra en Espera conectada al apagarse con el modo de energía establecido en Inicio instantáneo.
  • Cuando el juego permanece sin foco durante diez minutos. Por ejemplo, al iniciar una aplicación como Configuración y mantenerla con el foco durante diez minutos.
A efectos de este caso de prueba, se deben comprobar ambos métodos en el paso 3. Pasos de prueba
  1. Inicie sesión con un perfil de XBOX con el modo de energía de la consola establecido en Inicio instantáneo.
  2. Inicie el juego y avance hasta la fase de juego.
  3. En varios momentos a lo largo del juego, suspenda el juego.
  4. Reanude el juego y compruebe que el juego controla correctamente la desconexión.
  5. Repita los pasos 3 y 4 a lo largo del juego.
Resultado esperado
En caso de que la consola no pueda acceder a los servicios de XBOX después de haberse suspendido, el título debe reanudarse correctamente, controlar la situación adecuadamente y responder con un mensaje de error fácil de entender cuando corresponda.
Ejemplos de aprobación
  1. Durante una sesión multijugador de XBOX en línea, 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 sin conexión.
  2. El título entra en un estado inestable o deja de responder.
  3. El título muestra un mensaje de error engañoso o incorrecto después de reanudarse.

074-04 Reconexión a los servicios de XBOX durante la suspensión

En las consolas comerciales, un juego se suspende en las siguientes condiciones:
  • Cuando la consola entra en Espera conectada al apagarse con el modo de energía establecido en Inicio instantáneo.
  • Cuando el juego permanece sin foco durante diez minutos. Por ejemplo, al iniciar una aplicación como Configuración y mantenerla con el foco durante diez minutos.
A efectos de este caso de prueba, se deben comprobar ambos métodos en el paso 3. Pasos de prueba
  1. Inicie sesión con un perfil de XBOX con el modo de energía de la consola establecido en Inicio instantáneo y asegúrese de que la consola está en Inicio.
  2. Sin conexión con XBOX pero manteniendo una conexión de red local, inicie el título.
    • Si usa un conmutador o concentrador Ethernet, desconecte el cable de enlace ascendente del dispositivo de red.
    • Si el dispositivo está conectado mediante Wi-Fi, desconecte el cable de enlace ascendente del punto de acceso inalámbrico.
  3. En varios momentos a lo largo del juego, suspenda el juego.
  4. Vuelva a conectar el cable de enlace ascendente 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 correctamente la reconexión.
  6. Repita los pasos 2 a 5 a lo largo del juego.
Resultado esperado
En caso de que la consola no pueda acceder a los servicios de XBOX después de haberse suspendido, el título debe reanudarse correctamente, controlar la situación adecuadamente y responder con un mensaje de error fácil de entender cuando corresponda.
Ejemplos de aprobación
  1. El usuario puede reanudar el título y completar una sesión de juego de XBOX sin conexión sin interrupciones.
  2. El título permanece estable y no se bloquea.
Ejemplos de error
  1. El usuario no puede completar una sesión de juego de XBOX sin conexión.
  2. El título entra en un estado inestable o deja de responder.
  3. El título muestra un mensaje de error engañoso o incorrecto después de reanudarse.

074-07 Pérdida dinámica de conectividad

Herramientas necesarias: Configurar XMAT para bloquear los servicios de asociados Para obtener instrucciones de instalación, configuración de capturas y scripting, consulte Usar XBOX Multiplayer Analysis Tool para inspeccionar y modificar el tráfico de red.
  1. Inicie XMAT como administrador y agregue una captura de Web Proxy para el dispositivo en prueba.
    • En una consola de desarrollo XBOX, seleccione Enable XBOX Proxy y espere a que la consola se reinicie.
    • En Windows, seleccione Start Capture.
  2. Con XMAT capturando, inicie el título y recorra todos los menús, complete una sesión multijugador, cargue todos los modos de juego y recorra todas las áreas del título, entre ellas:
    • Menús.
    • Tablas de clasificación.
    • Servidores (cree uno y únase al de otra persona).
    • Listas de amigos.
    • Tiendas dentro del título.
    • Eventos por tiempo limitado.
  3. Use el filtro Host para identificar los hosts de servicios de asociados con los que se establece contacto durante el juego normal. Confirme que los hosts seleccionados no pertenecen a Microsoft, XBOX ni PlayFab antes de bloquearlos.
  4. Abra el Script Editor, seleccione el evento SSL Connection Request y cree un script que establezca Params.Continue en false para cada host de servicio de asociado.
  5. Habilite el script y compruebe que se compila correctamente. A continuación, deshabilite el script para que los servicios de asociados sigan disponibles cuando comience la prueba. Mantenga la captura de XMAT en ejecución.
Pasos de prueba
  1. Con el script de bloqueo de XMAT deshabilitado, inicie sesión con un perfil de XBOX e inicie el título.
  2. Vaya a una característica del título que use un servicio hospedado por un asociado y confirme que la característica está disponible.
  3. Sin cerrar el título, habilite el script de bloqueo de XMAT.
  4. Continúe por el título y use todas las áreas aplicables, entre ellas:
    • 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
  5. 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 servicios que no son de Microsoft.
Ejemplos de aprobación
  1. El título no deja de responder ni se bloquea al perder la conectividad con 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 poco 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: Pasos de prueba
  1. En las consolas, cree un canal de red interrumpido con xbstress.exe para el tráfico que no es de Microsoft mediante el comando:
xbstress set channel=0 network=broken addresses=[semicolon delimited list of addresses]
  1. Inicie la simulación de red con el comando: xbstress simulate network=channels.
  2. Si realiza la prueba en Windows, configure una captura de proxy web de XMAT y habilite un script que bloquee los hosts de servicios de asociados aplicables antes de iniciar el título.
  3. Inicie sesión con un perfil de XBOX.
  4. Inicie el título.
  5. Acceda a una característica en línea que no sea de Microsoft.
Resultado esperado
Los títulos deben proporcionar un mensaje de error fácil de entender que indique que hay un problema para acceder al servicio que no es de Microsoft y deben ofrecer la oportunidad de reintentar la conexión.
Ejemplos de aprobación
  1. El título no deja de responder ni se bloquea al perder la conectividad con el servicio hospedado por un 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 poco descriptivo.
  3. El título se bloquea, se vuelve inestable o provoca el reinicio de la consola.
Última modificación el 20 de octubre de 2026