> ## 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 로비에 참여하고, 멤버 참여, 초기 속성 및 액세스 정책 제한을 처리합니다.

# 로비 참여 및 연결 문자열

플레이어는 로비 서비스에 로비의 "연결 문자열"(로비 멤버십을 부여하는 불투명 식별자)을 제공하여 로비에 참여합니다.

플레이어는 다음과 같은 방법으로 연결 문자열을 발견하고 로비에 참여할 수 있습니다.

1. 인게임 초대 사용 - 로비의 멤버는 로비 서비스를 통해 직접 다른 플레이어를 해당 로비로 초대할 수 있습니다. 이는 초대된 플레이어와 로비의 연결 문자열을 공유합니다. 이러한 초대는 크로스 플랫폼에서 작동하지만 인게임에서만 작동합니다. 자세한 내용은 [로비 초대](/services/playfab/multiplayer/lobby/lobby-invites)를 참조하세요.
2. 플랫폼 제공 초대 사용 - 로비의 멤버는 플랫폼별 초대 메커니즘을 통해 다른 플레이어와 로비의 연결 문자열을 직접 공유할 수 있습니다. 이러한 초대는 크로스 플랫폼에서 작동하지 않지만, 수신자가 이미 게임을 실행하지 않고도 받을 수 있습니다.
3. [FindLobbies](/services/playfab/multiplayer/lobby/find-lobbies)로 사용 가능한 로비를 검색하여 사용 가능한 로비에 참여
4. 대역 외(out-of-band) 사용자 지정 검색 메커니즘을 통해 로비의 연결 문자열 공유

<Note>
  플레이어(즉, title\_player\_account PlayFab 엔티티)만 멤버로서 로비에 참여할 수 있습니다. 게임 서버(즉, game\_server PlayFab 엔티티)는 멤버로서 로비에 참여할 수 없습니다. 게임 서버가 로비와 상호 작용하는 방식에 대한 자세한 내용은 [Game Servers and Lobbies](/services/playfab/multiplayer/lobby/lobby-server-overview)를 참조하세요.
</Note>

## 연결 문자열 및 Lobby 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)
* [Lobby 및 matchmaking](/services/playfab/multiplayer/lobby/lobby-and-matchmaking)
* [Lobby properties](/services/playfab/multiplayer/lobby/lobby-properties)
* [로비 만들기](/services/playfab/multiplayer/lobby/create-a-lobby)


## Related topics

- [Multiplayer Unity 플러그인 빠른 시작](/ko/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/multiplayer-unity-plugin-quickstart.md)
- [로비 초대](/ko/services/playfab/multiplayer/lobby/lobby-invites.md)
- [로비 찾기](/ko/services/playfab/multiplayer/lobby/find-lobbies.md)
- [검색 가능한 로비 만들기](/ko/services/playfab/multiplayer/lobby/define-search-keywords.md)
- [PlayFabMultiplayer.JoinLobby](/ko/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinLobby.md)