gpg:: PlayerManager
#include <player_manager.h>
取得及設定各種玩家相關資料。
摘要
公開類型 |
|
---|---|
FetchCallback
|
typedefstd::function< void(const FetchResponse &)>
定義接收 FetchResponse 的回呼類型。 |
FetchListCallback
|
typedefstd::function< void(const FetchListResponse &)>
定義接收 FetchListResponse 的回呼類型。 |
FetchSelfCallback
|
typedefstd::function< void(const FetchSelfResponse &)>
定義接收 FetchSelfResponse 的回呼類型。 |
Structs |
|
---|---|
gpg:: |
包含玩家向量的回應。 |
gpg:: |
特定 Player 的 |
gpg:: |
包含所有玩家的資料以及回應狀態。 |
公開類型
FetchCallback
std::function< void(const FetchResponse &)> FetchCallback
定義接收 FetchResponse 的回呼類型。
這個回呼類型提供給下方的 Fetch(*)
函式。
FetchListCallback
std::function< void(const FetchListResponse &)> FetchListCallback
定義接收 FetchListResponse 的回呼類型。
這個回呼類型提供給下方的 Fetch(*)
函式。
FetchSelfCallback
std::function< void(const FetchSelfResponse &)> FetchSelfCallback
定義接收 FetchSelfResponse 的回呼類型。
這個回呼類型提供給下方的 FetchSelf(*)
函式。
公開函式
擷取
void Fetch( const std::string & player_id, FetchCallback callback )
以非同步方式載入特定玩家的所有資料。
在作業完成時呼叫提供的 FetchCallback。如未指定 data_source,這個函式呼叫會等同於呼叫 Fetch(DataSource data_source, const std::string& player_id, FetchCallback callback)
,且 data_source 指定為 CACHE_OR_NETWORK。
擷取
void Fetch( DataSource data_source, const std::string & player_id, FetchCallback callback )
以非同步方式載入特定玩家的所有資料。
在作業完成時呼叫提供的 FetchCallback。將 data_source 指定為 CACHE_OR_NETWORK 或 NETWORK_ONLY。
FetchBlocking
FetchResponse FetchBlocking( const std::string & player_id )
直接傳回 FetchResponse,即可同步載入特定玩家的所有資料。
如果未指定 data_source 和逾時,這個函式呼叫會等於呼叫 FetchResponse FetchBlocking(DataSource data_source, timeout timeout), (將 DataSource 指定為 CACHE_OR_NETWORK,逾時設定為 10 年)。
FetchBlocking
FetchResponse FetchBlocking( DataSource data_source, const std::string & player_id )
直接傳回 FetchResponse,即可同步載入特定玩家的所有資料。
將 data_source 指定為 CACHE_OR_NETWORK 或 NETWORK_ONLY。如果未指定逾時設定,這個函式呼叫將等同於呼叫 FetchResponse FetchBlocking(DataSource data_source, Timeout timeout) 和您所指定的 data_source 值及逾時 (以 10 年為定)。
FetchBlocking
FetchResponse FetchBlocking( Timeout timeout, const std::string & player_id )
直接傳回 FetchResponse,即可同步載入特定玩家的所有資料。
指定逾時時間時,單位為毫秒。如果未指定 data_source 值,這個函式呼叫會等同於呼叫 FetchResponse FetchBlocking(DataSource data_source, Timeout timeout) 並使用 data_source 指定為 CACHE_OR_NETWORK 。
FetchBlocking
FetchResponse FetchBlocking( DataSource data_source, Timeout timeout, const std::string & player_id )
同步載入特定玩家的所有資料,直接傳回 FetchResponse。
將 data_source 指定為 CACHE_OR_NETWORK 或 NETWORK_ONLY。指定逾時時間時,單位為毫秒。
FetchConnected
void FetchConnected( DataSource data_source, FetchListCallback callback )
以非同步方式載入所有已連線至目前遊戲的玩家,以及已登入的玩家有權知道的遊戲。
在作業完成時呼叫提供的 FetchCallback。將 data_source 指定為 CACHE_OR_NETWORK 或 NETWORK_ONLY。
請注意,這個函式可能會傳回 Player 物件,且 Player.HasLevelInfo 傳回 false。在這種情況下,您可以透過 Fetch API 重新要求指定的玩家來擷取等級資訊。 已淘汰,
FetchConnected
void FetchConnected( FetchListCallback callback )
FetchConnected 超載使用 CACHE_OR_NETWORK 的預設 data_source。
FetchConnectedBlocking
FetchListResponse FetchConnectedBlocking( DataSource data_Source, Timeout timeout )
封鎖 FetchConnected 版本。
允許呼叫端指定逾時時間 (以毫秒為單位)。經過指定時間後,函式會傳回 ERROR_TIMEOUT
。請注意,在 iOS 上,您無法從 UI 執行緒呼叫這個封鎖版本,因為提供資料的基礎 Plus 服務必須在 UI 執行緒上執行作業。
已淘汰,
FetchConnectedBlocking
FetchListResponse FetchConnectedBlocking( DataSource data_source )
FetchConnectedBlocking 超載使用預設逾時 10 年。
FetchConnectedBlocking
FetchListResponse FetchConnectedBlocking( Timeout timeout )
FetchConnectedBlocking 超載使用 CACHE_OR_NETWORK 的預設 data_source。
FetchConnectedBlocking
FetchListResponse FetchConnectedBlocking()
FetchConnectedBlocking 超載使用預設 CACHE_OR_NETWORK 且預設逾時為 10 年。
FetchInvitable
void FetchInvitable( DataSource data_source, FetchListCallback callback )
以非同步方式載入本機玩家社交圈中的所有玩家 (並能接收本機玩家的邀請)。
請注意,如果可邀請的玩家並未與目前的遊戲建立連結,他們可能不會收到任何受邀的通知。
在作業完成時呼叫提供的 FetchCallback。將 data_source 指定為 CACHE_OR_NETWORK 或 NETWORK_ONLY。
請注意,這個函式可能會傳回 Player 物件,且 Player.HasLevelInfo 傳回 false。在這種情況下,您可以透過 Fetch API 重新要求指定的玩家來擷取等級資訊。 已淘汰,
FetchInvitable
void FetchInvitable( FetchListCallback callback )
FetchInvitable 使用預設 CACHE_OR_NETWORK 的預設 data_source。
FetchInvitableBlocking
FetchListResponse FetchInvitableBlocking( DataSource data_source, Timeout timeout )
封鎖 FetchInvitable 版本。
允許呼叫端指定逾時時間 (以毫秒為單位)。經過指定時間後,函式會傳回 ERROR_TIMEOUT
。請注意,在 iOS 上,您無法從 UI 執行緒呼叫這個封鎖版本,因為提供資料的基礎 Plus 服務必須在 UI 執行緒上執行作業。
已淘汰,
FetchInvitableBlocking
FetchListResponse FetchInvitableBlocking( DataSource data_source )
FetchInvitableBlocking 超載,會使用 10 年的預設逾時時間。
FetchInvitableBlocking
FetchListResponse FetchInvitableBlocking( Timeout timeout )
FetchInvitableBlocking 使用預設 CACHE_OR_NETWORK 的預設 data_source。
FetchInvitableBlocking
FetchListResponse FetchInvitableBlocking()
FetchInvitableBlocking 超載,其使用預設 CACHE_OR_NETWORK 的預設 data_source 及 10 年的預設逾時。
FetchRecentlyPlayed
void FetchRecentlyPlayed( DataSource data_source, FetchListCallback callback )
以非同步方式載入所有最近玩過的玩家。
在作業完成時呼叫提供的 FetchCallback。將 data_source 指定為 CACHE_OR_NETWORK 或 NETWORK_ONLY。
FetchRecentlyPlayed
void FetchRecentlyPlayed( FetchListCallback callback )
FetchRecentlyPlayed 超載使用 CACHE_OR_NETWORK 的預設 data_source。
FetchRecentlyPlayedBlocking
FetchListResponse FetchRecentlyPlayedBlocking( DataSource data_source, Timeout timeout )
封鎖 FetchRecentlyPlayed 的版本。
允許呼叫端指定逾時時間 (以毫秒為單位)。經過指定時間後,函式會傳回 ERROR_TIMEOUT
。
FetchRecentlyPlayedBlocking
FetchListResponse FetchRecentlyPlayedBlocking( DataSource data_source )
FetchRecentlyPlayedBlocking的超載,會使用 10 年的預設逾時。
FetchRecentlyPlayedBlocking
FetchListResponse FetchRecentlyPlayedBlocking( Timeout timeout )
FetchRecentlyPlayedBlocking 使用 CACHE_OR_NETWORK 的預設 data_source 超載。
FetchRecentlyPlayedBlocking
FetchListResponse FetchRecentlyPlayedBlocking()
FetchRecentlyPlayedBlocking 使用預設 CACHE_OR_NETWORK 的預設 data_source 及 10 年的預設逾時。
FetchSelf
void FetchSelf( FetchSelfCallback callback )
以非同步方式載入所有目前登入玩家的所有資料。
在作業完成時呼叫所提供的 FetchSelfCallback。如未指定 data_source,這個函式呼叫會等同於呼叫 FetchSelf(DataSource data_source, FetchSelfCallback callback)
,且 data_source 指定為 CACHE_OR_NETWORK。
FetchSelf
void FetchSelf( DataSource data_source, FetchSelfCallback callback )
以非同步方式載入所有目前登入玩家的所有資料。
在作業完成時呼叫所提供的 FetchSelfCallback。將 data_source 指定為 CACHE_OR_NETWORK 或 NETWORK_ONLY。
FetchSelfBlocking
FetchSelfResponse FetchSelfBlocking()
讓系統同步載入所有目前登入玩家的所有資料,直接傳回 FetchSelfResponse。
如未指定 data_source 或逾時,這個函式呼叫會等同於呼叫 FetchSelfResponse FetchSelfBlocking(DataSource data_source, Timeout timeout) 並使用 data_source 指定為 CACHE_OR_NETWORK,逾時期限指定為 10 年。
FetchSelfBlocking
FetchSelfResponse FetchSelfBlocking( DataSource data_source )
讓系統同步載入所有目前登入玩家的所有資料,直接傳回 FetchSelfResponse。
將 data_source 指定為 CACHE_OR_NETWORK 或 NETWORK_ONLY。如果不指定逾時,這個函式呼叫將等同於呼叫 FetchSelfResponse FetchSelfBlocking(DataSource data_source, Timeout timeout) 和您指定的 data_source 值及逾時時間 (以 10 年為單位)。
FetchSelfBlocking
FetchSelfResponse FetchSelfBlocking( Timeout timeout )
讓系統同步載入所有目前登入玩家的所有資料,直接傳回 FetchSelfResponse。
指定逾時時間時,單位為毫秒。如未指定 data_source,這項函式呼叫會等同於呼叫 FetchSelfResponse FetchSelfBlocking(DataSource data_source, Timeout timeout) 和使用 data_source 為 CACHE_OR_NETWORK ,且逾時時間包含您指定的值。
FetchSelfBlocking
FetchSelfResponse FetchSelfBlocking( DataSource data_source, Timeout timeout )
讓系統同步載入所有目前登入玩家的所有資料,直接傳回 FetchSelfResponse。
將 data_source 指定為 CACHE_OR_NETWORK 或 NETWORK_ONLY。指定逾時時間時,單位為毫秒。