​

XR-112: Establecimiento de un usuario y un mando durante la activación inicial y la reanudación *

Versión 2.0, 11/01/2025 Los títulos deben establecer uno o varios usuarios activos que funcionen como usuario o usuarios principales en el título, y controlar al usuario o usuarios al reanudarse desde los modos suspendido y restringido. Los títulos lo hacen en el GDK mediante el modelo de usuario simplificado o el avanzado. Títulos con el modelo de usuario simplificado del GDK El modelo de usuario simplificado del GDK controla la adquisición del usuario predeterminado en nombre del título. El título sigue siendo responsable de garantizar que haya un mando asignado al usuario y de usar ese mando para la entrada del juego. Si no hay ningún mando asignado al usuario predeterminado, el título debe usar XUserFindControllerForUserWithUiAsync para invocar el cuadro de diálogo del sistema para seleccionar un mando y comenzar a aceptar la entrada del jugador. Modelo de usuario avanzado del GDK, ERA y aplicaciones UWP multiusuario En la activación inicial, los juegos pueden elegir cómo determinar el usuario inicial según su diseño de juego y sus preferencias, usando al usuario que inició el título o solicitando explícitamente un usuario. El título debe indicar el usuario o usuarios activos antes de que se realice la primera acción relacionada con el perfil (como guardar el progreso o la configuración) en el perfil de ese usuario. Todos los títulos del Microsoft Game Development Kit (GDK) que usan el modelo de usuario avanzado, los títulos ERA y los títulos de aplicación UWP multiusuario (MUA) deben proporcionar un punto de entrada al selector de cuentas para cambiar el usuario activo. Cuando un título se reanuda desde la suspensión o el modo restringido, el título debe validar el emparejamiento usuario/mando y reaccionar en consecuencia reanudando la sesión del usuario anterior o adquiriendo un nuevo usuario o usuarios.

​

Más información

​

Establecimiento de usuarios durante la activación inicial

Modelo de usuario simplificado del GDK El usuario inicial se proporciona al título mediante una llamada a XUserAddAsync(silent), que siempre devolverá un único resultado para el usuario que realiza el inicio. Modelo de usuario avanzado del GDK, ERA y aplicaciones UWP multiusuario Si el juego usa al usuario que inició el título:

• Para el GDK, el usuario activo puede determinarse llamando a XUserAddAsync(silent). Si el sistema devuelve que no hay ningún usuario predeterminado presente, el título debe solicitar un usuario mediante XUserAddAsync sin la opción silenciosa. Esto mostrará un selector de cuentas al usuario.
• Para ERA y UWP, el usuario activo puede encontrarse en el usuario recomendado del contexto de activación de la aplicación (CoreApplicationContext.CurrentUser). Si el contexto de activación de la aplicación no ha proporcionado un usuario recomendado y el título realiza acciones relacionadas con el perfil, el título debe iniciar el selector de cuentas y establecer el usuario activo según la selección de perfil del usuario.

Si se solicita un usuario:

• El título muestra un aviso de interacción y debe mostrar el selector de cuentas. El usuario se determina según la selección.
• Para el GDK, el selector de cuentas se invoca mediante XUserAddAsync.
• Para ERA y UWP, el selector de cuentas se invoca mediante ShowAccountPickerAsync.

Si el usuario decide cancelar el inicio de sesión, el título debe notificar a los usuarios que su progreso no se guardará si continúan. Una vez que se ha elegido o identificado un usuario desde el inicio, el título muestra el gamertag antes de realizar cualquier acción relacionada con el perfil. No hay requisitos sobre cómo o dónde el título muestra quién es el usuario activo. Los procedimientos recomendados incluyen mostrar la imagen de jugador y el nombre para mostrar del usuario en la pantalla principal de la aplicación o en el menú de título del juego.

​

Establecimiento de mandos durante la activación inicial

Los juegos deben respetar la vinculación de mando y usuario establecida por el selector de cuentas o la plataforma cuando el juego se inicia con un usuario que ha iniciado sesión. La plataforma XBOX vinculará el mando a un jugador siempre que se seleccione un jugador en el selector de cuentas durante el juego o fuera de él. Si el título usa al usuario que inició el título, el título debe usar el mando asociado asignado a ese usuario para controlar el juego y la interacción.

​

Reanudación desde el modo suspendido o restringido

Modelo de usuario simplificado del GDK La plataforma XBOX garantizará que el usuario que inició el juego inicialmente siga teniendo la sesión iniciada de forma activa. El título puede registrarse para recibir notificaciones de cambio a través de UDA; si hay un cambio, use ese mando recién vinculado para controlar el juego. Cualquier usuario adicional en el juego deberá controlarse en consecuencia de acuerdo con la siguiente guía del modelo de usuario avanzado al reanudarse desde un estado suspendido o restringido. Modelo de usuario avanzado del GDK, ERA y aplicaciones UWP multiusuario Cuando un título se reanuda desde la suspensión o sale del modo restringido, el título debe validar el emparejamiento usuario/mando y reaccionar en consecuencia:

• Si no hay cambios en el emparejamiento usuario/mando, el título debe continuar.
• En ERA o UWP, si el usuario activo anterior de un título sigue con la sesión iniciada pero está en un nuevo objeto User (generalmente porque el usuario cerró sesión y volvió a iniciarla mientras el título estaba suspendido), el título debe usar el nuevo objeto User con sesión iniciada como reemplazo del objeto User cuya sesión se cerró. El uso debe continuar como si el usuario nunca hubiera cerrado sesión.
• Si todos los usuarios esperados están emparejados con un mando válido, pero diferente, el título debe actualizar y usar los nuevos emparejamientos de mando del sistema.
• Si el usuario esperado no tiene mandos válidos, el título debe establecer un mando activo para el usuario mediante el selector de cuentas.
• Si el jugador esperado no ha iniciado sesión, el título debe quitar al jugador del juego o restablecer un usuario y un mando activo. Los títulos suelen hacerlo mostrando el selector de cuentas. Si se elige un nuevo usuario como parte del restablecimiento de un usuario, los títulos deben usar el estado de ese nuevo usuario para el juego si el estado del juego se guarda por usuario.

​

Recursos adicionales

Para obtener información sobre la identidad del jugador con el GDK, lea la sección de usuarios de la documentación del GDK.

​

Casos de prueba de certificación

La siguiente tabla muestra qué casos de prueba de XR-112 se aplican a su título si usa el modelo de usuario simplificado del GDK o el modelo de usuario avanzado del GDK, ERA y aplicaciones UWP multiusuario.

​

112-02 Usuario y mando iniciales

Pasos de la prueba

1. Inicie sesión en el Perfil A e inicie el título.
2. Compruebe que el usuario activo puede controlar el título.
3. Repita el paso 1 sin ningún perfil con sesión iniciada y compruebe que el título solicita establecer un usuario activo.
4. Establezca el usuario activo y compruebe que el usuario puede controlar el título.

Resultado esperado Los títulos deben establecer el usuario activo según el emparejamiento mando/usuario que inició el título, o mostrar un aviso de interacción para identificar el mando y el usuario, o mostrar el selector de cuentas para iniciar sesión. Ejemplos de aprobado

1. El título establece el usuario activo según el emparejamiento mando/usuario que inició el título.
2. El título muestra un aviso de interacción para identificar el mando y el usuario.
3. El título muestra el selector de cuentas para iniciar sesión.

Ejemplos de error

1. El título no permite al usuario controlar el título con el primer mando usado.
2. El título no solicita al usuario que establezca un usuario activo cuando se inicia sin ningún usuario con sesión iniciada.

​

112-03 Sin usuario con sesión iniciada

Pasos de la prueba

1. Compruebe que ningún usuario tiene la sesión iniciada.
2. Inicie el título y entre en todos los modos que admitan el guardado de datos de usuario.
3. Valide que cada modo ofrece al usuario la oportunidad de iniciar sesión antes de que se produzca cualquier pérdida de datos.
4. Cancele la oportunidad de iniciar sesión y compruebe que el título proporciona una advertencia que indica que el progreso no se guardará.

Resultado esperado Los títulos deben ofrecer a los usuarios la oportunidad de iniciar sesión si el título está en un modo que normalmente guardaría datos de usuario o el estado del juego. Los títulos deben notificar a los usuarios que su progreso no se guardará si continúan jugando sin iniciar sesión. Ejemplos de aprobado

1. A un usuario que no ha iniciado sesión se le solicita que inicie sesión al acceder a un modo del título que normalmente guardaría datos de usuario o el estado del juego.
2. Se notifica al usuario que el progreso no se guardará si continúa sin iniciar sesión.

Ejemplos de error

1. Mientras se está en un modo que normalmente guarda datos de usuario o el estado del juego, no se notifica a los usuarios que el progreso no se guardará si continúan sin iniciar sesión.
2. Se notifica a los usuarios que no podrán guardar su progreso después de que ya se haya producido la pérdida de datos.

​

112-04 Indicación del usuario activo

Pasos de la prueba

1. Inicie sesión en un perfil que no haya visto el título antes y que no tenga datos de guardado asociados.
2. Inicie el título.
3. Compruebe que el título identifica al usuario activo dentro de la interfaz de usuario antes de realizar cualquier acción relacionada con el perfil. Algunos ejemplos de “acción relacionada con el perfil” incluyen modificar la partida guardada o las preferencias de un usuario, guardar datos en el perfil del usuario, otorgar logros, escribir estadísticas de un usuario o cualquier otro uso o manipulación local o en la nube de los datos o el estado del usuario.
4. Cree un guardado.
5. Vuelva a iniciar el título y compruebe que el título identifica al usuario activo dentro de la interfaz de usuario antes de realizar cualquier acción relacionada con el perfil.
6. Desconéctese de XBOX Live.
7. Vuelva a iniciar el título y compruebe que el título identifica al usuario activo dentro de la interfaz de usuario antes de realizar cualquier acción relacionada con el perfil.

Resultado esperado Los títulos deben indicar el contexto de usuario actual antes de la primera acción relacionada con el perfil. Ejemplos de aprobado

1. El título muestra el gamertag o la imagen de jugador del usuario dentro del título antes de realizar cualquier acción relacionada con el perfil.
2. Un título que no usa perfiles de usuario no indica el usuario activo.
3. Un título muestra varios usuarios activos en los modos de juego que admiten varios usuarios.

Ejemplos de error

1. El título no indica el usuario activo del título antes de realizar acciones relacionadas con el perfil.

​

112-05 Acceso al selector de cuentas

Pasos de la prueba

1. Inicie sesión en un perfil e inicie el título.
2. Confirme que el título permite al usuario activo acceder al selector de cuentas en el título y seleccionar un perfil diferente.

Resultado esperado Los títulos deben permitir a los usuarios acceder al selector de cuentas en el título para cambiar el usuario activo. Ejemplos de aprobado

1. El título permite al usuario acceder al selector de cuentas en el título.

Ejemplos de error

1. El título no permite al usuario acceder al selector de cuentas en el título.

​

112-06 Control del cambio de perfil

Pasos de la prueba

1. Inicie sesión en un perfil e inicie el título.
2. Acceda al selector de cuentas y seleccione un perfil diferente.
3. Compruebe que el título reacciona adecuadamente y cambia el contexto del usuario activo al nuevo perfil.
4. Repita los pasos 1 a 4 en todas las ubicaciones del título donde haya acceso al selector de cuentas.

Resultado esperado Los títulos deben permitir a los usuarios cambiar sin problemas al contexto de otro usuario. Ejemplos de aprobado

1. El título notifica al usuario que cambiar el usuario activo podría provocar la pérdida de datos y solicita la confirmación del usuario antes de continuar al selector de cuentas.
2. El título se actualiza adecuadamente al contexto del nuevo usuario activo.

Ejemplos de error

1. El título no se actualiza adecuadamente al contexto del nuevo usuario activo.

​

112-07 Cambio de usuario durante el modo restringido

Pasos de la prueba

1. Inicie sesión en el perfil A e inicie el título.
2. En varias ubicaciones dentro del título, presione el botón XBOX para restringir el título.
3. Mientras el título está restringido, cierre la sesión del Perfil A e inicie sesión en el perfil B.
4. Reanude el título.
5. Compruebe que el título reacciona en consecuencia al nuevo usuario activo.

Resultado esperado Cuando un título se reanuda desde el modo restringido, el título debe comprobar si todos los usuarios previamente implicados siguen con la sesión iniciada en la consola. Ejemplos de aprobado

1. Una aplicación cambia automáticamente el contexto del usuario activo al Perfil B al reanudarse.
2. Un título de juego quita automáticamente al Perfil A del título o restablece un nuevo usuario y usa el estado de ese nuevo usuario para el juego.

Ejemplos de error

1. Los títulos no se actualizan para quitar al perfil A del contexto como usuario activo.
2. Un juego sigue usando el estado del Perfil A para el juego después de seleccionar un nuevo perfil.

​

112-08 Cambio de usuario 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 2. Pasos de la prueba

1. Inicie sesión en un perfil de XBOX e inicie el juego.
2. En varias ubicaciones a lo largo del juego, suspenda el juego.
3. Mientras el juego está suspendido, cierre la sesión del perfil A e inicie sesión en el perfil B.
4. Reanude el juego y compruebe que el juego reacciona en consecuencia al nuevo usuario activo.
5. Entre en el juego con el nuevo usuario activo y compruebe que el usuario puede progresar.

Resultado esperado Cuando un juego se reanuda desde la suspensión, el juego debe comprobar si todos los usuarios previamente implicados siguen con la sesión iniciada en la consola. Ejemplos de aprobado

1. El juego cambia automáticamente el contexto del usuario activo al perfil B al reanudarse.
2. El juego quita automáticamente al perfil A del juego o restablece un nuevo usuario y usa el estado de ese nuevo usuario para el juego.

Ejemplos de error

1. El juego no se actualiza para quitar al perfil A del contexto como usuario activo.
2. El juego sigue usando el estado del perfil A para el juego después de seleccionar un nuevo perfil.