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 một lệnh gọi lại có thể dùng để nhận MultiplayerStatus.
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
Người tham gia có thể được chuyển đến các phương thức lấy "tiếp theo tham gia".

Hàm công khai
AcceptInvitation(const MultiplayerInvitation & invitation, TurnBasedMatchCallback callback)
void
Chấp nhận MultiplayerInvitation một cách không đồng bộ và trả về kết quả qua TurnBasedMatchCallback.
AcceptInvitationBlocking(Timeout timeout, const MultiplayerInvitation & invitation)
Chặn phiên bản của AcceptInvitation.
AcceptInvitationBlocking(const MultiplayerInvitation & invitation)
Tình trạng quá tải của 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 cách không đồng bộ việc so khớp.
CancelMatchBlocking(Timeout timeout, const TurnBasedMatch & match)
Chặn phiên bản của CancelMatch.
CancelMatchBlocking(const TurnBasedMatch & match)
Tình trạng 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 một trận đấu đã kết thúc và đang chờ kết quả cục bộ.
ConfirmPendingCompletionBlocking(Timeout timeout, const TurnBasedMatch & match)
Chặn phiên bản của ConfirmPendingCompletion.
ConfirmPendingCompletionBlocking(const TurnBasedMatch & match)
Hàm 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 không đồng bộ bằng cách sử dụng TurnBasedMatchConfig đã cung cấp.
CreateTurnBasedMatchBlocking(Timeout timeout, const gpg::TurnBasedMatchConfig & config)
Phiên bản chặn của CreateTurnBasedMatch.
CreateTurnBasedMatchBlocking(const gpg::TurnBasedMatchConfig & config)
Quá tải của CreateTurnBasedMatchBlocking, sử dụng thời gian chờ mặc định là 10 năm.
DeclineInvitation(const MultiplayerInvitation & invitation)
void
Từ chối một MultiplayerInvitation với một TurnBasedMatch.
DismissInvitation(const MultiplayerInvitation & invitation)
void
DismissMatch(const TurnBasedMatch & match)
void
FetchMatch(const std::string & match_id, TurnBasedMatchCallback callback)
void
Tìm nạp một cách 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 của FetchMatch.
FetchMatchBlocking(const std::string & match_id)
Tình trạng quá tải của 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 của FetchMatches.
FetchMatchesBlocking()
Tình trạng 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ả phù hợp được 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)
Tình trạng 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
Không đồng bộ rời khỏi kết quả trùng khớp trong thời gian đến lượt của người tham gia cục bộ.
LeaveMatchDuringMyTurnBlocking(Timeout timeout, const TurnBasedMatch & match, const MultiplayerParticipant & next_participant)
Đang chặn phiên bản của LeaveMatchDuringMyTurn.
LeaveMatchDuringMyTurnBlocking(const TurnBasedMatch & match, const MultiplayerParticipant & next_participant)
Tình trạng quá tải của LeaveMatchDuringMyTurnBlocking, sử dụng thời gian chờ mặc định là 10 năm.
LeaveMatchDuringTheirTurn(const TurnBasedMatch & match, MultiplayerStatusCallback callback)
void
Không đồng bộ rời khỏi trận đấu trong khi đến 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)
Tình trạng quá tải của LeaveMatchDuringTheirTurnBlocking, 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 kết quả trùng khớp có trạng thái là MatchStatus::COMPLETED.
RematchBlocking(Timeout timeout, const TurnBasedMatch & match)
Chặn phiên bản của Trùng khớp.
RematchBlocking(const TurnBasedMatch & match)
Tình trạng 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 so khớp trong hộp thư đến, cho phép người chơi chọn một trận đấu hoặc lời mời.
ShowMatchInboxUIBlocking(Timeout timeout)
Chặn phiên bản ShowMatchInboxUI.
ShowMatchInboxUIBlocking()
Tình trạng quá tải 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 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)
Chặn phiên bản của ShowPlayerSelectUI.
ShowPlayerSelectUIBlocking(uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch)
Tình trạng quá tải 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
Một cách không đồng bộ đến lượt của người tham gia cục bộ.
TakeMyTurnBlocking(Timeout timeout, const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, const MultiplayerParticipant & next_participant)
Đang 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 thao tác ShowMatchInboxUI.

gpg::TurnBasedMultiplayerManager::PlayerSelectUIResponse

Data và ResponseStatus cho thao tác 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 một lệnh gọi lại có thể dùng để nhận MultiplayerStatus.

Được các hàm KeepMatch và CancelMatch sử dụng.

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

Người tham gia có thể được chuyển đến các phương thức lấy "tiếp theo tham gia".

Điều này khiến 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. Bạn chỉ có thể chuyển kAutomatching tỉ thành một hàm nếu TurnBasedMatch::AutomatchingSlotsAvailable 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 MultiplayerInvitation một cách không đồng bộ và trả về kết quả qua TurnBasedMatchCallback.

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

AcceptInvitationBlocking

TurnBasedMatchResponse AcceptInvitationBlocking(
  Timeout timeout,
  const MultiplayerInvitation & invitation
)

Chặn phiên bả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 đã chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

AcceptInvitationBlocking

TurnBasedMatchResponse AcceptInvitationBlocking(
  const MultiplayerInvitation & invitation
)

Tình trạng quá tải của 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 cách không đồng bộ việc so khớp.

Trạng thái được trả về qua MultiplayerStatusCallback cho biết thao tác có thành công hay không. Trạng thái so khớp phải là MẠNG, THEIR_TURN hoặc MY_TURN để chức năng này có thể sử dụng được.

CancelMatchBlocking

MultiplayerStatus CancelMatchBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

Chặn phiên bản của 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 đã chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

CancelMatchBlocking

MultiplayerStatus CancelMatchBlocking(
  const TurnBasedMatch & match
)

Tình trạng 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 một trận đấu đã kết thúc và đang chờ kết quả cục bộ.

Hàm này chỉ có thể được gọi khi TurnBasedMatch::Status() trả về MatchStatus::PENDING_COMPLETION.

Thông tin chi tiết
Tham số
match
Kết quả trùng khớp cần xác nhận trạng thái hoàn thành.
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 đã chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

ConfirmPendingCompletionBlocking

TurnBasedMatchResponse ConfirmPendingCompletionBlocking(
  const TurnBasedMatch & match
)

Hàm 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 không đồng bộ bằng cách sử dụng TurnBasedMatchConfig đã 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 tạo luôn bắt đầu ở trạng thái TurnBasedMatchState::MY_TURN.

CreateTurnBasedMatchBlocking

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

Phiên bản chặ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 đã chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

CreateTurnBasedMatchBlocking

TurnBasedMatchResponse CreateTurnBasedMatchBlocking(
  const gpg::TurnBasedMatchConfig & config
)

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

DeclineInvitation

void DeclineInvitation(
  const MultiplayerInvitation & invitation
)

Từ chối một MultiplayerInvitation với một TurnBasedMatch.

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

DismissInvitation

void DismissInvitation(
  const MultiplayerInvitation & invitation
)

Đóng MultiplayerInvitation khỏi TurnBasedMatch.

Thao tác này không làm 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 thiết bị.

DismissMatch

void DismissMatch(
  const TurnBasedMatch & match
)

Đóng TurnBasedMatch.

Thao tác này không làm 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 thiết bị.

FetchMatch

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

Tìm nạp một cách 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 của 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 đã chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

FetchMatchBlocking

TurnBasedMatchResponse FetchMatchBlocking(
  const std::string & match_id
)

Tình trạng quá tải của 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.

Hệ thống sẽ trả về tất cả các kết quả trùng khớp đang diễn ra và tối đa 10 kết quả trùng khớp đã hoàn tất.

FetchMatchesBlocking

TurnBasedMatchesResponse FetchMatchesBlocking(
  Timeout timeout
)

Chặn phiên bản của 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 đã chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

FetchMatchesBlocking

TurnBasedMatchesResponse FetchMatchesBlocking()

Tình trạng 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ả phù hợp được chỉ định.

Bạn có thể dùng cử chỉ 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ả trùng khớp đã cập nhật sẽ được trả về qua TurnBasedMatchCallback. được 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
Tham số
match
Trận đấu sắp kết thúc.
match_data
Một blob dữ liệu cho biết trạng thái cuối cùng của kết quả trùng khớp.
results
Mọi kết quả của từng cầu thủ trong trận đấu. Lưu ý rằng những 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 đó thông qua TakeTurn. Việc cố gắng đặt các kết quả khác cho một trình phát sẽ dẫn đến ERROR_INVALID_RESULTS.
callback
Lệnh gọi lại nhận 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 đã 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
)

Tình trạng 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
)

Không đồng bộ rời khỏi kết quả trùng khớp trong thời gian đến lượt của người tham gia cục bộ.

Phản hồi được trả về thông 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 khiến trận đấu có ít hơn 2 người tham gia, thì trận đấu sẽ bị huỷ. match.Status() phải trả về MatchStatus::MY_TURN thì hàm này mới có thể sử dụng được.

Thông tin chi tiết
Tham số
match
Trận đấu sẽ bị loại.
next_participant
Người tham gia có lượt tiếp theo. Bạn có thể dùng TurnBasedMultiplayerManager::kAutomatchingParticipant để chỉ định rằng hệ thống sẽ chọn người tham gia tiếp theo thông qua tính năng tự động so khớp.
callback
Lệnh gọi lại nhận TurnBasedMatchResponse

LeaveMatchDuringMyTurnBlocking

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

Đang chặn phiên bản của 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 đã chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

LeaveMatchDuringMyTurnBlocking

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

Tình trạng quá tải của LeaveMatchDuringMyTurnBlocking, sử dụng thời gian chờ mặc định là 10 năm.

LeaveMatchDuringTheirTurn

void LeaveMatchDuringTheirTurn(
  const TurnBasedMatch & match,
  MultiplayerStatusCallback callback
)

Không đồng bộ rời khỏi trận đấu trong khi đến 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 kết quả trùng khớp thành công hay không. Nếu lượt khởi hành này khiến trận đấu có ít hơn 2 người tham gia, thì trận đấu sẽ bị huỷ. match.Status() phải trả về MatchStatus::THEIR_TURN thì hàm này mới có thể sử dụng được.

LeaveMatchDuringTheirTurnBlocking

MultiplayerStatus LeaveMatchDuringTheirTurnBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

Đang 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 đã chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

LeaveMatchDuringTheirTurnBlocking

MultiplayerStatus LeaveMatchDuringTheirTurnBlocking(
  const TurnBasedMatch & match
)

Tình trạng quá tải của LeaveMatchDuringTheirTurnBlocking, 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 kết quả trùng khớp có trạng thái là MatchStatus::COMPLETED.

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

Thông tin chi tiết
Tham số
match
Trận đấu cần ghép lại.
callback
Lệnh gọi lại nhận được TurnBasedMatchResponse.

RematchBlocking

TurnBasedMatchResponse RematchBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

Chặn phiên bả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 đã chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

RematchBlocking

TurnBasedMatchResponse RematchBlocking(
  const TurnBasedMatch & match
)

Tình trạng 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 so khớp trong hộp thư đến, cho phép người chơi chọn một 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
)

Chặn phiên bản 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 đã chỉ định trôi qua, hàm sẽ trả về ERROR_TIMEOUT.

ShowMatchInboxUIBlocking

MatchInboxUIResponse ShowMatchInboxUIBlocking()

Tình trạng quá tải 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 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 thành, những 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
)

Chặn phiên bả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 đã 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
)

Tình trạng quá tải 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
)

Một cách không đồng bộ đến lượt của người tham gia cục bộ.

Khi đến một 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 kết thúc, kết quả trùng khớp mới đượ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
Tham số
match
Trận đấu diễn ra lượt.
match_data
Một blob dữ liệu để gửi cho người tham gia tiếp theo.
results
Mọi kết quả đã biết cho kết quả trùng khớp tại thời điểm hiện tại. Lưu ý rằng kết quả cho một người chơi nhất định chỉ có thể được chỉ định một lần. Việc cố gắng đặt các kết quả khác cho một trình phát sẽ dẫn đến ERROR_INVALID_RESULTS.
next_participant
Người tham gia có lượt tiếp theo. Bạn có thể dùng TurnBasedMultiplayerManager::kAutomatchingParticipant để chỉ định rằng hệ thống sẽ chọn người tham gia tiếp theo thông qua tính năng tự động so khớp.
callback
Lệnh gọi lại nhận TurnBasedMatchResponse.

TakeMyTurnBlocking

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

Đang 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 đã 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.