ドキュメント

サポート

Cloud Save

Unity SDK tutorial

Cloud Save for Cloud Code

Open Unity Dashboard

Cloud Save

Cloud Save クエリ

Understand indexes and query types for both numerical and text data stored in player and game data.
読み終わるまでの所要時間 2 分最終更新 23日前
Cloud Save を使用すると、プレイヤーデータ と ゲームデータ に保存された数値データとテキストデータの両方のクエリを実行できます。 ギルドやクランシステムを作成する、マッチメイキングを追加する、経済システムやオークションハウスを実装する、マルチプレイヤー環境で NPC やアイテムのデータを返すなど、さまざまな目的でクエリを使用できます。

インデックスの作成

Cloud Save 内のデータは、クエリを実行する前にインデックスを作成する必要があります。インデックスの作成と管理は Unity Cloud Dashboard、Unity CLI、または Admin REST API で行うことができます。 個々の Cloud Save キーでインデックスを形成することも、複数のキーを特定の順序で組み合わせて複合インデックスを形成することもできます。Cloud Save は、各キーを、インデックスを昇順と降順のどちらでソートするかを指定するブーリアン値でマークします。インデックスを使用するのに、追加料金はかかりません。

クエリタイプ

Cloud Save では、以下のタイプのクエリがサポートされています。 
  • EQ
    - 等しい
  • NE
    - 等しくない
  • LT
    - より小さい
  • LE
    - 以下
  • GT
    - より大きい
  • GE
    - 以上
Cloud Save は、文字列データの場合は辞書的に、数値データの場合は数値的に、値をインデックス化された値と比較します。

ランダムサンプリング

Cloud Save では、(デフォルトの動作である) ページ分割可能なソートされた結果セット全体を返す必要がない場合に、クエリ結果のランダムサンプルを返すことができます。 この機能を使用するには、クエリを実行するときに 
sampleSize
オプションを渡し、Cloud Save が返す結果の最大数を指定します。 プレイヤーが参加できるギルドのリストを表示したり、同じような統計値の 2 人のプレイヤーをランダムに対戦させたりといったユースケースにサンプリングを使用できます。

制限

クエリの制限

クライアントまたはサーバーからクエリを実行できるデータは、インデックス化されたキーの アクセスクラス によって定義されます。

インデックスの制限

  • インデックス化できる値の最大サイズは 128 バイトです。 128 バイトを超える値はインデックス化されません。128 バイトを超える値をインデックス化されたキーに書き込もうとすると、失敗します (データは Cloud Save に保存されますが、インデックス化されません)。
  • 最大 20 個のキーを定義可能で、すべてのインデックス、すべてのアクセスクラス、プレイヤー状態およびゲーム状態にわたってキーをインデックス化できます。 つまり、インデックス化されたキーの合計数が制限を超えない限り、インデックス化されたキー 1 個を含む最大 20 個のインデックス、キー 20 個を含む 1 つのインデックス、あるいはその中間の任意の組み合わせを持つことができます。

追加リソース