> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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`](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnLobbyMemberAdded) 事件，之后是一个 `OnAddMemberCompleted result` 字段设置为 [`Success`](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyError/Success) 的 [`OnAddMemberCompleted`](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnAddMemberCompleted) 事件。失败完成时，标题将收到一个 `OnAddMemberCompleted result` 字段设置为失败错误代码的 [`OnAddMemberCompleted`](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnAddMemberCompleted)。

此方法用于将额外的本地 PlayFab 实体添加到已存在的大厅对象中。由于大厅对象必须已通过调用 [`CreateAndJoinLobby`](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/CreateAndJoinLobby) 或 [`JoinLobby`](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinLobby) 创建，因此此方法主要用于多本地用户场景。

这是一个异步操作。通过此方法添加的成员在异步操作成功完成之前不会反映在 [`GetMembers`](https://docs.xbox.com/zh-CN/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`](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnLobbyMemberAdded) 事件，之后是一个 `OnAddMemberCompleted result` 字段设置为 [`Success`](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyError/Success) 的 [`OnAddMemberCompleted`](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnAddMemberCompleted) 事件。失败完成时，标题将收到一个 `OnAddMemberCompleted result` 字段设置为失败错误代码的 [`OnAddMemberCompleted`](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnAddMemberCompleted)。

此方法用于将额外的本地 PlayFab 实体添加到已存在的大厅对象中。由于大厅对象必须已通过调用 [`CreateAndJoinLobby`](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/CreateAndJoinLobby) 或 [`JoinLobby`](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinLobby) 创建，因此此方法主要用于多本地用户场景。

这是一个异步操作。通过此方法添加的成员在异步操作成功完成之前不会反映在 [`GetMembers`](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/Lobby/GetMembers) 返回的列表中。

## 另请参阅

* class [Lobby](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/Lobby/overview.md)
* class [PFEntityKey](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PFEntityKey/overview.md)
* namespace [PlayFab.Multiplayer](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference.md)


## Related topics

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