值类型

表示游戏服务数据的不可变值类型。

摘要

管理器上的访问器方法以 <status, valuetype=""> 对的形式提供结果,这些结果可以异步(通过回调)或同步(如果访问器是阻塞访问器)的形式提供。</status,>

值类型对象可以是有效值(表示有效值),也可以是无效值。如果状态随值类型对象 IsSuccess() 一起返回,则关联值将始终有效;如果状态 IsError(),则关联值将始终无效。您可以直接通过每个值类型对象上的 Valid() 方法测试其有效性。调用无效值类型对象中的 Valid() 以外的方法是一种错误,应避免调用。

值类型对象是不可变的,并且会在调用提供它们的访问器时反映底层数据的一致视图。

值类型对象可以移动并高效地复制。

复杂或复制成本高的值类型对象的属性由引用返回。所返回引用的生命周期受限于值类型对象的生命周期。

可以使用用于将值类型对象转换为调试字符串或将其输出到调试流的辅助方法。这些方法提供的人类可读表示法仅用于日志记录和调试目的,不应被视为稳定版本。

gpg::成就

允许您访问特定成就状态相关数据的单一数据结构。

gpg:: 事件

包含特定事件状态相关数据的单个数据结构。

gpg::排行榜

单一数据结构,可让您访问与特定排行榜的状态有关的数据,例如其名称和有效性。

gpg::MultiplayerInvitation

一个数据结构,包含回合制对局邀请的当前状态数据。

gpg::Multiplayer 参与者

包含多人游戏对局中某位参与者的数据的数据结构。

gpg::PARTICIPANTResults

一个数据结构,包含有关 TurnBasedMatch 中每位参与者结果的数据。

gpg::播放器

一种数据结构,可让您访问特定玩家的相关数据。

gpg::PlayerLevel

包含玩家关卡相关数据的单个数据结构。

gpg::PlayerStats

一种数据结构,可让您访问特定玩家的相关数据。

gpg::RealTimeRoom

包含实时多人游戏房间当前状态的数据结构。

gpg::RealTimeRoomConfig

包含创建 RealTimeRoom 对象所需数据的数据结构。

gpg::评分

单一数据结构,可让您访问有关玩家得分的数据。

gpg::ScorePage

允许您访问得分数据的单一数据结构。

gpg::ScorePage::Entry

用于在得分页面上创建条目的类。

gpg::ScorePage::ScorePageToken

一种近乎不透明类型的数据结构,表示对 ScorePage 的查询(或为空)。

gpg::ScoreSummary

允许您访问得分信息摘要的单一数据结构。

gpg::SnapshotMetadata

允许您访问特定快照元数据状态相关数据的单一数据结构。

gpg::SnapshotMetadataChange

允许您访问特定快照状态相关数据的单一数据结构。

gpg::SnapshotMetadataChange::CoverImage

允许您访问特定封面图片状态相关数据的单一数据结构。

gpg::TurnBasedMatch

包含 TurnBasedMatch 当前状态的相关数据的数据结构。

gpg::TurnBasedMatchConfig

包含创建 TurnBasedMatch 所需数据的数据结构。