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

# PlayFab 大厅自定义属性

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

# 大厅属性

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

## 预定义属性

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

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

## 自定义属性

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

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

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

## 另请参阅

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


## Related topics

- [玩家自定义属性快速入门](/zh-CN/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties-qs.md)
- [玩家自定义属性](/zh-CN/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties.md)
- [创建大厅](/zh-CN/services/playfab/multiplayer/lobby/create-a-lobby.md)
- [查找大厅](/zh-CN/services/playfab/multiplayer/lobby/find-lobbies.md)
- [使用玩家自定义属性进行高级分段](/zh-CN/services/playfab/live-service-management/game-configuration/segmentation/advanced-segmentation.md)