gpg::成就

#include <achievement.h>

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

摘要

数据包括两类:特定于用户的类型(例如用户是否解锁了成就等)和全局类型(例如成就名称)。

构造函数和析构函数

Achievement()
Achievement(std::shared_ptr< const AchievementImpl > impl)
构造从 shared_ptrAchievementImpl成就。供 API 内部使用。
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
返回成就状态:HIDDENREVEALEDUNLOCKED
TotalSteps() const
uint32_t
返回玩家解锁指定增量成就所需的总步数。
Type() const
返回成就类型:INCREMENTALSTANDARD
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_ptrAchievementImpl成就。供 API 内部使用。

成就

 Achievement(
  const Achievement & copy_from
)

创建现有成就的副本。

成就

 Achievement(
  Achievement && move_from
)

移动现有的成就

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 时才能调用该方法。

LastModified

Timestamp LastModified() const 

已弃用。 首选 LastModifiedTime。

LastModifiedTime

Timestamp LastModifiedTime() const 

返回条目的上次修改时间(以自 Unix 纪元起经过的毫秒数表示)。

只有当 Achievement::Valid() 返回 true 时才能调用该方法。

名称

const std::string & Name() const 

返回成就的简称。

最多 100 个字符。只有当 Achievement::Valid() 返回 true 时才能调用该方法。

RevealedIconUrl

const std::string & RevealedIconUrl() const 

返回指向此成就的已显示图标图片的网址。

成就已显示但尚未解锁时,系统就会显示此图标。只有当 Achievement::Valid() 返回 true 时才能调用此函数。

状态

AchievementState State() const 

返回成就状态:HIDDENREVEALEDUNLOCKED

只有当 Achievement::Valid() 返回 true 时才能调用该方法。如需了解详情,请点击此处

TotalSteps

uint32_t TotalSteps() const 

返回玩家解锁指定增量成就所需的总步数。

只有当 Achievement::Valid() 返回 true 时才能调用该方法。

类型

AchievementType Type() const 

返回成就类型:INCREMENTALSTANDARD

只有当 Achievement::Valid() 返回 true 时才能调用该方法。如需了解详情,请点击此处

UnlockedIconUrl

const std::string & UnlockedIconUrl() const 

返回指向此成就的未锁定图标图片的网址。

该图标应该在成就已解锁时显示(因此也会显示)。只有当 Achievement::Valid() 返回 true 时才能调用此函数。

有效

bool Valid() const 

如果返回的成就已填充数据且有成功响应状态,则返回 true;如果返回的成就有未填充的用户创建的成就或已填充的响应状态为失败,则返回 false。

此成就的 getter 函数(id、Name、Description 等)必须为 true,才能使用。

XP

uint64_t XP() const 

此成就所奖励的经验值数。

只有当 Achievement::Valid() 返回 true 时才能调用该方法。

运算符=

Achievement & operator=(
  const Achievement & copy_from
)

通过复制其他成就来分配此成就

运算符=

Achievement & operator=(
  Achievement && move_from
)

通过将另一成就中移至此成就来分配此成就。

~成就感

 ~Achievement()