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 的回呼類型。 |
結構 |
|
---|---|
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 逾時),並將 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, TimeoutTimeout)、指定的 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 使用的預設 data_source 為 CACHE_OR_NETWORK。
FetchConnectedBlocking
FetchListResponse FetchConnectedBlocking()
FetchConnectedBlocking 使用的預設 data_source 為 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 )
使用 CACHE_OR_NETWORK 預設 data_source 的 FetchInvitableBlocking 超載。
FetchInvitableBlocking
FetchListResponse FetchInvitableBlocking()
FetchInvitableBlocking 使用的預設 data_source 為 CACHE_OR_NETWORK,預設逾時時間為 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 )
使用 CACHE_OR_NETWORK 的預設 data_source 超載 FetchRecentlyPlayedBlocking。
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。將逾時值指定為任意毫秒數。