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

# ロビーへの参加

> ロビー ID、接続文字列、または招待を使用して PlayFab Lobby に参加し、メンバー参加、初期プロパティ、およびアクセス ポリシーの制約を処理します。

# ロビーへの参加と接続文字列

プレイヤーはロビーの「接続文字列」(ロビーのメンバーシップを付与する不透明な識別子) をロビー サービスに提供することでロビーに参加します。

プレイヤーは次の方法で接続文字列を発見し、ロビーに参加できます。

1. ゲーム内招待を使用する—ロビーのメンバーは、ロビー サービスを介して直接、別のプレイヤーをそのロビーに招待できます。これにより、ロビーの接続文字列が招待されたプレイヤーと共有されます。これらの招待はクロスプラットフォームで動作しますが、ゲーム内でのみ機能します。詳細については、[ロビーの招待](/services/playfab/multiplayer/lobby/lobby-invites) を参照してください。
2. プラットフォーム提供の招待を使用する—ロビーのメンバーは、プラットフォーム固有の招待メカニズムを通じて、ロビーの接続文字列を他のプレイヤーと直接共有できます。これらの招待はクロスプラットフォームでは機能しませんが、受信者がゲームを既に実行していなくても受信できます。
3. [FindLobbies](/services/playfab/multiplayer/lobby/find-lobbies) を使って利用可能なロビーを検索し、利用可能なロビーに参加する
4. 任意の帯域外のカスタム発見メカニズムを介してロビーの接続文字列を共有する

<Note>
  プレイヤー (すなわち title\_player\_account PlayFab エンティティ) のみがメンバーとしてロビーに参加できます。ゲーム サーバー (すなわち game\_server PlayFab エンティティ) はメンバーとしてロビーに参加できません。ゲーム サーバーがロビーとどのようにやり取りするかの詳細については、[ゲーム サーバーとロビー](/services/playfab/multiplayer/lobby/lobby-server-overview) を参照してください。
</Note>

## 接続文字列とロビー ID

接続文字列とは別に、ロビーには **LobbyId** という別の識別子があります。**LobbyId** はロビーの一意の識別子です。タイトルは **LobbyId** を使用して、プレイヤーが参加している複数のロビーを区別できますが、LobbyId を使ってロビーに参加したり、メンバーシップが必要な情報についてロビーを直接照会したりすることはできません。したがって、タイトルは **LobbyId** を秘密に保つ必要はありません。一方、接続文字列はロビーへのアクセスを付与するため、望ましくない外部の関係者にさらされないよう注意が必要です。

## Lobby and 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);
```

## 関連項目

* [ロビーの検索](/services/playfab/multiplayer/lobby/find-lobbies)
* [検索可能なロビーの作成](/services/playfab/multiplayer/lobby/define-search-keywords)
* [ロビーとマッチメイキング](/services/playfab/multiplayer/lobby/lobby-and-matchmaking)
* [ロビーのプロパティ](/services/playfab/multiplayer/lobby/lobby-properties)
* [ロビーの作成](/services/playfab/multiplayer/lobby/create-a-lobby)


## Related topics

- [MPSD から PlayFab Multiplayer と MPA への移行](/ja-jp/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [ロビーの招待](/ja-jp/services/playfab/multiplayer/lobby/lobby-invites.md)
- [ロビーの検索](/ja-jp/services/playfab/multiplayer/lobby/find-lobbies.md)
- [検索可能なロビーの作成](/ja-jp/services/playfab/multiplayer/lobby/define-search-keywords.md)
- [PFLobbyJoinLobbyAsServerCompletedStateChange](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinlobbyasservercompletedstatechange.md)
