玩家自定义属性

注意

玩家自定义属性功能以个人预览版提供。 随着我们继续收集反馈并优化客户使用,我们预计将对其进行持续的更改。

自定义属性是存储有关玩家的其他信息的键值数据对。 这些数据对类型可以是字符串、数值、布尔值或日期时间。

自定义属性及其值与其他玩家信息一起存储,例如显示名称、统计信息和标记。

注意

仅 title_player_account 实体支持自定义属性。

配置自定义属性

可以采用不同的方式设置自定义属性:

  • 通过 UpdatePlayerCustomProperties 操作更新玩家的属性。
  • 还可以使用 DeletePlayerCustomProperties 操作删除自定义属性。
  • 还可以通过 Game Manager UI 修改单个玩家的属性。

限制

自定义属性的一些限制包括:

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

好处

自定义属性功能强大,使你能够进行无代码开发,从而关联多个现有的 PlayStream 事件,从而能够跨与同一玩家相关的事件跟踪状态。