> ## 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 玩家自訂屬性概觀：在 title_player_account 實體上儲存字串、數值、布林值或日期時間資料的索引鍵/值組，以及其限制。

<Note>
  玩家自訂屬性功能目前為公開預覽版。雖然核心功能已就緒，但我們正根據意見反應和使用模式持續改善體驗。
</Note>

自訂屬性是索引鍵/值資料組，用於儲存玩家的其他資訊。這些資料組的類型可以是字串、數值、布林值或日期時間。

自訂屬性及其值會與其他玩家資訊 (例如顯示名稱、統計資料和標籤) 一起儲存。

<Note>
  只有 title\_player\_account 實體支援自訂屬性。
</Note>

## 設定自訂屬性

自訂屬性可以透過不同方式設定：

* 透過 **UpdatePlayerCustomProperties** 動作，更新玩家的屬性。
* 您也可以使用 **DeletePlayerCustomProperties** 動作移除自訂屬性。
* 您也可以透過 Game Manager UI 修改單一玩家的屬性。

## 限制

自訂屬性的部分限制如下：

* 屬性名稱必須是字串類型，且長度上限為 36 個字元
* 屬性名稱會區分大小寫，例如 prop 和 PROP 是不同的名稱
* 字串值的長度上限為 36 個字元
* 支援的數值為雙精確度浮點數 (IEEE 754 標準)
* 日期時間字串值必須使用 ISO 8601 格式，且所有比較都以 UTC 為準
* 每位玩家只能有 5 個唯一的自訂屬性 (不要求每位玩家都有完全相同的 5 個屬性名稱)

## 優點

自訂屬性功能強大，可讓您進行無程式碼開發，將多個現有的 PlayStream 事件相互關聯，讓您能夠追蹤與同一玩家相關之多個事件的狀態。


## Related topics

- [列出玩家自訂屬性](/zh-TW/services/playfab/api-references/rest/client/player-data-management/list-player-custom-properties.md)
- [刪除玩家自訂屬性](/zh-TW/services/playfab/api-references/rest/client/player-data-management/delete-player-custom-properties.md)
- [取得玩家自訂屬性](/zh-TW/services/playfab/api-references/rest/admin/player-data-management/get-player-custom-property.md)