值类型

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

摘要

Manager 上的访问器方法以 <status, valuetype=""> 对的形式提供结果,可以是异步(通过回调)或同步(在阻塞访问器的情况下)。</status,>

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

值类型对象是不可变的,并且会反映在调用提供这些对象的访问器时刻的基础数据的一致视图。

值类型对象可移动且可高效复制。

复杂或复制开销较高的值类型对象的属性会以引用方式返回。返回的引用的生命周期仅限于值类型对象的生命周期。

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

gpg::成就

一个数据结构,可让您访问与特定成就的状态相关的数据。

gpg::Event

一个数据结构,其中包含有关特定事件状态的数据。

gpg::排行榜

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

gpg::MultiplayerInvitation

一个数据结构,其中包含有关回合制比赛邀请的当前状态的数据。

gpg::MultiplayerParticipant

一个数据结构,其中包含多人对战参与者的数据。

gpg::ParticipantResults

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

gpg::Player

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

gpg::PlayerLevel

一个数据结构,其中包含有关玩家等级的数据。

gpg::PlayerStats

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

gpg::RealTimeRoom

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

gpg::RealTimeRoomConfig

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

gpg::Score

单个数据结构,可让您访问与玩家得分相关的数据。

gpg::ScorePage

一个数据结构,可让您访问得分数据。

gpg::ScorePage::Entry

用于在成绩页面上创建条目的类。

gpg::ScorePage::ScorePageToken

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

gpg::ScoreSummary

一个数据结构,可让您访问得分信息摘要。

gpg::SnapshotMetadata

一个数据结构,可让您访问有关特定快照元数据状态的数据。

gpg::SnapshotMetadataChange

一个数据结构,可让您访问与特定快照状态相关的数据。

gpg::SnapshotMetadataChange::CoverImage

一个数据结构,可让您访问特定封面图片状态的数据。

gpg::TurnBasedMatch

一个数据结构,其中包含有关 TurnBasedMatch 当前状态的数据。

gpg::TurnBasedMatchConfig

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