gpg:: TurnBasedMatch
#include <turn_based_match.h>
TurnBasedMatch
의 현재 상태에 관한 데이터가 포함된 데이터 구조입니다.
요약
생성자 및 소멸자 |
|
---|---|
TurnBasedMatch()
|
|
TurnBasedMatch(std::shared_ptr< const TurnBasedMatchImpl > impl)
|
|
TurnBasedMatch(const TurnBasedMatch & copy_from)
기존
TurnBasedMatch 의 사본을 생성합니다. |
|
TurnBasedMatch(TurnBasedMatch && move_from)
기존
TurnBasedMatch 를 이동합니다. |
공개 함수 |
|
---|---|
AutomatchingSlotsAvailable() const
|
uint32_t
게임에 사용 가능한 자동 게임 슬롯 수를 반환합니다.
|
CreatingParticipant() const
|
이 일치 항목을 만든 참가자를 반환합니다.
|
CreationTime() const
|
std::chrono::milliseconds
이
TurnBasedMatch was created 의 시간을 반환합니다 (Unix 에포크 이후 밀리초로 표현됨). |
Data() const
|
const std::vector< uint8_t > &
HasData() 가 true인 경우 일치 데이터를 반환합니다. |
Description() const
|
const std::string &
서버에서 생성한 일치 상태 요약을 반환합니다.
|
HasData() const
|
bool
이 객체에 이전 차례 중에 설정된 데이터가 있으면 true입니다.
|
HasPreviousMatchData() const
|
bool
재일치의 첫 번째 회전이면 true이며, 이 함수를 사용하려면 이전 Valid의 데이터가 true를 반환해야 합니다.
|
HasRematchId() const
|
bool
이 일치 항목이 다시 일치되면 true를 반환합니다.
|
Id() const
|
const std::string &
이
TurnBasedMatch 를 고유하게 식별하는 ID를 반환합니다. |
LastUpdateTime() const
|
이
TurnBasedMatch 가 마지막으로 업데이트된 시간을 반환합니다 (Unix 에포크 이후 밀리초로 표현됨). |
LastUpdatingParticipant() const
|
이 경기를 가장 최근에 업데이트한 참가자를 반환합니다.
|
Number() const
|
uint32_t
재일치를 통해 이보다 먼저 일치하는 항목의 수를 나타내는 숫자입니다.
|
ParticipantResults() const
|
const gpg::ParticipantResults &
일치 결과를 반환합니다.
|
Participants() const
|
const std::vector< MultiplayerParticipant > &
이 경기의 모든 참가자의 벡터입니다.
|
PendingParticipant() const
|
이 경기를 업데이트할 차례가 된 참가자를 반환합니다.
|
PreviousMatchData() const
|
const std::vector< uint8_t > &
HasPreviousMatchData()인 경우 이전 일치의 데이터입니다.
|
RematchId() const
|
const std::string &
이 일치 항목과 재대결된 일치 항목의 ID를 반환합니다(있는 경우).
|
Status() const
|
로컬 참가자의 일치 상태를 반환합니다.
|
SuggestedNextParticipant() const
|
조인된, 초대 가능, 자동 매칭 참가자 집합에서 유효한 참가자를 선택하는 도우미 함수.
|
Valid() const
|
bool
이
TurnBasedMatch 에 데이터가 채워져 있으면 true를 반환합니다. |
Variant() const
|
uint32_t
게임에서 다양한 게임 모드를 식별하는 데 사용할 수 있는 게임별 변형 식별자를 반환합니다.
|
Version() const
|
uint32_t
엄격하게 증가하는 ID로, 일치 항목이 수정될 때마다 업데이트됩니다.
|
operator=(const TurnBasedMatch & copy_from)
|
다른 항목에서 복사하여 이
TurnBasedMatch 를 할당합니다. |
operator=(TurnBasedMatch && move_from)
|
다른 항목을 이동하여 이
TurnBasedMatch 를 할당합니다. |
공개 함수
AutomatchingSlotsAvailable
uint32_t AutomatchingSlotsAvailable() const
일치하는 항목에 사용할 수 있는 자동 게임 슬롯 수를 반환합니다.
이 숫자는 매치가 생성된 자동 게임 슬롯 수에서 이미 자동 매칭을 통해 추가된 참가자 수를 뺀 값과 같습니다. 이 함수를 사용하려면 Valid가 true를 반환해야 합니다.
CreatingParticipant
MultiplayerParticipant CreatingParticipant() const
이 일치 항목을 만든 참가자를 반환합니다.
이 함수를 사용하려면 Valid가 true를 반환해야 합니다.
CreationTime
std::chrono::milliseconds CreationTime() const
이 TurnBasedMatch was created
의 시간을 반환합니다 (Unix 에포크 이후 밀리초로 표현됨).
이 함수를 사용하려면 Valid가 true를 반환해야 합니다.
데이터
const std::vector< uint8_t > & Data() const
설명
const std::string & Description() const
서버에서 생성한 일치 상태 요약을 반환합니다.
이 함수를 사용하려면 Valid가 true를 반환해야 합니다.
HasData
bool HasData() const
이 객체에 이전 차례 중에 설정된 데이터가 있으면 true입니다.
이 함수를 사용하려면 Valid가 true를 반환해야 합니다.
HasPreviousMatchData
bool HasPreviousMatchData() const
재일치의 첫 번째 차례가 되면 true이며, 이 함수를 사용하려면 이전 Valid의 데이터가 true를 반환해야 합니다.
HasRematchId
bool HasRematchId() const
이 일치 항목이 다시 일치되면 true를 반환합니다.
ID
const std::string & Id() const
이 TurnBasedMatch
를 고유하게 식별하는 ID를 반환합니다.
TurnBasedMultiplayerManager::FetchMatch
와 함께 사용하여 나중에 이 일치 항목을 가져옵니다. 이 함수를 사용하려면 Valid가 true를 반환해야 합니다.
LastUpdateTime
Timestamp LastUpdateTime() const
이 TurnBasedMatch
가 마지막으로 업데이트된 시간을 반환합니다 (Unix 에포크 이후 밀리초로 표현됨).
이 함수를 사용하려면 Valid가 true를 반환해야 합니다.
LastUpdatingParticipant
MultiplayerParticipant LastUpdatingParticipant() const
이 경기를 가장 최근에 업데이트한 참가자를 반환합니다.
이 함수를 사용하려면 Valid가 true를 반환해야 합니다.
숫자
uint32_t Number() const
재일치를 통해 이보다 먼저 일치하는 항목의 수를 나타내는 숫자입니다.
첫 번째 일치 시 1로 설정되고 재일치 시마다 1씩 증가합니다.
ParticipantResults
const gpg::ParticipantResults & ParticipantResults() const
일치 결과를 반환합니다.
결과는 TurnBasedMultiplayerManager::TakeMyTurn
, TurnBasedMultiplayerManager::FinishDuringMyTurn
, 기타 관련 함수를 통해 설정할 수 있습니다. 항상 ParticipantResults().WithResult(...)
를 사용하여 기존 객체와 일치하는 새로운 ParticipantResults
객체를 만듭니다. 이 함수를 사용하려면 Valid가 true를 반환해야 합니다.
참여자
const std::vector< MultiplayerParticipant > & Participants() const
이 경기의 모든 참가자의 벡터입니다.
이 함수를 사용하려면 Valid가 true를 반환해야 합니다.
PendingParticipant
MultiplayerParticipant PendingParticipant() const
이 경기를 업데이트할 차례가 된 참가자를 반환합니다.
이 함수를 사용하려면 Valid가 true를 반환해야 합니다.
PreviousMatchData
const std::vector< uint8_t > & PreviousMatchData() const
HasPreviousMatchData()인 경우 이전 일치의 데이터입니다.
Valid가 true를 반환하는 경우에만 호출할 수 있습니다.
RematchId
const std::string & RematchId() const
이 일치 항목과 재대결된 일치 항목의 ID를 반환합니다(있는 경우).
상태
MatchStatus Status() const
로컬 참가자의 일치 상태를 반환합니다.
상태는 일치에 대해 수행할 수 있는 작업을 결정합니다. 이 함수를 사용하려면 Valid가 true를 반환해야 합니다.
SuggestedNextParticipant
MultiplayerParticipant SuggestedNextParticipant() const
조인된, 초대 가능, 자동 매칭 참가자 집합에서 유효한 참가자를 선택하는 도우미 함수.
이 기능을 사용하여 항상 다음 참가자를 선택하는 경우, 모든 참가자를 순서대로 재생이 진행되며 필요한 경우 이 작업을 반복합니다. 이 함수는 Status()가 MatchStatus::MY_TURN인 경우에만 호출해야 합니다. 이 함수의 결과가 의미 있게 사용될 수 있는 유일한 시점이기 때문입니다. 이 함수가 잘못 호출되면 잘못된 참여자 (MultiplayerParticipant::Valid() == false
)가 반환됩니다.
TurnBasedMatch
TurnBasedMatch()
TurnBasedMatch
TurnBasedMatch( std::shared_ptr< const TurnBasedMatchImpl > impl )
shared_ptr
에서 TurnBasedMatchImpl
로 TurnBasedMatch
를 구성합니다.
API에서 내부적으로 사용하기 위한 용도입니다.
유효
bool Valid() const
이 TurnBasedMatch
에 데이터가 채워져 있으면 true를 반환합니다.
TurnBasedMatch
객체 (Id
, CreationTime
등)의 getter 함수를 사용하려면 true를 반환해야 합니다.
변형
uint32_t Variant() const
게임에서 다양한 게임 모드를 식별하는 데 사용할 수 있는 게임별 변형 식별자를 반환합니다.
이 함수를 사용하려면 Valid가 true를 반환해야 합니다.
버전
uint32_t Version() const
엄격하게 증가하는 ID로, 일치 항목이 수정될 때마다 업데이트됩니다.
operator=
TurnBasedMatch & operator=( const TurnBasedMatch & copy_from )
다른 항목에서 복사하여 이 TurnBasedMatch
를 할당합니다.
operator=
TurnBasedMatch & operator=( TurnBasedMatch && move_from )
다른 항목을 이동하여 이 TurnBasedMatch
를 할당합니다.