гпг:: Пошаговый мультиплеерменеджер

#include <turn_based_multiplayer_manager.h>

Извлекает, изменяет и создает объекты TurnBasedMatch .

Краткое содержание

Публичные типы

MatchInboxUICallback определение типа
std::function< void(const MatchInboxUIResponse &)>
Определяет обратный вызов, который может получить MatchInboxUIResponse от ShowMatchInboxUI .
MultiplayerStatusCallback определение типа
std::function< void( MultiplayerStatus )>
Определяет обратный вызов, который можно использовать для получения MultiplayerStatus.
PlayerSelectUICallback определение типа
std::function< void(const PlayerSelectUIResponse &)>
Определяет обратный вызов, который может получить PlayerSelectUIResponse от ShowPlayerSelectUI .
TurnBasedMatchCallback определение типа
std::function< void(const TurnBasedMatchResponse &)>
Определяет обратный вызов, который можно использовать для получения TurnBasedMatchResponse от одной из пошаговых многопользовательских операций.
TurnBasedMatchesCallback определение типа
std::function< void(const TurnBasedMatchesResponse &)>
Определяет обратный вызов, который может получить TurnBasedMatchesResponse от одной из пошаговых многопользовательских операций.

Публичные статические атрибуты

kAutomatchingParticipant
Участник, который может быть передан методам, принимающим «следующего участника».

Общественные функции

AcceptInvitation (const MultiplayerInvitation & invitation, TurnBasedMatchCallback callback)
void
Асинхронно принимает MultiplayerInvitation и возвращает результат через TurnBasedMatchCallback .
AcceptInvitationBlocking ( Timeout timeout, const MultiplayerInvitation & invitation)
Блокирующая версия AcceptInvitation .
AcceptInvitationBlocking (const MultiplayerInvitation & invitation)
Перегрузка AcceptInvitationBlocking , которая использует тайм-аут по умолчанию, равный 10 годам.
CancelMatch (const TurnBasedMatch & match, MultiplayerStatusCallback callback)
void
Асинхронно отменяет совпадение.
CancelMatchBlocking ( Timeout timeout, const TurnBasedMatch & match)
Блокирующая версия CancelMatch .
CancelMatchBlocking (const TurnBasedMatch & match)
Перегрузка CancelMatch , которая использует тайм-аут по умолчанию, равный 10 годам.
ConfirmPendingCompletion (const TurnBasedMatch & match, TurnBasedMatchCallback callback)
void
Подтверждает результаты матча, который завершился и ожидает локального завершения.
ConfirmPendingCompletionBlocking ( Timeout timeout, const TurnBasedMatch & match)
Блокирующая версия ConfirmPendingCompletion .
ConfirmPendingCompletionBlocking (const TurnBasedMatch & match)
Перегрузка ConfirmPendingCompletionBlocking , которая использует тайм-аут по умолчанию, равный 10 годам.
CreateTurnBasedMatch (const gpg::TurnBasedMatchConfig & config, TurnBasedMatchCallback callback)
void
Асинхронно создает TurnBasedMatch используя предоставленный TurnBasedMatchConfig .
CreateTurnBasedMatchBlocking ( Timeout timeout, const gpg::TurnBasedMatchConfig & config)
Блокирующая версия CreateTurnBasedMatch .
CreateTurnBasedMatchBlocking (const gpg::TurnBasedMatchConfig & config)
Перегрузка CreateTurnBasedMatchBlocking , которая использует тайм-аут по умолчанию, равный 10 годам.
DeclineInvitation (const MultiplayerInvitation & invitation)
void
Отклоняет MultiplayerInvitation в TurnBasedMatch .
DismissInvitation (const MultiplayerInvitation & invitation)
void
Отклоняет MultiplayerInvitation в TurnBasedMatch .
DismissMatch (const TurnBasedMatch & match)
void
Отклоняет TurnBasedMatch .
FetchMatch (const std::string & match_id, TurnBasedMatchCallback callback)
void
Асинхронно извлекает определенное совпадение по идентификатору.
FetchMatchBlocking ( Timeout timeout, const std::string & match_id)
Блокирующая версия FetchMatch .
FetchMatchBlocking (const std::string & match_id)
Перегрузка FetchMatchBlocking , которая использует тайм-аут по умолчанию, равный 10 годам.
FetchMatches ( TurnBasedMatchesCallback callback)
void
Асинхронно извлекает объекты TurnBasedMatch и Invitation для текущего игрока.
FetchMatchesBlocking ( Timeout timeout)
Блокирующая версия FetchMatches .
FetchMatchesBlocking ()
Перегрузка FetchMatchesBlocking , которая использует тайм-аут по умолчанию, равный 10 годам.
FinishMatchDuringMyTurn (const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, TurnBasedMatchCallback callback)
void
Асинхронно завершает указанное совпадение.
FinishMatchDuringMyTurnBlocking ( Timeout timeout, const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results)
Блокирующая версия FinishMatchDuringMyTurn .
FinishMatchDuringMyTurnBlocking (const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results)
Перегрузка FinishMatchDuringMyTurnBlocking , которая использует тайм-аут по умолчанию, равный 10 годам.
LeaveMatchDuringMyTurn (const TurnBasedMatch & match, const MultiplayerParticipant & next_participant, MultiplayerStatusCallback callback)
void
Асинхронно покидает матч во время хода локального участника.
LeaveMatchDuringMyTurnBlocking ( Timeout timeout, const TurnBasedMatch & match, const MultiplayerParticipant & next_participant)
Блокирующая версия LeaveMatchDuringMyTurn .
LeaveMatchDuringMyTurnBlocking (const TurnBasedMatch & match, const MultiplayerParticipant & next_participant)
Перегрузка LeaveMatchDuringMyTurnBlocking , которая использует тайм-аут по умолчанию, равный 10 годам.
LeaveMatchDuringTheirTurn (const TurnBasedMatch & match, MultiplayerStatusCallback callback)
void
Асинхронно покидает матч во время хода другого участника.
LeaveMatchDuringTheirTurnBlocking ( Timeout timeout, const TurnBasedMatch & match)
Блокирующая версия LeaveMatchDuringTheirTurn .
LeaveMatchDuringTheirTurnBlocking (const TurnBasedMatch & match)
Перегрузка LeaveMatchDuringTheirTurnBlocking , которая использует тайм-аут по умолчанию, равный 10 годам.
Rematch (const TurnBasedMatch & match, TurnBasedMatchCallback callback)
void
Повторно сопоставляет совпадение с состоянием MatchStatus::COMPLETED .
RematchBlocking ( Timeout timeout, const TurnBasedMatch & match)
Блокирующая версия Rematch .
RematchBlocking (const TurnBasedMatch & match)
Перегрузка RematchBlocking , которая использует тайм-аут по умолчанию, равный 10 годам.
ShowMatchInboxUI ( MatchInboxUICallback callback)
void
Асинхронно отображает пользовательский интерфейс почтового ящика матча, позволяя игроку выбрать матч или приглашение.
ShowMatchInboxUIBlocking ( Timeout timeout)
Блокирующая версия ShowMatchInboxUI .
ShowMatchInboxUIBlocking ()
Перегрузка ShowMatchInboxUIBlocking , которая использует тайм-аут по умолчанию, равный 10 годам.
ShowPlayerSelectUI (uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch, PlayerSelectUICallback callback)
void
Асинхронно отображает пользовательский интерфейс выбора игрока, позволяющий игроку выбирать других игроков для игры в матче.
ShowPlayerSelectUIBlocking ( Timeout timeout, uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch)
Блокирующая версия ShowPlayerSelectUI .
ShowPlayerSelectUIBlocking (uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch)
Перегрузка ShowPlayerSelectUIBlocking , которая использует тайм-аут по умолчанию, равный 10 годам.
SynchronizeData ()
void
Принудительно синхронизирует данные соответствия TBMP с сервером.
TakeMyTurn (const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, const MultiplayerParticipant & next_participant, TurnBasedMatchCallback callback)
void
Асинхронно занимает очередь локального участника.
TakeMyTurnBlocking ( Timeout timeout, const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, const MultiplayerParticipant & next_participant)
Блокирующая версия TakeMyTurn .
TakeMyTurnBlocking (const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, const MultiplayerParticipant & next_participant)
Перегрузка TakeMyTurnBlocking , которая использует тайм-аут по умолчанию, равный 10 годам.

Структуры

gpg:: TurnBasedMultiplayerManager:: MatchInboxUIResponse

Data и ResponseStatus для операции ShowMatchInboxUI .

gpg:: TurnBasedMultiplayerManager:: PlayerSelectUIResponse

Data и ResponseStatus для операции ShowPlayerSelectUI .

gpg:: TurnBasedMultiplayerManager:: TurnBasedMatchResponse

Data и ResponseStatus для конкретного TurnBasedMatch .

gpg:: TurnBasedMultiplayerManager:: TurnBasedMatchesResponse

Data и ResponseStatus для TurnBasedMatches и приглашений .

Публичные типы

МатчВходящиеUICallback

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

Определяет обратный вызов, который может получить MatchInboxUIResponse от ShowMatchInboxUI .

Многопользовательский статусОбратный вызов

std::function< void(MultiplayerStatus)> MultiplayerStatusCallback

Определяет обратный вызов, который можно использовать для получения MultiplayerStatus.

Используется функциями LeaveMatch и CancelMatch.

PlayerSelectUICallback

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

Определяет обратный вызов, который может получить PlayerSelectUIResponse от ShowPlayerSelectUI .

Обратный обратный вызов

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

Определяет обратный вызов, который можно использовать для получения TurnBasedMatchResponse от одной из пошаговых многопользовательских операций.

Пошаговые матчиОбратный вызов

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

Определяет обратный вызов, который может получить TurnBasedMatchesResponse от одной из пошаговых многопользовательских операций.

Публичные статические атрибуты

kAutomatchingParticipant

const MultiplayerParticipant kAutomatchingParticipant

Участник, который может быть передан методам, принимающим «следующего участника».

Это заставляет метод выбирать следующего участника посредством автоматизации. Передача kAutomatchingParticipant в функцию допустима только в том случае, если значение TurnBasedMatch::AutomatchingSlotsAvailable больше 0 для соответствующего совпадения.

Общественные функции

Принять приглашение

void AcceptInvitation(
  const MultiplayerInvitation & invitation,
  TurnBasedMatchCallback callback
)

Асинхронно принимает MultiplayerInvitation и возвращает результат через TurnBasedMatchCallback .

Если операция прошла успешно, TurnBasedMatch , возвращенный через обратный вызов, находится в состоянии TurnBasedMatchState::MY_TURN .

AcceptInvitationBlocking

TurnBasedMatchResponse AcceptInvitationBlocking(
  Timeout timeout,
  const MultiplayerInvitation & invitation
)

Блокирующая версия AcceptInvitation .

Позволяет вызывающему абоненту указать тайм-аут в мс. По истечении указанного времени функция возвращает ERROR_TIMEOUT .

AcceptInvitationBlocking

TurnBasedMatchResponse AcceptInvitationBlocking(
  const MultiplayerInvitation & invitation
)

Перегрузка AcceptInvitationBlocking , которая использует тайм-аут по умолчанию, равный 10 годам.

Отменить совпадение

void CancelMatch(
  const TurnBasedMatch & match,
  MultiplayerStatusCallback callback
)

Асинхронно отменяет совпадение.

Статус, возвращаемый через MultiplayerStatusCallback указывает, была ли операция успешной. Статус матча должен быть INVITED, THEIR_TURN или MY_TURN, чтобы эту функцию можно было использовать.

ОтменаБлокировка совпадений

MultiplayerStatus CancelMatchBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

Блокирующая версия CancelMatch .

Позволяет вызывающему абоненту указать тайм-аут в мс. По истечении указанного времени функция возвращает ERROR_TIMEOUT .

ОтменаБлокировка совпадений

MultiplayerStatus CancelMatchBlocking(
  const TurnBasedMatch & match
)

Перегрузка CancelMatch , которая использует тайм-аут по умолчанию, равный 10 годам.

ПодтвердитьОжидание завершения

void ConfirmPendingCompletion(
  const TurnBasedMatch & match,
  TurnBasedMatchCallback callback
)

Подтверждает результаты матча, который завершился и ожидает локального завершения.

Эту функцию можно вызвать только тогда, когда TurnBasedMatch::Status() возвращает MatchStatus::PENDING_COMPLETION .

Подробности
Параметры
match
Матч, завершение которого необходимо подтвердить.
callback
Обратный вызов, получающий TurnBasedMatchResponse .

ПодтвердитьОжидание завершенияБлокировка

TurnBasedMatchResponse ConfirmPendingCompletionBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

Блокирующая версия ConfirmPendingCompletion .

Позволяет вызывающему абоненту указать тайм-аут в мс. По истечении указанного времени функция возвращает ERROR_TIMEOUT .

ПодтвердитьОжидание завершенияБлокировка

TurnBasedMatchResponse ConfirmPendingCompletionBlocking(
  const TurnBasedMatch & match
)

Перегрузка ConfirmPendingCompletionBlocking , которая использует тайм-аут по умолчанию, равный 10 годам.

СоздатьTurnBasedMatch

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

Асинхронно создает TurnBasedMatch используя предоставленный TurnBasedMatchConfig .

Если создание прошло успешно, эта функция возвращает TurnBasedMatch через предоставленный TurnBasedMatchCallback . Вновь созданный TurnBasedMatch всегда запускается в состоянии TurnBasedMatchState::MY_TURN .

CreateTurnBasedMatchBlocking

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

Блокирующая версия CreateTurnBasedMatch .

Позволяет вызывающему абоненту указать тайм-аут в мс. По истечении указанного времени функция возвращает ERROR_TIMEOUT .

CreateTurnBasedMatchBlocking

TurnBasedMatchResponse CreateTurnBasedMatchBlocking(
  const gpg::TurnBasedMatchConfig & config
)

Перегрузка CreateTurnBasedMatchBlocking , которая использует тайм-аут по умолчанию, равный 10 годам.

Отклонить приглашение

void DeclineInvitation(
  const MultiplayerInvitation & invitation
)

Отклоняет MultiplayerInvitation в TurnBasedMatch .

При этом матч для других участников будет отменен, а матч будет удален с устройства локального игрока.

Отклонить приглашение

void DismissInvitation(
  const MultiplayerInvitation & invitation
)

Отклоняет MultiplayerInvitation в TurnBasedMatch .

Это не меняет видимое состояние TurnBasedMatch для других участников, но удаляет TurnBasedMatch с устройства локального игрока.

DismissMatch

void DismissMatch(
  const TurnBasedMatch & match
)

Отклоняет TurnBasedMatch .

Это не меняет видимое состояние TurnBasedMatch для других участников, но удаляет TurnBasedMatch с устройства локального игрока.

FetchMatch

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

Асинхронно извлекает определенное совпадение по идентификатору.

Результат этой операции возвращается через TurnBasedMatchCallback .

Блокировка FetchMatch

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

Блокирующая версия FetchMatch .

Позволяет вызывающему абоненту указать тайм-аут в мс. По истечении указанного времени функция возвращает ERROR_TIMEOUT .

Блокировка FetchMatch

TurnBasedMatchResponse FetchMatchBlocking(
  const std::string & match_id
)

Перегрузка FetchMatchBlocking , которая использует тайм-аут по умолчанию, равный 10 годам.

FetchMatches

void FetchMatches(
  TurnBasedMatchesCallback callback
)

Асинхронно извлекает объекты TurnBasedMatch и Invitation для текущего игрока.

Возвращаются все активные матчи и до 10 завершенных матчей.

FetchMatchesБлокировка

TurnBasedMatchesResponse FetchMatchesBlocking(
  Timeout timeout
)

Блокирующая версия FetchMatches .

Позволяет вызывающему абоненту указать таймаут в мс. По истечении указанного времени функция возвращает ERROR_TIMEOUT .

FetchMatchesБлокировка

TurnBasedMatchesResponse FetchMatchesBlocking()

Перегрузка FetchMatchesBlocking , которая использует тайм-аут по умолчанию, равный 10 годам.

FinishMatchDuringMyTurn

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

Асинхронно завершает указанное совпадение.

Его можно использовать вместо TakeMyTurn во время финального хода матча. Позволяет вызывающему объекту указать окончательное значение для match_data , а также набор окончательных значений для ParticipantResults . После завершения этой операции обновленное совпадение возвращается через предоставленный TurnBasedMatchCallback. Эту функцию можно вызвать только тогда, когда TurnBasedMatch::Status() возвращает MatchStatus::MY_TURN .

Подробности
Параметры
match
Матч до конца.
match_data
Блок данных, представляющий окончательное состояние совпадения.
results
Любые результаты для каждого игрока в матче. Обратите внимание, что эти результаты не должны противоречить каким-либо результатам, указанным ранее через TakeTurn . Попытка установить разные результаты для игрока приводит к ошибке ERROR_INVALID_RESULTS .
callback
Обратный вызов, который получает TurnBasedMatchResponse .

FinishMatchDuringMyTurnBlocking

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

Блокирующая версия FinishMatchDuringMyTurn .

Позволяет вызывающему абоненту указать таймаут в мс. По истечении указанного времени функция возвращает ERROR_TIMEOUT .

FinishMatchDuringMyTurnBlocking

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

Перегрузка FinishMatchDuringMyTurnBlocking , которая использует тайм-аут по умолчанию, равный 10 годам.

Выход из матча во время MyTurn

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

Асинхронно покидает матч во время хода локального участника.

Ответ, возвращаемый через TurnBasedMatchCallback содержит состояние матча после ухода локального игрока. Если в результате такого вылета в матче останется менее двух участников, матч отменяется. match.Status() должен возвращать MatchStatus::MY_TURN чтобы эту функцию можно было использовать.

Подробности
Параметры
match
Матч оставить.
next_participant
Участник, чья очередь следующая. TurnBasedMultiplayerManager::kAutomatchingParticipant можно использовать, чтобы указать, что следующий участник должен быть выбран посредством автоматического сопоставления.
callback
Обратный вызов, который получает TurnBasedMatchResponse

LeaveMatchDuringMyTurnBlocking

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

Блокирующая версия LeaveMatchDuringMyTurn .

Позволяет вызывающему абоненту указать таймаут в мс. По истечении указанного времени функция возвращает ERROR_TIMEOUT .

LeaveMatchDuringMyTurnBlocking

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

Перегрузка LeaveMatchDuringMyTurnBlocking , которая использует тайм-аут по умолчанию, равный 10 годам.

Выход из матча во время их хода

void LeaveMatchDuringTheirTurn(
  const TurnBasedMatch & match,
  MultiplayerStatusCallback callback
)

Асинхронно покидает матч во время хода другого участника.

Ответ, возвращенный через MultiplayerStatusCallback содержит информацию о том, успешно ли локальный участник покинул матч. Если в результате такого вылета в матче останется менее двух участников, матч отменяется. match.Status() должен возвращать MatchStatus::THEIR_TURN чтобы эту функцию можно было использовать.

LeaveMatchDuringTheirTurnБлокирование

MultiplayerStatus LeaveMatchDuringTheirTurnBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

Блокирующая версия LeaveMatchDuringTheirTurn .

Позволяет вызывающему абоненту указать тайм-аут в мс. По истечении указанного времени функция возвращает ERROR_TIMEOUT .

LeaveMatchDuringTheirTurnБлокирование

MultiplayerStatus LeaveMatchDuringTheirTurnBlocking(
  const TurnBasedMatch & match
)

Перегрузка LeaveMatchDuringTheirTurnBlocking , которая использует тайм-аут по умолчанию, равный 10 годам.

Матч-реванш

void Rematch(
  const TurnBasedMatch & match,
  TurnBasedMatchCallback callback
)

Повторно сопоставляет совпадение с состоянием MatchStatus::COMPLETED .

Если повторное сопоставление возможно, TurnBasedMatchCallback получает новое совпадение.

Подробности
Параметры
match
Матч-реванш.
callback
Обратный вызов, который получает TurnBasedMatchResponse .

Блокировка матча-реванша

TurnBasedMatchResponse RematchBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

Блокирующая версия Rematch .

Позволяет вызывающему абоненту указать тайм-аут в мс. По истечении указанного времени функция возвращает ERROR_TIMEOUT .

Блокировка матча-реванша

TurnBasedMatchResponse RematchBlocking(
  const TurnBasedMatch & match
)

Перегрузка RematchBlocking , которая использует тайм-аут по умолчанию, равный 10 годам.

ШоуМатчИнбоксUI

void ShowMatchInboxUI(
  MatchInboxUICallback callback
)

Асинхронно отображает пользовательский интерфейс почтового ящика матча, позволяя игроку выбрать матч или приглашение.

По завершении выбранное совпадение или приглашение возвращается через MatchInboxUICallback .

ПоказатьMatchInboxUIБлокирование

MatchInboxUIResponse ShowMatchInboxUIBlocking(
  Timeout timeout
)

Блокирующая версия ShowMatchInboxUI .

Позволяет вызывающему абоненту указать тайм-аут в мс. По истечении указанного времени функция возвращает ERROR_TIMEOUT .

ПоказатьMatchInboxUIБлокирование

MatchInboxUIResponse ShowMatchInboxUIBlocking()

Перегрузка ShowMatchInboxUIBlocking , которая использует тайм-аут по умолчанию, равный 10 годам.

Показать плеерселект UI

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

Асинхронно отображает пользовательский интерфейс выбора игрока, позволяющий игроку выбирать других игроков для игры в матче.

По завершении выбранные игроки будут возвращены через PlayerSelectUICallback .

ShowPlayerSelectUIБлокирование

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

Блокирующая версия ShowPlayerSelectUI .

Позволяет вызывающему абоненту указать тайм-аут в мс. По истечении указанного времени функция возвращает ERROR_TIMEOUT .

ПоказатьPlayerSelectUIБлокирование

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

Перегрузка ShowPlayerSelectUIBlocking , которая использует тайм-аут по умолчанию, равный 10 годам.

Синхронизировать данные

void SynchronizeData()

Принудительно синхронизирует данные соответствия TBMP с сервером.

Прием новых данных запускает OnTurnBasedMatchEventCallback или OnMultiplayerInvitationReceivedCallback .

TakeMyTurn

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

Асинхронно занимает очередь локального участника.

Делая ход, участник может указать новое значение match_data , а также набор ParticipantResults . Когда ход завершен, обновленное совпадение возвращается через TurnBasedMatchCallback . Эту функцию можно вызывать только тогда, когда TurnBasedMatch::Status() имеет значение MatchStatus::MY_TURN .

Подробности
Параметры
match
Матч, в котором происходит терн.
match_data
Блок данных для отправки следующему участнику.
results
Какие-либо известные результаты матча на текущий момент. Обратите внимание, что результат для данного игрока можно указать только один раз. Попытка установить разные результаты для игрока приводит к ошибке ERROR_INVALID_RESULTS .
next_participant
Участник, чья очередь следующая. TurnBasedMultiplayerManager::kAutomatchingParticipant можно использовать, чтобы указать, что следующий участник должен быть выбран посредством автоматического сопоставления.
callback
Обратный вызов, который получает TurnBasedMatchResponse .

TakeMyTurnБлокировка

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

Блокирующая версия TakeMyTurn .

Позволяет вызывающему абоненту указать тайм-аут в мс. По истечении указанного времени функция возвращает ERROR_TIMEOUT .

TakeMyTurnБлокировка

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

Перегрузка TakeMyTurnBlocking , которая использует тайм-аут по умолчанию, равный 10 годам.