> ## 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`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnLobbyMemberAdded) 事件，接著收到 `OnAddMemberCompleted result` 欄位設定為 [`Success`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyError/Success) 的 [`OnAddMemberCompleted`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnAddMemberCompleted) 事件。 失敗完成時，遊戲會收到 `OnAddMemberCompleted result` 欄位設定為失敗錯誤碼的 [`OnAddMemberCompleted`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnAddMemberCompleted)。

此方法用於將額外的本機 PlayFab 實體新增至既有的大廳物件。由於大廳物件必須已透過呼叫 [`CreateAndJoinLobby`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/CreateAndJoinLobby) 或 [`JoinLobby`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinLobby) 建立，因此此方法主要適用於多個本機使用者的情境。

這是一項非同步作業。在非同步作業成功完成之前，透過此方法新增的成員不會反映在 [`GetMembers`](/zh-TW/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`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnLobbyMemberAdded) 事件，接著收到 `OnAddMemberCompleted result` 欄位設定為 [`Success`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyError/Success) 的 [`OnAddMemberCompleted`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnAddMemberCompleted) 事件。 失敗完成時，遊戲會收到 `OnAddMemberCompleted result` 欄位設定為失敗錯誤碼的 [`OnAddMemberCompleted`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnAddMemberCompleted)。

此方法用於將額外的本機 PlayFab 實體新增至既有的大廳物件。由於大廳物件必須已透過呼叫 [`CreateAndJoinLobby`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/CreateAndJoinLobby) 或 [`JoinLobby`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinLobby) 建立，因此此方法主要適用於多個本機使用者的情境。

這是一項非同步作業。在非同步作業成功完成之前，透過此方法新增的成員不會反映在 [`GetMembers`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/Lobby/GetMembers) 所傳回的清單中。

## 另請參閱

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


## Related topics

- [PFLobbyAddMemberCompletedStateChange](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange.md)
- [PFLobbyAddMember](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbyaddmember.md)
- [Add Members](/api-reference/groups/add-members.md)
- [LobbyCreateConfiguration.MaxMemberCount](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyCreateConfiguration/MaxMemberCount.md)
- [Lobby.GetMemberProperties](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/Lobby/GetMemberProperties.md)