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

Atributos estáticos públicos
kAutomatchingParticipant
Um participante que pode ser passado para métodos que assumem um "próximo participante".

Funções públicas
AcceptInvitation(const MultiplayerInvitation & invitation, TurnBasedMatchCallback callback)
void
Aceita de maneira assíncrona um MultiplayerInvitation e retorna o resultado usando um TurnBasedMatchCallback.
AcceptInvitationBlocking(Timeout timeout, const MultiplayerInvitation & invitation)
Bloqueando a versão de AcceptInvitation.
AcceptInvitationBlocking(const MultiplayerInvitation & invitation)
A 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)
Versão de bloqueio 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á pendente de conclusão local.
ConfirmPendingCompletionBlocking(Timeout timeout, const TurnBasedMatch & match)
Bloqueando a 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 um TurnBasedMatch de maneira assíncrona usando o TurnBasedMatchConfig fornecido.
CreateTurnBasedMatchBlocking(Timeout timeout, const gpg::TurnBasedMatchConfig & config)
Bloqueio da 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 maneira assíncrona uma correspondência específica por código.
FetchMatchBlocking(Timeout timeout, const std::string & match_id)
A 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 do jogador atual.
FetchMatchesBlocking(Timeout timeout)
Bloqueio da 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
Encerra a correspondência especificada de maneira assíncrona.
FinishMatchDuringMyTurnBlocking(Timeout timeout, const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results)
Bloqueio da 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
Sai de uma partida de maneira assíncrona durante a 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 maneira assíncrona durante o turno de outro participante.
LeaveMatchDuringTheirTurnBlocking(Timeout timeout, const TurnBasedMatch & match)
Bloqueando a versão de LeaveMatchDuringTheirTurn.
LeaveMatchDuringTheirTurnBlocking(const TurnBasedMatch & match)
A sobrecarga de LeaveMatchDuringTheirTurnBlocking, que usa um tempo limite padrão de 10 anos.
Rematch(const TurnBasedMatch & match, TurnBasedMatchCallback callback)
void
Corresponde a uma correspondência com o 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 maneira assíncrona a interface da caixa de entrada de partidas, permitindo que o jogador selecione uma partida ou um convite.
ShowMatchInboxUIBlocking(Timeout timeout)
Bloqueando a versão 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 maneira assíncrona a interface de seleção do jogador, permitindo que ele escolha 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 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
Faz 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)
Bloqueio da versão 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 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 do ShowMatchInboxUI.

MultiplayerStatusCallback

std::function< void(MultiplayerStatus)> MultiplayerStatusCallback

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

Usado pelas funções ExitMatch e CancelMatch.

PlayerSelectUICallback

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

Define um callback que pode receber um PlayerSelectUIResponse do 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 baseadas em turnos.

TurnBasedMatchesCallback

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

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

Atributos estáticos públicos

kAutomatchingParticipant

const MultiplayerParticipant kAutomatchingParticipant

Um participante que pode ser passado para métodos que assumem um "próximo participante".

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

Funções públicas

AcceptInvitation

void AcceptInvitation(
  const MultiplayerInvitation & invitation,
  TurnBasedMatchCallback callback
)

Aceita de maneira assíncrona um MultiplayerInvitation e retorna o resultado usando um TurnBasedMatchCallback.

Se a operação for bem-sucedida, o TurnBasedMatch retornado pelo callback ficará 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 retorna ERROR_TIMEOUT.

AcceptInvitationBlocking

TurnBasedMatchResponse AcceptInvitationBlocking(
  const MultiplayerInvitation & invitation
)

A 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 de correspondência deve ser CONVIDADO, THEIR_TURN ou MY_TURN para que esta função seja utilizável.

CancelMatchBlocking

MultiplayerStatus CancelMatchBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

Versão de bloqueio de CancelMatch.

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

Essa função só pode ser chamada quando TurnBasedMatch::Status() retornar 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
)

Bloqueando a versão de ConfirmPendingCompletion.

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

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

CreateTurnBasedMatchBlocking

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

Bloqueio da versão de CreateTurnBasedMatch.

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

Isso cancela a partida dos outros participantes e remove a partida 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 o 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 o TurnBasedMatch do dispositivo do player local.

FetchMatch

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

Busca de maneira assíncrona uma correspondência específica por código.

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

FetchMatchBlocking

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

A versão de bloqueio de FetchMatch.

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

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

FetchMatchesBlocking

TurnBasedMatchesResponse FetchMatchesBlocking(
  Timeout timeout
)

Bloqueio da versão de FetchMatches.

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

Encerra a correspondência especificada de maneira assíncrona.

Isto 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. Após a conclusão da operação, a correspondência atualizada é retornada usando o TurnBasedMatchCallback. fornecido. Essa função só pode ser chamada quando TurnBasedMatch::Status() retornar MatchStatus::MY_TURN..

Detalhes
Parâmetros
match
A partida a terminar.
match_data
Um blob de dados que representa o estado final da correspondência.
results
Quaisquer resultados 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
)

Bloqueio da versão de FinishMatchDuringMyTurn.

Permite que o autor da chamada especifique um tempo limite em ms. Após o tempo especificado, a função retorna 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 uma partida de maneira assíncrona durante a vez do participante local.

A resposta retornada por TurnBasedMatchCallback contém o estado da partida após a saída do jogador local. Se essa partida 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 de partida.
next_participant
O participante cuja vez é a próxima. 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 retorna 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 maneira assíncrona durante o turno de outro participante.

A resposta retornada por MultiplayerStatusCallback contém se o participante local saiu da correspondência. Se essa partida 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
)

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 retorna ERROR_TIMEOUT.

LeaveMatchDuringTheirTurnBlocking

MultiplayerStatus LeaveMatchDuringTheirTurnBlocking(
  const TurnBasedMatch & match
)

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

Jogar de novo

void Rematch(
  const TurnBasedMatch & match,
  TurnBasedMatchCallback callback
)

Corresponde a uma correspondência com o estado MatchStatus::COMPLETED.

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

Detalhes
Parâmetros
match
A partida que você quer vencer.
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 retorna 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 maneira assíncrona a interface da caixa de entrada de partidas, permitindo que o jogador selecione uma partida ou um convite.

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

ShowMatchInboxUIBlocking

MatchInboxUIResponse ShowMatchInboxUIBlocking(
  Timeout timeout
)

Bloqueando a versão de ShowMatchInboxUI.

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

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

Ao jogar, o participante pode especificar um novo valor para match_data, assim como um conjunto de ParticipantResults. Quando a rodada termina, a partida atualizada é retornada pelo TurnBasedMatchCallback. Essa função só pode ser chamada quando TurnBasedMatch::Status() for MatchStatus::MY_TURN.

Detalhes
Parâmetros
match
A partida em que a curva acontece.
match_data
Um blob de dados para enviar ao próximo participante.
results
Quaisquer resultados conhecidos para a correspondência no momento atual. 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 cuja vez é a próxima. 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
)

Bloqueio da versão de TakeMyTurn.

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