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

# 加入大廳

> 使用大廳識別碼、連接字串或邀請加入 PlayFab 大廳，並處理成員加入、初始屬性和存取原則限制。

# 加入大廳和連接字串

玩家透過向大廳服務提供大廳的「連接字串」來加入大廳，連接字串是一個不透明的識別碼，可授與大廳的成員資格。

玩家可以透過下列方式探索連接字串並加入大廳。

1. 使用遊戲內邀請——大廳的成員可以直接透過大廳服務邀請其他玩家加入該大廳。這會與受邀的玩家共用大廳的連接字串。這些邀請可跨平台運作，但只能在遊戲內運作。如需詳細資訊，請參閱[大廳邀請](/zh-TW/services/playfab/multiplayer/lobby/lobby-invites)
2. 使用平台提供的邀請——大廳的成員可以透過平台專屬的邀請機制，直接與其他玩家共用大廳的連接字串。這些邀請無法跨平台運作，但收件者不必已在執行遊戲即可收到。
3. 使用 [FindLobbies](/zh-TW/services/playfab/multiplayer/lobby/find-lobbies) 搜尋可用的大廳，並加入可用的大廳
4. 透過任何頻外的自訂探索機制共用大廳的連接字串

<Note>
  只有玩家 (也就是 title\_player\_account PlayFab 實體) 可以成員身分加入大廳。遊戲伺服器 (也就是 game\_server PlayFab 實體) 無法以成員身分加入大廳。如需遊戲伺服器如何與大廳互動的詳細資訊，請參閱[遊戲伺服器和大廳](/zh-TW/services/playfab/multiplayer/lobby/lobby-server-overview)。
</Note>

## 連接字串和大廳識別碼

除了連接字串之外，大廳還有另一個稱為 **LobbyId** 的識別碼。**LobbyId** 是大廳的唯一識別碼。遊戲可以使用 **LobbyId** 來區分玩家所在的多個大廳，但 LobbyId 不能用來加入大廳，也不能直接查詢大廳中任何需要成員資格的資訊。因此，您的遊戲不必將 **LobbyId** 保密。另一方面，連接字串會授與大廳的存取權，因此應小心避免將其洩露給不必要的外部人士。

## 使用 Lobby 和 Matchmaking SDK 加入大廳的範例

以下是一個簡短的程式碼片段，示範將連接字串傳遞給 SDK 所提供的 **PFMultiplayerJoinLobby** API。

在此程式碼片段中，連接字串可以由上述任何探索機制提供：遊戲內邀請、平台專屬邀請或篩選後的大廳搜尋。

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

## 另請參閱

* [尋找大廳](/zh-TW/services/playfab/multiplayer/lobby/find-lobbies)
* [建立可搜尋的大廳](/zh-TW/services/playfab/multiplayer/lobby/define-search-keywords)
* [大廳和配對](/zh-TW/services/playfab/multiplayer/lobby/lobby-and-matchmaking)
* [大廳屬性](/zh-TW/services/playfab/multiplayer/lobby/lobby-properties)
* [建立大廳](/zh-TW/services/playfab/multiplayer/lobby/create-a-lobby)


## Related topics

- [加入大廳](/zh-TW/services/playfab/api-references/rest/multiplayer/lobby/join-lobby.md)
- [Multiplayer Unity 外掛程式快速入門](/zh-TW/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/multiplayer-unity-plugin-quickstart.md)
- [從 MPSD 移至 PlayFab Multiplayer 與 MPA](/zh-TW/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [使用 Multiplayer SDK 將 Party 與 Lobby 整合](/zh-TW/services/playfab/multiplayer/networking/party-lobby-integration.md)
- [邀請加入大廳](/zh-TW/services/playfab/api-references/rest/multiplayer/lobby/invite-to-lobby.md)