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

# PlayFab Lobby 自定义属性

> 使用 PlayFab 大厅自定义属性存储大厅级和成员级状态、控制可见性,并向大厅发现公开可搜索的属性。

# 大厅属性

本文介绍存储在大厅上的自定义属性。使用此功能可存储关于大厅所代表游戏会话的元数据。

## 预定义属性

每个大厅都有一组常见的、大多数游戏场景所需的预定义属性。

| 属性 | 定义 |
| - | - |
| lobbyId | 这是大厅的唯一标识符。可用于区分玩家可能加入的多个大厅。 |
| connectionString | 用于加入大厅的标识符。它由大厅服务提供。当向其他玩家发送邀请时,**connectionString** 会作为邀请内容发送。 |
| maxMemberCount | 大厅中允许的最大玩家数量。此属性只能由所有者更改。 |
| owner | 拥有大厅的实体。在某些情况下,某些大厅可能暂时没有所有者。若要了解更多,请参阅[所有权变更](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/ownership-changes.md)。 |
| ownerMigrationPolicy | 决定如何选择新所有者的策略。若要了解更多,请参阅[所有权变更](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/ownership-changes.md)。 |
| accessPolicy | 指示谁可以发现大厅连接字符串的策略。此属性只能由所有者更改。 |
| membershipLock | 此值指示新成员是否可以加入大厅。当为 **Locked** 时,新成员无法加入。当为 **Unlocked** 时,新成员可以加入。此属性只能由所有者更改。 |
| RestrictInvitesToLobbyOwner | 一个用于控制是否仅允许大厅所有者发送加入大厅邀请的设置。当为 true 时,只有大厅所有者可以发送邀请。当为 false 或未指定时,任何成员都可以发送邀请。如果未指定,默认为 false。仅限于客户端所拥有的大厅。 |

## 自定义属性

游戏可以定义三种类型的自定义属性。

1. 自定义大厅属性
   * 这些属性适用于整个大厅。
   * 只有大厅成员可以看到这些属性。
   * 只有大厅所有者可以更改这些属性。
2. 自定义成员属性
   * 大厅中每位成员都有一个独立的成员属性映射
   * 只有大厅成员可以看到这些属性。
   * 大厅中的所有成员都可以看到其他每位成员的属性。
   * 每位成员可以修改自己的成员属性,但无法修改其他成员的属性。
   * 一旦成员离开大厅,他们的成员属性将从大厅中删除。
3. 自定义搜索属性。
   * 这些是特殊属性,你游戏中的所有玩家可用它们来搜索匹配特定条件的大厅。
   * 这些属性适用于整个大厅。
   * 只有大厅所有者可以更改这些属性。
   * 可用于这些属性的键存在一些限制。
   * 若要了解更多,请参阅[创建可搜索的大厅](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/define-search-keywords.md)。

所有属性都是键值对映射。

## 另请参阅

* [创建大厅](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/create-a-lobby.md)
* [所有者要求与特权](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/owner-requirements-and-privileges.md)
* [大厅与匹配](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/lobby-and-matchmaking.md)
* [查找大厅](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/find-lobbies.md)
* [创建可搜索的大厅](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/define-search-keywords.md)


## Related topics

- [玩家自定义属性快速入门](https://docs.xbox.com/zh-CN/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties-qs.md)
- [玩家自定义属性](https://docs.xbox.com/zh-CN/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties.md)
- [列出玩家自定义属性](https://docs.xbox.com/zh-CN/services/playfab/api-references/rest/admin/player-data-management/list-player-custom-properties.md)
- [获取玩家自定义属性](https://docs.xbox.com/zh-CN/services/playfab/api-references/rest/client/player-data-management/get-player-custom-property.md)
- [删除玩家自定义属性](https://docs.xbox.com/zh-CN/services/playfab/api-references/rest/client/player-data-management/delete-player-custom-properties.md)