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

# Ingressar em lobbies

> Ingresse em PlayFab Lobbies usando uma ID de lobby, uma cadeia de conexão ou um convite e trate as entradas de membros, as propriedades iniciais e as restrições da política de acesso.

# Ingressar em lobbies e cadeias de conexão

Os jogadores ingressam em lobbies fornecendo ao serviço de lobby a "cadeia de conexão" de um lobby, um identificador opaco que concede associação ao lobby.

Os jogadores podem descobrir cadeias de conexão e ingressar em lobbies das seguintes formas.

1. Usando convites no jogo: um membro de um lobby pode convidar outro jogador para esse lobby diretamente por meio do serviço de lobby. Isso compartilhará a cadeia de conexão do lobby com o jogador convidado. Esses convites funcionam entre plataformas, mas só funcionam dentro do jogo. Para obter mais informações, consulte [Convites de lobby](/pt-BR/services/playfab/multiplayer/lobby/lobby-invites)
2. Usando convites fornecidos pela plataforma: os membros do lobby podem compartilhar diretamente a cadeia de conexão do lobby com outros jogadores por meio de mecanismos de convite específicos da plataforma. Esses convites não funcionam entre plataformas, mas podem ser recebidos sem que o destinatário já esteja executando o jogo.
3. Pesquisando lobbies disponíveis com [FindLobbies](/pt-BR/services/playfab/multiplayer/lobby/find-lobbies) e ingressando em um lobby disponível
4. Compartilhando a cadeia de conexão do lobby por meio de qualquer mecanismo de descoberta personalizado e fora de banda

<Note>
  Somente jogadores (ou seja, entidades title\_player\_account do PlayFab) podem ingressar em lobbies como membros. Servidores de jogo (ou seja, entidades game\_server do PlayFab) não podem ingressar em lobbies como membros. Para obter mais informações sobre como os servidores de jogo interagem com os lobbies, consulte [Servidores de jogo e lobbies](/pt-BR/services/playfab/multiplayer/lobby/lobby-server-overview).
</Note>

## Cadeias de conexão e IDs de lobby

Além das cadeias de conexão, os lobbies têm outro identificador, conhecido como **LobbyId**. **LobbyId** é o identificador exclusivo de um lobby. Os títulos podem usar **LobbyId** para distinguir entre vários lobbies em que um jogador está, mas as LobbyIds não podem ser usadas para ingressar nos lobbies nem para consultá-los diretamente sobre informações que exigem associação. Portanto, seu título não precisa manter a **LobbyId** em segredo. As cadeias de conexão, por outro lado, concedem acesso aos lobbies, portanto é preciso ter cuidado para não expô-las a terceiros indesejados.

## Exemplo de ingresso em um lobby usando o SDK de Lobby e Matchmaking

Veja um breve trecho que demonstra como passar uma cadeia de conexão para a API **PFMultiplayerJoinLobby** fornecida pelo SDK.

Neste trecho, a cadeia de conexão pode ser fornecida por qualquer um dos mecanismos de descoberta mencionados acima: convites no jogo, convites específicos da plataforma ou pesquisas de lobby filtradas.

```cpp theme={null}
// Initialize the member properties for the newly joining member
const char* playerColorPropertyKey = "PlayerColor";
const char* playerColorPropertyValue = MyGame::GetPlayerColorString(localUser);

PFLobbyJoinConfiguration joinConfig;
joinConfig.memberPropertyCount = 1;
joinConfig.memberPropertyKeys = &playerColorPropertyKey;
joinConfig.memberPropertyValues = &playerColorPropertyValue;

// Join the lobby using the connection string
HRESULT hr = PFMultiplayerJoinLobby(
    g_pfmHandle,
    &localUser,
    connectionString,
    &joinConfig,
    nullptr,
    nullptr);
```

## Confira também

* [Localizar lobbies](/pt-BR/services/playfab/multiplayer/lobby/find-lobbies)
* [Criar lobbies pesquisáveis](/pt-BR/services/playfab/multiplayer/lobby/define-search-keywords)
* [Lobby e matchmaking](/pt-BR/services/playfab/multiplayer/lobby/lobby-and-matchmaking)
* [Propriedades do lobby](/pt-BR/services/playfab/multiplayer/lobby/lobby-properties)
* [Criar um lobby](/pt-BR/services/playfab/multiplayer/lobby/create-a-lobby)


## Related topics

- [Localizar lobbies](/pt-BR/services/playfab/multiplayer/lobby/find-lobbies.md)
- [Convites de lobby](/pt-BR/services/playfab/multiplayer/lobby/lobby-invites.md)
- [Mensagens em tempo real de Lobby e Matchmaking](/pt-BR/services/playfab/multiplayer/lobby/lobby-and-matchmaking-real-time-messages.md)
- [Lobby.GetServerConnectionStatus](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/Lobby/GetServerConnectionStatus.md)
- [PFLobbyGetServerConnectionStatus](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetserverconnectionstatus.md)
