XBOX サービス Title Storage の機能
XBOX サービス Title Storage には、次のような高レベルの機能が含まれます。- プレイヤー、タイトル、さまざまなプラットフォーム間で共有できる
- JSON、バイナリ、および構成ファイルをサポートする
ストレージの種類
スロットル制限
タイトルが 1 分間に行える読み取りと書き込みの数に制限はありませんが、通常、1 時間セッションあたり平均して 1 分間に 1 回を超えることはできません。たとえば、タイトルはセッションの開始時に 60 回の読み取りまたは書き込みを行うことができますが、その時間の残りの部分ではそれ以上行えません。要求のスロットルが必要になった場合に備えて、タイトルは後で追加の呼び出しを行わないよう堅牢化する必要があります。タイトルに追加の読み取りや書き込みなど、特別なパーティション要件がある場合は、Microsoft の担当者にお問い合わせください。
データの種類
このセクションでは、サポートされる 3 種類について説明します。バイナリ情報
バイナリ情報には、画像、サウンド、カスタム データなどが含まれます。データは HTTP 経由で送信する必要があるため、バイナリ データは HTTP が受け付ける文字にエンコードする必要があります。たとえば、データを 16 進文字列に変換したり、base64 エンコードを使用したりできます。Title Storage はエンコードされたデータを処理しないため、Title Storage からの読み取りおよび Title Storage への書き込みの際、ゲームはエンコードとデコードで同じ方式を使用する必要があります。JSON 情報
JSON 情報には、構造化データ (キーと値のペア) が含まれます。JavaScript など、JSON オブジェクトをサポートする言語で JSON オブジェクトを使用できます。JSON ファイルからデータを取得する場合、ゲームはselectQuery パラメーターを指定して、構造内の特定のアイテムを返せます。たとえば、次の情報を含む JSON ファイルを使用できます。
セキュリティ上の理由から、JSON データの最初の要素は配列であってはなりません。ルートに配列を含む JSON データが送信された場合、サービスによって拒否されます。
selectQuery として選択できます (たとえば、weapon.name)。その後、次の内容を受け取ります。
構成情報
構成 blob は、グローバル タイトル ストレージに格納されるデータ構造です。構成 blob の形式は、JSON オブジェクトの形式に似ています。構成 blob には、いくつかの候補の中から設定を返す仮想ノードを含めることができます。仮想ノードは、タイトルやロケールなど、特定の状況に応じた設定を提供するのに役立ちます。仮想ノードには、値のリストと、その値の中から選択するための条件を含む複数の可能な設定が含まれます。次の例では、defaultCardDesign 設定は、仮想ノード内の値のいずれかを取ることができます。
\_sourceNodes 配列内の値のいずれかを選択します。この場合、アイテムはゲームのタイトル ID に基づいて選択されます。たとえば、ゲーム 12456799 をプレイしているプレイヤーには、次の内容が表示されます。
customSelector パラメーターに文字列を渡します。たとえば、2 番目のオプションを取得するには、ゲームは selectQuery として gameMode.serious を要求します。
XBOX サービス Title Storage を使い始めるには
- どの種類のデータを格納するかを決定します。例としては、セーブされたゲーム、ゲーム状態、デイリー チャレンジ、ゲーム マップ、アート リソースが挙げられます。
- どのタイトルとプラットフォームがデータにアクセスする必要があるかを決定します。Title Storage は、単一のプラットフォーム上の単一のタイトルからのクラウド データ アクセス、および複数のプラットフォーム上の複数のタイトルからのクラウド データ アクセスをサポートしています。