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

Versión 2.0, 1/11/2025 Los títulos deben establecer uno o varios usuarios activos que funcionen como usuario o usuarios principales del título, y controlar dicho usuario o usuarios al reanudar desde la suspensión, la suspensión del sistema o la hibernación. En el GDK, los títulos lo hacen mediante el modelo de usuario simplificado o el modelo de usuario avanzado. Títulos con el modelo de usuario simplificado del GDK El modelo de usuario simplificado del GDK se encarga de la adquisición del usuario predeterminado en nombre del título. El título sigue siendo responsable de garantizar que se asigne un mando 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 abrir el cuadro de diálogo del sistema que permite seleccionar un mando y empezar a aceptar la entrada del jugador. Modelo de usuario avanzado del GDK En la activación inicial, los juegos pueden optar por determinar el usuario inicial en función de su diseño y sus preferencias, ya sea usando el usuario que inició el título o solicitando explícitamente un usuario. El título debe indicar los 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 de Microsoft Game Development Kit (GDK) que usan el modelo de usuario avanzado 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, la suspensión del sistema o la hibernación, el título debe validar el emparejamiento de usuario y mando y reaccionar en consecuencia, ya sea reanudando la sesión del usuario anterior o adquiriendo uno o varios usuarios nuevos.

​

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 llamando a XUserAddAsync(silent), que siempre devolverá un único resultado correspondiente al usuario que realiza el inicio. Modelo de usuario avanzado del GDK y aplicaciones multiusuario ERA y UWP Si el juego usa el usuario que inició el título:

• En el GDK, el usuario activo se puede determinar 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 silent. Esto mostrará un selector de cuentas al usuario.
• En ERA y UWP, el usuario activo se puede encontrar 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 en función de la selección de perfil del usuario.

Si se solicita un usuario:

• El título muestra una indicación de interacción y debe mostrar el selector de cuentas. El usuario se determina en función de la selección.
• En el GDK, el selector de cuentas se invoca mediante XUserAddAsync
• En 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 muestra el título quién es el usuario activo. Entre los procedimientos recomendados se incluye mostrar la imagen de jugador y el nombre para mostrar del usuario en la pantalla principal de la aplicación o en el menú del 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 por 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, ya sea durante el juego o fuera de él. Si el título usa el 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 la suspensión o el modo restringido Modelo de usuario simplificado del GDK La plataforma XBOX garantizará que el usuario que inició el juego inicialmente siga con la sesión iniciada activamente. El título puede registrarse para recibir notificaciones de cambios mediante UDA; si hay un cambio, debe usar ese mando recién vinculado para controlar el juego. Cualquier usuario adicional que participe en el juego deberá controlarse en consecuencia, de acuerdo con las siguientes instrucciones del modelo de usuario avanzado, al reanudar desde un estado suspendido o restringido. Modelo de usuario avanzado del GDK y aplicaciones multiusuario ERA y UWP Cuando un título se reanuda desde la suspensión o sale del modo restringido, el título debe validar el emparejamiento de usuario y mando y reaccionar en consecuencia:

• Si no hay cambios en el emparejamiento de usuario y 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 en un nuevo objeto User (lo que suele deberse a que 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 la sesión iniciada como sustituto del objeto User que cerró sesión. 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 ningún mando válido, 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 volver a establecer un usuario y un mando activo. Normalmente, los títulos lo hacen mostrando el selector de cuentas. Si se elige un nuevo usuario al volver a establecer 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 Usuarios

​

Casos de prueba de certificación

En la siguiente tabla se 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 y las aplicaciones multiusuario ERA y UWP.

​

112-02 Usuario y mando iniciales

Pasos de prueba

1. Inicie sesión con 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 la 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 como usuario activo el emparejamiento de mando y usuario que inició el título, mostrar una indicación de interacción para identificar el mando y el usuario, o mostrar el selector de cuentas para iniciar sesión. Ejemplos de aprobación

1. El título establece como usuario activo el emparejamiento de mando y usuario que inició el título.
2. El título muestra una indicación 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 la sesión iniciada.

​

112-03 Ningún usuario con la sesión iniciada

Pasos de prueba

1. Compruebe que no hay ningún usuario con la sesión iniciada.
2. Inicie el título y entre en todos los modos que admiten guardar datos de usuario.
3. Compruebe 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 muestra 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 aprobación

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 en el modo sin iniciar sesión.

Ejemplos de error

1. Mientras están 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 en ese modo 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 una pérdida de datos.

​

112-04 Indicación del usuario activo

Pasos de prueba

1. Inicie sesión con un perfil que no haya visto el título antes y que no tenga datos guardados asociados.
2. Inicie el título.
3. Compruebe que el título identifica al usuario activo en la interfaz de usuario antes de realizar cualquier acción relacionada con el perfil. Algunos ejemplos de “acción relacionada con el perfil” son modificar la partida guardada o las preferencias de un usuario, guardar datos en el perfil del usuario, conceder 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 una partida guardada.
5. Vuelva a iniciar el título y compruebe que el título identifica al usuario activo en 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 en la interfaz de usuario antes de realizar cualquier acción relacionada con el perfil.

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

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 prueba

1. Inicie sesión con 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 aprobación

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 prueba

1. Inicie sesión con 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 desde las que se pueda acceder al selector de cuentas.

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

1. El título notifica al usuario que cambiar el usuario activo podría provocar una pérdida de datos y le solicita confirmación antes de pasar 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 prueba

1. Inicie sesión con el perfil A e inicie el título.
2. En varias ubicaciones 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 con 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 que participaban anteriormente siguen con la sesión iniciada en la consola Ejemplos de aprobación

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 el perfil A del título o vuelve a establecer 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 el 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 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 2. Pasos de prueba

1. Inicie sesión con 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 con el perfil B.
4. Reanude el juego y compruebe que el juego reacciona en consecuencia al nuevo usuario activo.
5. Empiece a jugar con el nuevo usuario activo y compruebe que el usuario puede avanzar.

Resultado esperado

1. Cuando un juego se reanuda desde la suspensión, el juego debe comprobar si todos los usuarios que participaban anteriormente siguen con la sesión iniciada en la consola.

Ejemplos de aprobación

1. El juego cambia automáticamente el contexto del usuario activo al perfil B al reanudarse.
2. El juego quita automáticamente el perfil A del juego o vuelve a establecer 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 el 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.