gpg::Achievement

#include <achievement.h>

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

摘要

数据分为两类:特定于用户的数据(例如,用户是否已解锁成就等)和全局数据(例如,成就名称)。

构造函数和析构函数

Achievement()
Achievement(std::shared_ptr< const AchievementImpl > impl)
shared_ptr 构建为 AchievementImpl 成就。供 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_ptr 构建为 AchievementImpl 成就。供 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 管理中心事先生成的唯一字符串。

您可以使用此 ID 引用游戏客户端中的成就。只有当 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。

此属性必须为 true,此成就的 getter 函数(id、名称、说明等)才能使用。

XP

uint64_t XP() const 

此成就可获得的经验值数。

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

operator=

Achievement & operator=(
  const Achievement & copy_from
)

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

operator=

Achievement & operator=(
  Achievement && move_from
)

通过将其他成就移入此成就来分配此成就。

~成就

 ~Achievement()