gpg::SnapshotManager

定义一个接收 CommitResponse 的回调类型。

此回调类型提供给下面的 Commit(*) 和 ResolveConflict(*) 函数。

定义一个接收 FetchAllResponse 的回调类型。

此回调类型提供给下面的 FetchAll(*) 函数。

定义一个回调类型，接收一个 MaxSizeResponse。

此回调类型提供给 GetMaxSize。

定义一个回调类型，接收一个 OpenResponse。

此回调类型提供给下面的 Open(*) 函数。

定义一个回调类型，接收一个 ReadResponse。

此回调类型提供给下面的 Read(*) 函数。

定义一个回调，可以接收来自 ShowSelectUIOperation 的 SnapshotSelectUIResponse。

异步提交提供给快照的数据，并使用提供的元数据对象更新快照的元数据。

操作完成后，调用提供的 CommitCallback。

同步提交提供给快照的数据，并使用提供的元数据对象更新快照的元数据。

同步提交提供给快照的数据，并使用提供的元数据对象更新快照的元数据。

以毫秒为单位指定 timeout。

删除指定的快照。

这将删除本地和服务器上的快照数据。

异步加载当前登录玩家的所有快照数据。

操作完成后，调用提供的 FetchAllCallback。不指定 data_source 使此函数调用等效于调用 FetchAll(DataSource data_source, FetchAllCallback callback)，其中 data_source 指定为 CACHE_OR_NETWORK.

异步加载当前登录玩家的所有快照数据。

操作完成后，调用提供的 FetchAllCallback。将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。

同步加载当前登录玩家的所有快照数据，直接返回 FetchAllResponse。

既不指定 data_source 也不指定 timeout 使此函数调用等效于调用 FetchAllResponse FetchAllBlocking(DataSource data_source, Timeout timeout)，其中 data_source 指定为 CACHE_OR_NETWORK，并且 timeout 指定为 10 年。

同步加载当前登录玩家的所有快照数据，直接返回 FetchAllResponse。

将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。不指定 timeout 使此函数调用等效于调用 FetchAllBlocking FetchAllResponse(DataSource data_source, Timeout timeout)，其中包含您指定的 data_source 值，并且 timeout 指定为 10 年。

同步加载当前登录玩家的所有快照数据，直接返回 FetchAllResponse。

以毫秒为单位指定 timeout。不指定 data_source 使此函数调用等效于调用 FetchAllResponse FetchAllBlocking(DataSource data_source, Timeout timeout)，其中 data_source 指定为 CACHE_OR_NETWORK，并且 timeout 包含您指定的值。

同步加载当前登录玩家的所有快照数据，直接返回 FetchAllResponse。

将 data_source 指定为 CACHE_OR_NETWORK 或 NETWORK_ONLY。以毫秒为单位指定 timeout。

异步获取每个快照的最大数据大小和最大封面图像大小（以字节为单位）。

操作完成后，调用提供的 MaxSizeCallback。

每个快照的最大数据大小保证至少为 3 MB。将来可能会增加。

每个快照封面图像的最大数据大小保证至少为 800 KB。将来可能会增加。

同步获取每个快照的最大数据大小和最大封面图像大小（以字节为单位），直接返回 MaxSizeResponse。

每个快照的最大数据大小保证至少为 3 MB。将来可能会增加。

每个快照封面图像的最大数据大小保证至少为 800 KB。将来可能会增加。

同步获取每个快照的最大数据大小和最大封面图像大小（以字节为单位），直接返回 MaxSizeResponse。

每个快照的最大数据大小保证至少为 3 MB。将来可能会增加。

每个快照封面图像的最大数据大小保证至少为 800 KB。将来可能会增加。

以毫秒为单位指定 timeout。

异步打开具有给定名称的快照。

如果指定的快照尚不存在，则会创建它。操作完成后，调用提供的 OpenCallback。

快照名称必须介于 1 到 100 个非 URL 保留字符之间（a-z、A-Z、0-9 或符号“-”、“.”、“_”或“~”）。

如果另一个设备在当前设备上加载和提交快照之间提交了快照，则可能会发生冲突。您必须解决这些冲突。有关冲突的更多详细信息，请参阅上面的 OpenResponse。

conflict_policy 可以是以下值之一

SnapshotConflictPolicy::MANUAL - 如果发生冲突，则响应的状态为 OpenResponse::VALID_WITH_CONFLICT。您必须使用 SnapshotManager::ResolveConflict 解决冲突。您可能会连续看到多个冲突，因此每次调用 Open 时都应进行检查。这是您将看到冲突的唯一策略。其余策略为您处理解决。此策略确保不会丢失用户对保存游戏状态的任何更改。

SnapshotConflictPolicy::LONGEST_PLAYTIME - 如果发生冲突，将使用具有最大游戏时间值的快照。如果游戏时间长度是“最佳”保存游戏的合理代理，则此策略是一个不错的选择。请注意，对于此策略有效，您必须在保存游戏时使用 SnapshotMetadataChange::Builder::SetPlayedTime()。

SnapshotConflictPolicy::LAST_KNOWN_GOOD - 如果发生冲突，将使用基本快照。如果您的游戏需要快照数据的稳定性，则此策略是一个合理的选择。此策略确保只有未争用的写入才能被玩家看到，从而保证所有客户端都收敛。注意：以前为 SnapshotManager::BASE_WINS

SnapshotConflictPolicy::MOST_RECENTLY_MODIFIED - 如果发生冲突，将使用远程快照。如果您的游戏可以容忍多个设备上的玩家覆盖自己的更改，则此策略是一个合理的选择。由于此策略盲目选择最新的数据，因此玩家的更改可能会丢失。注意：以前为 SnapshotManager::REMOTE_WINS

SnapshotConflictPolicy::HIGHEST_PROGRESS在发生冲突的情况下，将使用具有最高进度值的快照。如果出现平局，则改为选择最后一个已知的良好快照。如果您的游戏使用快照的进度值来确定最佳保存的游戏，则此策略是一个不错的选择。请注意，对于此策略有效，您必须在保存游戏时使用 SnapshotMetadataChange::Builder::SetPlayedTime()。

异步打开具有给定名称的快照。

已弃用。 data_source 被忽略。请改用 Open(file_name, conflict_policy, callback)。

同步打开具有给定名称的快照。

如果指定的快照尚不存在，则会创建它。

有关更多详细信息，请参阅 Open。

同步打开具有给定名称的快照。

如果指定的快照尚不存在，则会创建它。

以毫秒为单位指定 timeout。

有关更多详细信息，请参阅 Open。

同步打开具有给定名称的快照。

已弃用。 data_source 被忽略。请改用 OpenBlocking(file_name, conflict_policy)。

同步打开具有给定名称的快照。

已弃用。 data_source 被忽略。请改用 OpenBlocking(timeout, file_name, conflict_policy)。

异步从磁盘读取快照，并将其复制到内存中。

为了更容易修改，数据按值传递回来。每次调用此函数都会导致完整读取。这意味着通常最好只读取一次快照。操作完成后，调用提供的 ReadCallback。

同步从磁盘读取快照，并将其复制到内存中。

为了更容易修改，数据按值传递回来。每次调用此函数都会导致完整读取。这意味着通常最好只读取一次快照。不指定 timeout 使此函数调用等效于调用 ReadBlocking ReadBlocking(Timeout timeout, const SnapshotMetadata& snapshot_metadata)，其中 timeout 指定为 10 年。

同步从磁盘读取快照并将其复制到内存中。

为了更容易修改，数据按值传递回来。每次调用此函数都会进行完整读取，因此通常只读取一次快照。以毫秒为单位指定 timeout。

异步使用提供的快照中的数据解决冲突。

这将使用指定的快照替换服务器上的数据。请注意，此操作本身也可能导致冲突，在这种情况下，应重复解决。

使用已提交或未通过 Open 打开的快照调用此方法将失败，状态为 BaseStatus::ERROR_INTERNAL。

操作完成后，调用提供的 OpenCallback。

异步使用提供的数据解决冲突。

这将使用指定的元数据更改和 contents 替换服务器上的数据。请注意，此操作本身也可能导致冲突，在这种情况下，应重复解决。

元数据更改中未包含的值将解析为当前服务器上的版本。

请注意，contents 的总大小不得超过 GetMaxSize 提供的 maxDataSize。

使用已提交或未通过 Open 打开的快照调用此方法将失败，状态为 BaseStatus::ERROR_INTERNAL。

操作完成后，调用提供的 OpenCallback。

同步使用提供的快照中的数据解决冲突。

这将使用指定的快照替换服务器上的数据。请注意，此操作本身也可能导致冲突，在这种情况下，应重复解决。

使用已提交或未通过 Open 打开的快照调用此方法将失败，状态为 BaseStatus::ERROR_INTERNAL。

同步使用提供的数据解决冲突。

这将使用指定的元数据更改和 contents 替换服务器上的数据。请注意，此操作本身也可能导致冲突，在这种情况下，应重复解决。

元数据更改中未包含的值将解析为当前服务器上的版本。

请注意，contents 的总大小不得超过 GetMaxSize 提供的 maxDataSize。

使用已提交或未通过 Open 打开的快照调用此方法将失败，状态为 BaseStatus::ERROR_INTERNAL。

同步使用提供的快照中的数据解决冲突。

这将使用指定的快照替换服务器上的数据。请注意，此操作本身也可能导致冲突，在这种情况下，应重复解决。

使用已提交或未通过 Open 打开的快照调用此方法将失败，状态为 BaseStatus::ERROR_INTERNAL。

以毫秒为单位指定 timeout。

同步使用提供的数据解决冲突。

这将使用指定的元数据更改和 contents 替换服务器上的数据。请注意，此操作本身也可能导致冲突，在这种情况下，应重复解决。

元数据更改中未包含的值将解析为当前服务器上的版本。

请注意，contents 的总大小不得超过 GetMaxSize 提供的 maxDataSize。

使用已提交或未通过 Open 打开的快照调用此方法将失败，状态为 BaseStatus::ERROR_INTERNAL。

以毫秒为单位指定 timeout。

异步显示快照 UI，允许玩家选择快照或请求新快照。

完成后，选定的快照或新的快照请求将通过 SnapshotSelectUICallback 返回。

ShowSelectUIOperation 的阻塞版本。

允许调用方以毫秒为单位指定超时。超过指定时间后，函数返回 ERROR_TIMEOUT。

ShowSelectUIOperationBlocking 的重载，使用默认超时时间 10 年。