> ## 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 Lobby 自訂屬性

> 使用 PlayFab Lobby 自訂屬性儲存大廳層級和成員層級的狀態、控制可見性，並公開可搜尋的屬性以供探索大廳。

# 大廳屬性

本文說明儲存在大廳上的自訂屬性。使用此功能來儲存您的大廳所代表之遊戲工作階段的中繼資料。

## 預先定義的屬性

每個大廳都有一組大多數遊戲情境通常需要的預先定義屬性。

| 屬性 | 定義 |
| - | - |
| lobbyId | 這是大廳的唯一識別碼。可用於區分玩家可能所屬的多個大廳。 |
| connectionString | 用於加入大廳的識別碼。它由大廳服務提供。傳送邀請給其他玩家時，會將 **connectionString** 作為邀請傳送。 |
| maxMemberCount | 大廳中允許的最大玩家數目。此屬性只能由擁有者變更。 |
| owner | 擁有大廳的實體。在某些情況下，部分大廳可能會暫時沒有擁有者。若要深入了解，請參閱[擁有權變更](/zh-TW/services/playfab/multiplayer/lobby/ownership-changes)。 |
| ownerMigrationPolicy | 決定如何選擇新擁有者的原則。若要深入了解，請參閱[擁有權變更](/zh-TW/services/playfab/multiplayer/lobby/ownership-changes)。 |
| accessPolicy | 指出誰可以探索大廳連接字串的原則。此屬性只能由擁有者變更。 |
| membershipLock | 此值表示新成員是否可以加入大廳。為 **Locked** 時，新成員無法加入。為 **Unlocked** 時，新成員可以加入。此屬性只能由擁有者變更。 |
| RestrictInvitesToLobbyOwner | 控制是否只有大廳擁有者可以傳送加入大廳邀請的設定。為 true 時，只有大廳擁有者可以傳送邀請。為 false 或未指定時，任何成員都可以傳送邀請。若未指定，預設為 false。僅限用戶端擁有的大廳。 |

## 自訂屬性

遊戲可以定義三種類型的自訂屬性。

1. 自訂大廳屬性
   * 這些屬性適用於整個大廳。
   * 只有大廳的成員可以看到這些屬性。
   * 只有大廳的擁有者可以變更這些屬性。
2. 自訂成員屬性
   * 大廳中的每個成員都有一個唯一的成員屬性對應
   * 只有大廳的成員可以看到這些屬性。
   * 大廳的所有成員都可以看到每個其他成員的屬性。
   * 每個成員可以修改自己的成員屬性，但不能修改其他成員的屬性。
   * 成員離開大廳後，其成員屬性就會從大廳中刪除。
3. 自訂搜尋屬性。
   * 這些是特殊屬性，遊戲中的所有玩家都可以使用它們來搜尋符合特定準則的大廳。
   * 這些屬性適用於整個大廳。
   * 只有大廳的擁有者可以變更這些屬性。
   * 這些屬性可以使用的索引鍵有所限制。
   * 若要深入了解，請參閱[建立可搜尋的大廳](/zh-TW/services/playfab/multiplayer/lobby/define-search-keywords)。

所有屬性都是索引鍵/值組的對應。

## 另請參閱

* [建立大廳](/zh-TW/services/playfab/multiplayer/lobby/create-a-lobby)
* [擁有者需求和權限](/zh-TW/services/playfab/multiplayer/lobby/owner-requirements-and-privileges)
* [大廳和配對](/zh-TW/services/playfab/multiplayer/lobby/lobby-and-matchmaking)
* [尋找大廳](/zh-TW/services/playfab/multiplayer/lobby/find-lobbies)
* [建立可搜尋的大廳](/zh-TW/services/playfab/multiplayer/lobby/define-search-keywords)


## Related topics

- [玩家自訂屬性快速入門](/zh-TW/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties-qs.md)
- [玩家自訂屬性](/zh-TW/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties.md)
- [列出玩家自訂屬性](/zh-TW/services/playfab/api-references/rest/client/player-data-management/list-player-custom-properties.md)
- [取得玩家自訂屬性](/zh-TW/services/playfab/api-references/rest/admin/player-data-management/get-player-custom-property.md)
- [刪除玩家自訂屬性](/zh-TW/services/playfab/api-references/rest/client/player-data-management/delete-player-custom-properties.md)