gpg::TurnBasedMultiplayerManager

#include <turn_based_multiplayer_manager.h>

Busca, modifica e cria objetos TurnBasedMatch.

Resumo

Tipos públicos

MatchInboxUICallback typedef
std::function< void(const MatchInboxUIResponse &)>
Define um callback que pode receber um MatchInboxUIResponse de ShowMatchInboxUI.
MultiplayerStatusCallback typedef
std::function< void(MultiplayerStatus)>
Define um callback que pode ser usado para receber um MultiplayerStatus.
PlayerSelectUICallback typedef
std::function< void(const PlayerSelectUIResponse &)>
Define um callback que pode receber um PlayerSelectUIResponse de ShowPlayerSelectUI.
TurnBasedMatchCallback typedef
std::function< void(const TurnBasedMatchResponse &)>
Define um callback que pode ser usado para receber um TurnBasedMatchResponse de uma das operações multijogador por turnos.
TurnBasedMatchesCallback typedef
std::function< void(const TurnBasedMatchesResponse &)>
Define um callback que pode receber um TurnBasedMatchesResponse de uma das operações multijogador por turnos.

Atributos estáticos públicos

kAutomatchingParticipant
Um participante que pode ser transmitido a métodos que usam um "participante seguinte".

Funções públicas

AcceptInvitation(const MultiplayerInvitation & invitation, TurnBasedMatchCallback callback)
void
Aceita assíncronamente um MultiplayerInvitation e retorna o resultado por meio de um TurnBasedMatchCallback.
AcceptInvitationBlocking(Timeout timeout, const MultiplayerInvitation & invitation)
Bloqueio da versão AcceptInvitation.
AcceptInvitationBlocking(const MultiplayerInvitation & invitation)
Sobrecarga de AcceptInvitationBlocking, que usa um tempo limite padrão de 10 anos.
CancelMatch(const TurnBasedMatch & match, MultiplayerStatusCallback callback)
void
Cancela de forma assíncrona uma correspondência.
CancelMatchBlocking(Timeout timeout, const TurnBasedMatch & match)
Bloqueio da versão CancelMatch.
CancelMatchBlocking(const TurnBasedMatch & match)
Sobrecarga de CancelMatch, que usa um tempo limite padrão de 10 anos.
ConfirmPendingCompletion(const TurnBasedMatch & match, TurnBasedMatchCallback callback)
void
Confirma os resultados de uma partida que terminou e está aguardando a conclusão local.
ConfirmPendingCompletionBlocking(Timeout timeout, const TurnBasedMatch & match)
Versão de bloqueio de ConfirmPendingCompletion.
ConfirmPendingCompletionBlocking(const TurnBasedMatch & match)
Sobrecarga de ConfirmPendingCompletionBlocking, que usa um tempo limite padrão de 10 anos.
CreateTurnBasedMatch(const gpg::TurnBasedMatchConfig & config, TurnBasedMatchCallback callback)
void
Cria um TurnBasedMatch de forma assíncrona usando o TurnBasedMatchConfig fornecido.
CreateTurnBasedMatchBlocking(Timeout timeout, const gpg::TurnBasedMatchConfig & config)
Versão de bloqueio de CreateTurnBasedMatch.
CreateTurnBasedMatchBlocking(const gpg::TurnBasedMatchConfig & config)
Sobrecarga de CreateTurnBasedMatchBlocking, que usa um tempo limite padrão de 10 anos.
DeclineInvitation(const MultiplayerInvitation & invitation)
void
DismissInvitation(const MultiplayerInvitation & invitation)
void
Descartar uma MultiplayerInvitation para uma TurnBasedMatch.
DismissMatch(const TurnBasedMatch & match)
void
Dispensa uma TurnBasedMatch.
FetchMatch(const std::string & match_id, TurnBasedMatchCallback callback)
void
Busca assíncrona uma correspondência específica por ID.
FetchMatchBlocking(Timeout timeout, const std::string & match_id)
Versão de bloqueio de FetchMatch.
FetchMatchBlocking(const std::string & match_id)
Sobrecarga de FetchMatchBlocking, que usa um tempo limite padrão de 10 anos.
FetchMatches(TurnBasedMatchesCallback callback)
void
Busca de maneira assíncrona os objetos TurnBasedMatch e Invitation para o player atual.
FetchMatchesBlocking(Timeout timeout)
Versão bloqueada de FetchMatches.
FetchMatchesBlocking()
Sobrecarga de FetchMatchesBlocking, que usa um tempo limite padrão de 10 anos.
FinishMatchDuringMyTurn(const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, TurnBasedMatchCallback callback)
void
Conclui de forma assíncrona a correspondência especificada.
FinishMatchDuringMyTurnBlocking(Timeout timeout, const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results)
Versão bloqueada de FinishMatchDuringMyTurn.
FinishMatchDuringMyTurnBlocking(const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results)
Sobrecarga de FinishMatchDuringMyTurnBlocking, que usa um tempo limite padrão de 10 anos.
LeaveMatchDuringMyTurn(const TurnBasedMatch & match, const MultiplayerParticipant & next_participant, MultiplayerStatusCallback callback)
void
Sai de forma assíncrona de uma partida durante a vez do participante local.
LeaveMatchDuringMyTurnBlocking(Timeout timeout, const TurnBasedMatch & match, const MultiplayerParticipant & next_participant)
Versão bloqueada de LeaveMatchDuringMyTurn.
LeaveMatchDuringMyTurnBlocking(const TurnBasedMatch & match, const MultiplayerParticipant & next_participant)
Overload of LeaveMatchDuringMyTurnBlocking, que usa um tempo limite padrão de 10 anos.
LeaveMatchDuringTheirTurn(const TurnBasedMatch & match, MultiplayerStatusCallback callback)
void
Sai de uma partida de forma assíncrona durante a vez de outro participante.
LeaveMatchDuringTheirTurnBlocking(Timeout timeout, const TurnBasedMatch & match)
Versão bloqueada de LeaveMatchDuringTheirTurn.
LeaveMatchDuringTheirTurnBlocking(const TurnBasedMatch & match)
Sobrecarga de LeaveMatchDuringTheirTurnBlocking, que usa um tempo limite padrão de 10 anos.
Rematch(const TurnBasedMatch & match, TurnBasedMatchCallback callback)
void
Refaz uma partida cujo estado é MatchStatus::COMPLETED.
RematchBlocking(Timeout timeout, const TurnBasedMatch & match)
Bloqueio da versão Rematch.
RematchBlocking(const TurnBasedMatch & match)
Sobrecarga de RematchBlocking, que usa um tempo limite padrão de 10 anos.
ShowMatchInboxUI(MatchInboxUICallback callback)
void
Mostra de forma assíncrona a IU da caixa de entrada de correspondências, permitindo que o jogador selecione uma correspondência ou um convite.
ShowMatchInboxUIBlocking(Timeout timeout)
Versão bloqueada de ShowMatchInboxUI.
ShowMatchInboxUIBlocking()
Sobrecarga de ShowMatchInboxUIBlocking, que usa um tempo limite padrão de 10 anos.
ShowPlayerSelectUI(uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch, PlayerSelectUICallback callback)
void
Mostra de forma assíncrona a interface de seleção do jogador, permitindo que ele selecione outros jogadores para jogar uma partida.
ShowPlayerSelectUIBlocking(Timeout timeout, uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch)
Versão de bloqueio de ShowPlayerSelectUI.
ShowPlayerSelectUIBlocking(uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch)
Sobrecarga de ShowPlayerSelectUIBlocking, que usa um tempo limite padrão de 10 anos.
SynchronizeData()
void
Força uma sincronização dos dados de correspondência do TBMP com o servidor.
TakeMyTurn(const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, const MultiplayerParticipant & next_participant, TurnBasedMatchCallback callback)
void
Assume de maneira assíncrona a vez do participante local.
TakeMyTurnBlocking(Timeout timeout, const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, const MultiplayerParticipant & next_participant)
Versão de bloqueio de TakeMyTurn.
TakeMyTurnBlocking(const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, const MultiplayerParticipant & next_participant)
Sobrecarga de TakeMyTurnBlocking, que usa um tempo limite padrão de 10 anos.

Estruturas

gpg::TurnBasedMultiplayerManager::MatchInboxUIResponse

Data e ResponseStatus para a operação ShowMatchInboxUI.

gpg::TurnBasedMultiplayerManager::PlayerSelectUIResponse

Data e ResponseStatus para a operação ShowPlayerSelectUI.

gpg::TurnBasedMultiplayerManager::TurnBasedMatchResponse

Data e ResponseStatus para um TurnBasedMatch específico.

gpg::TurnBasedMultiplayerManager::TurnBasedMatchesResponse

Data e ResponseStatus para TurnBasedMatches e convites.

Tipos públicos

MatchInboxUICallback

std::function< void(const MatchInboxUIResponse &)> MatchInboxUICallback

Define um callback que pode receber um MatchInboxUIResponse de ShowMatchInboxUI.

MultiplayerStatusCallback

std::function< void(MultiplayerStatus)> MultiplayerStatusCallback

Define um callback que pode ser usado para receber um MultiplayerStatus.

Usado pelas funções LeaveMatch e CancelMatch.

PlayerSelectUICallback

std::function< void(const PlayerSelectUIResponse &)> PlayerSelectUICallback

Define um callback que pode receber um PlayerSelectUIResponse de ShowPlayerSelectUI.

TurnBasedMatchCallback

std::function< void(const TurnBasedMatchResponse &)> TurnBasedMatchCallback

Define um callback que pode ser usado para receber um TurnBasedMatchResponse de uma das operações multijogador por turnos.

TurnBasedMatchesCallback

std::function< void(const TurnBasedMatchesResponse &)> TurnBasedMatchesCallback

Define um callback que pode receber um TurnBasedMatchesResponse de uma das operações multijogador por turnos.

Atributos estáticos públicos

kAutomatchingParticipant

const MultiplayerParticipant kAutomatchingParticipant

Um participante que pode ser transmitido a métodos que recebem um "participante seguinte".

Isso faz com que o método selecione o próximo participante por correspondência automática. Só é válido transmitir kAutomatchingParticipant para uma função se TurnBasedMatch::AutomatchingSlotsAvailable for maior que 0 para a correspondência relacionada.

Funções públicas

AcceptInvitation

void AcceptInvitation(
  const MultiplayerInvitation & invitation,
  TurnBasedMatchCallback callback
)

Aceita assíncronamente um MultiplayerInvitation e retorna o resultado por meio de um TurnBasedMatchCallback.

Se a operação for bem-sucedida, o TurnBasedMatch retornado pelo callback estará no estado TurnBasedMatchState::MY_TURN.

AcceptInvitationBlocking

TurnBasedMatchResponse AcceptInvitationBlocking(
  Timeout timeout,
  const MultiplayerInvitation & invitation
)

Bloqueio da versão AcceptInvitation.

Permite que o autor da chamada especifique um tempo limite em ms. Depois que o tempo especificado expirar, a função vai retornar ERROR_TIMEOUT.

AcceptInvitationBlocking

TurnBasedMatchResponse AcceptInvitationBlocking(
  const MultiplayerInvitation & invitation
)

Sobrecarga de AcceptInvitationBlocking, que usa um tempo limite padrão de 10 anos.

CancelMatch

void CancelMatch(
  const TurnBasedMatch & match,
  MultiplayerStatusCallback callback
)

Cancela de forma assíncrona uma correspondência.

O status retornado pelo MultiplayerStatusCallback indica se a operação teve êxito. O status da partida precisa ser INVITED, THEIR_TURN ou MY_TURN para que essa função seja utilizável.

CancelMatchBlocking

MultiplayerStatus CancelMatchBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

Bloqueio da versão CancelMatch.

Permite que o autor da chamada especifique um tempo limite em ms. Depois que o tempo especificado expirar, a função vai retornar ERROR_TIMEOUT.

CancelMatchBlocking

MultiplayerStatus CancelMatchBlocking(
  const TurnBasedMatch & match
)

Sobrecarga de CancelMatch, que usa um tempo limite padrão de 10 anos.

ConfirmPendingCompletion

void ConfirmPendingCompletion(
  const TurnBasedMatch & match,
  TurnBasedMatchCallback callback
)

Confirma os resultados de uma partida que terminou e está aguardando a conclusão local.

Essa função só pode ser chamada quando TurnBasedMatch::Status() retorna MatchStatus::PENDING_COMPLETION.

Detalhes
Parâmetros
match
A correspondência que você quer confirmar.
callback
O callback que recebe uma TurnBasedMatchResponse.

ConfirmPendingCompletionBlocking

TurnBasedMatchResponse ConfirmPendingCompletionBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

Versão de bloqueio de ConfirmPendingCompletion.

Permite que o autor da chamada especifique um tempo limite em ms. Depois que o tempo especificado expirar, a função vai retornar ERROR_TIMEOUT.

ConfirmPendingCompletionBlocking

TurnBasedMatchResponse ConfirmPendingCompletionBlocking(
  const TurnBasedMatch & match
)

Sobrecarga de ConfirmPendingCompletionBlocking, que usa um tempo limite padrão de 10 anos.

CreateTurnBasedMatch

void CreateTurnBasedMatch(
  const gpg::TurnBasedMatchConfig & config,
  TurnBasedMatchCallback callback
)

Cria um TurnBasedMatch de forma assíncrona usando o TurnBasedMatchConfig fornecido.

Se a criação for bem-sucedida, essa função vai retornar o TurnBasedMatch pelo TurnBasedMatchCallback fornecido. Uma TurnBasedMatch recém-criada sempre começa no estado TurnBasedMatchState::MY_TURN.

CreateTurnBasedMatchBlocking

TurnBasedMatchResponse CreateTurnBasedMatchBlocking(
  Timeout timeout,
  const gpg::TurnBasedMatchConfig & config
)

Versão de bloqueio de CreateTurnBasedMatch.

Permite que o autor da chamada especifique um tempo limite em ms. Depois que o tempo especificado expirar, a função vai retornar ERROR_TIMEOUT.

CreateTurnBasedMatchBlocking

TurnBasedMatchResponse CreateTurnBasedMatchBlocking(
  const gpg::TurnBasedMatchConfig & config
)

Sobrecarga de CreateTurnBasedMatchBlocking, que usa um tempo limite padrão de 10 anos.

DeclineInvitation

void DeclineInvitation(
  const MultiplayerInvitation & invitation
)

Recusa uma MultiplayerInvitation para uma TurnBasedMatch.

Isso cancela a partida para os outros participantes e a remove do dispositivo do jogador local.

DismissInvitation

void DismissInvitation(
  const MultiplayerInvitation & invitation
)

Descartar uma MultiplayerInvitation para uma TurnBasedMatch.

Isso não muda o estado visível do TurnBasedMatch para os outros participantes, mas remove o TurnBasedMatch do dispositivo do player local.

DismissMatch

void DismissMatch(
  const TurnBasedMatch & match
)

Dispensa uma TurnBasedMatch.

Isso não muda o estado visível do TurnBasedMatch para os outros participantes, mas remove o TurnBasedMatch do dispositivo do player local.

FetchMatch

void FetchMatch(
  const std::string & match_id,
  TurnBasedMatchCallback callback
)

Busca assíncrona uma correspondência específica por ID.

O resultado dessa operação é retornado por uma TurnBasedMatchCallback.

FetchMatchBlocking

TurnBasedMatchResponse FetchMatchBlocking(
  Timeout timeout,
  const std::string & match_id
)

Versão de bloqueio de FetchMatch.

Permite que o autor da chamada especifique um tempo limite em ms. Depois que o tempo especificado expirar, a função vai retornar ERROR_TIMEOUT.

FetchMatchBlocking

TurnBasedMatchResponse FetchMatchBlocking(
  const std::string & match_id
)

Sobrecarga de FetchMatchBlocking, que usa um tempo limite padrão de 10 anos.

FetchMatches

void FetchMatches(
  TurnBasedMatchesCallback callback
)

Busca de maneira assíncrona os objetos TurnBasedMatch e Invitation para o player atual.

Todas as correspondências ativas e até 10 correspondências concluídas são retornadas.

FetchMatchesBlocking

TurnBasedMatchesResponse FetchMatchesBlocking(
  Timeout timeout
)

Versão bloqueada de FetchMatches.

Permite que o autor da chamada especifique um tempo limite em ms. Depois que o tempo especificado expirar, a função vai retornar ERROR_TIMEOUT.

FetchMatchesBlocking

TurnBasedMatchesResponse FetchMatchesBlocking()

Sobrecarga de FetchMatchesBlocking, que usa um tempo limite padrão de 10 anos.

FinishMatchDuringMyTurn

void FinishMatchDuringMyTurn(
  const TurnBasedMatch & match,
  std::vector< uint8_t > match_data,
  const ParticipantResults & results,
  TurnBasedMatchCallback callback
)

Conclui de forma assíncrona a correspondência especificada.

Isso pode ser usado em vez de TakeMyTurn durante a rodada final da partida. Permite que o autor da chamada especifique um valor final para match_data, bem como um conjunto de valores finais para ParticipantResults. Depois que essa operação for concluída, a correspondência atualizada será retornada pelo TurnBasedMatchCallback. fornecido. Essa função só pode ser chamada quando TurnBasedMatch::Status() retorna MatchStatus::MY_TURN..

Detalhes
Parâmetros
match
O jogo para terminar.
match_data
Um blob de dados que representa o estado final da partida.
results
Todos os resultados de cada jogador na partida. Esses resultados não podem contradizer os resultados especificados anteriormente por TakeTurn. A tentativa de definir resultados diferentes para um jogador resulta em ERROR_INVALID_RESULTS.
callback
O callback que recebe o TurnBasedMatchResponse.

FinishMatchDuringMyTurnBlocking

TurnBasedMatchResponse FinishMatchDuringMyTurnBlocking(
  Timeout timeout,
  const TurnBasedMatch & match,
  std::vector< uint8_t > match_data,
  const ParticipantResults & results
)

Versão bloqueada de FinishMatchDuringMyTurn.

Permite que o autor da chamada especifique um tempo limite em ms. Depois que o tempo especificado expirar, a função vai retornar ERROR_TIMEOUT.

FinishMatchDuringMyTurnBlocking

TurnBasedMatchResponse FinishMatchDuringMyTurnBlocking(
  const TurnBasedMatch & match,
  std::vector< uint8_t > match_data,
  const ParticipantResults & results
)

Sobrecarga de FinishMatchDuringMyTurnBlocking, que usa um tempo limite padrão de 10 anos.

LeaveMatchDuringMyTurn

void LeaveMatchDuringMyTurn(
  const TurnBasedMatch & match,
  const MultiplayerParticipant & next_participant,
  MultiplayerStatusCallback callback
)

Sai de forma assíncrona de uma partida durante a vez do participante local.

A resposta retornada pelo TurnBasedMatchCallback contém o estado da partida depois que o jogador local saiu. Se essa saída deixar a partida com menos de dois participantes, ela será cancelada. match.Status() precisa retornar MatchStatus::MY_TURN para que essa função seja utilizável.

Detalhes
Parâmetros
match
A partida que você quer deixar.
next_participant
O participante que está com a próxima vez. TurnBasedMultiplayerManager::kAutomatchingParticipant pode ser usado para especificar que o próximo participante deve ser selecionado por correspondência automática.
callback
O callback que recebe o TurnBasedMatchResponse

LeaveMatchDuringMyTurnBlocking

MultiplayerStatus LeaveMatchDuringMyTurnBlocking(
  Timeout timeout,
  const TurnBasedMatch & match,
  const MultiplayerParticipant & next_participant
)

Versão bloqueada de LeaveMatchDuringMyTurn.

Permite que o autor da chamada especifique um tempo limite em ms. Depois que o tempo especificado expirar, a função vai retornar ERROR_TIMEOUT.

LeaveMatchDuringMyTurnBlocking

MultiplayerStatus LeaveMatchDuringMyTurnBlocking(
  const TurnBasedMatch & match,
  const MultiplayerParticipant & next_participant
)

Overload of LeaveMatchDuringMyTurnBlocking, que usa um tempo limite padrão de 10 anos.

LeaveMatchDuringTheirTurn

void LeaveMatchDuringTheirTurn(
  const TurnBasedMatch & match,
  MultiplayerStatusCallback callback
)

Sai de uma partida de forma assíncrona durante a vez de outro participante.

A resposta retornada pelo MultiplayerStatusCallback contém se o participante local saiu da partida. Se essa saída deixar a partida com menos de dois participantes, ela será cancelada. match.Status() precisa retornar MatchStatus::THEIR_TURN para que essa função seja utilizável.

LeaveMatchDuringTheirTurnBlocking

MultiplayerStatus LeaveMatchDuringTheirTurnBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

Versão bloqueada de LeaveMatchDuringTheirTurn.

Permite que o autor da chamada especifique um tempo limite em ms. Depois que o tempo especificado expirar, a função vai retornar ERROR_TIMEOUT.

LeaveMatchDuringTheirTurnBlocking

MultiplayerStatus LeaveMatchDuringTheirTurnBlocking(
  const TurnBasedMatch & match
)

Sobrecarga de LeaveMatchDuringTheirTurnBlocking, que usa um tempo limite padrão de 10 anos.

Nova partida

void Rematch(
  const TurnBasedMatch & match,
  TurnBasedMatchCallback callback
)

Refaz uma partida cujo estado é MatchStatus::COMPLETED.

Se a revanche for possível, TurnBasedMatchCallback vai receber a nova correspondência.

Detalhes
Parâmetros
match
A partida para revanche.
callback
O callback que recebe uma TurnBasedMatchResponse.

RematchBlocking

TurnBasedMatchResponse RematchBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

Bloqueio da versão Rematch.

Permite que o autor da chamada especifique um tempo limite em ms. Depois que o tempo especificado expirar, a função vai retornar ERROR_TIMEOUT.

RematchBlocking

TurnBasedMatchResponse RematchBlocking(
  const TurnBasedMatch & match
)

Sobrecarga de RematchBlocking, que usa um tempo limite padrão de 10 anos.

ShowMatchInboxUI

void ShowMatchInboxUI(
  MatchInboxUICallback callback
)

Mostra de forma assíncrona a IU da caixa de entrada de correspondências, permitindo que o jogador selecione uma correspondência ou um convite.

Após a conclusão, a correspondência ou o convite selecionado é retornado pelo MatchInboxUICallback.

ShowMatchInboxUIBlocking

MatchInboxUIResponse ShowMatchInboxUIBlocking(
  Timeout timeout
)

Versão bloqueada de ShowMatchInboxUI.

Permite que o autor da chamada especifique um tempo limite em ms. Depois que o tempo especificado expirar, a função vai retornar ERROR_TIMEOUT.

ShowMatchInboxUIBlocking

MatchInboxUIResponse ShowMatchInboxUIBlocking()

Sobrecarga de ShowMatchInboxUIBlocking, que usa um tempo limite padrão de 10 anos.

ShowPlayerSelectUI

void ShowPlayerSelectUI(
  uint32_t minimum_players,
  uint32_t maximum_players,
  bool allow_automatch,
  PlayerSelectUICallback callback
)

Mostra de forma assíncrona a interface de seleção de jogadores, permitindo que o jogador selecione outros jogadores para jogar uma partida.

Após a conclusão, os jogadores selecionados serão retornados pelo PlayerSelectUICallback.

ShowPlayerSelectUIBlocking

PlayerSelectUIResponse ShowPlayerSelectUIBlocking(
  Timeout timeout,
  uint32_t minimum_players,
  uint32_t maximum_players,
  bool allow_automatch
)

Versão de bloqueio de ShowPlayerSelectUI.

Permite que o autor da chamada especifique um tempo limite em ms. Depois que o tempo especificado expirar, a função vai retornar ERROR_TIMEOUT.

ShowPlayerSelectUIBlocking

PlayerSelectUIResponse ShowPlayerSelectUIBlocking(
  uint32_t minimum_players,
  uint32_t maximum_players,
  bool allow_automatch
)

Sobrecarga de ShowPlayerSelectUIBlocking, que usa um tempo limite padrão de 10 anos.

SynchronizeData

void SynchronizeData()

Força uma sincronização dos dados de correspondência do TBMP com o servidor.

O recebimento de novos dados aciona um OnTurnBasedMatchEventCallback ou um OnMultiplayerInvitationReceivedCallback.

TakeMyTurn

void TakeMyTurn(
  const TurnBasedMatch & match,
  std::vector< uint8_t > match_data,
  const ParticipantResults & results,
  const MultiplayerParticipant & next_participant,
  TurnBasedMatchCallback callback
)

Assume de maneira assíncrona a vez do participante local.

Ao fazer uma jogada, o participante pode especificar um novo valor para match_data, bem como um conjunto de ParticipantResults. Quando a vez acaba, a correspondência atualizada é retornada pelo TurnBasedMatchCallback. Essa função só pode ser chamada quando TurnBasedMatch::Status() é MatchStatus::MY_TURN.

Detalhes
Parâmetros
match
A partida em que a jogada acontece.
match_data
Um blob de dados a ser enviado ao próximo participante.
results
Todos os resultados conhecidos para a correspondência no momento. O resultado de um determinado jogador só pode ser especificado uma vez. A tentativa de definir resultados diferentes para um jogador resulta em ERROR_INVALID_RESULTS.
next_participant
O participante que está com a próxima vez. TurnBasedMultiplayerManager::kAutomatchingParticipant pode ser usado para especificar que o próximo participante deve ser selecionado por correspondência automática.
callback
O callback que recebe o TurnBasedMatchResponse.

TakeMyTurnBlocking

TurnBasedMatchResponse TakeMyTurnBlocking(
  Timeout timeout,
  const TurnBasedMatch & match,
  std::vector< uint8_t > match_data,
  const ParticipantResults & results,
  const MultiplayerParticipant & next_participant
)

Versão de bloqueio de TakeMyTurn.

Permite que o autor da chamada especifique um tempo limite em ms. Depois que o tempo especificado expirar, a função vai retornar ERROR_TIMEOUT.

TakeMyTurnBlocking

TurnBasedMatchResponse TakeMyTurnBlocking(
  const TurnBasedMatch & match,
  std::vector< uint8_t > match_data,
  const ParticipantResults & results,
  const MultiplayerParticipant & next_participant
)

Sobrecarga de TakeMyTurnBlocking, que usa um tempo limite padrão de 10 anos.