gpg::TurnBasedMatch

#include <turn_based_match.h>

Một cấu trúc dữ liệu chứa dữ liệu về trạng thái hiện tại của TurnBasedMatch.

Tóm tắt

Hàm khởi tạo và phá huỷ
TurnBasedMatch()
TurnBasedMatch(std::shared_ptr< const TurnBasedMatchImpl > impl)
Tạo TurnBasedMatch từ shared_ptr thành TurnBasedMatchImpl.
TurnBasedMatch(const TurnBasedMatch & copy_from)
Tạo bản sao của TurnBasedMatch hiện có.
TurnBasedMatch(TurnBasedMatch && move_from)
Di chuyển một TurnBasedMatch hiện có.

Hàm công khai
AutomatchingSlotsAvailable() const
uint32_t
Trả về số lượng vị trí tự động phù hợp sẵn có cho trận đấu.
CreatingParticipant() const
Trả về người tham gia đã tạo trận đấu này.
CreationTime() const
std::chrono::milliseconds
Trả về thời gian mà TurnBasedMatch was created này (được biểu thị dưới dạng mili giây kể từ thời gian bắt đầu của hệ thống Unix).
Data() const
const std::vector< uint8_t > &
Trả về dữ liệu trùng khớp nếu HasData() là true.
Description() const
const std::string &
Trả về bản tóm tắt do máy chủ tạo về trạng thái khớp.
HasData() const
bool
Đúng nếu đối tượng này có dữ liệu đã được thiết lập trong lần rẽ trước.
HasPreviousMatchData() const
bool
"True" nếu đây là lượt đầu tiên của kết quả so khớp lại và dữ liệu từ trạng thái Valid trước đó phải trả về true để hàm này có thể sử dụng được.
HasRematchId() const
bool
Trả về true nếu kết quả trùng khớp này được đối sánh lại.
Id() const
const std::string &
Trả về mã nhận dạng duy nhất của TurnBasedMatch này.
LastUpdateTime() const
Trả về thời gian cập nhật TurnBasedMatch này lần gần đây nhất (được biểu thị bằng mili giây kể từ thời gian bắt đầu của hệ thống Unix).
LastUpdatingParticipant() const
Trả về người tham gia đã cập nhật trận đấu này gần đây nhất.
Number() const
uint32_t
Số cho biết có bao nhiêu kết quả khớp trước kết quả khớp này thông qua kết quả so khớp lại.
ParticipantResults() const
Trả về kết quả phù hợp.
Participants() const
const std::vector< MultiplayerParticipant > &
Vectơ của tất cả người tham gia trong trận đấu này.
PendingParticipant() const
Trả về người tham gia mà đến lượt cập nhật trận đấu này.
PreviousMatchData() const
const std::vector< uint8_t > &
Dữ liệu từ kết quả trùng khớp trước, nếu HasPreviousMatchData().
RematchId() const
const std::string &
Trả về mã của kết quả trùng khớp là kết quả trùng khớp lại của kết quả trùng khớp này (nếu có).
Status() const
Trả về trạng thái của kết quả trùng khớp cho người tham gia tại địa phương.
SuggestedNextParticipant() const
Một chức năng trợ giúp chọn một người tham gia hợp lệ trong tập hợp những người tham gia đã tham gia, không thể tham gia và tự động so khớp.
Valid() const
bool
Trả về true nếu TurnBasedMatch này được điền sẵn dữ liệu.
Variant() const
uint32_t
Trả về giá trị nhận dạng biến thể của từng trò chơi mà trò chơi có thể dùng để xác định các chế độ chơi khác nhau.
Version() const
uint32_t
Mã nhận dạng tăng mạnh, được cập nhật mỗi khi sửa đổi kết quả trùng khớp.
operator=(const TurnBasedMatch & copy_from)
Chỉ định TurnBasedMatch này bằng cách sao chép từ một mã khác.
operator=(TurnBasedMatch && move_from)
Chỉ định TurnBasedMatch này bằng cách di chuyển một mã khác vào đó.

Hàm công khai

AutomatchingSlotsAvailable

uint32_t AutomatchingSlotsAvailable() const

Trả về số lượng vị trí tự động phù hợp sẵn có cho trận đấu.

Con số này bằng số khung giờ tự động so khớp mà trận đấu được tạo ra, trừ đi số người tham gia được thêm vào thông qua tính năng tự động so khớp. Giá trị Hợp lệ phải trả về true thì hàm này mới có thể sử dụng được.

CreatingParticipant

MultiplayerParticipant CreatingParticipant() const

Trả về người tham gia đã tạo trận đấu này.

Giá trị Hợp lệ phải trả về true thì hàm này mới có thể sử dụng được.

CreationTime

std::chrono::milliseconds CreationTime() const

Trả về thời gian mà TurnBasedMatch was created này (được biểu thị dưới dạng mili giây kể từ thời gian bắt đầu của hệ thống Unix).

Giá trị Hợp lệ phải trả về true thì hàm này mới có thể sử dụng được.

Dữ liệu

const std::vector< uint8_t > & Data() const

Trả về dữ liệu trùng khớp nếu HasData() là true.

Giá trị Hợp lệ phải trả về true thì hàm này mới có thể sử dụng được.

Mô tả

const std::string & Description() const

Trả về bản tóm tắt do máy chủ tạo về trạng thái khớp.

Giá trị Hợp lệ phải trả về true thì hàm này mới có thể sử dụng được.

HasData

bool HasData() const

Đúng nếu đối tượng này có dữ liệu đã được thiết lập trong lần rẽ trước.

Giá trị Hợp lệ phải trả về true thì hàm này mới có thể sử dụng được.

HasPreviousMatchData

bool HasPreviousMatchData() const

"True" nếu đây là lượt đầu tiên của kết quả so khớp lại và dữ liệu từ trạng thái Valid trước đó phải trả về true để hàm này có thể sử dụng được.

HasRematchId

bool HasRematchId() const

Trả về true nếu kết quả trùng khớp này được đối sánh lại.

Id

const std::string & Id() const

Trả về mã nhận dạng duy nhất của TurnBasedMatch này.

Sử dụng với TurnBasedMultiplayerManager::FetchMatch để truy xuất kết quả trùng khớp này sau. Giá trị Hợp lệ phải trả về true thì hàm này mới có thể sử dụng được.

LastUpdateTime

Timestamp LastUpdateTime() const

Trả về thời gian cập nhật TurnBasedMatch này lần gần đây nhất (được biểu thị bằng mili giây kể từ thời gian bắt đầu của hệ thống Unix).

Giá trị Hợp lệ phải trả về true thì hàm này mới có thể sử dụng được.

LastUpdatingParticipant

MultiplayerParticipant LastUpdatingParticipant() const

Trả về người tham gia đã cập nhật trận đấu này gần đây nhất.

Giá trị Hợp lệ phải trả về true thì hàm này mới có thể sử dụng được.

Số

uint32_t Number() const

Số cho biết số lượng kết quả phù hợp trước kết quả này thông qua kết quả so khớp lại.

Được đặt thành 1 trong kết quả trùng khớp đầu tiên và tăng thêm một giá trị trong mỗi lần so khớp lại.

ParticipantResults

const gpg::ParticipantResults & ParticipantResults() const

Trả về kết quả khớp.

Kết quả có thể được đặt thông qua TurnBasedMultiplayerManager::TakeMyTurn, TurnBasedMultiplayerManager::FinishDuringMyTurn và các hàm liên quan khác. Luôn sử dụng ParticipantResults().WithResult(...) để tạo đối tượng ParticipantResults mới nhất quán với mọi đối tượng hiện có. Giá trị Hợp lệ phải trả về true thì hàm này mới có thể sử dụng được.

Người tham gia

const std::vector< MultiplayerParticipant > & Participants() const

Vectơ của tất cả người tham gia trong trận đấu này.

Giá trị Hợp lệ phải trả về true thì hàm này mới có thể sử dụng được.

PendingParticipant

MultiplayerParticipant PendingParticipant() const

Trả về người tham gia mà đến lượt cập nhật trận đấu này.

Giá trị Hợp lệ phải trả về true thì hàm này mới có thể sử dụng được.

PreviousMatchData

const std::vector< uint8_t > & PreviousMatchData() const

Dữ liệu từ kết quả trùng khớp trước, nếu HasPreviousMatchData().

Chỉ có thể được gọi nếu giá trị Valid trả về là true.

RematchId

const std::string & RematchId() const

Trả về mã của kết quả trùng khớp là kết quả trùng khớp lại của kết quả trùng khớp này (nếu có).

Trạng thái

MatchStatus Status() const

Trả về trạng thái của kết quả trùng khớp cho người tham gia tại địa phương.

Trạng thái xác định những hành động có thể được thực hiện đối với video trùng khớp. Giá trị Hợp lệ phải trả về true thì hàm này mới có thể sử dụng được.

SuggestedNextParticipant

MultiplayerParticipant SuggestedNextParticipant() const

Một chức năng trợ giúp chọn một người tham gia hợp lệ trong tập hợp những người tham gia đã tham gia, không thể tham gia và tự động so khớp.

Nếu chức năng này luôn được dùng để chọn người tham gia tiếp theo, quá trình chơi sẽ diễn ra theo thứ tự tất cả những người tham gia và lặp lại nếu cần. Chỉ được gọi hàm này nếu Status() là MatchStatus::MY_TURN, vì đây là thời gian duy nhất mà kết quả của hàm này có thể được sử dụng một cách có ý nghĩa. Nếu được gọi không chính xác, hàm này sẽ trả về một người tham gia không hợp lệ (MultiplayerParticipant::Valid() == false).

TurnBasedMatch

 TurnBasedMatch()

TurnBasedMatch

 TurnBasedMatch(
  std::shared_ptr< const TurnBasedMatchImpl > impl
)

Tạo TurnBasedMatch từ shared_ptr thành TurnBasedMatchImpl.

Dành cho API sử dụng nội bộ.

TurnBasedMatch

 TurnBasedMatch(
  const TurnBasedMatch & copy_from
)

Tạo bản sao của TurnBasedMatch hiện có.

TurnBasedMatch

 TurnBasedMatch(
  TurnBasedMatch && move_from
)

Di chuyển một TurnBasedMatch hiện có.

Hợp lệ

bool Valid() const

Trả về true nếu TurnBasedMatch này được điền sẵn dữ liệu.

Phải trả về giá trị true để các hàm getter trên đối tượng TurnBasedMatch (Id, CreationTime, v.v.) có thể sử dụng được.

Biến thể

uint32_t Variant() const

Trả về giá trị nhận dạng biến thể của từng trò chơi mà trò chơi có thể dùng để xác định các chế độ chơi khác nhau.

Giá trị Hợp lệ phải trả về true thì hàm này mới có thể sử dụng được.

Phiên bản

uint32_t Version() const

Mã nhận dạng tăng mạnh, được cập nhật mỗi khi sửa đổi kết quả trùng khớp.

operator=

TurnBasedMatch & operator=(
  const TurnBasedMatch & copy_from
)

Chỉ định TurnBasedMatch này bằng cách sao chép từ một mã khác.

operator=

TurnBasedMatch & operator=(
  TurnBasedMatch && move_from
)

Chỉ định TurnBasedMatch này bằng cách di chuyển một mã khác vào đó.