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 超載使用 CACHE_OR_NETWORK 的預設 data_source。
FetchConnectedBlocking() 已淘汰，
FetchConnectedBlocking 超載使用預設 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) 已淘汰，
FetchInvitableBlocking 使用預設 CACHE_OR_NETWORK 的預設 data_source。
FetchInvitableBlocking() 已淘汰，
FetchInvitableBlocking 超載，其使用預設 CACHE_OR_NETWORK 的預設 data_source 及 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)
FetchRecentlyPlayedBlocking 使用 CACHE_OR_NETWORK 的預設 data_source 超載。
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。

Structs
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 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

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。指定逾時時間時，單位為毫秒。