> ## 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](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange.md)
- [PFLobbyAddMember](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbyaddmember.md)
- [LobbyCreateConfiguration.MaxMemberCount](/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyCreateConfiguration/MaxMemberCount.md)
- [Lobby.GetMemberProperties](/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/Lobby/GetMemberProperties.md)
- [LobbyArrangedJoinConfiguration.MaxMemberCount](/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyArrangedJoinConfiguration/MaxMemberCount.md)