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)
|
|
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
|
const gpg::ParticipantResults &
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
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() 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 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ó.
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 đó.