gpg::TurnBasedMultiplayerManager

#include <turn_based_multiplayer_manager.h>

TurnBasedMatch 객체를 가져오고 수정하고 만듭니다.

요약

공개 유형
MatchInboxUICallback typedef
std::function< void(const MatchInboxUIResponse &)>
ShowMatchInboxUI에서 MatchInboxUIResponse를 수신할 수 있는 콜백을 정의합니다.
MultiplayerStatusCallback typedef
std::function< void(MultiplayerStatus)>
MultiplayerStatus를 수신하는 데 사용할 수 있는 콜백을 정의합니다.
PlayerSelectUICallback typedef
std::function< void(const PlayerSelectUIResponse &)>
ShowPlayerSelectUI에서 PlayerSelectUIResponse를 수신할 수 있는 콜백을 정의합니다.
TurnBasedMatchCallback typedef
std::function< void(const TurnBasedMatchResponse &)>
턴 기반 멀티플레이어 작업 중 하나에서 TurnBasedMatchResponse를 수신하는 데 사용할 수 있는 콜백을 정의합니다.
TurnBasedMatchesCallback typedef
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)
기본 제한 시간 10년을 사용하는 AcceptInvitationBlocking의 오버로드입니다.
CancelMatch(const TurnBasedMatch & match, MultiplayerStatusCallback callback)
void
일치를 비동기식으로 취소합니다.
CancelMatchBlocking(Timeout timeout, const TurnBasedMatch & match)
CancelMatch의 차단 버전입니다.
CancelMatchBlocking(const TurnBasedMatch & match)
기본 시간 제한 10년을 사용하는 CancelMatch의 오버로드입니다.
ConfirmPendingCompletion(const TurnBasedMatch & match, TurnBasedMatchCallback callback)
void
종료되었으며 로컬 완료를 대기 중인 일치의 결과를 확인합니다.
ConfirmPendingCompletionBlocking(Timeout timeout, const TurnBasedMatch & match)
ConfirmPendingCompletion의 차단 버전입니다.
ConfirmPendingCompletionBlocking(const TurnBasedMatch & match)
기본 제한 시간 10년을 사용하는 ConfirmPendingCompletionBlocking의 오버로드입니다.
CreateTurnBasedMatch(const gpg::TurnBasedMatchConfig & config, TurnBasedMatchCallback callback)
void
제공된 TurnBasedMatchConfig를 사용하여 TurnBasedMatch를 비동기식으로 만듭니다.
CreateTurnBasedMatchBlocking(Timeout timeout, const gpg::TurnBasedMatchConfig & config)
CreateTurnBasedMatch의 차단 버전입니다.
CreateTurnBasedMatchBlocking(const gpg::TurnBasedMatchConfig & config)
기본 제한 시간 10년을 사용하는 CreateTurnBasedMatchBlocking의 오버로드입니다.
DeclineInvitation(const MultiplayerInvitation & invitation)
void
MultiplayerInvitation를 TurnBasedMatch로 거부합니다.
DismissInvitation(const MultiplayerInvitation & invitation)
void
DismissMatch(const TurnBasedMatch & match)
void
TurnBasedMatch을 닫습니다.
FetchMatch(const std::string & match_id, TurnBasedMatchCallback callback)
void
ID별로 특정 일치를 비동기식으로 가져옵니다.
FetchMatchBlocking(Timeout timeout, const std::string & match_id)
FetchMatch의 차단 버전입니다.
FetchMatchBlocking(const std::string & match_id)
기본 제한 시간 10년을 사용하는 FetchMatchBlocking의 오버로드입니다.
FetchMatches(TurnBasedMatchesCallback callback)
void
현재 플레이어의 TurnBasedMatch 및 Invitation 객체를 비동기식으로 가져옵니다.
FetchMatchesBlocking(Timeout timeout)
FetchMatches의 차단 버전입니다.
FetchMatchesBlocking()
기본 제한 시간 10년을 사용하는 FetchMatchesBlocking의 오버로드입니다.
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)
기본 제한 시간 10년을 사용하는 FinishMatchDuringMyTurnBlocking의 오버로드입니다.
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)
기본 제한 시간 10년을 사용하는 LeaveMatchDuringMyTurnBlocking의 오버로드입니다.
LeaveMatchDuringTheirTurn(const TurnBasedMatch & match, MultiplayerStatusCallback callback)
void
다른 참여자의 차례 중에 비동기식으로 경기를 종료합니다.
LeaveMatchDuringTheirTurnBlocking(Timeout timeout, const TurnBasedMatch & match)
LeaveMatchDuringTheirTurn의 차단 버전입니다.
LeaveMatchDuringTheirTurnBlocking(const TurnBasedMatch & match)
기본 제한 시간 10년을 사용하는 LeaveMatchDuringTheirTurnBlocking의 오버로드입니다.
Rematch(const TurnBasedMatch & match, TurnBasedMatchCallback callback)
void
상태가 MatchStatus::COMPLETED인 일치를 다시 일치시킵니다.
RematchBlocking(Timeout timeout, const TurnBasedMatch & match)
Rematch의 차단 버전입니다.
RematchBlocking(const TurnBasedMatch & match)
기본 제한 시간 10년을 사용하는 RematchBlocking의 오버로드입니다.
ShowMatchInboxUI(MatchInboxUICallback callback)
void
일치 받은편지함 UI를 비동기식으로 표시하여 플레이어가 일치 또는 초대를 선택할 수 있도록 합니다.
ShowMatchInboxUIBlocking(Timeout timeout)
ShowMatchInboxUI의 차단 버전입니다.
ShowMatchInboxUIBlocking()
기본 제한 시간 10년을 사용하는 ShowMatchInboxUIBlocking의 오버로드입니다.
ShowPlayerSelectUI(uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch, PlayerSelectUICallback callback)
void
플레이어 선택 UI를 비동기식으로 표시하여 플레이어가 경기를 치를 다른 플레이어를 선택할 수 있도록 합니다.
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)
기본 제한 시간 10년을 사용하는 ShowPlayerSelectUIBlocking의 오버로드입니다.
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)
기본 제한 시간 10년을 사용하는 TakeMyTurnBlocking의 오버로드입니다.

구조체
gpg::TurnBasedMultiplayerManager::MatchInboxUIResponse

ShowMatchInboxUI 작업의 경우 Data 및 ResponseStatus

gpg::TurnBasedMultiplayerManager::PlayerSelectUIResponse

ShowPlayerSelectUI 작업의 경우 Data 및 ResponseStatus

gpg::TurnBasedMultiplayerManager::TurnBasedMatchResponse

특정 TurnBasedMatch의 Data 및 ResponseStatus

gpg::TurnBasedMultiplayerManager::TurnBasedMatchesResponse

TurnBasedMatches 및 invitations의 경우 Data 및 ResponseStatus

공개 유형

MatchInboxUICallback

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

ShowMatchInboxUI에서 MatchInboxUIResponse를 수신할 수 있는 콜백을 정의합니다.

MultiplayerStatusCallback

std::function< void(MultiplayerStatus)> MultiplayerStatusCallback

MultiplayerStatus를 수신하는 데 사용할 수 있는 콜백을 정의합니다.

LeaveMatch 및 CancelMatch 함수에서 사용합니다.

PlayerSelectUICallback

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

ShowPlayerSelectUI에서 PlayerSelectUIResponse를 수신할 수 있는 콜백을 정의합니다.

TurnBasedMatchCallback

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

턴 기반 멀티플레이어 작업 중 하나에서 TurnBasedMatchResponse를 수신하는 데 사용할 수 있는 콜백을 정의합니다.

TurnBasedMatchesCallback

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

턴 기반 멀티플레이어 작업 중 하나에서 TurnBasedMatchesResponse를 수신할 수 있는 콜백을 정의합니다.

공개 정적 속성

kAutomatchingParticipant

const MultiplayerParticipant kAutomatchingParticipant

'다음 참여자'를 사용하는 메서드에 전달할 수 있는 참여자입니다.

이렇게 하면 메서드가 자동 일치를 통해 다음 참여자를 선택합니다. 관련 경기에서 TurnBasedMatch::AutomatchingSlotsAvailable이 0보다 큰 경우에만 함수에 kAutomatchingParticipant를 전달할 수 있습니다.

공개 함수

AcceptInvitation

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
)

기본 제한 시간 10년을 사용하는 AcceptInvitationBlocking의 오버로드입니다.

CancelMatch

void CancelMatch(
  const TurnBasedMatch & match,
  MultiplayerStatusCallback callback
)

일치를 비동기식으로 취소합니다.

MultiplayerStatusCallback를 통해 반환된 상태는 작업의 성공 여부를 나타냅니다. 이 함수를 사용하려면 경기 상태가 INVITED, THEIR_TURN 또는 MY_TURN이어야 합니다.

CancelMatchBlocking

MultiplayerStatus CancelMatchBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

CancelMatch의 차단 버전입니다.

호출자가 제한 시간을 밀리초 단위로 지정할 수 있습니다. 지정된 시간이 지나면 함수는 ERROR_TIMEOUT를 반환합니다.

CancelMatchBlocking

MultiplayerStatus CancelMatchBlocking(
  const TurnBasedMatch & match
)

기본 시간 제한 10년을 사용하는 CancelMatch의 오버로드입니다.

ConfirmPendingCompletion

void ConfirmPendingCompletion(
  const TurnBasedMatch & match,
  TurnBasedMatchCallback callback
)

종료되었으며 로컬 완료를 대기 중인 일치의 결과를 확인합니다.

이 함수는 TurnBasedMatch::Status()가 MatchStatus::PENDING_COMPLETION를 반환할 때만 호출할 수 있습니다.

세부정보
매개변수
match
완료를 확인할 일치 항목입니다.
callback
TurnBasedMatchResponse를 수신하는 콜백

ConfirmPendingCompletionBlocking

TurnBasedMatchResponse ConfirmPendingCompletionBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

ConfirmPendingCompletion의 차단 버전입니다.

호출자가 제한 시간을 밀리초 단위로 지정할 수 있습니다. 지정된 시간이 지나면 함수는 ERROR_TIMEOUT를 반환합니다.

ConfirmPendingCompletionBlocking

TurnBasedMatchResponse ConfirmPendingCompletionBlocking(
  const TurnBasedMatch & match
)

기본 제한 시간 10년을 사용하는 ConfirmPendingCompletionBlocking의 오버로드입니다.

CreateTurnBasedMatch

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

제공된 TurnBasedMatchConfig를 사용하여 TurnBasedMatch를 비동기식으로 만듭니다.

생성에 성공하면 이 함수는 제공된 TurnBasedMatchCallback를 통해 TurnBasedMatch를 반환합니다. 새로 생성된 TurnBasedMatch는 항상 TurnBasedMatchState::MY_TURN 상태로 시작합니다.

CreateTurnBasedMatchBlocking

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

CreateTurnBasedMatch의 차단 버전입니다.

호출자가 제한 시간을 밀리초 단위로 지정할 수 있습니다. 지정된 시간이 지나면 함수는 ERROR_TIMEOUT를 반환합니다.

CreateTurnBasedMatchBlocking

TurnBasedMatchResponse CreateTurnBasedMatchBlocking(
  const gpg::TurnBasedMatchConfig & config
)

기본 제한 시간 10년을 사용하는 CreateTurnBasedMatchBlocking의 오버로드입니다.

DeclineInvitation

void DeclineInvitation(
  const MultiplayerInvitation & invitation
)

MultiplayerInvitation를 TurnBasedMatch로 거부합니다.

이렇게 하면 다른 참여자의 일치가 취소되고 로컬 플레이어의 기기에서 일치가 삭제됩니다.

DismissInvitation

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
)

ID별로 특정 일치를 비동기식으로 가져옵니다.

이 작업의 결과는 TurnBasedMatchCallback를 통해 반환됩니다.

FetchMatchBlocking

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

FetchMatch의 차단 버전입니다.

호출자가 제한 시간을 밀리초 단위로 지정할 수 있습니다. 지정된 시간이 지나면 함수는 ERROR_TIMEOUT를 반환합니다.

FetchMatchBlocking

TurnBasedMatchResponse FetchMatchBlocking(
  const std::string & match_id
)

기본 제한 시간 10년을 사용하는 FetchMatchBlocking의 오버로드입니다.

FetchMatches

void FetchMatches(
  TurnBasedMatchesCallback callback
)

현재 플레이어의 TurnBasedMatch 및 Invitation 객체를 비동기식으로 가져옵니다.

모든 활성 상태의 일치 항목과 완료된 일치 항목 최대 10개가 반환됩니다.

FetchMatchesBlocking

TurnBasedMatchesResponse FetchMatchesBlocking(
  Timeout timeout
)

FetchMatches의 차단 버전입니다.

호출자가 제한 시간을 밀리초 단위로 지정할 수 있습니다. 지정된 시간이 지나면 함수는 ERROR_TIMEOUT를 반환합니다.

FetchMatchesBlocking

TurnBasedMatchesResponse FetchMatchesBlocking()

기본 제한 시간 10년을 사용하는 FetchMatchesBlocking의 오버로드입니다.

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
일치의 최종 상태를 나타내는 데이터 blob입니다.
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
)

기본 제한 시간 10년을 사용하는 FinishMatchDuringMyTurnBlocking의 오버로드입니다.

LeaveMatchDuringMyTurn

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

로컬 참여자의 차례 중에 비동기식으로 경기를 종료합니다.

TurnBasedMatchCallback를 통해 반환된 응답에는 로컬 플레이어가 종료된 후 경기의 상태가 포함됩니다. 이로 인해 참여자가 2명 미만이 되면 경기가 취소됩니다. 이 함수를 사용할 수 있으려면 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
)

기본 제한 시간 10년을 사용하는 LeaveMatchDuringMyTurnBlocking의 오버로드입니다.

LeaveMatchDuringTheirTurn

void LeaveMatchDuringTheirTurn(
  const TurnBasedMatch & match,
  MultiplayerStatusCallback callback
)

다른 참여자의 차례 중에 비동기식으로 경기를 종료합니다.

MultiplayerStatusCallback를 통해 반환된 응답에는 로컬 참여자가 경기에서 탈퇴했는지 여부가 포함됩니다. 이로 인해 참여자가 2명 미만이 되면 경기가 취소됩니다. 이 함수를 사용할 수 있으려면 match.Status()가 MatchStatus::THEIR_TURN를 반환해야 합니다.

LeaveMatchDuringTheirTurnBlocking

MultiplayerStatus LeaveMatchDuringTheirTurnBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

LeaveMatchDuringTheirTurn의 차단 버전입니다.

호출자가 제한 시간을 밀리초 단위로 지정할 수 있습니다. 지정된 시간이 지나면 함수는 ERROR_TIMEOUT를 반환합니다.

LeaveMatchDuringTheirTurnBlocking

MultiplayerStatus LeaveMatchDuringTheirTurnBlocking(
  const TurnBasedMatch & match
)

기본 제한 시간 10년을 사용하는 LeaveMatchDuringTheirTurnBlocking의 오버로드입니다.

재대결

void Rematch(
  const TurnBasedMatch & match,
  TurnBasedMatchCallback callback
)

상태가 MatchStatus::COMPLETED인 일치를 다시 일치시킵니다.

재경기가 가능한 경우 TurnBasedMatchCallback는 새 경기를 수신합니다.

세부정보
매개변수
match
재경기할 경기입니다.
callback
TurnBasedMatchResponse를 수신하는 콜백입니다.

RematchBlocking

TurnBasedMatchResponse RematchBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

Rematch의 차단 버전입니다.

호출자가 제한 시간을 밀리초 단위로 지정할 수 있습니다. 지정된 시간이 지나면 함수는 ERROR_TIMEOUT를 반환합니다.

RematchBlocking

TurnBasedMatchResponse RematchBlocking(
  const TurnBasedMatch & match
)

기본 제한 시간 10년을 사용하는 RematchBlocking의 오버로드입니다.

ShowMatchInboxUI

void ShowMatchInboxUI(
  MatchInboxUICallback callback
)

일치 받은편지함 UI를 비동기식으로 표시하여 플레이어가 일치 또는 초대를 선택할 수 있도록 합니다.

완료되면 선택한 일치 항목 또는 초대가 MatchInboxUICallback를 통해 반환됩니다.

ShowMatchInboxUIBlocking

MatchInboxUIResponse ShowMatchInboxUIBlocking(
  Timeout timeout
)

ShowMatchInboxUI의 차단 버전입니다.

호출자가 제한 시간을 밀리초 단위로 지정할 수 있습니다. 지정된 시간이 지나면 함수는 ERROR_TIMEOUT를 반환합니다.

ShowMatchInboxUIBlocking

MatchInboxUIResponse ShowMatchInboxUIBlocking()

기본 제한 시간 10년을 사용하는 ShowMatchInboxUIBlocking의 오버로드입니다.

ShowPlayerSelectUI

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

플레이어 선택 UI를 비동기식으로 표시하여 플레이어가 경기를 치를 다른 플레이어를 선택할 수 있도록 합니다.

완료되면 선택한 플레이어가 PlayerSelectUICallback를 통해 반환됩니다.

ShowPlayerSelectUIBlocking

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

ShowPlayerSelectUI의 차단 버전입니다.

호출자가 제한 시간을 밀리초 단위로 지정할 수 있습니다. 지정된 시간이 지나면 함수는 ERROR_TIMEOUT를 반환합니다.

ShowPlayerSelectUIBlocking

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

기본 제한 시간 10년을 사용하는 ShowPlayerSelectUIBlocking의 오버로드입니다.

SynchronizeData

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
다음 참여자에게 전송할 데이터 blob입니다.
results
현재 알려진 일치 항목의 결과입니다. 특정 플레이어의 결과는 한 번만 지정할 수 있습니다. 플레이어에 다른 결과를 설정하려고 하면 ERROR_INVALID_RESULTS이 발생합니다.
next_participant
다음 차례인 참여자입니다. TurnBasedMultiplayerManager::kAutomatchingParticipant는 다음 참가자를 자동 일치를 통해 선택해야 한다고 지정하는 데 사용할 수 있습니다.
callback
TurnBasedMatchResponse를 수신하는 콜백입니다.

TakeMyTurnBlocking

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

TakeMyTurn의 차단 버전입니다.

호출자가 제한 시간을 밀리초 단위로 지정할 수 있습니다. 지정된 시간이 지나면 함수는 ERROR_TIMEOUT를 반환합니다.

TakeMyTurnBlocking

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

기본 제한 시간 10년을 사용하는 TakeMyTurnBlocking의 오버로드입니다.