英語で読む

次の方法で共有


Microsoft.Xbox.Wrappers.XGameSave.Provider

XGameSave ラッパーのプライマリ管理クラス。

構文

class Provider

メソッド

メソッド 説明
Initialize セーブ データのラッパーを初期化し、指定されたユーザーのすべてのコンテナーを同期します。
QueryContainers 指定された名前プレフィックスに一致するコンテナー名のベクトルを返します。
QueryContainerBlobs 指定されたコンテナ内の blob (ファイル) を識別する BlobInfo オブジェクトのベクトルを返します。
Load 指定したコンテナー内にある、指定した BLOB (ファイル) からデータを読み込みます。
保存 指定したコンテナー内の BLOB (ファイル) にデータを保存します。
GetQuota セーブ データのラッパーを使用して保存するために使用できるデータ量を返します。
Delete(std::string&) コンテナーとそこに含まれるすべての BLOB (ファイル) を削除します。
Delete(std::string&, std::string&) 指定されたコンテナーから指定された BLOB (ファイル) を削除します。
Delete(std::string&, BlobNames&) 指定されたコンテナーから 1 つ以上の BLOB (ファイル) を削除します。

解説

XGameSave の簡略化されたラッパーは、ユーザーに代わってデータの読み取りと書き込みを可能にし、ゲーム セッション間で永続化し、複数のデバイス間でクラウドと見かけ上同期できるようにする API のセットです。 ラッパー API は、次の 3 つのカテゴリに分類されます。

プロバイダー

gs_provider_t は、ユーザー コンテキストをゲームのセーブ データにバインドするハンドルです。 これは、API の相互作用に必要です。 各プロバイダーには複数のコンテナーを含めることができ、各プロバイダーには 256 MB の既定のクォータがあります。 プロバイダーの操作には次のものが含まれます。

  • クォータの情報
  • コンテナー管理
  • プロバイダーのメタデータ (サービス構成 ID、ユーザー コンテキスト)

コンテナー

コンテナーを使用して、データをグループに論理的に関連付け、アトミックに書き込み、更新、および読み取りを行うことができます。 コンテナーの操作には次のものが含まれます。

  • コンテナー情報とコンテナー ステータスに関するクエリ
  • コンテナー コンテンツのクエリ
  • コンテナー データのアトミック アップデート

バイナリ ラージ オブジェクト (BLOB)

BLOB には、コンテナー内に含まれるデータが含まれています。 BLOB に含めることができるデータの最大量は 16 MBです。

  • BLOB の更新および削除操作はアトミックになるように設計されているため、一連の変更を 1 つの操作でコミットできます。 いずれかの部分が失敗すると、更新全体が失敗します。

要件

ヘッダー: xgamesavewrappers.hpp

サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体

関連項目

Microsoft.Xbox.Wrappers.XGameSave.Provider
XGameSave ラッパー メンバー
セーブデータのシンプルなラッパー
オブザーバー デザイン パターン