> ## 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-CN/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties-qs.md)
- [使用玩家自定义属性进行高级分段](/zh-CN/services/playfab/live-service-management/game-configuration/segmentation/advanced-segmentation.md)
- [player_custom_properties_changed](/zh-CN/services/playfab/api-references/events/PlayerIdentity/player-custom-properties-changed.md)
- [ActionType](/zh-CN/services/playfab/api-references/events/data-types/actiontype.md)
- [PlayFab 数据与分析文档](/zh-CN/services/playfab/data-analytics/index.md)