跳轉到主要內容
玩家自訂屬性功能目前為公開預覽版。雖然核心功能已就緒,但我們正根據意見反應和使用模式持續改善體驗。
自訂屬性是索引鍵/值資料組,用於儲存玩家的其他資訊。這些資料組的類型可以是字串、數值、布林值或日期時間。 自訂屬性及其值會與其他玩家資訊 (例如顯示名稱、統計資料和標籤) 一起儲存。
只有 title_player_account 實體支援自訂屬性。

設定自訂屬性

自訂屬性可以透過不同方式設定:
  • 透過 UpdatePlayerCustomProperties 動作,更新玩家的屬性。
  • 您也可以使用 DeletePlayerCustomProperties 動作移除自訂屬性。
  • 您也可以透過 Game Manager UI 修改單一玩家的屬性。

限制

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

優點

自訂屬性功能強大,可讓您進行無程式碼開發,將多個現有的 PlayStream 事件相互關聯,讓您能夠追蹤與同一玩家相關之多個事件的狀態。
最後修改於 2026年10月8日