gpg::TurnBasedMultiplayerManager

#include <turn_based_multiplayer_manager.h>

Tìm nạp, sửa đổi và tạo đối tượng TurnBasedMatch.

Tóm tắt

Loại công khai
MatchInboxUICallback typedef
std::function< void(const MatchInboxUIResponse &)>
Xác định lệnh gọi lại có thể nhận MatchInboxUIResponse từ ShowMatchInboxUI.
MultiplayerStatusCallback typedef
std::function< void(MultiplayerStatus)>
Xác định lệnh gọi lại có thể dùng để nhận nhiều người chơi.
PlayerSelectUICallback typedef
std::function< void(const PlayerSelectUIResponse &)>
Xác định lệnh gọi lại có thể nhận PlayerSelectUIResponse từ ShowPlayerSelectUI.
TurnBasedMatchCallback typedef
std::function< void(const TurnBasedMatchResponse &)>
Xác định lệnh gọi lại có thể dùng để nhận TurnBasedMatchResponse từ một trong các hoạt động nhiều người chơi theo lượt.
TurnBasedMatchesCallback typedef
std::function< void(const TurnBasedMatchesResponse &)>
Xác định lệnh gọi lại có thể nhận TurnBasedMatchesResponse từ một trong các hoạt động nhiều người chơi theo lượt.

Thuộc tính tĩnh công khai
kAutomatchingParticipant
Một người tham gia có thể được truyền đến các phương thức lấy "người tham gia tiếp theo".

Hàm công khai
AcceptInvitation(const MultiplayerInvitation & invitation, TurnBasedMatchCallback callback)
void
Chấp nhận không đồng bộ MultiplayerInvitation và trả về kết quả qua TurnBasedMatchCallback.
AcceptInvitationBlocking(Timeout timeout, const MultiplayerInvitation & invitation)
Phiên bản chặn của AcceptInvitation.
AcceptInvitationBlocking(const MultiplayerInvitation & invitation)
Tùy chọn nạp chồng AcceptInvitationBlocking, sử dụng thời gian chờ mặc định là 10 năm.
CancelMatch(const TurnBasedMatch & match, MultiplayerStatusCallback callback)
void
Huỷ một so khớp không đồng bộ.
CancelMatchBlocking(Timeout timeout, const TurnBasedMatch & match)
Chặn phiên bản CancelMatch.
CancelMatchBlocking(const TurnBasedMatch & match)
Quá tải của CancelMatch sử dụng thời gian chờ mặc định là 10 năm.
ConfirmPendingCompletion(const TurnBasedMatch & match, TurnBasedMatchCallback callback)
void
Xác nhận kết quả của trận đấu đã kết thúc và đang chờ hoàn tất cục bộ.
ConfirmPendingCompletionBlocking(Timeout timeout, const TurnBasedMatch & match)
Chặn phiên bản của ConfirmPendingCompletion.
ConfirmPendingCompletionBlocking(const TurnBasedMatch & match)
Quá tải ConfirmPendingCompletionBlocking, sử dụng thời gian chờ mặc định là 10 năm.
CreateTurnBasedMatch(const gpg::TurnBasedMatchConfig & config, TurnBasedMatchCallback callback)
void
Tạo TurnBasedMatch một cách không đồng bộ bằng cách sử dụng TurnBasedMatchConfig được cung cấp.
CreateTurnBasedMatchBlocking(Timeout timeout, const gpg::TurnBasedMatchConfig & config)
Chặn phiên bản của CreateTurnBasedMatch.
CreateTurnBasedMatchBlocking(const gpg::TurnBasedMatchConfig & config)
Quá tải CreateTurnBasedMatchBlocking, sử dụng thời gian chờ mặc định là 10 năm.
DeclineInvitation(const MultiplayerInvitation & invitation)
void
DismissInvitation(const MultiplayerInvitation & invitation)
void
DismissMatch(const TurnBasedMatch & match)
void
FetchMatch(const std::string & match_id, TurnBasedMatchCallback callback)
void
Tìm nạp không đồng bộ một kết quả trùng khớp cụ thể theo mã nhận dạng.
FetchMatchBlocking(Timeout timeout, const std::string & match_id)
Chặn phiên bản FetchMatch.
FetchMatchBlocking(const std::string & match_id)
Quá tải FetchMatchBlocking, sử dụng thời gian chờ mặc định là 10 năm.
FetchMatches(TurnBasedMatchesCallback callback)
void
Tìm nạp không đồng bộ các đối tượng TurnBasedMatch và Invitation cho trình phát hiện tại.
FetchMatchesBlocking(Timeout timeout)
Chặn phiên bản FetchMatches.
FetchMatchesBlocking()
Quá tải FetchMatchesBlocking, sử dụng thời gian chờ mặc định là 10 năm.
FinishMatchDuringMyTurn(const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, TurnBasedMatchCallback callback)
void
Kết thúc không đồng bộ kết quả trùng khớp đã chỉ định.
FinishMatchDuringMyTurnBlocking(Timeout timeout, const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results)
Chặn phiên bản FinishMatchDuringMyTurn.
FinishMatchDuringMyTurnBlocking(const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results)
Quá tải của FinishMatchDuringMyTurnBlocking, sử dụng thời gian chờ mặc định là 10 năm.
LeaveMatchDuringMyTurn(const TurnBasedMatch & match, const MultiplayerParticipant & next_participant, MultiplayerStatusCallback callback)
void
Rời khỏi trận đấu một cách không đồng bộ trong lượt của người tham gia cục bộ.
LeaveMatchDuringMyTurnBlocking(Timeout timeout, const TurnBasedMatch & match, const MultiplayerParticipant & next_participant)
Chặn phiên bản LeaveMatchDuringMyTurn.
LeaveMatchDuringMyTurnBlocking(const TurnBasedMatch & match, const MultiplayerParticipant & next_participant)
Quá tải LeaveMatchDuringMyTurnBlocking sử dụng thời gian chờ mặc định là 10 năm.
LeaveMatchDuringTheirTurn(const TurnBasedMatch & match, MultiplayerStatusCallback callback)
void
Rời khỏi trận đấu một cách không đồng bộ trong lượt của người tham gia khác.
LeaveMatchDuringTheirTurnBlocking(Timeout timeout, const TurnBasedMatch & match)
Chặn phiên bản của LeaveMatchDuringTheirTurn.
LeaveMatchDuringTheirTurnBlocking(const TurnBasedMatch & match)
Phương thức quá tải LeaveMatchDuringTheirTurnBlocking của phương thức này, sử dụng thời gian chờ mặc định là 10 năm.
Rematch(const TurnBasedMatch & match, TurnBasedMatchCallback callback)
void
So khớp lại một video trùng khớp có trạng thái là MatchStatus::COMPLETED.
RematchBlocking(Timeout timeout, const TurnBasedMatch & match)
Phiên bản chặn của Rematch.
RematchBlocking(const TurnBasedMatch & match)
Quá tải của RematchBlocking, sử dụng thời gian chờ mặc định là 10 năm.
ShowMatchInboxUI(MatchInboxUICallback callback)
void
Hiển thị không đồng bộ giao diện người dùng của hộp thư đến của trận đấu, cho phép người chơi chọn trận đấu hoặc lời mời.
ShowMatchInboxUIBlocking(Timeout timeout)
Phiên bản chặn của ShowMatchInboxUI.
ShowMatchInboxUIBlocking()
Phương thức nạp chồng của ShowMatchInboxUIBlocking, sử dụng thời gian chờ mặc định là 10 năm.
ShowPlayerSelectUI(uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch, PlayerSelectUICallback callback)
void
Hiển thị không đồng bộ giao diện người dùng chọn của người chơi, cho phép người chơi chọn những người chơi khác để chơi cùng.
ShowPlayerSelectUIBlocking(Timeout timeout, uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch)
Phiên bản chặn của ShowPlayerSelectUI.
ShowPlayerSelectUIBlocking(uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch)
Quá tải của ShowPlayerSelectUIBlocking, sử dụng thời gian chờ mặc định là 10 năm.
SynchronizeData()
void
Buộc đồng bộ hoá dữ liệu so khớp TBMP với máy chủ.
TakeMyTurn(const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, const MultiplayerParticipant & next_participant, TurnBasedMatchCallback callback)
void
Không đồng bộ nhận lượt của người tham gia trên máy.
TakeMyTurnBlocking(Timeout timeout, const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, const MultiplayerParticipant & next_participant)
Chặn phiên bản của TakeMyTurn.
TakeMyTurnBlocking(const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, const MultiplayerParticipant & next_participant)
Quá tải TakeMyTurnBlocking, sử dụng thời gian chờ mặc định là 10 năm.

Cấu trúc
gpg::TurnBasedMultiplayerManager::MatchInboxUIResponse

Data và ResponseStatus cho toán tử ShowMatchInboxUI.

gpg::TurnBasedMultiplayerManager::PlayerSelectUIResponse

Data và ResponseStatus cho toán tử ShowPlayerSelectUI.

gpg::TurnBasedMultiplayerManager::TurnBasedMatchResponse

Data và ResponseStatus cho một TurnBasedMatch cụ thể.

gpg::TurnBasedMultiplayerManager::TurnBasedMatchesResponse

Data và ResponseStatus cho TurnBasedMatches và lời mời.

Loại công khai

MatchInboxUICallback

std::function< void(const MatchInboxUIResponse &)> MatchInboxUICallback

Xác định lệnh gọi lại có thể nhận MatchInboxUIResponse từ ShowMatchInboxUI.

MultiplayerStatusCallback

std::function< void(MultiplayerStatus)> MultiplayerStatusCallback

Xác định lệnh gọi lại có thể dùng để nhận nhiều người chơi.

Được sử dụng trong các hàmLeaveMatch và CancelMatch.

PlayerSelectUICallback

std::function< void(const PlayerSelectUIResponse &)> PlayerSelectUICallback

Xác định lệnh gọi lại có thể nhận PlayerSelectUIResponse từ ShowPlayerSelectUI.

TurnBasedMatchCallback

std::function< void(const TurnBasedMatchResponse &)> TurnBasedMatchCallback

Xác định lệnh gọi lại có thể dùng để nhận TurnBasedMatchResponse từ một trong các hoạt động nhiều người chơi theo lượt.

TurnBasedMatchesCallback

std::function< void(const TurnBasedMatchesResponse &)> TurnBasedMatchesCallback

Xác định lệnh gọi lại có thể nhận TurnBasedMatchesResponse từ một trong các hoạt động nhiều người chơi theo lượt.

Thuộc tính tĩnh công khai

kAutomatchingParticipant

const MultiplayerParticipant kAutomatchingParticipant

Một người tham gia có thể được truyền đến các phương thức lấy "người tham gia tiếp theo".

Thao tác này giúp phương thức chọn người tham gia tiếp theo thông qua tính năng tự động so khớp. Chỉ hợp lệ để chuyển kAutomatching TCF vào một hàm nếu TurnBasedMatch::AutomatchingSlotsAvailable có giá trị lớn hơn 0 cho kết quả trùng khớp có liên quan.

Hàm công khai

AcceptInvitation

void AcceptInvitation(
  const MultiplayerInvitation & invitation,
  TurnBasedMatchCallback callback
)

Chấp nhận không đồng bộ MultiplayerInvitation và trả về kết quả qua TurnBasedMatchCallback.

Nếu thao tác thành công thì TurnBasedMatch được trả về qua lệnh gọi lại sẽ ở trạng thái TurnBasedMatchState::MY_TURN.

AcceptInvitationBlocking

TurnBasedMatchResponse AcceptInvitationBlocking(
  Timeout timeout,
  const MultiplayerInvitation & invitation
)

Phiên bản chặn của AcceptInvitation.

Cho phép phương thức gọi chỉ định thời gian chờ tính bằng mili giây. Sau khi thời gian được chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

AcceptInvitationBlocking

TurnBasedMatchResponse AcceptInvitationBlocking(
  const MultiplayerInvitation & invitation
)

Tùy chọn nạp chồng AcceptInvitationBlocking, sử dụng thời gian chờ mặc định là 10 năm.

CancelMatch

void CancelMatch(
  const TurnBasedMatch & match,
  MultiplayerStatusCallback callback
)

Huỷ một so khớp không đồng bộ.

Trạng thái được trả về qua MultiplayerStatusCallback cho biết liệu thao tác có thành công hay không. Trạng thái so khớp phải là MỜI, THEIR_TURN hoặc MY_TURN để hàm này có thể sử dụng được.

CancelMatchBlocking

MultiplayerStatus CancelMatchBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

Chặn phiên bản CancelMatch.

Cho phép phương thức gọi chỉ định thời gian chờ tính bằng mili giây. Sau khi thời gian được chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

CancelMatchBlocking

MultiplayerStatus CancelMatchBlocking(
  const TurnBasedMatch & match
)

Quá tải của CancelMatch sử dụng thời gian chờ mặc định là 10 năm.

ConfirmPendingCompletion

void ConfirmPendingCompletion(
  const TurnBasedMatch & match,
  TurnBasedMatchCallback callback
)

Xác nhận kết quả của trận đấu đã kết thúc và đang chờ hoàn tất cục bộ.

Chỉ có thể gọi hàm này khi TurnBasedMatch::Status() trả về MatchStatus::PENDING_COMPLETION.

Thông tin chi tiết
Các tham số
match
Trận đấu mà cần xác nhận hoàn tất.
callback
Lệnh gọi lại nhận được TurnBasedMatchResponse.

ConfirmPendingCompletionBlocking

TurnBasedMatchResponse ConfirmPendingCompletionBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

Chặn phiên bản của ConfirmPendingCompletion.

Cho phép phương thức gọi chỉ định thời gian chờ tính bằng mili giây. Sau khi thời gian được chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

ConfirmPendingCompletionBlocking

TurnBasedMatchResponse ConfirmPendingCompletionBlocking(
  const TurnBasedMatch & match
)

Quá tải ConfirmPendingCompletionBlocking, sử dụng thời gian chờ mặc định là 10 năm.

CreateTurnBasedMatch

void CreateTurnBasedMatch(
  const gpg::TurnBasedMatchConfig & config,
  TurnBasedMatchCallback callback
)

Tạo TurnBasedMatch một cách không đồng bộ bằng cách sử dụng TurnBasedMatchConfig được cung cấp.

Nếu tạo thành công, hàm này sẽ trả về TurnBasedMatch thông qua TurnBasedMatchCallback được cung cấp. TurnBasedMatch mới được tạo luôn bắt đầu ở trạng thái TurnBasedMatchState::MY_TURN.

CreateTurnBasedMatchBlocking

TurnBasedMatchResponse CreateTurnBasedMatchBlocking(
  Timeout timeout,
  const gpg::TurnBasedMatchConfig & config
)

Chặn phiên bản của CreateTurnBasedMatch.

Cho phép phương thức gọi chỉ định thời gian chờ tính bằng mili giây. Sau khi thời gian được chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

CreateTurnBasedMatchBlocking

TurnBasedMatchResponse CreateTurnBasedMatchBlocking(
  const gpg::TurnBasedMatchConfig & config
)

Quá tải CreateTurnBasedMatchBlocking, sử dụng thời gian chờ mặc định là 10 năm.

DeclineInvitation

void DeclineInvitation(
  const MultiplayerInvitation & invitation
)

Từ chối MultiplayerInvitation đến TurnBasedMatch.

Thao tác này sẽ hủy trận đấu của những người tham gia khác và xóa trận đấu khỏi thiết bị của người chơi trên máy.

DismissInvitation

void DismissInvitation(
  const MultiplayerInvitation & invitation
)

Đóng MultiplayerInvitation cho TurnBasedMatch.

Việc này không thay đổi trạng thái hiển thị của TurnBasedMatch đối với những người tham gia khác, nhưng sẽ xoá TurnBasedMatch khỏi thiết bị của người chơi trên máy.

DismissMatch

void DismissMatch(
  const TurnBasedMatch & match
)

Đóng TurnBasedMatch.

Việc này không thay đổi trạng thái hiển thị của TurnBasedMatch đối với những người tham gia khác, nhưng sẽ xoá TurnBasedMatch khỏi thiết bị của người chơi trên máy.

FetchMatch

void FetchMatch(
  const std::string & match_id,
  TurnBasedMatchCallback callback
)

Tìm nạp không đồng bộ một kết quả trùng khớp cụ thể theo mã nhận dạng.

Kết quả của thao tác này được trả về qua TurnBasedMatchCallback.

FetchMatchBlocking

TurnBasedMatchResponse FetchMatchBlocking(
  Timeout timeout,
  const std::string & match_id
)

Chặn phiên bản FetchMatch.

Cho phép phương thức gọi chỉ định thời gian chờ tính bằng mili giây. Sau khi thời gian được chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

FetchMatchBlocking

TurnBasedMatchResponse FetchMatchBlocking(
  const std::string & match_id
)

Quá tải FetchMatchBlocking, sử dụng thời gian chờ mặc định là 10 năm.

FetchMatches

void FetchMatches(
  TurnBasedMatchesCallback callback
)

Tìm nạp không đồng bộ các đối tượng TurnBasedMatch và Invitation cho trình phát hiện tại.

Tất cả kết quả trùng khớp đang hoạt động và tối đa 10 kết quả trùng khớp đã hoàn tất sẽ được trả về.

FetchMatchesBlocking

TurnBasedMatchesResponse FetchMatchesBlocking(
  Timeout timeout
)

Chặn phiên bản FetchMatches.

Cho phép phương thức gọi chỉ định thời gian chờ tính bằng mili giây. Sau khi thời gian được chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

FetchMatchesBlocking

TurnBasedMatchesResponse FetchMatchesBlocking()

Quá tải FetchMatchesBlocking, sử dụng thời gian chờ mặc định là 10 năm.

FinishMatchDuringMyTurn

void FinishMatchDuringMyTurn(
  const TurnBasedMatch & match,
  std::vector< uint8_t > match_data,
  const ParticipantResults & results,
  TurnBasedMatchCallback callback
)

Kết thúc không đồng bộ kết quả trùng khớp đã chỉ định.

Bạn có thể sử dụng tính năng này thay vì TakeMyTurn trong lượt cuối cùng của trận đấu. Cho phép phương thức gọi chỉ định giá trị cuối cùng cho match_data, cũng như tập hợp các giá trị cuối cùng cho ParticipantResults. Sau khi hoàn tất thao tác này, kết quả khớp đã cập nhật sẽ được trả về thông qua TurnBasedMatchCallback. đã cung cấp. Hàm này chỉ có thể được gọi khi TurnBasedMatch::Status() trả về MatchStatus::MY_TURN.

Thông tin chi tiết
Các tham số
match
Trận đấu kết thúc.
match_data
Một luồng dữ liệu đại diện cho trạng thái cuối cùng của video trùng khớp.
results
Kết quả bất kỳ cho mỗi người chơi trong trận đấu. Lưu ý rằng các kết quả này không được mâu thuẫn với bất kỳ kết quả nào được chỉ định trước đó qua TakeTurn. Việc cố gắng thiết lập các kết quả khác nhau cho một trình phát sẽ dẫn đến ERROR_INVALID_RESULTS.
callback
Lệnh gọi lại nhận được TurnBasedMatchResponse.

FinishMatchDuringMyTurnBlocking

TurnBasedMatchResponse FinishMatchDuringMyTurnBlocking(
  Timeout timeout,
  const TurnBasedMatch & match,
  std::vector< uint8_t > match_data,
  const ParticipantResults & results
)

Chặn phiên bản FinishMatchDuringMyTurn.

Cho phép phương thức gọi chỉ định thời gian chờ tính bằng mili giây. Sau khi thời gian được chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

FinishMatchDuringMyTurnBlocking

TurnBasedMatchResponse FinishMatchDuringMyTurnBlocking(
  const TurnBasedMatch & match,
  std::vector< uint8_t > match_data,
  const ParticipantResults & results
)

Quá tải của FinishMatchDuringMyTurnBlocking, sử dụng thời gian chờ mặc định là 10 năm.

LeaveMatchDuringMyTurn

void LeaveMatchDuringMyTurn(
  const TurnBasedMatch & match,
  const MultiplayerParticipant & next_participant,
  MultiplayerStatusCallback callback
)

Rời khỏi trận đấu một cách không đồng bộ trong lượt của người tham gia cục bộ.

Phản hồi được trả về qua TurnBasedMatchCallback chứa trạng thái của trận đấu sau khi người chơi cục bộ đã rời đi. Nếu lượt khởi hành này rời khỏi trận đấu có ít hơn 2 người tham gia, trận đấu sẽ bị huỷ. match.Status() phải trả về MatchStatus::MY_TURN thì mới dùng được hàm này.

Thông tin chi tiết
Các tham số
match
Trận đấu khởi hành.
next_participant
Người tham gia có lượt chơi tiếp theo. Bạn có thể sử dụng TurnBasednhiều người quản lý::kTự động phù hợp để chỉ định rằng người tham gia tiếp theo sẽ được chọn thông qua tính năng tự động khớp.
callback
Lệnh gọi lại nhận được TurnBasedMatchResponse

LeaveMatchDuringMyTurnBlocking

MultiplayerStatus LeaveMatchDuringMyTurnBlocking(
  Timeout timeout,
  const TurnBasedMatch & match,
  const MultiplayerParticipant & next_participant
)

Chặn phiên bản LeaveMatchDuringMyTurn.

Cho phép phương thức gọi chỉ định thời gian chờ tính bằng mili giây. Sau khi thời gian được chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

LeaveMatchDuringMyTurnBlocking

MultiplayerStatus LeaveMatchDuringMyTurnBlocking(
  const TurnBasedMatch & match,
  const MultiplayerParticipant & next_participant
)

Quá tải LeaveMatchDuringMyTurnBlocking sử dụng thời gian chờ mặc định là 10 năm.

LeaveMatchDuringTheirTurn

void LeaveMatchDuringTheirTurn(
  const TurnBasedMatch & match,
  MultiplayerStatusCallback callback
)

Rời khỏi trận đấu một cách không đồng bộ trong lượt của người tham gia khác.

Phản hồi được trả về qua MultiplayerStatusCallback cho biết người tham gia cục bộ có rời khỏi trận đấu thành công hay không. Nếu lượt khởi hành này rời khỏi trận đấu có ít hơn 2 người tham gia, trận đấu sẽ bị huỷ. match.Status() phải trả về MatchStatus::THEIR_TURN thì mới dùng được hàm này.

LeaveMatchDuringTheirTurnBlocking

MultiplayerStatus LeaveMatchDuringTheirTurnBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

Chặn phiên bản của LeaveMatchDuringTheirTurn.

Cho phép phương thức gọi chỉ định thời gian chờ tính bằng mili giây. Sau khi thời gian được chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

LeaveMatchDuringTheirTurnBlocking

MultiplayerStatus LeaveMatchDuringTheirTurnBlocking(
  const TurnBasedMatch & match
)

Phương thức quá tải LeaveMatchDuringTheirTurnBlocking của phương thức này, sử dụng thời gian chờ mặc định là 10 năm.

Tái đấu

void Rematch(
  const TurnBasedMatch & match,
  TurnBasedMatchCallback callback
)

So khớp lại một video trùng khớp có trạng thái là MatchStatus::COMPLETED.

Nếu có thể đấu lại, TurnBasedMatchCallback sẽ nhận được kết quả trùng khớp mới.

Thông tin chi tiết
Các tham số
match
Trận đấu để tái đấu.
callback
Lệnh gọi lại nhận được TurnBasedMatchResponse.

RematchBlocking

TurnBasedMatchResponse RematchBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

Phiên bản chặn của Rematch.

Cho phép phương thức gọi chỉ định thời gian chờ tính bằng mili giây. Sau khi thời gian được chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

RematchBlocking

TurnBasedMatchResponse RematchBlocking(
  const TurnBasedMatch & match
)

Quá tải của RematchBlocking, sử dụng thời gian chờ mặc định là 10 năm.

ShowMatchInboxUI

void ShowMatchInboxUI(
  MatchInboxUICallback callback
)

Hiển thị không đồng bộ giao diện người dùng của hộp thư đến của trận đấu, cho phép người chơi chọn trận đấu hoặc lời mời.

Sau khi hoàn tất, kết quả trùng khớp hoặc lời mời đã chọn sẽ được trả về qua MatchInboxUICallback.

ShowMatchInboxUIBlocking

MatchInboxUIResponse ShowMatchInboxUIBlocking(
  Timeout timeout
)

Phiên bản chặn của ShowMatchInboxUI.

Cho phép phương thức gọi chỉ định thời gian chờ tính bằng mili giây. Sau khi thời gian được chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

ShowMatchInboxUIBlocking

MatchInboxUIResponse ShowMatchInboxUIBlocking()

Phương thức nạp chồng của ShowMatchInboxUIBlocking, sử dụng thời gian chờ mặc định là 10 năm.

ShowPlayerSelectUI

void ShowPlayerSelectUI(
  uint32_t minimum_players,
  uint32_t maximum_players,
  bool allow_automatch,
  PlayerSelectUICallback callback
)

Hiển thị không đồng bộ giao diện người dùng chọn của người chơi, cho phép người chơi chọn những người chơi khác để chơi cùng.

Sau khi hoàn tất, người chơi đã chọn sẽ được trả về qua PlayerSelectUICallback.

ShowPlayerSelectUIBlocking

PlayerSelectUIResponse ShowPlayerSelectUIBlocking(
  Timeout timeout,
  uint32_t minimum_players,
  uint32_t maximum_players,
  bool allow_automatch
)

Phiên bản chặn của ShowPlayerSelectUI.

Cho phép phương thức gọi chỉ định thời gian chờ tính bằng mili giây. Sau khi thời gian được chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

ShowPlayerSelectUIBlocking

PlayerSelectUIResponse ShowPlayerSelectUIBlocking(
  uint32_t minimum_players,
  uint32_t maximum_players,
  bool allow_automatch
)

Quá tải của ShowPlayerSelectUIBlocking, sử dụng thời gian chờ mặc định là 10 năm.

SynchronizeData

void SynchronizeData()

Buộc đồng bộ hoá dữ liệu so khớp TBMP với máy chủ.

Việc nhận dữ liệu mới sẽ kích hoạt OnTurnBasedMatchEventCallback hoặc OnMultiplayerInvitationReceivedCallback.

TakeMyTurn

void TakeMyTurn(
  const TurnBasedMatch & match,
  std::vector< uint8_t > match_data,
  const ParticipantResults & results,
  const MultiplayerParticipant & next_participant,
  TurnBasedMatchCallback callback
)

Không đồng bộ nhận lượt của người tham gia trên máy.

Khi đến lượt, người tham gia có thể chỉ định một giá trị mới cho match_data cũng như một nhóm ParticipantResults. Khi lượt chơi kết thúc, kết quả trùng khớp đã cập nhật sẽ được trả về qua TurnBasedMatchCallback. Hàm này chỉ có thể được gọi khi TurnBasedMatch::Status() là MatchStatus::MY_TURN.

Thông tin chi tiết
Các tham số
match
Trận đấu nơi lượt diễn ra.
match_data
Một luồng dữ liệu sẽ gửi cho người tham gia tiếp theo.
results
Mọi kết quả đã biết cho trận đấu ở thời điểm hiện tại. Lưu ý rằng bạn chỉ có thể chỉ định kết quả cho một người chơi nhất định một lần. Việc cố gắng thiết lập các kết quả khác nhau cho một trình phát sẽ dẫn đến ERROR_INVALID_RESULTS.
next_participant
Người tham gia có lượt chơi tiếp theo. Bạn có thể sử dụng TurnBasednhiều người quản lý::kTự động phù hợp để chỉ định rằng người tham gia tiếp theo sẽ được chọn thông qua tính năng tự động khớp.
callback
Lệnh gọi lại nhận được TurnBasedMatchResponse.

TakeMyTurnBlocking

TurnBasedMatchResponse TakeMyTurnBlocking(
  Timeout timeout,
  const TurnBasedMatch & match,
  std::vector< uint8_t > match_data,
  const ParticipantResults & results,
  const MultiplayerParticipant & next_participant
)

Chặn phiên bản của TakeMyTurn.

Cho phép phương thức gọi chỉ định thời gian chờ tính bằng mili giây. Sau khi thời gian được chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

TakeMyTurnBlocking

TurnBasedMatchResponse TakeMyTurnBlocking(
  const TurnBasedMatch & match,
  std::vector< uint8_t > match_data,
  const ParticipantResults & results,
  const MultiplayerParticipant & next_participant
)

Quá tải TakeMyTurnBlocking, sử dụng thời gian chờ mặc định là 10 năm.