プレイヤーのカスタム プロパティ
注意
プレイヤーのカスタム プロパティ機能はプライベート プレビュー段階です。 今後もお客様からのご意見をもとに、最適化を進めていきたいと考えています。
カスタム プロパティは、プレイヤーに関する追加情報を格納するキーと値のデータ ペアです。 データ ペアの型としては、文字列、数値、ブール値、または datetime を使用できます。
カスタム プロパティとその値は、他のプレイヤー情報 (表示名、統計情報、タグなど) と一緒に格納されます。
注意
カスタム プロパティは、title_player_account エンティティでのみサポートされています。
カスタム プロパティを構成する
カスタム プロパティをセットアップする方法は、以下のように複数あります。
- UpdatePlayerCustomProperties アクションを使用してプレイヤーのプロパティを更新する方法。
- DeletePlayerCustomProperties アクションを使用してカスタム プロパティを削除することもできます。
- また、ゲーム マネージャー UI で個別のプレイヤーのプロパティを変更することもできます。
制限
カスタム プロパティには以下のような制限事項があります。
- プロパティ名は string 型で、最大長は 24 文字です
- プロパティ名の大文字と小文字は区別されます。たとえば prop と PROP は異なる名前です
- 文字列値の最大長は 32 文字です
- サポートされている数値は、倍精度浮動小数点 (IEEE 754 標準) です
- Datetime 文字列値には ISO 8601 形式を使用する必要があり、すべての比較は UTC に基づいて行われます
- プレイヤー 1 人に設定できる一意のカスタム プロパティは 10 個以下です (異なるプレイヤーに異なる 10 個のプロパティ名を使用することは可能です)
利点
カスタム プロパティは、コーディングなしの開発で複数の既存 PlayStream イベントを関連付けることができる強力な機能です。個々のプレイヤーについて、関連するさまざまなイベントの状態を横断的にトラックできます。