Microsoft.Xbox.Wrappers.XGameSave.Provider

[アーティクル]
05/09/2023

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

構文

メソッド

解説

要件

関連項目

その他のリソース