Microsoft.Xbox.Wrappers.XGameSave.Provider
XGameSave 包装器的主管理类。
语法
class Provider
方法
| 方法 | 说明 |
|---|---|
| 初始化 | 对保存游戏包装器进行初始化，并为该游戏的特定用户强制同步所有容器。 |
| QueryContainers | 返回与提供的名称前缀匹配的容器名称向量。 |
| QueryContainerBlobs | 返回 BlobInfo 对象的向量，确定指定容器中的 blob （文件）。 |
| 负载 | 从指定容器内的给定 blob（文件）中加载数据。 |
| 保存 | 将数据保存到指定容器内的指定 blob（文件）中。 |
| GetQuota | 返回可使用保存游戏包装器存储的数据量。 |
| Delete(std::string&) | 删除容器及其所有 blob（文件）。 |
| Delete(std::string&, std::string&) | 从指定容器中删除指定的 blob (文件)。 |
| 删除 (std::string&, BlobNames&) | 从指定容器中删除一个或多个 blob（文件）。 |
备注
XGameSave 简化包装器是一组 API，支持代表用户读写数据，在游戏会话中持久化，并在多个设备上与云无缝同步。 包装器 API 分为三类：
提供程序
gs_provider_t 是将用户上下文绑定到游戏存储的句柄。 它是 API 交互所必需的。 每个提供程序可以包含多个容器，并且每个提供程序的默认配额为 256 MB。 提供程序操作包括：
- 配额信息
- 容器管理
- 提供程序元数据（服务配置 ID、UserContext）
容器
可以使用容器将数据逻辑关联到可自动写入、更新和读取的组。 容器操作包括：
- 查询容器信息和容器状态
- 容器内容查询
- 容器数据的原子更新
二进制大型对象 (BLOB)
BLOB 包含容器中包含的数据。 BLOB 可以包含的最大数据量为 16 MB。
- BLOB 更新和删除操作被设计为原子操作，因此可以在一个操作中提交一组更改。 任何部分失败将导致整个更新失败。
要求
头文件：xgamesavewrappers.hpp
支持平台：Windows、Xbox One 系列主机和 Xbox Series 主机
另请参阅
Microsoft.Xbox.Wrappers.XGameSave.Provider
XGameSave 包装器成员
游戏存档简化包装器
观察者设计模式