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

# Lobby.AddMember

> Lobby.AddMember

## 메서드(1/2)

로컬 사용자를 멤버로 로비에 추가합니다.

```csharp theme={null}
public void AddMember(PFEntityKey localUser, IDictionary<string, string> memberProperties)
```

| 매개 변수            | 설명                                    |
| ---------------- | ------------------------------------- |
| localUser        | 멤버로 로비에 추가할 로컬 사용자의 PlayFab 엔터티 키입니다. |
| memberProperties | 이 사용자가 로비에 참여할 때 설정할 초기 멤버 속성입니다.     |

## 설명(1/2)

이는 비동기 작업입니다. 성공적으로 완료되면 타이틀은 [`OnLobbyMemberAdded`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnLobbyMemberAdded) 이벤트에 이어 `OnAddMemberCompleted result` 필드가 [`Success`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyError/Success)로 설정된 [`OnAddMemberCompleted`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnAddMemberCompleted) 이벤트를 받습니다. 실패한 완료 시 타이틀은 `OnAddMemberCompleted result` 필드가 실패한 오류 코드로 설정된 [`OnAddMemberCompleted`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnAddMemberCompleted)를 받습니다.

이 메서드는 기존 로비 개체에 추가 로컬 PlayFab 엔터티를 추가하는 데 사용됩니다. 로비 개체는 [`CreateAndJoinLobby`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/CreateAndJoinLobby) 또는 [`JoinLobby`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinLobby)에 대한 호출을 통해 이미 만들어져 있어야 하므로, 이 메서드는 주로 여러 로컬 사용자 시나리오에서 유용합니다.

이는 비동기 작업입니다. 이 메서드를 통해 추가된 멤버는 비동기 작업이 성공적으로 완료될 때까지 [`GetMembers`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/Lobby/GetMembers)에서 반환된 목록에 반영되지 않습니다.

***

## 메서드(2/2)

로컬 사용자를 멤버로 로비에 추가합니다.

```csharp theme={null}
public void AddMember(PlayFabAuthenticationContext localUser, 
    IDictionary<string, string> memberProperties)
```

| 매개 변수            | 설명                                    |
| ---------------- | ------------------------------------- |
| localUser        | 멤버로 로비에 추가할 로컬 사용자의 PlayFab 엔터티 키입니다. |
| memberProperties | 이 사용자가 로비에 참여할 때 설정할 초기 멤버 속성입니다.     |

## 설명(2/2)

이는 비동기 작업입니다. 성공적으로 완료되면 타이틀은 [`OnLobbyMemberAdded`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnLobbyMemberAdded) 이벤트에 이어 `OnAddMemberCompleted result` 필드가 [`Success`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyError/Success)로 설정된 [`OnAddMemberCompleted`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnAddMemberCompleted) 이벤트를 받습니다. 실패한 완료 시 타이틀은 `OnAddMemberCompleted result` 필드가 실패한 오류 코드로 설정된 [`OnAddMemberCompleted`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnAddMemberCompleted)를 받습니다.

이 메서드는 기존 로비 개체에 추가 로컬 PlayFab 엔터티를 추가하는 데 사용됩니다. 로비 개체는 [`CreateAndJoinLobby`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/CreateAndJoinLobby) 또는 [`JoinLobby`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinLobby)에 대한 호출을 통해 이미 만들어져 있어야 하므로, 이 메서드는 주로 여러 로컬 사용자 시나리오에서 유용합니다.

이는 비동기 작업입니다. 이 메서드를 통해 추가된 멤버는 비동기 작업이 성공적으로 완료될 때까지 [`GetMembers`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/Lobby/GetMembers)에서 반환된 목록에 반영되지 않습니다.

## 함께 보기

* class [Lobby](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/Lobby/overview)
* class [PFEntityKey](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PFEntityKey/overview)
* namespace [PlayFab.Multiplayer](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference)


## Related topics

- [PFLobbyAddMemberCompletedStateChange](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange.md)
- [PFLobbyAddMember](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbyaddmember.md)
- [Lobby.GetMemberProperties](/ko/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/Lobby/GetMemberProperties.md)
- [LobbyCreateConfiguration.MaxMemberCount](/ko/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyCreateConfiguration/MaxMemberCount.md)
- [LobbyArrangedJoinConfiguration.MaxMemberCount](/ko/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyArrangedJoinConfiguration/MaxMemberCount.md)