gpg::TurnBasedMatch

#include <turn_based_match.h>

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à hàm phá

TurnBasedMatch()
TurnBasedMatch(std::shared_ptr< const TurnBasedMatchImpl > impl)
Tạo TurnBasedMatch từ shared_ptr đến TurnBasedMatchImpl.
TurnBasedMatch(const TurnBasedMatch & copy_from)
Tạo bản sao của một TurnBasedMatch hiện có.
TurnBasedMatch(TurnBasedMatch && move_from)
Di chuyển TurnBasedMatch hiện có.

Hàm công khai

AutomatchingSlotsAvailable() const
uint32_t
Trả về số vị trí tự động khớp hiện có cho kết quả trùng khớp.
CreatingParticipant() const
Trả về người tham gia đã tạo kết quả trùng khớp này.
CreationTime() const
std::chrono::milliseconds
Trả về thời gian mà TurnBasedMatch was created này (được biểu thị bằ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 so 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 đặt trong lượt trước.
HasPreviousMatchData() const
bool
"True" nếu đây là lượt đầu tiên của lượt đấu lại và dữ liệu từ giá trị Valid trước đó phải trả về giá trị 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 kết hợp lại.
Id() const
const std::string &
Trả về một mã nhận dạng duy nhất TurnBasedMatch này.
LastUpdateTime() const
Trả về thời gian TurnBasedMatch được cập nhật 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
Một số cho biết có bao nhiêu kết quả trùng khớp đứng trước kết quả này thông qua tính năng so khớp lại.
ParticipantResults() const
Trả về kết quả cho kết quả trùng khớp.
Participants() const
const std::vector< MultiplayerParticipant > &
Vectơ của tất cả những người tham gia trận đấu này.
PendingParticipant() const
Trả về người tham gia đến lượt cần cập nhật trận đấu này.
PreviousMatchData() const
const std::vector< uint8_t > &
Dữ liệu của kết quả 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 của kết quả trùng khớp này, nếu có.
Status() const
Trả về trạng thái khớp của người tham gia cục bộ.
SuggestedNextParticipant() const
Chức năng trợ giúp chọn người tham gia hợp lệ trong nhóm người tham gia đã tham gia, không thể nhìn thấy 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ể dành riêng cho trò chơi mà trò chơi có thể sử dụng để xác định nhiều chế độ trò chơi.
Version() const
uint32_t
Mã nhận dạng tăng dần nghiêm ngặt, được cập nhật mỗi khi kết quả trùng khớp được sửa đổi.
operator=(const TurnBasedMatch & copy_from)
Chỉ định TurnBasedMatch này bằng cách sao chép từ một thiết bị khác.
operator=(TurnBasedMatch && move_from)
Gán TurnBasedMatch này bằng cách di chuyển một màn hình khác vào đó.

Hàm công khai

AutomatchingSlotsAvailable

uint32_t AutomatchingSlotsAvailable() const 

Trả về số vị trí tự động khớp hiện có cho kết quả trùng khớp.

Số này bằng với số vị trí tự động so khớp mà kết quả trùng khớp được tạo, trừ đi số người tham gia đã được thêm thông qua tính năng tự động so khớp. Giá trị Hợp lệ phải trả về giá trị true (đúng) để hàm này có thể sử dụng được.

CreatingParticipant

MultiplayerParticipant CreatingParticipant() const 

Trả về người tham gia đã tạo kết quả trùng khớp này.

Giá trị Hợp lệ phải trả về giá trị true (đúng) để hàm này 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ị 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ề giá trị true (đúng) để hàm này có thể sử dụng được.

Dữ liệu

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

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

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

Nội dung 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ề giá trị true (đúng) để hàm này có thể sử dụng được.

HasData

bool HasData() const 

Đúng nếu đối tượng này có dữ liệu đã được đặt trong lượt trước.

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

HasPreviousMatchData

bool HasPreviousMatchData() const 

"True" nếu đây là lượt đầu tiên của lượt đấu lại và dữ liệu từ giá trị Valid trước đó phải trả về giá trị 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 kết hợp lại.

Mã nhận dạng

const std::string & Id() const 

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

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

LastUpdateTime

Timestamp LastUpdateTime() const 

Trả về thời gian TurnBasedMatch được cập nhật 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ề giá trị true (đúng) để hàm này 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ề giá trị true (đúng) để hàm này có thể sử dụng được.

Số

uint32_t Number() const 

Một số cho biết có bao nhiêu kết quả trùng khớp đứng trước kết quả này thông qua tính năng so khớp lại.

Được thiết lập là 1 trong lần trùng khớp đầu tiên và tăng thêm một trong mỗi lần tái đấu.

ParticipantResults

const gpg::ParticipantResults & ParticipantResults() const 

Trả về kết quả cho kết quả trùng khớp.

Bạn có thể đặt kết quả qua TurnBasedMultiplayerManager::TakeMyTurn, TurnBasedMultiplayerManager::FinishDuringMyTurn và các hàm liên quan khác. Luôn sử dụng ParticipantResults().WithResult(...) để tạo một đố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ề giá trị true (đúng) để hàm này có thể sử dụng được.

Người tham gia

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

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

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

PendingParticipant

MultiplayerParticipant PendingParticipant() const 

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

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

PreviousMatchData

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

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

Chỉ có thể được gọi nếu giá trị Valid (Hợp lệ) trả về giá trị true (đúng).

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 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 khớp của người tham gia cục bộ.

Trạng thái này xác định những hành động mà bạn có thể thực hiện trên phần so khớp. Giá trị Hợp lệ phải trả về giá trị true (đúng) để hàm này có thể sử dụng được.

SuggestedNextParticipant

MultiplayerParticipant SuggestedNextParticipant() const 

Chức năng trợ giúp chọn người tham gia hợp lệ trong nhóm người tham gia đã tham gia, không thể nhìn thấy 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, thì quá trình phát sẽ tiếp tục diễn ra theo thứ tự tất cả những người tham gia và lặp lại nếu cần. Hàm này chỉ được gọi nếu Status()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 có ý nghĩa. Nếu gọi không đúng, 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 đến TurnBasedMatchImpl.

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

TurnBasedMatch

 TurnBasedMatch(
  const TurnBasedMatch & copy_from
)

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

TurnBasedMatch

 TurnBasedMatch(
  TurnBasedMatch && move_from
)

Di chuyển 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 (đúng) cho các hàm getter trên đối tượng TurnBasedMatch (Id, CreationTime, v.v.) thì mới dùng được.

Biến thể

uint32_t Variant() const 

Trả về giá trị nhận dạng biến thể dành riêng cho trò chơi mà trò chơi có thể sử dụng để xác định nhiều chế độ trò chơi.

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

Phiên bản

uint32_t Version() const 

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

toán tử=

TurnBasedMatch & operator=(
  const TurnBasedMatch & copy_from
)

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

toán tử=

TurnBasedMatch & operator=(
  TurnBasedMatch && move_from
)

Gán TurnBasedMatch này bằng cách di chuyển một màn hình khác vào đó.