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

# Enviando convites de jogo usando o Multiplayer Manager

> Como enviar convites de jogo do XBOX Live com o Multiplayer Manager usando a Title-Callable UI (TCUI) da plataforma ou uma interface do usuário de convite personalizada implementada pelo título.

Em um cenário multiplayer simples, um jogador do seu jogo pode jogá-lo online com amigos. Este tópico descreve as etapas para enviar convites a outro jogador para que ele ingresse no seu jogo.

Inicialize o Multiplayer Manager e crie uma sessão de lobby adicionando usuários locais. Para obter mais informações, consulte [Habilitar jogos multiplayer com amigos usando o Multiplayer Manager](/pt-BR/services/xbox-services/multiplayer/mpm/how-to/live-play-multiplayer-with-friends).
Depois de receber o evento [XblMultiplayerEventType](/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/enums/xblmultiplayereventtype)`::UserAdded`, você pode começar a enviar convites.

Um convite pode ser enviado de duas maneiras.

* [Title-Callable UI (TCUI) de convite da plataforma XBOX](#xbox-platform-invite-tcui)
* [Interface do usuário personalizada implementada pelo título](#title-implemented-custom-ui)

Para obter mais informações sobre o processo, consulte [Enviando convites para outro jogador (fluxograma)](/pt-BR/services/xbox-services/multiplayer/mpm/concepts/flowcharts/live-mpm-send-invites).

### TCUI de convite da plataforma XBOX <a id="xbox-platform-invite-tcui" />

Chame [XblMultiplayerManagerLobbySessionInviteFriends](/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninvitefriends) para exibir a interface do usuário padrão do XBOX, na qual o jogador pode selecionar amigos ou jogadores recentes para convidar para o jogo.
Quando o jogador confirma a seleção, o Multiplayer Manager envia os convites aos jogadores selecionados.

#### API C simples

```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());
```

O Multiplayer Manager executa as funções a seguir para convidar jogadores usando a TCUI de convite da plataforma XBOX.

* Exibe a TCUI padrão do XBOX.
* Envia o convite diretamente aos jogadores selecionados.

### Interface do usuário personalizada implementada pelo título<a id="title-implemented-custom-ui" />

Seu título pode implementar uma TCUI personalizada para visualizar amigos online e convidá-los.
Os jogos podem usar o método [XblMultiplayerManagerLobbySessionInviteUsers](/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninviteusers) para enviar convites a um conjunto de pessoas definidas por seus IDs de usuário do XBOX Live.
Isso é útil se você usar sua própria interface do usuário no jogo em vez da interface do usuário padrão do XBOX.

#### API C simples

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

Ao usar uma interface do usuário personalizada implementada pelo título, o Multiplayer Manager envia um convite diretamente aos jogadores selecionados.


## Related topics

- [Enviando convites](/pt-BR/services/xbox-services/multiplayer/invites/how-to/live-invites-send.md)
- [Visão geral dos convites](/pt-BR/services/xbox-services/multiplayer/invites/live-multiplayer-invites-overview.md)
- [Convidar jogadores para sessões de jogo](/pt-BR/services/xbox-services/multiplayer/invites/live-invites-nav.md)
- [Visão geral do Multiplayer Manager](/pt-BR/services/xbox-services/multiplayer/mpm/live-multiplayer-manager-overview.md)
- [Instruções](/pt-BR/services/xbox-services/multiplayer/mpm/how-to/index.md)