gpg:: TurnBasedMultiplayerManager
#include <turn_based_multiplayer_manager.h>
TurnBasedMatch
객체를 가져오고 수정하고 만듭니다.
요약
공개 유형 |
|
---|---|
MatchInboxUICallback
|
typedefstd::function< void(const MatchInboxUIResponse &)>
ShowMatchInboxUI 에서 MatchInboxUIResponse 를 수신할 수 있는 콜백을 정의합니다. |
MultiplayerStatusCallback
|
typedefstd::function< void(MultiplayerStatus)>
MultiplayerStatus를 수신하는 데 사용할 수 있는 콜백을 정의합니다. |
PlayerSelectUICallback
|
typedefstd::function< void(const PlayerSelectUIResponse &)>
ShowPlayerSelectUI 에서 PlayerSelectUIResponse 를 수신할 수 있는 콜백을 정의합니다. |
TurnBasedMatchCallback
|
typedefstd::function< void(const TurnBasedMatchResponse &)>
턴 방식 멀티플레이어 작업 중 하나에서 TurnBasedMatchResponse 를 수신하는 데 사용할 수 있는 콜백을 정의합니다. |
TurnBasedMatchesCallback
|
typedefstd::function< void(const TurnBasedMatchesResponse &)>
턴 방식 멀티플레이어 작업 중 하나에서 TurnBasedMatchesResponse 를 수신할 수 있는 콜백을 정의합니다. |
공개 정적 속성 |
|
---|---|
kAutomatchingParticipant
|
const MultiplayerParticipant
'다음
있습니다.
|
구조체 |
|
---|---|
gpg:: |
|
gpg:: |
|
gpg:: |
특정 |
gpg:: |
TurnBasedMatches 및 초대의 경우 |
공개 유형
MatchInboxUICallback
std::function< void(const MatchInboxUIResponse &)> MatchInboxUICallback
ShowMatchInboxUI
에서 MatchInboxUIResponse
를 수신할 수 있는 콜백을 정의합니다.
MultiplayerStatusCallback
std::function< void(MultiplayerStatus)> MultiplayerStatusCallback
MultiplayerStatus를 수신하는 데 사용할 수 있는 콜백을 정의합니다.
ChooseMatch 및 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보다 큰 경우에만 kAutomatchingContributor를 함수에 전달할 수 있습니다.
공개 함수
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
를 반환할 때만 호출할 수 있습니다.
세부정보 | |||||
---|---|---|---|---|---|
매개변수 |
|
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 )
TurnBasedMatch
에 대해 MultiplayerInvitation
를 거부합니다.
이렇게 하면 다른 참가자의 대결이 취소되고 로컬 플레이어의 기기에서 대결이 삭제됩니다.
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.
를 반환할 때만 호출할 수 있습니다.
세부정보 | |||||||||
---|---|---|---|---|---|---|---|---|---|
매개변수 |
|
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
를 반환해야 합니다.
세부정보 | |||||||
---|---|---|---|---|---|---|---|
매개변수 |
|
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
는 새 일치 항목을 수신합니다.
세부정보 | |||||
---|---|---|---|---|---|
매개변수 |
|
RematchBlocking
TurnBasedMatchResponse RematchBlocking( Timeout timeout, const TurnBasedMatch & match )
재일치의 차단 버전입니다.
호출자가 밀리초 단위로 제한 시간을 지정할 수 있도록 허용합니다. 지정된 시간이 지나면 함수는 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
인 경우에만 호출할 수 있습니다.
세부정보 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
매개변수 |
|
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의 오버로드