gpg:: 成就
#include <achievement.h>
允许您访问特定成就状态相关数据的单一数据结构。
摘要
数据包括两类:特定于用户的类型(例如用户是否解锁了成就等)和全局类型(例如成就名称)。
构造函数和析构函数 |
|
---|---|
Achievement()
|
|
Achievement(std::shared_ptr< const AchievementImpl > impl)
|
|
Achievement(const Achievement & copy_from)
创建现有成就的副本。
|
|
Achievement(Achievement && move_from)
移动现有的成就。
|
|
~Achievement()
|
公共函数 |
|
---|---|
CurrentSteps() const
|
uint32_t
返回玩家解锁分步成就的步数。
|
Description() const
|
const std::string &
返回成就的简要说明。
|
Id() const
|
const std::string &
返回 Google Play 管理中心事先生成的唯一字符串。
|
LastModified() const
|
已弃用。 首选 LastModifiedTime。 |
LastModifiedTime() const
|
返回条目的上次修改时间(以自 Unix 纪元起经过的毫秒数表示)。
|
Name() const
|
const std::string &
返回成就的简称。
|
RevealedIconUrl() const
|
const std::string &
返回指向此成就的已显示图标图片的网址。
|
State() const
|
返回成就状态:
HIDDEN 、REVEALED 或 UNLOCKED 。 |
TotalSteps() const
|
uint32_t
返回玩家解锁指定增量成就所需的总步数。
|
Type() const
|
返回成就类型:
INCREMENTAL 或 STANDARD 。 |
UnlockedIconUrl() const
|
const std::string &
返回指向此成就的未锁定图标图片的网址。
|
Valid() const
|
bool
如果返回的成就已填充数据且有成功响应状态,则返回 true;如果返回的成就有未填充的用户创建的成就或已填充的响应状态为失败,则返回 false。
|
XP() const
|
uint64_t
此成就所奖励的经验值数。
|
operator=(const Achievement & copy_from)
|
通过复制其他成就来分配此成就。
|
operator=(Achievement && move_from)
|
通过将另一成就中移至此成就来分配此成就。
|
公共函数
成就
Achievement()
成就
Achievement( std::shared_ptr< const AchievementImpl > impl )
构造从 shared_ptr
到 AchievementImpl
的成就。供 API 内部使用。
CurrentSteps
uint32_t CurrentSteps() const
返回玩家解锁分步成就的步数。
只有当 Achievement::Valid() 返回 true 时才能调用该方法。
说明
const std::string & Description() const
返回成就的简要说明。
通常会告知玩家如何达成成就。最多 500 个字符。只有当 Achievement::Valid() 返回 true 时才能调用该方法。
ID
const std::string & Id() const
返回 Google Play 管理中心事先生成的唯一字符串。
用它来指代游戏客户端中的成就。只有当 Achievement::Valid() 返回 true 时才能调用该方法。
LastModifiedTime
Timestamp LastModifiedTime() const
返回条目的上次修改时间(以自 Unix 纪元起经过的毫秒数表示)。
只有当 Achievement::Valid() 返回 true 时才能调用该方法。
RevealedIconUrl
const std::string & RevealedIconUrl() const
返回指向此成就的已显示图标图片的网址。
当成就已显示但尚未解锁时,系统就会显示此图标。只有当 Achievement::Valid() 返回 true 时才能调用此函数。
状态
AchievementState State() const
返回成就状态:HIDDEN
、REVEALED
或 UNLOCKED
。
只有当 Achievement::Valid() 返回 true 时才能调用该方法。如需了解详情,请点击此处。
TotalSteps
uint32_t TotalSteps() const
返回玩家解锁指定增量成就所需的总步数。
只有当 Achievement::Valid() 返回 true 时才能调用该方法。
类型
AchievementType Type() const
返回成就类型:INCREMENTAL
或 STANDARD
。
只有当 Achievement::Valid() 返回 true 时才能调用该方法。如需了解详情,请点击此处。
UnlockedIconUrl
const std::string & UnlockedIconUrl() const
返回指向此成就的未锁定图标图片的网址。
该图标应该在成就已解锁时显示(因此也会显示)。只有当 Achievement::Valid() 返回 true 时才能调用此函数。
有效
bool Valid() const
如果返回的成就已填充数据且有成功响应状态,则返回 true;如果返回的成就有未填充的用户创建的成就或已填充的响应状态为失败,则返回 false。
此成就的 getter 函数(id、Name、Description 等)必须为 true,才能使用。
~成就感
~Achievement()