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 retorno de chamada 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 multiplayer com base em turnos.
TurnBasedMatchesCallback typedef
std::function< void(const TurnBasedMatchesResponse &)>
Define um callback que pode receber um TurnBasedMatchesResponse de uma das operações multiplayer com base em turnos.

Atributos estáticos públicos
kAutomatchingParticipant
Um participante que pode ser passado para métodos que tomam uma "próxima participante".

Funções públicas
AcceptInvitation(const MultiplayerInvitation & invitation, TurnBasedMatchCallback callback)
void
Aceita de maneira assíncrona uma MultiplayerInvitation e retorna o resultado por uma TurnBasedMatchCallback.
AcceptInvitationBlocking(Timeout timeout, const MultiplayerInvitation & invitation)
Bloqueando a versão de 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 uma correspondência de forma assíncrona.
CancelMatchBlocking(Timeout timeout, const TurnBasedMatch & match)
Bloquear a versão de 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 correspondência que terminou e está com conclusão local pendente.
ConfirmPendingCompletionBlocking(Timeout timeout, const TurnBasedMatch & match)
Bloqueio da versão 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 de maneira assíncrona um TurnBasedMatch usando o TurnBasedMatchConfig fornecido.
CreateTurnBasedMatchBlocking(Timeout timeout, const gpg::TurnBasedMatchConfig & config)
Bloqueando a versão 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
DismissMatch(const TurnBasedMatch & match)
void
Dispensa um TurnBasedMatch.
FetchMatch(const std::string & match_id, TurnBasedMatchCallback callback)
void
Busca de forma assíncrona uma correspondência específica por ID.
FetchMatchBlocking(Timeout timeout, const std::string & match_id)
Bloquear a versão 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 jogador atual.
FetchMatchesBlocking(Timeout timeout)
Bloqueando a versão 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
Termina de forma assíncrona a correspondência especificada.
FinishMatchDuringMyTurnBlocking(Timeout timeout, const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results)
Bloquear a versão 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
Deixa uma partida de forma assíncrona na vez do participante local.
LeaveMatchDuringMyTurnBlocking(Timeout timeout, const TurnBasedMatch & match, const MultiplayerParticipant & next_participant)
Bloqueando a versão de LeaveMatchDuringMyTurn.
LeaveMatchDuringMyTurnBlocking(const TurnBasedMatch & match, const MultiplayerParticipant & next_participant)
Sobrecarga de 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 na vez de outro participante.
LeaveMatchDuringTheirTurnBlocking(Timeout timeout, const TurnBasedMatch & match)
Bloqueando a versão 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
Corresponde novamente a uma correspondência cujo estado é MatchStatus::COMPLETED.
RematchBlocking(Timeout timeout, const TurnBasedMatch & match)
Versão de bloqueio de 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 interface da caixa de entrada da partida, permitindo que o jogador selecione uma partida ou um convite.
ShowMatchInboxUIBlocking(Timeout timeout)
Bloqueio da versão da 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 maneira assíncrona a interface de seleção do jogador, permitindo que o jogador selecione outros jogadores para jogar.
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 de dados de correspondência TBMP com o servidor.
TakeMyTurn(const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, const MultiplayerParticipant & next_participant, TurnBasedMatchCallback callback)
void
Toma a vez do participante local de forma assíncrona.
TakeMyTurnBlocking(Timeout timeout, const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, const MultiplayerParticipant & next_participant)
Bloquear a versão do 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 uma TurnBasedMatch específica.

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 retorno de chamada que pode ser usado para receber um MultiplayerStatus.

Usado pelas funções DeixeMatch 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 multiplayer com base em turnos.

TurnBasedMatchesCallback

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

Define um callback que pode receber um TurnBasedMatchesResponse de uma das operações multiplayer com base em turnos.

Atributos estáticos públicos

kAutomatchingParticipant

const MultiplayerParticipant kAutomatchingParticipant

Um participante que pode ser passado para métodos que tomam uma "próxima participante".

Isso faz com que o método selecione o próximo participante por meio da correspondência automática. Só é válido passar o 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 de maneira assíncrona uma MultiplayerInvitation e retorna o resultado por uma 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
)

Bloqueando a versão de AcceptInvitation.

Permite que o autor da chamada especifique um tempo limite em ms. Após o tempo especificado, a função 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 uma correspondência de forma assíncrona.

O status retornado por MultiplayerStatusCallback indica se a operação foi bem-sucedida. O status da correspondência precisa ser CONVIDADO, THEIR_TURN ou MY_TURN para que esta função seja utilizável.

CancelMatchBlocking

MultiplayerStatus CancelMatchBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

Bloquear a versão de CancelMatch.

Permite que o autor da chamada especifique um tempo limite em ms. Após o tempo especificado, a função 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 correspondência que terminou e está com conclusão local pendente.

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

Detalhes
Parâmetros
match
A correspondência cuja conclusão deve ser confirmada.
callback
O callback que recebe um TurnBasedMatchResponse.

ConfirmPendingCompletionBlocking

TurnBasedMatchResponse ConfirmPendingCompletionBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

Bloqueio da versão de ConfirmPendingCompletion.

Permite que o autor da chamada especifique um tempo limite em ms. Após o tempo especificado, a função 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 de maneira assíncrona um TurnBasedMatch usando o TurnBasedMatchConfig fornecido.

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

CreateTurnBasedMatchBlocking

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

Bloqueando a versão de CreateTurnBasedMatch.

Permite que o autor da chamada especifique um tempo limite em ms. Após o tempo especificado, a função 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 MultiplayerInvitation para TurnBasedMatch.

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

DismissInvitation

void DismissInvitation(
  const MultiplayerInvitation & invitation
)

Dispensa um MultiplayerInvitation para um TurnBasedMatch.

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

DismissMatch

void DismissMatch(
  const TurnBasedMatch & match
)

Dispensa um TurnBasedMatch.

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

FetchMatch

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

Busca de forma 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
)

Bloquear a versão de FetchMatch.

Permite que o autor da chamada especifique um tempo limite em ms. Após o tempo especificado, a função 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 jogador atual.

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

FetchMatchesBlocking

TurnBasedMatchesResponse FetchMatchesBlocking(
  Timeout timeout
)

Bloqueando a versão de FetchMatches.

Permite que o autor da chamada especifique um tempo limite em ms. Após o tempo especificado, a função 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
)

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

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 e um conjunto de valores finais para ParticipantResults. Após a conclusão dessa operação, a correspondência atualizada é retornada pelo TurnBasedMatchCallback. fornecido. Essa função só pode ser chamada quando TurnBasedMatch::Status() retorna MatchStatus::MY_TURN..

Detalhes
Parâmetros
match
A partida para encerrar.
match_data
Um blob de dados que representa o estado final da correspondência.
results
Qualquer resultado para cada jogador na partida. Esses resultados não podem contradizer nenhum resultado especificado 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
)

Bloquear a versão de FinishMatchDuringMyTurn.

Permite que o autor da chamada especifique um tempo limite em ms. Após o tempo especificado, a função 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
)

Deixa uma partida de forma assíncrona na vez do participante local.

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

Detalhes
Parâmetros
match
A partida para sair.
next_participant
O próximo participante. TurnBasedMultiplayerManager::kAutomatchingParticipant pode ser usado para especificar que o próximo participante deve ser selecionado por meio da correspondência automática.
callback
O callback que recebe o TurnBasedMatchResponse

LeaveMatchDuringMyTurnBlocking

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

Bloqueando a versão de LeaveMatchDuringMyTurn.

Permite que o autor da chamada especifique um tempo limite em ms. Após o tempo especificado, a função retornará ERROR_TIMEOUT.

LeaveMatchDuringMyTurnBlocking

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

Sobrecarga de 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 na vez de outro participante.

A resposta retornada pelo MultiplayerStatusCallback contém se o participante local saiu da correspondência. Se essa partida deixar a partida com menos de dois participantes, a partida 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
)

Bloqueando a versão de LeaveMatchDuringTheirTurn.

Permite que o autor da chamada especifique um tempo limite em ms. Após o tempo especificado, a função retornará ERROR_TIMEOUT.

LeaveMatchDuringTheirTurnBlocking

MultiplayerStatus LeaveMatchDuringTheirTurnBlocking(
  const TurnBasedMatch & match
)

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

Jogar de novo

void Rematch(
  const TurnBasedMatch & match,
  TurnBasedMatchCallback callback
)

Corresponde novamente a uma correspondência cujo estado é MatchStatus::COMPLETED.

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

Detalhes
Parâmetros
match
A partida da nova partida.
callback
O callback que recebe um TurnBasedMatchResponse.

RematchBlocking

TurnBasedMatchResponse RematchBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

Versão de bloqueio de Rematch.

Permite que o autor da chamada especifique um tempo limite em ms. Após o tempo especificado, a função 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 interface da caixa de entrada da partida, permitindo que o jogador selecione uma partida ou um convite.

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

ShowMatchInboxUIBlocking

MatchInboxUIResponse ShowMatchInboxUIBlocking(
  Timeout timeout
)

Bloqueio da versão da ShowMatchInboxUI.

Permite que o autor da chamada especifique um tempo limite em ms. Após o tempo especificado, a função 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 maneira assíncrona a interface de seleção do jogador, permitindo que o jogador selecione outros jogadores para jogar.

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. Após o tempo especificado, a função 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 de dados de correspondência TBMP com o servidor.

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

TakeMyTurn

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

Toma a vez do participante local de forma assíncrona.

Ao dar uma jogada, o participante pode especificar um novo valor para match_data, bem como um conjunto de ParticipantResults. Quando a rodada termina, 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 rodada acontece.
match_data
Um blob de dados para enviar ao próximo participante.
results
Quaisquer resultados conhecidos para a correspondência no momento. O resultado de um determinado player só pode ser especificado uma vez. A tentativa de definir resultados diferentes para um jogador resulta em ERROR_INVALID_RESULTS.
next_participant
O próximo participante. TurnBasedMultiplayerManager::kAutomatchingParticipant pode ser usado para especificar que o próximo participante deve ser selecionado por meio da 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
)

Bloquear a versão do TakeMyTurn.

Permite que o autor da chamada especifique um tempo limite em ms. Após o tempo especificado, a função 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.