gpg::PlayerManager

#include <player_manager.h>

取得並設定各種玩家相關資料。

摘要

公開類型
FetchCallback typedef
std::function< void(const FetchResponse &)>
定義接收 FetchResponse 的回呼類型。
FetchListCallback typedef
std::function< void(const FetchListResponse &)>
定義接收 FetchListResponse 的回呼類型。
FetchSelfCallback typedef
std::function< void(const FetchSelfResponse &)>
定義接收 FetchSelfResponse 的回呼類型。

公用函式
Fetch(const std::string & player_id, FetchCallback callback)
void
以非同步方式載入特定玩家的所有資料。
Fetch(DataSource data_source, const std::string & player_id, FetchCallback callback)
void
以非同步方式載入特定玩家的所有資料。
FetchBlocking(const std::string & player_id)
同步載入特定玩家的所有資料，直接傳回 FetchResponse。
FetchBlocking(DataSource data_source, const std::string & player_id)
同步載入特定玩家的所有資料，直接傳回 FetchResponse。
FetchBlocking(Timeout timeout, const std::string & player_id)
同步載入特定玩家的所有資料，直接傳回 FetchResponse。
FetchBlocking(DataSource data_source, Timeout timeout, const std::string & player_id)
同步載入特定玩家的所有資料，直接傳回 FetchResponse。
FetchConnected(DataSource data_source, FetchListCallback callback)
void
已淘汰。
以非同步方式載入所有連結至目前遊戲的玩家，以及已登入玩家已取得權限資訊的所有玩家。
FetchConnected(FetchListCallback callback)
void
已淘汰。
FetchConnected的超載，使用預設的 CACHE_OR_NETWORK 預設 data_source。
FetchConnectedBlocking(DataSource data_Source, Timeout timeout) 已淘汰。
封鎖的 FetchConnected 版本。
FetchConnectedBlocking(DataSource data_source) 已淘汰。
FetchConnectedBlocking 超載，使用的預設逾時時間為 10 年。
FetchConnectedBlocking(Timeout timeout) 已淘汰。
FetchConnectedBlocking 使用的預設 data_source 為 CACHE_OR_NETWORK。
FetchConnectedBlocking() 已淘汰。
FetchConnectedBlocking 使用的預設 data_source 為 CACHE_OR_NETWORK，預設逾時為 10 年。
FetchInvitable(DataSource data_source, FetchListCallback callback)
void
已淘汰。
以非同步方式載入本機玩家社交圈中的所有玩家 (並能接收本機玩家的邀請)。
FetchInvitable(FetchListCallback callback)
void
已淘汰。
FetchInvitable 的超載，使用預設的 CACHE_OR_NETWORK 預設 data_source。
FetchInvitableBlocking(DataSource data_source, Timeout timeout) 已淘汰。
封鎖的 FetchInvitable 版本。
FetchInvitableBlocking(DataSource data_source) 已淘汰。
FetchInvitableBlocking 的超載，其預設逾時時間為 10 年。
FetchInvitableBlocking(Timeout timeout) 已淘汰。
使用 CACHE_OR_NETWORK 預設 data_source 的 FetchInvitableBlocking 超載。
FetchInvitableBlocking() 已淘汰。
FetchInvitableBlocking 使用的預設 data_source 為 CACHE_OR_NETWORK，預設逾時時間為 10 年。
FetchRecentlyPlayed(DataSource data_source, FetchListCallback callback)
void
以非同步方式載入所有最近玩過的玩家。
FetchRecentlyPlayed(FetchListCallback callback)
void
FetchRecentlyPlayed 超載使用，使用 CACHE_OR_NETWORK 的預設 data_source。
FetchRecentlyPlayedBlocking(DataSource data_source, Timeout timeout)
封鎖「FetchRecentlyPlayed」的封鎖版本。
FetchRecentlyPlayedBlocking(DataSource data_source)
FetchRecentlyPlayedBlocking 超載，使用的預設逾時時間為 10 年。
FetchRecentlyPlayedBlocking(Timeout timeout)
使用 CACHE_OR_NETWORK 的預設 data_source 超載 FetchRecentlyPlayedBlocking。
FetchRecentlyPlayedBlocking()
FetchRecentlyPlayedBlocking 使用的超載資源，預設使用 CACHE_OR_NETWORK 的預設 data_source，逾時時間則是 10 年。
FetchSelf(FetchSelfCallback callback)
void
以非同步方式載入所有目前登入玩家的所有資料。
FetchSelf(DataSource data_source, FetchSelfCallback callback)
void
以非同步方式載入所有目前登入玩家的所有資料。
FetchSelfBlocking()
同步載入目前登入玩家的所有資料，直接傳回 FetchSelfResponse。
FetchSelfBlocking(DataSource data_source)
同步載入目前登入玩家的所有資料，直接傳回 FetchSelfResponse。
FetchSelfBlocking(Timeout timeout)
同步載入目前登入玩家的所有資料，直接傳回 FetchSelfResponse。
FetchSelfBlocking(DataSource data_source, Timeout timeout)
同步載入目前登入玩家的所有資料，直接傳回 FetchSelfResponse。

結構
gpg::PlayerManager::FetchListResponse

回應包含玩家向量的回應。
gpg::PlayerManager::FetchResponse

特定 Player 的 data 和 ResponseStatus。
gpg::PlayerManager::FetchSelfResponse

保留所有玩家資料以及回應狀態。

公開類型

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。將逾時值指定為任意毫秒數。