カタログ ビュー (プライベート プレビュー)
注意
カタログ ビューは現在プライベート プレビュー段階です。 この機能にアクセスするには、カタログ ビューのプライベート ビューへのアクセスという件名で、PlayFab タイトル ID を記載したメールを PFEconomyPreviews@microsoft.com にお送りいただければ、ご使用の環境でこの機能の使用を開始できるよう手配します。
ゲームは起動時にアイテムを読み込むことで、スムーズでシームレスなプレイヤー エクスペリエンスを実現します。 メイン メニューのグラフィックス、キャラクター モデル、環境テクスチャなどの重要なアセットを事前に読み込むことで、ゲームは待機時間を最小限に抑え、プレイヤーにゲームのコンテンツへの迅速なアクセスを提供できます。 ただし、ゲームの起動中にアイテムを読み込むには、アセットのサイズや複雑さ、ネットワークの待機時間、アセットの圧縮と展開などのさまざまな要因により、長い時間がかかる場合があります。この問題に対処するために、PlayFab Economy V2 ではカタログ ビューが導入されています。
カタログ ビューは、コンテンツ配信ネットワーク (CDN) を介してアクセスできる、クエリ結果の定期的に更新されるストレージ BLOB です。 これらのパブリックおよびプライベート ビューを呼び出してゲームに適用できます。 この非同期更新により、キャッシュ メカニズムを適用することでパフォーマンスが向上するため、あまり頻繁に検索クエリを実行せずにすむようになります。 このアプローチは、全体的な効率を向上させるだけでなく、PlayFab に対する API 呼び出しの数を最小限に抑えることでコストも削減します。
定義
カタログ ビュー: 検索クエリを定義するメタデータのコレクションです。 これは、検索結果を表す BLOB を非同期的かつ定期的に更新するために使用されます。
カタログ ビュー BLOB: 検索クエリを表すカタログ ビューによって作成される BLOB です。
パブリック ビュー: パブリック ビューは、ビューの既定のアクセス状態です。 この種類のビューでは、CDN 経由でアクセスできるパブリック BLOB が生成されます。 この BLOB には、検索の動作と一貫性のある、すべてのユーザーに公開されている情報が含まれています。 たとえば、タイトル限定のアイテムは除外され、開始日と終了日の範囲外の項目も排除されます。 カタログ ビューには、タイトル ビューまたはパブリック ビューを指定できます。
タイトル ビュー: タイトル ビューは、すべてのアイテム メタデータが含まれていて、ユーザーではなくタイトルが使用することを意図したカタログ ビューです。 この種類のビューでは、プライベート BLOB が生成されます。この BLOB には、GetView API 呼び出しで取得できる SAS トークンを介して CDN 経由でアクセスできます。 カタログ ビューには、タイトル ビューまたはパブリック ビューを指定できます。
更新の遅延: ビュー BLOB を更新するまでの最小時間です。 プレビューのすべてのビューには 1 日の更新遅延があり、この遅延はビュー BLOB の更新にのみ適用されます。 ビュー BLOB の初回の作成は、ビューが処理されるとすぐに行われます。
概念
含まれるカタログ アイテム: ビューに含めることができるのは公開済みアイテムのみであり、下書きのアイテムでは使用できません。 ビュー BLOB に含まれるアイテムは、ビューのアクセス状態 (タイトルまたはパブリック) と指定された検索クエリによって決まります。
制限:
現時点では、最大 10 個のカタログ ビューを作成できます。
ビュー BLOB は 500 MB までで、最大 10,000 個のアイテムのみを含めることができます。
ビューの検索クエリの複雑さには、検索自体の制限と同様に制限があり、ビューの作成および更新時に適用されます。
CDN の構成:
ビュー BLOB は、views.prod.catalog.playfab.com を通じて提供されます
CDN には 30 分のキャッシュがあるため、ビューを削除しても、削除したビュー BLOB には CDN で引き続き 30 分間アクセスできる可能性があります。
ビュー BLOB でサポートされているファイル拡張子:
Json (.json)
JsonLines (.jsonl)
GZippedJson (.gz.json)
GZippedJsonLines (.gz.jsonl)
状態: ビュー BLOB が非同期的に生成されると、最後のビュー BLOB の生成の状態がビューに追加されます。 状態の詳細については、こちらを参照してください:
成功: エラーなしでビュー BLOB が正常に生成されました。
FileSizeExceeded: このエラーはビュー BLOB の作成時に発生し、ファイル サイズのバイト制限または含まれるアイテム数の制限を超えたことを示します。 お客様は、500 MB のファイル サイズと 10,000 のアイテム数を超えていないことを確認する必要があります。
エラー: ビュー BLOB の処理中に致命的かつ予期しないエラーが発生しました。 PlayFab エンジニアに通知され、調査が行われます。
StoreDoesNotExist: ビューが削除されたストアを指定しています。 お客様は、正しい StoreID が入力されていることを確認する必要があります。
TransientError: 必要なサービスの 1 つと通信中に一時的な接続エラーが発生しました。 PlayFab エンジニアに通知され、調査が行われます。
PartialSuccess: ビュー BLOB は正常に生成されましたが、メタデータが無効なため、一部のアイテムを削除する必要がありました。 これらのアイテムが必要な場合、お客様は無効なメタデータを確認して修正する必要があります。
保留中: ビューが新しく作成され、処理が保留中であるため、'最後のビュー BLOB 生成状態' はありません。 お客様による対処は必要ありません。
ゲーム マネージャーでカタログ ビューを作成および更新する
前提条件
- カタログ ビューは現在プライベート プレビュー段階です。 カタログ ビューのプライベート ビューへのアクセスという件名で、PlayFab タイトル ID を記載したメールを PFEconomyPreviews@microsoft.com にお送りいただければ、ご使用の環境でこの機能の使用を開始できるよう手配します。
- PlayFab portal にサインインします。
- [タイトル] に移動します。
新しいビューを作成する
- [Economy] > [カタログ ビュー (V2) (プレビュー)] > [新しいビュー]
の順に選択します。 - 優先するファイルの種類と、パブリック ビューとタイトル ビューのどちらであるかを選択して、静的プロパティを入力します
-
次のビューのプロパティを入力します。 すべてのフィールドは省略可能ですが、一部のフィールドに値を指定すると、クエリを絞り込むのに役立ち、より正確な結果が得られます。
- フレンドリ ID - 新しいビューの名前を参照します。 例: 上位 10 個のアイテム、クリスマス セールのアイテムなど
- カウント - クエリを実行するアイテムの数を参照します。例: 1000。
- 言語 - アイテムの言語エンコードを参照します。 例: en-US、en-CAN など
- 選択 - クエリを実行する特定のプロパティを参照します。 例: 名前、価格など
- フィルター - カタログ アイテムをフィルター処理します。 例: eq 'sword' と入力して、カタログ内のすべての剣をフィルター処理します。
-
ストア ID - クエリを実行するカタログ内のストア ID を参照します。
- ビューが正常に作成されると、最初に選択した形式でビューをダウンロードするためのダウンロード リンクが表示されます。
ビューの削除
- ビューを削除するには、[ビューの概要] ページ>に移動し、[ビュー] > [削除]
