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.

読み終わるまでの所要時間 6 分

最終更新 6ヶ月前

Cloud Save プレイヤーデータは、プレイヤーに関連付けられているデータ用のキー/値ストレージです。プレイヤーデータは、ゲームクライアントおよび Cloud Code からの読み取りと書き込みが可能です。

データがクエリ可能で、さまざまなアクセスクラスをサポートするようにプレイヤーデータを設定できます。クエリ可能なデータとは、プレイヤーのみが読み取りおよび書き込みできるデータ、他のプレイヤーが見ることができる公開データ、およびプレイヤーが直接変更できないデータを持つことが可能であることを意味します。

Unity Dashboard を使用して、プレイヤーデータを表示および編集できます。

アクセスクラス

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

アクセスクラス	説明
デフォルト	データに対応するプレイヤーによる読み取りと書き込みが可能。
Public	すべてのプレイヤーによる読み取りが可能、データに対応するプレイヤーによる書き込みが可能。ノート: 公開データは、他のプレイヤーが読み取ることができるうえに、対応するプレイヤーのクライアントが直接書き込むことができるようにしたい、公開プロファイルデータに使用するのに適しています。
保護済み	データに対応するプレイヤーによる読み取りが可能、サーバーからのみ書き込みが可能。ノート: 保護済みデータは、クライアントサイドのロジックからはそのデータを直接変更できないサーバー認証ロジックのために、Cloud Code またはゲームサーバーで使用するのに適しています。

注

ノート: プレイヤーによる読み取りが可能で、サーバーからのみ書き込みが可能なデータが必要な場合は、デフォルトゲームデータを使用できます。

Cloud Code、ゲームサーバー、Unity CLI、Unity 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 個持つことができます。