Skip to main content
玩家自定义属性功能处于公共预览阶段。虽然核心功能已就绪,但我们正根据反馈和使用模式对体验进行改进。
自定义属性是键值数据对,用于存储关于玩家的附加信息。这些数据对的类型可以是字符串、数值、布尔值或日期时间。 自定义属性及其值与玩家的其他信息一起存储,例如显示名称、统计信息和标签。
自定义属性仅在 title_player_account 实体上受支持。

配置自定义属性

自定义属性可以通过不同方式设置:
  • 通过 UpdatePlayerCustomProperties 操作更新玩家的属性。
  • 你也可以使用 DeletePlayerCustomProperties 操作移除自定义属性。
  • 你还可以通过 Game Manager UI 修改单个玩家的属性。

限制

自定义属性的一些限制:
  • 属性名称必须是字符串类型,且最大长度为 36 个字符
  • 属性名称区分大小写,例如 prop 和 PROP 是不同的名称
  • 字符串值的最大长度为 36 个字符
  • 支持的数值为双精度浮点数(IEEE 754 标准)
  • 日期时间字符串值必须使用 ISO 8601 格式,且所有比较均以 UTC 为基准进行
  • 每个玩家最多只能有 5 个唯一的自定义属性(不要求每个玩家具有完全相同的 5 个属性名称)

优势

自定义属性功能强大,让你能够进行无代码开发,将多个现有的 PlayStream 事件相关联,从而使你能够跨与同一玩家相关的事件跟踪状态。
最后修改于 2026年8月13日