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
返回成就状态：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 内部使用。

成就

 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

返回成就状态：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。

此属性必须为 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()