> ## 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.

# Enviar invitaciones de juego mediante Multiplayer Manager

> Cómo enviar invitaciones de juego de XBOX Live con Multiplayer Manager mediante la interfaz de usuario invocable por el título (TCUI) de la plataforma o una interfaz de usuario de invitaciones personalizada implementada por el título.

En un escenario multijugador sencillo, un jugador de tu juego puede jugar en línea con amigos. Este tema describe los pasos para enviar invitaciones a otro jugador para que se una a tu juego.

Inicializa Multiplayer Manager y crea una sesión de sala agregando usuarios locales. Para obtener más información, consulta [Habilitar el juego multijugador con amigos mediante Multiplayer Manager](/services/xbox-services/multiplayer/mpm/how-to/live-play-multiplayer-with-friends).
Después de recibir el evento [XblMultiplayerEventType](/reference/live/xsapi-c/multiplayer_manager_c/enums/xblmultiplayereventtype)`::UserAdded`, puedes empezar a enviar invitaciones.

Una invitación se puede enviar de dos maneras.

* [TCUI de invitación de la plataforma XBOX (interfaz de usuario invocable por el título)](#xbox-platform-invite-tcui)
* [Interfaz de usuario personalizada implementada por el título](#title-implemented-custom-ui)

Para obtener más información sobre el proceso, consulta [Enviar invitaciones a otro jugador (diagrama de flujo)](/services/xbox-services/multiplayer/mpm/concepts/flowcharts/live-mpm-send-invites).

### TCUI de invitación de la plataforma XBOX <a id="xbox-platform-invite-tcui" />

Llama a [XblMultiplayerManagerLobbySessionInviteFriends](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninvitefriends) para mostrar la interfaz de usuario estándar de XBOX en la que el jugador puede seleccionar amigos o jugadores recientes para invitarlos al juego.
Cuando el jugador confirma su selección, Multiplayer Manager envía las invitaciones a los jugadores seleccionados.

#### API de C plana

```cpp theme={null}
std::string customActivationContext = "{ \"customGameData\": 1 }"; // This string can be anything your game sends across to the invited player's game.

HRESULT hr = XblMultiplayerManagerLobbySessionInviteFriends(xuserHandle, nullptr, customActivationContext.c_str());
```

Multiplayer Manager realiza las siguientes funciones para invitar a jugadores mediante la TCUI de invitación de la plataforma XBOX.

* Muestra la TCUI estándar de XBOX.
* Envía la invitación directamente a los jugadores seleccionados.

### Interfaz de usuario personalizada implementada por el título<a id="title-implemented-custom-ui" />

Tu título puede implementar una TCUI personalizada para ver amigos en línea e invitarlos.
Los juegos pueden usar el método [XblMultiplayerManagerLobbySessionInviteUsers](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninviteusers) para enviar invitaciones a un conjunto de personas definidas por sus identificadores de usuario de XBOX Live.
Esto es útil si usas tu propia interfaz de usuario del juego en lugar de la interfaz de usuario estándar de XBOX.

#### API de C plana

```cpp theme={null}
size_t xuidsCount = 1;
uint64_t xuids[1] = {};
xuids[0] = 1234567891234567;
HRESULT hr = XblMultiplayerManagerLobbySessionInviteUsers(
    xblUserHandle, 
    xuids, 
    xuidsCount, 
    nullptr,    // ContextStringId 
    nullptr     // CustomActivationContext
);
```

Cuando se usa una interfaz de usuario personalizada implementada por el título, Multiplayer Manager envía una invitación directamente a los jugadores seleccionados.