ドキュメント

サポート

Cloud Save プレイヤーデータ

Understand how Cloud Save stores key and value pairs associated with players, and how you can query data and use different access classes.
読み終わるまでの所要時間 1 分最終更新 23日前

Cloud Save プレイヤーデータは、プレイヤーに関連付けられているデータ用のキー/値ストレージです。プレイヤーデータは、ゲームクライアントおよび Cloud Code からの読み取りと書き込みが可能です。 データが クエリ可能 で、さまざまなアクセスクラスをサポートするようにプレイヤーデータを設定できます。クエリ可能なデータとは、プレイヤーのみが読み取りおよび書き込みできるデータ、他のプレイヤーが見ることができる公開データ、およびプレイヤーが直接変更できないデータを持つことが可能であることを意味します。 Unity Cloud Dashboard を使用して、プレイヤーデータを表示および編集できます。

アクセスクラス

Cloud Save では、プレイヤーデータ に対して 3 つの異なるアクセスクラスがサポートされています。

アクセスクラス

説明

デフォルトデータに対応するプレイヤーによる読み取りと書き込みが可能。
Publicすべてのプレイヤーによる読み取りが可能、データに対応するプレイヤーによる書き込みが可能。
ノート: 公開データは、他のプレイヤーが読み取ることができるうえに、対応するプレイヤーのクライアントが直接書き込むことができるようにしたい、公開プロファイルデータに使用するのに適しています。
保護済みデータに対応するプレイヤーによる読み取りが可能、サーバーからのみ書き込みが可能。
ノート: 保護済みデータは、クライアントサイドのロジックからはそのデータを直接変更できないサーバー認証ロジックのために、Cloud Code またはゲームサーバーで使用するのに適しています。
Cloud Code、ゲームサーバー、Unity CLI、Unity Cloud Dashboard など、サーバー認証コンテキストからプレイヤーデータの読み書きを行うことができます。 クライアントアクセスをさらに制限する場合は、Unity Gaming Services のアクセス制御 を使用できます。例えば、クライアントからのすべての書き込みアクセスを無効にし、Cloud Code またはゲームサーバーからの書き込みアクセスのみを許可することができます。

制限

  • プレイヤーデータ には、アクセスクラスごとに 2000 個のキー/値ペアという制限があります
    • デフォルトアクセスクラスで 2000 個のキー
    • 公開データで 2000 個のキー
    • 保護済みデータで 2000 個のキー
  • プレイヤーデータ には、アクセスクラスごとに合計 5 MiB という制限があります
    • デフォルトアクセスクラスで 5 MiB のデータ
    • 5 MiB の公開データ
    • 5 MiB の保護済みデータ
例えば、プレイヤーはそれぞれ 2.5 KB のキーを 2000 個、または 5 MiB のキーを 1 個持つことができます。

追加リソース