gpg:: AchievementManager
#include <achievement_manager.h>
获取和设置各种与成就相关的数据。
摘要
公共类型 |
|
---|---|
FetchAllCallback
|
typedefstd::function< void(const FetchAllResponse &)>
定义接收 FetchAllResponse 的回调类型。 |
FetchCallback
|
typedefstd::function< void(const FetchResponse &)>
定义接收 FetchResponse 的回调类型。 |
ShowAllUICallback
|
typedefstd::function< void(const UIStatus &)>
定义接收 UIStatus 的回调类型。 |
公共函数 |
|
---|---|
Fetch(const std::string & achievement_id, FetchCallback callback)
|
void
异步加载当前已登录玩家的特定成就的数据。
|
Fetch(DataSource data_source, const std::string & achievement_id, FetchCallback callback)
|
void
异步加载当前已登录玩家的特定成就的数据。
|
FetchAll(FetchAllCallback callback)
|
void
异步加载当前已登录玩家的所有成就数据。
|
FetchAll(DataSource data_source, FetchAllCallback callback)
|
void
异步加载当前已登录玩家的所有成就数据。
|
FetchAllBlocking()
|
同步加载当前已登录玩家的所有成就数据,直接返回
FetchAllResponse 。 |
FetchAllBlocking(DataSource data_source)
|
同步加载当前已登录玩家的所有成就数据,直接返回
FetchAllResponse 。 |
FetchAllBlocking(Timeout timeout)
|
同步加载当前已登录玩家的所有成就数据,直接返回
FetchAllResponse 。 |
FetchAllBlocking(DataSource data_source, Timeout timeout)
|
同步加载当前已登录玩家的所有成就数据,直接返回
FetchAllResponse 。 |
FetchBlocking(const std::string & achievement_id)
|
同步加载当前已登录玩家的具体成就数据(通过字符串 ID 标识);直接返回
FetchResponse 。 |
FetchBlocking(DataSource data_source, const std::string & achievement_id)
|
同步加载当前已登录玩家的具体成就数据(通过字符串 ID 标识);直接返回
FetchResponse 。 |
FetchBlocking(Timeout timeout, const std::string & achievement_id)
|
同步加载当前已登录玩家的具体成就数据(通过字符串 ID 标识);直接返回
FetchResponse 。 |
FetchBlocking(DataSource data_source, Timeout timeout, const std::string & achievement_id)
|
同步加载当前已登录玩家的具体成就数据(通过字符串 ID 标识);直接返回
FetchResponse 。 |
Increment(const std::string & achievement_id)
|
void
将成就增加指定的步数。
|
Increment(const std::string & achievement_id, uint32_t steps)
|
void
将成就增加指定的步数。
|
Reveal(const std::string & achievement_id)
|
void
向当前登录的玩家显示隐藏的成就。
|
SetStepsAtLeast(const std::string & achievement_id, uint32_t steps)
|
void
将成就设置为至少完成给定步数。
|
ShowAllUI(ShowAllUICallback callback)
|
void
向用户显示一个显示所有成就相关信息的界面。
|
ShowAllUI()
|
void
|
ShowAllUIBlocking()
|
向用户显示一个显示所有成就相关信息的界面。
|
ShowAllUIBlocking(Timeout timeout)
|
向用户显示一个显示所有成就相关信息的界面。
|
Unlock(const std::string & achievement_id)
|
void
为当前已登录的玩家解锁成就。
|
结构体 |
|
---|---|
gpg:: |
保存所有成就的所有数据以及回答状态。 |
gpg:: |
包含单个成就的数据和响应状态。 |
公共类型
FetchAllCallback
std::function< void(const FetchAllResponse &)> FetchAllCallback
定义接收 FetchAllResponse
的回调类型。
此回调类型会提供给以下 FetchAll(*)
函数。
FetchCallback
std::function< void(const FetchResponse &)> FetchCallback
定义接收 FetchResponse
的回调类型。
此回调类型会提供给以下 Fetch(*)
函数。
ShowAllUICallback
std::function< void(const UIStatus &)> ShowAllUICallback
定义接收 UIStatus
的回调类型。
此回调类型会提供给下面的 ShowAllUI*
函数。
公共函数
提取
void Fetch( const std::string & achievement_id, FetchCallback callback )
异步加载当前已登录玩家的特定成就的数据。
在操作完成时调用提供的 FetchCallback
。如果未指定 data_source
,此函数调用等同于调用 Fetch(DataSource data_source, const std::string& id,
FetchCallback)
,并将 data_source
指定为 CACHE_OR_NETWORK
。
提取
void Fetch( DataSource data_source, const std::string & achievement_id, FetchCallback callback )
异步加载当前已登录玩家的特定成就的数据。
在操作完成时调用提供的 FetchCallback
。将 data_source 指定为 CACHE_OR_NETWORK
或 NETWORK_ONLY
。
FetchAll
void FetchAll( FetchAllCallback callback )
异步加载当前已登录玩家的所有成就数据。
在操作完成时调用提供的 FetchAllCallback
。如果未指定 data_source
,此函数调用等同于调用 FetchAll(DataSource data_source, FetchAllCallback)
,并将 data_source
指定为 CACHE_OR_NETWORK
。
FetchAll
void FetchAll( DataSource data_source, FetchAllCallback callback )
异步加载当前已登录玩家的所有成就数据。
在操作完成时调用提供的 FetchAllCallback
。将 data_source
指定为 CACHE_OR_NETWORK
或 NETWORK_ONLY
。
FetchAllBlocking
FetchAllResponse FetchAllBlocking()
同步加载当前已登录玩家的所有成就数据,直接返回 FetchAllResponse
。
如果 data_source
和 timeout
均不指定,则此函数调用等同于调用 FetchAllResponse FetchAllBlocking(DataSource data_source,
Timeout timeout)
,其中 data_source
指定为 CACHE_OR_NETWORK
,timeout
指定为 10 年。
FetchAllBlocking
FetchAllResponse FetchAllBlocking( DataSource data_source )
同步加载当前已登录玩家的所有成就数据,直接返回 FetchAllResponse
。
将 data_source
指定为 CACHE_OR_NETWORK
或 NETWORK_ONLY
。如果未指定 timeout
,则此函数调用等同于调用 FetchAllBlocking FetchAllResponse(DataSource data_source,
Timeout timeout)
,使用指定的 data_source
值和 timeout
指定为 10 年。
FetchAllBlocking
FetchAllResponse FetchAllBlocking( Timeout timeout )
同步加载当前已登录玩家的所有成就数据,直接返回 FetchAllResponse
。
将 timeout
指定为任意毫秒数。如果未指定 data_source
,此函数调用等同于调用 FetchAllResponse FetchAllBlocking(DataSource data_source,
Timeout timeout)
,其中 data_source
指定为 CACHE_OR_NETWORK
,timeout
包含您指定的值。
FetchAllBlocking
FetchAllResponse FetchAllBlocking( DataSource data_source, Timeout timeout )
同步加载当前已登录玩家的所有成就数据,直接返回 FetchAllResponse
。
将 data_source
指定为 CACHE_OR_NETWORK
或 NETWORK_ONLY
。将超时指定为任意毫秒数。
FetchBlocking
FetchResponse FetchBlocking( const std::string & achievement_id )
同步加载当前已登录玩家的具体成就数据(通过字符串 ID 标识);直接返回 FetchResponse
。
如果不指定 data_source
和 timeout
,则此函数调用等同于调用 FetchResponse FetchBlocking(DataSource data_source,
Timeout timeout, const std::string& id)
,其中 data_source
指定为 CACHE_OR_NETWORK
,timeout
指定为 10 年。
FetchBlocking
FetchResponse FetchBlocking( DataSource data_source, const std::string & achievement_id )
同步加载当前已登录玩家的具体成就数据(通过字符串 ID 标识);直接返回 FetchResponse
。
将 data_source
指定为 CACHE_OR_NETWORK
或 NETWORK_ONLY
。如果不指定 timeout
,则此函数调用等同于调用 FetchResponse FetchBlocking(DataSource data_source,
Timeout timeout, const std::string& id)
,使用您指定的 data_source
值,将 timeout
指定为 10 年。
FetchBlocking
FetchResponse FetchBlocking( Timeout timeout, const std::string & achievement_id )
同步加载当前已登录玩家的具体成就数据(通过字符串 ID 标识);直接返回 FetchResponse
。
将 timeout
指定为任意毫秒数。如果不指定 data_source
,则此函数调用等同于调用 FetchResponse FetchBlocking(DataSource data_source,
Timeout timeout, const std::string& id)
,其中 data_source
指定为 CACHE_OR_NETWORK
,timeout
包含您指定的值。
FetchBlocking
FetchResponse FetchBlocking( DataSource data_source, Timeout timeout, const std::string & achievement_id )
同步加载当前已登录玩家的具体成就数据(通过字符串 ID 标识);直接返回 FetchResponse
。
将 data_source
指定为 CACHE_OR_NETWORK
或 NETWORK_ONLY
。将 timeout
指定为任意毫秒数。
递增
void Increment( const std::string & achievement_id )
将成就增加指定的步数。
增量未定义会导致其值默认为 1。成就必须是增量成就。成就达到步骤数上限后,会自动解锁。任何进一步的增量都会被忽略。
递增
void Increment( const std::string & achievement_id, uint32_t steps )
将成就增加指定的步数。
成就必须是增量成就。成就达到步骤数上限后,会自动解锁。任何进一步的增量都将被忽略。
Reveal
void Reveal( const std::string & achievement_id )
向当前登录的玩家显示隐藏的成就。
如果成就已解锁,则不会产生任何影响。
SetStepsAtLeast
void SetStepsAtLeast( const std::string & achievement_id, uint32_t steps )
将成就设置为至少完成给定步数。
当成就的步数超过提供的值时调用此方法,便是空操作。成就达到步数上限后,成就会自动解锁,且任何进一步的变更操作都会被忽略。
ShowAllUI
void ShowAllUI( ShowAllUICallback callback )
向用户显示一个显示所有成就相关信息的界面。
它会异步调用 ShowAllUICallback
。
ShowAllUI
void ShowAllUI()
已弃用。 首选 ShowAllUI(ShowAllUICallback callback)。向用户显示显示所有成就相关信息的界面。界面在所有平台上异步显示。
ShowAllUIBlocking
UIStatus ShowAllUIBlocking()
向用户显示一个显示所有成就相关信息的界面。
它会同步返回一个 UIStatus
。如果未指定 timeout
,则此函数调用等同于调用 ShowAllUIBlocking(Timeout timeout)
并将 timeout
指定为 10 年。
ShowAllUIBlocking
UIStatus ShowAllUIBlocking( Timeout timeout )
向用户显示一个显示所有成就相关信息的界面。
它会同步返回一个 UIStatus
。将 timeout
指定为任意毫秒数。
解锁
void Unlock( const std::string & achievement_id )
为当前已登录的玩家解锁成就。
如果成就处于隐藏状态,SDK 也会显示。