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 dựng |
|
---|---|
TurnBasedMatch()
|
|
TurnBasedMatch(std::shared_ptr< const TurnBasedMatchImpl > impl)
|
|
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 so khớp có sẵn cho kết quả trùng khớp.
|
CreatingParticipant() const
|
Trả về người tham gia đã tạo video 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à đúng. |
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 kết quả trùng khớp và dữ liệu từ Hợp lệ 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 kết hợp lại.
|
Id() const
|
const std::string &
Trả về một mã nhận dạng duy nhất xác định
TurnBasedMatch này. |
LastUpdateTime() const
|
Trả về thời gian gần đây nhất
TurnBasedMatch được cập 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 kết quả trùng khớp này gần đây nhất.
|
Number() const
|
uint32_t
Một số cho biết số kết quả trùng khớp đứng trước kết quả này thông qua việc so khớp lại.
|
ParticipantResults() const
|
const gpg::ParticipantResults &
Trả về 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 trong trận đấu này.
|
PendingParticipant() const
|
Trả về người tham gia có lượt để cập nhật kết quả trùng khớp này.
|
PreviousMatchData() const
|
const std::vector< uint8_t > &
Dữ liệu từ kết quả khớp trước, nếu IsPreviousMatchData().
|
RematchId() const
|
const std::string &
Trả về mã nhận dạng của kết quả trùng khớp, nếu mã này khớp lại.
|
Status() const
|
Trả về trạng thái khớp của người tham gia tại địa phương.
|
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ể truy cập được 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 các chế độ trò chơi khác nhau.
|
Version() const
|
uint32_t
ID gia tăng nghiêm ngặt, được cập nhật mỗi khi một kết quả phù hợp được sửa đổi.
|
operator=(const TurnBasedMatch & copy_from)
|
Giao bài
TurnBasedMatch bằng cách sao chép từ tệp khác. |
operator=(TurnBasedMatch && move_from)
|
Chỉ định
TurnBasedMatch này bằng cách di chuyển một thẻ khác vào đó. |
Hàm công khai
Có các khe tự động so khớp
uint32_t AutomatchingSlotsAvailable() const
Trả về số lượng vị trí tự động so khớp có sẵn cho kết quả trùng khớp.
Con số này bằng với số lượng vị trí tự động so khớp có hoạt động tạo video trùng khớp, trừ đi số người tham gia đã được thêm thông qua tính năng tự động so khớp. Hợp lệ phải trả về giá trị đúng để hàm này có thể sử dụng được.
Đang tạo người tham gia
MultiplayerParticipant CreatingParticipant() const
Trả về người tham gia đã tạo video trùng khớp này.
Hợp lệ phải trả về giá trị đúng để hàm này có thể sử dụng được.
Thời gian tạo
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).
Hợp lệ phải trả về giá trị đúng để hàm này có thể sử dụng được.
Dữ liệu
const std::vector< uint8_t > & Data() const
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.
Hợp lệ phải trả về giá trị đúng để hàm này có thể sử dụng được.
Hàm DataData
bool HasData() const
Đúng nếu đối tượng này có dữ liệu được đặt trong lượt trước.
Hợp lệ phải trả về giá trị đúng để hàm này có thể sử dụng được.
Dữ liệu so khớp trước đó
bool HasPreviousMatchData() const
True nếu đây là lượt đầu tiên của kết quả trùng khớp và dữ liệu từ Hợp lệ trước đó phải trả về true để hàm này có thể sử dụng được.
Mã 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 xác định TurnBasedMatch
này.
Sử dụng với TurnBasedMultiplayerManager::FetchMatch
để truy xuất kết quả trùng khớp này vào lúc khác. Hợp lệ phải trả về giá trị đúng để hàm này có thể sử dụng được.
Thời gian cập nhật gần đây nhất
Timestamp LastUpdateTime() const
Trả về thời gian gần đây nhất TurnBasedMatch
được cập 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).
Hợp lệ phải trả về giá trị đúng để hàm này có thể sử dụng được.
Người cập nhật lần cuối
MultiplayerParticipant LastUpdatingParticipant() const
Trả về người tham gia đã cập nhật kết quả trùng khớp này gần đây nhất.
Hợp lệ phải trả về giá trị đúng để hàm này có thể sử dụng được.
Số
uint32_t Number() const
Một số cho biết số kết quả trùng khớp đứng trước kết quả này thông qua việc so khớp lại.
Được đặt thành 1 trong trận đấu đầu tiên và được tăng thêm 1 trong mỗi trận đấu lại.
Kết quả của người tham gia
const gpg::ParticipantResults & ParticipantResults() const
Trả về 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 khác có liên quan. Luôn sử dụng ParticipantResults().WithResult(...)
để tạo đối tượng ParticipantResults
mới phù hợp với bất kỳ đối tượng hiện có nào. Hợp lệ phải trả về giá trị đú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 trong trận đấu này.
Hợp lệ phải trả về giá trị đúng để hàm này có thể sử dụng được.
Người tham gia đang chờ xem xét
MultiplayerParticipant PendingParticipant() const
Trả về người tham gia có lượt để cập nhật kết quả trùng khớp này.
Hợp lệ phải trả về giá trị đúng để hàm này có thể sử dụng được.
Dữ liệu so khớp trước đó
const std::vector< uint8_t > & PreviousMatchData() const
Dữ liệu từ kết quả khớp trước, nếu IsPreviousMatchData().
Chỉ có thể được gọi nếu Hợp lệ trả về true.
Mã trùng khớp
const std::string & RematchId() const
Trả về mã nhận dạng của kết quả trùng khớp, nếu mã này khớp lại.
Trạng thái
MatchStatus Status() const
Trả về trạng thái khớp của người tham gia tại địa phương.
Trạng thái xác định những hành động có thể thực hiện trên video trùng khớp. Hợp lệ phải trả về giá trị đúng để hàm này có thể sử dụng được.
Người tham gia được đề xuất tiếp theo
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ể truy cập được và tự động so khớp.
Nếu hàm 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 theo thứ tự tất cả những người tham gia theo thứ tự lặp lại nếu cần. Bạn chỉ được gọi hàm này nếu Status() là MatchStatus::MY_turn, vì đây là thời điểm 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ề người tham gia không hợp lệ (MultiplayerParticipant::Valid() == false
).
TurnBasedMatch
TurnBasedMatch()
TurnBasedMatch
TurnBasedMatch( std::shared_ptr< const TurnBasedMatchImpl > impl )
Tạo một 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 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ề 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ể dành riêng cho trò chơi mà trò chơi có thể sử dụng để xác định các chế độ trò chơi khác nhau.
Hợp lệ phải trả về giá trị đúng để hàm này có thể sử dụng được.
Phiên bản
uint32_t Version() const
ID gia tăng nghiêm ngặt, được cập nhật mỗi khi một kết quả phù hợp được sửa đổi.
toán tử=
TurnBasedMatch & operator=( const TurnBasedMatch & copy_from )
Giao bài TurnBasedMatch
bằng cách sao chép từ tệp khác.
toán tử=
TurnBasedMatch & operator=( TurnBasedMatch && move_from )
Chỉ định TurnBasedMatch
này bằng cách di chuyển một thẻ khác vào đó.