> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XR-115 Adición y eliminación de usuarios o mandos durante el juego

> XR-115 exige que los títulos multiusuario controlen los eventos de adición y eliminación de mandos y usuarios durante el juego, conservando el estado y devolviendo a los jugadores al juego.

# XR-115: Adición y eliminación de usuarios o mandos durante el juego \*

Versión 1.1, 05/01/2021

Los títulos que admiten varios usuarios deben responder a la adición y eliminación de usuarios, o a los escenarios en los que un jugador activo no tiene ningún mando asignado o se produce una pérdida de mando durante el juego, de la siguiente manera:

**Adición de mando:** una vez que los títulos han seleccionado o se les ha proporcionado el usuario y el mando iniciales, los títulos pueden aceptar opcionalmente la entrada de otros mandos. Los títulos que admiten experiencias multijugador deben considerar cómo se agrega un jugador o mando adicional al juego y se vincula a un usuario con `XUserAddAsync`. Por ejemplo, "Presiona A para unirte" o mostrando la silueta de un mando en una pantalla de selección de jugador.

**Eliminación de mando:** si el mando del jugador que controla el juego se quita durante el juego, los títulos deben permitir el restablecimiento de un nuevo mando activo (por ejemplo, "Presiona A para continuar" o recibiendo un evento `ControllerPairingChanged` en ERA o `XUserDeviceAssociationChangedCallback` en el GDK para el usuario activo con un mando válido). Los títulos también pueden invocar la experiencia de usuario del sistema mediante `XUserFindControllerForUserWithUiAsync` para solicitar al usuario que empareje un mando con su usuario y vuelva al juego.

**Adición de usuario:** al usar ERA o UWP, si un nuevo usuario inicia sesión, el título puede agregar al usuario al título si el título admite una experiencia multiusuario, pero el título no debe cambiar automáticamente el usuario activo al nuevo usuario ni interrumpir la experiencia de los usuarios activos basándose en un evento de inicio de sesión de un nuevo usuario.

Al usar el GDK (con el modelo de usuario simplificado o el avanzado), los usuarios solo se agregan cuando el título llama a `XUserAddAsync`.

**Eliminación del usuario principal:** para los títulos que usan ERA o el modelo de usuario avanzado del GDK, si el usuario principal cierra sesión (a través de la guía, SPOP u otros medios), el título debe quitar al jugador del juego o restablecer un usuario y un mando activo.

Para los títulos que usan el modelo de usuario simplificado del GDK, la eliminación del jugador principal hará que el título se suspenda a nivel de sistema.

En todos los escenarios, los títulos controlan la eliminación o el cierre dejando el juego en un buen estado. Esto incluye escribir en el almacenamiento conectado, notificar a las sesiones de MPSD pertinentes que el usuario se ha ido y llevar al usuario a un lugar apropiado para iniciar sesión si tampoco se ha agregado un nuevo usuario.

**Eliminación de usuarios adicionales o secundarios:** los títulos pueden controlar este evento a su discreción, normalmente quitando al jugador del juego inmediatamente o solicitándole que vuelva a unirse en el contexto de la experiencia multijugador que se esté usando.

## Guía de implementación y procedimientos recomendados

Un procedimiento recomendado es pausar el juego cuando se quita el mando de un jugador activo.

Cuando los usuarios activos cierran sesión, el procedimiento recomendado es guardar todo el progreso del usuario que sea posible, de modo que cuando los usuarios vuelvan a la experiencia estén prácticamente donde lo dejaron.

Si un título admite varios usuarios con sesión iniciada, cuando un usuario activo cierra sesión y otros usuarios activos siguen con la sesión iniciada, el procedimiento recomendado es permitir que los demás usuarios activos continúen la experiencia actual en la medida de lo posible. En los juegos, el usuario que cerró sesión podría quitarse por completo del juego o reemplazarse por un jugador controlado por el equipo.

## Recursos adicionales

## Casos de prueba de certificación

La siguiente tabla muestra qué casos de prueba de XR-115 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.

| Casos de prueba                | Aplicable al modelo de usuario simplificado del GDK | Aplicable al modelo de usuario avanzado del GDK, ERA y MUA de UWP |
| ------------------------------ | --------------------------------------------------- | ----------------------------------------------------------------- |
| 115-01 Adición de usuarios     | No                                                  | Sí \*                                                             |
| 115-02 Eliminación de mandos   | Sí                                                  | Sí                                                                |
| 115-03 Eliminación de usuarios | No                                                  | Sí                                                                |

\* **115-01 Adición de usuarios** solo se aplica a ERA y a las aplicaciones UWP multiusuario. Con el GDK, los títulos solo pueden ver los usuarios que han agregado intencionadamente. Los usuarios agregados a través del shell son desconocidos para el título del GDK.

### 115-01 Adición de usuarios

**Pasos de la prueba**

1. Inicie sesión en el Perfil A y asegúrese de que no haya otros perfiles con sesión iniciada.
2. Inicie el título y progrese hasta el juego activo.
3. En varios puntos durante el uso del título, conecte un segundo mando e inicie sesión en el Perfil B.
4. El Perfil B intenta proporcionar entrada de mando al título.

**Resultado esperado**

Los títulos ERA o MUA de UWP no deben interrumpir automáticamente la experiencia del usuario activo.

**Ejemplos de aprobado**

1. Los títulos no cambian automáticamente el usuario activo al nuevo usuario ni interrumpen la experiencia del usuario activo.
2. Los títulos de juego pueden optar por permitir que el Perfil B controle el título según el contexto actual.

**Ejemplos de error**

1. El título cambia inmediatamente el contexto al Perfil B como usuario activo.

### 115-02 Eliminación de mandos

**Pasos de la prueba**

1. Inicie sesión en un perfil e inicie el título.
2. En varios puntos durante el uso del título, quite las pilas del mando.
3. Vuelva a colocar las pilas en el mando y compruebe que el usuario puede seguir usando el título.
4. Repita los pasos 1 a 3, pero conecte un segundo mando en lugar de volver a colocar las pilas.

**Resultado esperado**

Los títulos deben responder correctamente a la eliminación y adición de mandos.

**Ejemplos de aprobado**

1. El usuario activo debe poder seguir usando el título tras la eliminación o adición de un mando.
2. Se solicita al usuario que restablezca un nuevo mando activo (por ejemplo, "Presiona A para continuar" o invocando la experiencia de usuario del sistema).

**Ejemplos de error**

1. Los usuarios no pueden seguir usando un título tras la eliminación de un mando.

### 115-03 Eliminación de usuarios

**Pasos de la prueba**

1. Inicie sesión en el Perfil A y asegúrese de que no haya otros perfiles con sesión iniciada.
2. Inicie el título y progrese hasta el juego activo.
3. En varios puntos durante el uso del título, cierre la sesión del Perfil A.
4. Compruebe que el título invoca el selector de cuentas o devuelve al usuario a la pantalla inicial.
5. Cuando sea posible, interactúe con el título de las siguientes maneras:
   * Inicie sesión en el Perfil A y asegúrese de que el título no interrumpe más la experiencia del usuario.
   * Inicie sesión en el Perfil B y asegúrese de que el título se actualiza al contexto del nuevo usuario.

**Resultado esperado**

El título debe quitar al jugador del juego o restablecer un usuario y un mando activo. Si el jugador se quita del juego, el título debe quedar en un buen estado. Esto incluye escribir en el almacenamiento conectado, notificar a las sesiones de MPSD pertinentes que el usuario se ha ido y llevar al usuario a un lugar apropiado para iniciar sesión si tampoco se ha agregado un nuevo usuario.

**Ejemplos de aprobado**

1. El título quita al jugador del juego y vuelve a la pantalla inicial.
2. El título permite al usuario restablecer un nuevo usuario y se actualiza correctamente al contexto de usuario pertinente.

**Ejemplos de error**

1. El título no reacciona al cambio en el estado del usuario.
2. El título sigue usando el estado de usuario del Perfil A después de seleccionar un nuevo perfil.


## Related topics

- [Información general de la certificación de XBOX](/es/publishing/certification/overview.md)
- [FMA XR-115: Adición o eliminación de usuarios y mandos durante el juego](/es/publishing/certification/fma/xr-115.md)
- [XR-124 Invitaciones de juego](/es/publishing/certification/xr/xr-124.md)
- [Referencia de certificación de los requisitos de XBOX (XR)](/es/publishing/certification/xbox-requirements.md)
- [Historial de cambios y control de versiones de los XR](/es/publishing/certification/xr-change-history.md)
