gpg::TurnBasedMultiplayerManager

#include <turn_based_multiplayer_manager.h>

Mengambil, mengubah, dan membuat objek TurnBasedMatch.

Ringkasan

Jenis publik

MatchInboxUICallback typedef
std::function< void(const MatchInboxUIResponse &)>
Menentukan callback yang dapat menerima MatchInboxUIResponse dari ShowMatchInboxUI.
MultiplayerStatusCallback typedef
std::function< void(MultiplayerStatus)>
Menentukan callback yang dapat digunakan untuk menerima MultiplayerStatus.
PlayerSelectUICallback typedef
std::function< void(const PlayerSelectUIResponse &)>
Menentukan callback yang dapat menerima PlayerSelectUIResponse dari ShowPlayerSelectUI.
TurnBasedMatchCallback typedef
std::function< void(const TurnBasedMatchResponse &)>
Menentukan callback yang dapat digunakan untuk menerima TurnBasedMatchResponse dari salah satu operasi multiplayer berbasis giliran.
TurnBasedMatchesCallback typedef
std::function< void(const TurnBasedMatchesResponse &)>
Menentukan callback yang dapat menerima TurnBasedMatchesResponse dari salah satu operasi multiplayer berbasis giliran.

Atribut statis publik

kAutomatchingParticipant
Peserta yang dapat diteruskan ke metode yang mengambil "peserta berikutnya".

Fungsi publik

AcceptInvitation(const MultiplayerInvitation & invitation, TurnBasedMatchCallback callback)
void
Menerima MultiplayerInvitation secara asinkron, dan menampilkan hasilnya melalui TurnBasedMatchCallback.
AcceptInvitationBlocking(Timeout timeout, const MultiplayerInvitation & invitation)
Memblokir versi AcceptInvitation.
AcceptInvitationBlocking(const MultiplayerInvitation & invitation)
Kelebihan AcceptInvitationBlocking, yang menggunakan waktu tunggu default 10 tahun.
CancelMatch(const TurnBasedMatch & match, MultiplayerStatusCallback callback)
void
Membatalkan pencocokan secara asinkron.
CancelMatchBlocking(Timeout timeout, const TurnBasedMatch & match)
Memblokir versi CancelMatch.
CancelMatchBlocking(const TurnBasedMatch & match)
Kelebihan CancelMatch yang menggunakan waktu tunggu default 10 tahun.
ConfirmPendingCompletion(const TurnBasedMatch & match, TurnBasedMatchCallback callback)
void
Mengonfirmasi hasil pertandingan yang telah berakhir dan menunggu penyelesaian lokal.
ConfirmPendingCompletionBlocking(Timeout timeout, const TurnBasedMatch & match)
Memblokir versi ConfirmPendingCompletion.
ConfirmPendingCompletionBlocking(const TurnBasedMatch & match)
Kelebihan ConfirmPendingCompletionBlocking, yang menggunakan waktu tunggu default selama 10 tahun.
CreateTurnBasedMatch(const gpg::TurnBasedMatchConfig & config, TurnBasedMatchCallback callback)
void
Membuat TurnBasedMatch secara asinkron menggunakan TurnBasedMatchConfig yang disediakan.
CreateTurnBasedMatchBlocking(Timeout timeout, const gpg::TurnBasedMatchConfig & config)
Memblokir versi CreateTurnBasedMatch.
CreateTurnBasedMatchBlocking(const gpg::TurnBasedMatchConfig & config)
Kelebihan CreateTurnBasedMatchBlocking, yang menggunakan waktu tunggu default selama 10 tahun.
DeclineInvitation(const MultiplayerInvitation & invitation)
void
DismissInvitation(const MultiplayerInvitation & invitation)
void
DismissMatch(const TurnBasedMatch & match)
void
Menutup TurnBasedMatch.
FetchMatch(const std::string & match_id, TurnBasedMatchCallback callback)
void
Mengambil pencocokan tertentu secara asinkron berdasarkan ID.
FetchMatchBlocking(Timeout timeout, const std::string & match_id)
Memblokir versi FetchMatch.
FetchMatchBlocking(const std::string & match_id)
Kelebihan FetchMatchBlocking, yang menggunakan waktu tunggu default selama 10 tahun.
FetchMatches(TurnBasedMatchesCallback callback)
void
Mengambil objek TurnBasedMatch dan Invitation secara asinkron untuk pemutar saat ini.
FetchMatchesBlocking(Timeout timeout)
Memblokir versi FetchMatches.
FetchMatchesBlocking()
Kelebihan FetchMatchesBlocking, yang menggunakan waktu tunggu default selama 10 tahun.
FinishMatchDuringMyTurn(const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, TurnBasedMatchCallback callback)
void
Menyelesaikan pencocokan yang ditentukan secara asinkron.
FinishMatchDuringMyTurnBlocking(Timeout timeout, const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results)
Memblokir versi FinishMatchDuringMyTurn.
FinishMatchDuringMyTurnBlocking(const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results)
Kelebihan FinishMatchDuringMyTurnBlocking, yang menggunakan waktu tunggu default selama 10 tahun.
LeaveMatchDuringMyTurn(const TurnBasedMatch & match, const MultiplayerParticipant & next_participant, MultiplayerStatusCallback callback)
void
Meninggalkan pertandingan secara asinkron saat giliran peserta lokal.
LeaveMatchDuringMyTurnBlocking(Timeout timeout, const TurnBasedMatch & match, const MultiplayerParticipant & next_participant)
Memblokir versi LeaveMatchDuringMyTurn.
LeaveMatchDuringMyTurnBlocking(const TurnBasedMatch & match, const MultiplayerParticipant & next_participant)
Kelebihan LeaveMatchDuringMyTurnBlocking, yang menggunakan waktu tunggu default selama 10 tahun.
LeaveMatchDuringTheirTurn(const TurnBasedMatch & match, MultiplayerStatusCallback callback)
void
Meninggalkan pertandingan secara asinkron saat giliran peserta lain tiba.
LeaveMatchDuringTheirTurnBlocking(Timeout timeout, const TurnBasedMatch & match)
Memblokir versi LeaveMatchDuringTheirTurn.
LeaveMatchDuringTheirTurnBlocking(const TurnBasedMatch & match)
Kelebihan LeaveMatchDuringTheirTurnBlocking, yang menggunakan waktu tunggu default selama 10 tahun.
Rematch(const TurnBasedMatch & match, TurnBasedMatchCallback callback)
void
Mencocokkan ulang kecocokan yang statusnya MatchStatus::COMPLETED.
RematchBlocking(Timeout timeout, const TurnBasedMatch & match)
Memblokir versi Pertandingan ulang.
RematchBlocking(const TurnBasedMatch & match)
Kelebihan RematchBlocking, yang menggunakan waktu tunggu default selama 10 tahun.
ShowMatchInboxUI(MatchInboxUICallback callback)
void
Secara asinkron menampilkan UI kotak masuk pencocokan, yang memungkinkan pemain memilih kecocokan atau undangan.
ShowMatchInboxUIBlocking(Timeout timeout)
Memblokir versi ShowMatchInboxUI.
ShowMatchInboxUIBlocking()
Kelebihan ShowMatchInboxUIBlocking, yang menggunakan waktu tunggu default selama 10 tahun.
ShowPlayerSelectUI(uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch, PlayerSelectUICallback callback)
void
Menampilkan UI pilihan pemain secara asinkron, sehingga pemain dapat memilih pemain lain untuk diajak bertanding.
ShowPlayerSelectUIBlocking(Timeout timeout, uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch)
Memblokir versi ShowPlayerSelectUI.
ShowPlayerSelectUIBlocking(uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch)
Kelebihan ShowPlayerSelectUIBlocking, yang menggunakan waktu tunggu default selama 10 tahun.
SynchronizeData()
void
Memaksa sinkronisasi data pencocokan TBMP dengan server.
TakeMyTurn(const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, const MultiplayerParticipant & next_participant, TurnBasedMatchCallback callback)
void
Secara asinkron mengambil giliran peserta lokal.
TakeMyTurnBlocking(Timeout timeout, const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, const MultiplayerParticipant & next_participant)
Memblokir versi TakeMyTurn.
TakeMyTurnBlocking(const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, const MultiplayerParticipant & next_participant)
Kelebihan TakeMyTurnBlocking, yang menggunakan waktu tunggu default selama 10 tahun.

Struct

gpg::TurnBasedMultiplayerManager::MatchInboxUIResponse

Data dan ResponseStatus untuk operasi ShowMatchInboxUI.

gpg::TurnBasedMultiplayerManager::PlayerSelectUIResponse

Data dan ResponseStatus untuk operasi ShowPlayerSelectUI.

gpg::TurnBasedMultiplayerManager::TurnBasedMatchResponse

Data dan ResponseStatus untuk TurnBasedMatch tertentu.

gpg::TurnBasedMultiplayerManager::TurnBasedMatchesResponse

Data dan ResponseStatus untuk TurnBasedMatches dan undangan.

Jenis publik

MatchInboxUICallback

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

Menentukan callback yang dapat menerima MatchInboxUIResponse dari ShowMatchInboxUI.

MultiplayerStatusCallback

std::function< void(MultiplayerStatus)> MultiplayerStatusCallback

Menentukan callback yang dapat digunakan untuk menerima MultiplayerStatus.

Digunakan oleh fungsi LearnMatch dan CancelMatch.

PlayerSelectUICallback

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

Menentukan callback yang dapat menerima PlayerSelectUIResponse dari ShowPlayerSelectUI.

TurnBasedMatchCallback

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

Menentukan callback yang dapat digunakan untuk menerima TurnBasedMatchResponse dari salah satu operasi multiplayer berbasis giliran.

TurnBasedMatchesCallback

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

Menentukan callback yang dapat menerima TurnBasedMatchesResponse dari salah satu operasi multiplayer berbasis giliran.

Atribut statis publik

kAutomatchingParticipant

const MultiplayerParticipant kAutomatchingParticipant

Peserta yang dapat diteruskan ke metode yang mengambil "peserta berikutnya".

Hal ini menyebabkan metode memilih peserta berikutnya melalui pencocokan otomatis. Tindakan ini hanya valid untuk meneruskan kAutomatchingParticipant ke sebuah fungsi jika TurnBasedMatch::AutomatchingSlotsAvailable akan lebih dari 0 untuk pencocokan terkait.

Fungsi publik

AcceptInvitation

void AcceptInvitation(
  const MultiplayerInvitation & invitation,
  TurnBasedMatchCallback callback
)

Menerima MultiplayerInvitation secara asinkron, dan menampilkan hasilnya melalui TurnBasedMatchCallback.

Jika operasi berhasil, TurnBasedMatch yang ditampilkan melalui callback berada dalam status TurnBasedMatchState::MY_TURN.

AcceptInvitationBlocking

TurnBasedMatchResponse AcceptInvitationBlocking(
  Timeout timeout,
  const MultiplayerInvitation & invitation
)

Memblokir versi AcceptInvitation.

Memungkinkan pemanggil menentukan waktu tunggu dalam md. Setelah waktu yang ditentukan berlalu, fungsi akan menampilkan ERROR_TIMEOUT.

AcceptInvitationBlocking

TurnBasedMatchResponse AcceptInvitationBlocking(
  const MultiplayerInvitation & invitation
)

Kelebihan AcceptInvitationBlocking, yang menggunakan waktu tunggu default 10 tahun.

CancelMatch

void CancelMatch(
  const TurnBasedMatch & match,
  MultiplayerStatusCallback callback
)

Membatalkan pencocokan secara asinkron.

Status yang ditampilkan melalui MultiplayerStatusCallback menunjukkan apakah operasi berhasil. Status pencocokan harus UNDANGD, THEIR_TURN, atau MY_TURN agar fungsi ini dapat digunakan.

CancelMatchBlocking

MultiplayerStatus CancelMatchBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

Memblokir versi CancelMatch.

Memungkinkan pemanggil menentukan waktu tunggu dalam md. Setelah waktu yang ditentukan berlalu, fungsi akan menampilkan ERROR_TIMEOUT.

CancelMatchBlocking

MultiplayerStatus CancelMatchBlocking(
  const TurnBasedMatch & match
)

Kelebihan CancelMatch yang menggunakan waktu tunggu default 10 tahun.

ConfirmPendingCompletion

void ConfirmPendingCompletion(
  const TurnBasedMatch & match,
  TurnBasedMatchCallback callback
)

Mengonfirmasi hasil pertandingan yang telah berakhir dan menunggu penyelesaian lokal.

Fungsi ini hanya dapat dipanggil jika TurnBasedMatch::Status() menampilkan MatchStatus::PENDING_COMPLETION.

Detail
Parameter
match
Pencocokan yang penyelesaiannya akan dikonfirmasi.
callback
Callback yang menerima TurnBasedMatchResponse.

ConfirmPendingCompletionBlocking

TurnBasedMatchResponse ConfirmPendingCompletionBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

Memblokir versi ConfirmPendingCompletion.

Memungkinkan pemanggil menentukan waktu tunggu dalam md. Setelah waktu yang ditentukan berlalu, fungsi akan menampilkan ERROR_TIMEOUT.

ConfirmPendingCompletionBlocking

TurnBasedMatchResponse ConfirmPendingCompletionBlocking(
  const TurnBasedMatch & match
)

Kelebihan ConfirmPendingCompletionBlocking, yang menggunakan waktu tunggu default selama 10 tahun.

CreateTurnBasedMatch

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

Membuat TurnBasedMatch secara asinkron menggunakan TurnBasedMatchConfig yang disediakan.

Jika pembuatan berhasil, fungsi ini akan menampilkan TurnBasedMatch melalui TurnBasedMatchCallback yang disediakan. TurnBasedMatch yang baru dibuat selalu dimulai dalam status TurnBasedMatchState::MY_TURN.

CreateTurnBasedMatchBlocking

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

Memblokir versi CreateTurnBasedMatch.

Memungkinkan pemanggil menentukan waktu tunggu dalam md. Setelah waktu yang ditentukan berlalu, fungsi akan menampilkan ERROR_TIMEOUT.

CreateTurnBasedMatchBlocking

TurnBasedMatchResponse CreateTurnBasedMatchBlocking(
  const gpg::TurnBasedMatchConfig & config
)

Kelebihan CreateTurnBasedMatchBlocking, yang menggunakan waktu tunggu default selama 10 tahun.

DeclineInvitation

void DeclineInvitation(
  const MultiplayerInvitation & invitation
)

Menolak MultiplayerInvitation ke TurnBasedMatch.

Tindakan ini akan membatalkan pencocokan untuk peserta lain dan menghapus kecocokan tersebut dari perangkat pemain lokal.

DismissInvitation

void DismissInvitation(
  const MultiplayerInvitation & invitation
)

Menutup MultiplayerInvitation menjadi TurnBasedMatch.

Ini tidak mengubah status TurnBasedMatch yang terlihat untuk peserta lain, tetapi menghapus TurnBasedMatch dari perangkat pemutar lokal.

DismissMatch

void DismissMatch(
  const TurnBasedMatch & match
)

Menutup TurnBasedMatch.

Ini tidak mengubah status TurnBasedMatch yang terlihat untuk peserta lain, tetapi menghapus TurnBasedMatch dari perangkat pemutar lokal.

FetchMatch

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

Mengambil pencocokan tertentu secara asinkron berdasarkan ID.

Hasil operasi ini ditampilkan melalui TurnBasedMatchCallback.

FetchMatchBlocking

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

Memblokir versi FetchMatch.

Memungkinkan pemanggil menentukan waktu tunggu dalam md. Setelah waktu yang ditentukan berlalu, fungsi akan menampilkan ERROR_TIMEOUT.

FetchMatchBlocking

TurnBasedMatchResponse FetchMatchBlocking(
  const std::string & match_id
)

Kelebihan FetchMatchBlocking, yang menggunakan waktu tunggu default selama 10 tahun.

FetchMatches

void FetchMatches(
  TurnBasedMatchesCallback callback
)

Mengambil objek TurnBasedMatch dan Invitation secara asinkron untuk pemutar saat ini.

Semua pencocokan aktif dan maksimum 10 pencocokan yang telah selesai akan ditampilkan.

FetchMatchesBlocking

TurnBasedMatchesResponse FetchMatchesBlocking(
  Timeout timeout
)

Memblokir versi FetchMatches.

Memungkinkan pemanggil menentukan waktu tunggu dalam md. Setelah waktu yang ditentukan berlalu, fungsi akan menampilkan ERROR_TIMEOUT.

FetchMatchesBlocking

TurnBasedMatchesResponse FetchMatchesBlocking()

Kelebihan FetchMatchesBlocking, yang menggunakan waktu tunggu default selama 10 tahun.

FinishMatchDuringMyTurn

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

Menyelesaikan pencocokan yang ditentukan secara asinkron.

Ini dapat digunakan dan bukan TakeMyTurn selama giliran terakhir pertandingan. Memungkinkan pemanggil menentukan nilai akhir untuk match_data, serta kumpulan nilai akhir untuk ParticipantResults. Setelah operasi ini selesai, kecocokan yang diperbarui akan ditampilkan melalui TurnBasedMatchCallback. yang disediakan. Fungsi ini hanya dapat dipanggil saat TurnBasedMatch::Status() menampilkan MatchStatus::MY_TURN.

Detail
Parameter
match
Pertandingan untuk menyelesaikan.
match_data
Blob data yang mewakili status akhir pencocokan.
results
Hasil apa pun untuk setiap pemain dalam pertandingan. Perhatikan bahwa hasil ini tidak boleh bertentangan dengan hasil yang ditentukan sebelumnya melalui TakeTurn. Mencoba menetapkan hasil yang berbeda untuk pemain akan menghasilkan ERROR_INVALID_RESULTS.
callback
Callback yang menerima TurnBasedMatchResponse.

FinishMatchDuringMyTurnBlocking

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

Memblokir versi FinishMatchDuringMyTurn.

Memungkinkan pemanggil menentukan waktu tunggu dalam md. Setelah waktu yang ditentukan berlalu, fungsi akan menampilkan ERROR_TIMEOUT.

FinishMatchDuringMyTurnBlocking

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

Kelebihan FinishMatchDuringMyTurnBlocking, yang menggunakan waktu tunggu default selama 10 tahun.

LeaveMatchDuringMyTurn

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

Meninggalkan pertandingan secara asinkron saat giliran peserta lokal.

Respons yang ditampilkan melalui TurnBasedMatchCallback berisi status pertandingan setelah pemain lokal pergi. Jika keberangkatan ini meninggalkan pertandingan dengan kurang dari dua peserta, pertandingan akan dibatalkan. match.Status() harus menampilkan MatchStatus::MY_TURN agar fungsi ini dapat digunakan.

Detail
Parameter
match
Pertandingan tersisa.
next_participant
Peserta yang gilirannya berikutnya. TurnBasedMultiplayerManager::kAutomatchingPeserta dapat digunakan untuk menentukan bahwa peserta berikutnya harus dipilih melalui pencocokan otomatis.
callback
Callback yang menerima TurnBasedMatchResponse

LeaveMatchDuringMyTurnBlocking

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

Memblokir versi LeaveMatchDuringMyTurn.

Memungkinkan pemanggil menentukan waktu tunggu dalam md. Setelah waktu yang ditentukan berlalu, fungsi akan menampilkan ERROR_TIMEOUT.

LeaveMatchDuringMyTurnBlocking

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

Kelebihan LeaveMatchDuringMyTurnBlocking, yang menggunakan waktu tunggu default selama 10 tahun.

LeaveMatchDuringTheirTurn

void LeaveMatchDuringTheirTurn(
  const TurnBasedMatch & match,
  MultiplayerStatusCallback callback
)

Meninggalkan pertandingan secara asinkron saat giliran peserta lain tiba.

Respons yang ditampilkan melalui MultiplayerStatusCallback berisi apakah peserta lokal berhasil keluar dari pertandingan. Jika keberangkatan ini meninggalkan pertandingan dengan kurang dari dua peserta, pertandingan akan dibatalkan. match.Status() harus menampilkan MatchStatus::THEIR_TURN agar fungsi ini dapat digunakan.

LeaveMatchDuringTheirTurnBlocking

MultiplayerStatus LeaveMatchDuringTheirTurnBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

Memblokir versi LeaveMatchDuringTheirTurn.

Memungkinkan pemanggil menentukan waktu tunggu dalam md. Setelah waktu yang ditentukan berlalu, fungsi akan menampilkan ERROR_TIMEOUT.

LeaveMatchDuringTheirTurnBlocking

MultiplayerStatus LeaveMatchDuringTheirTurnBlocking(
  const TurnBasedMatch & match
)

Kelebihan LeaveMatchDuringTheirTurnBlocking, yang menggunakan waktu tunggu default selama 10 tahun.

Tanding ulang

void Rematch(
  const TurnBasedMatch & match,
  TurnBasedMatchCallback callback
)

Mencocokkan ulang kecocokan yang statusnya MatchStatus::COMPLETED.

Jika pertandingan ulang dapat dilakukan, TurnBasedMatchCallback akan menerima kecocokan baru.

Detail
Parameter
match
Pertandingan yang akan ditandingkan ulang.
callback
Callback yang menerima TurnBasedMatchResponse.

RematchBlocking

TurnBasedMatchResponse RematchBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

Memblokir versi Pertandingan ulang.

Memungkinkan pemanggil menentukan waktu tunggu dalam md. Setelah waktu yang ditentukan berlalu, fungsi akan menampilkan ERROR_TIMEOUT.

RematchBlocking

TurnBasedMatchResponse RematchBlocking(
  const TurnBasedMatch & match
)

Kelebihan RematchBlocking, yang menggunakan waktu tunggu default selama 10 tahun.

ShowMatchInboxUI

void ShowMatchInboxUI(
  MatchInboxUICallback callback
)

Secara asinkron menampilkan UI kotak masuk pencocokan, yang memungkinkan pemain memilih kecocokan atau undangan.

Setelah selesai, kecocokan atau undangan yang dipilih akan ditampilkan melalui MatchInboxUICallback.

ShowMatchInboxUIBlocking

MatchInboxUIResponse ShowMatchInboxUIBlocking(
  Timeout timeout
)

Memblokir versi ShowMatchInboxUI.

Memungkinkan pemanggil menentukan waktu tunggu dalam md. Setelah waktu yang ditentukan berlalu, fungsi akan menampilkan ERROR_TIMEOUT.

ShowMatchInboxUIBlocking

MatchInboxUIResponse ShowMatchInboxUIBlocking()

Kelebihan ShowMatchInboxUIBlocking, yang menggunakan waktu tunggu default selama 10 tahun.

ShowPlayerSelectUI

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

Menampilkan UI pilihan pemain secara asinkron, sehingga pemain dapat memilih pemain lain untuk diajak bertanding.

Setelah selesai, pemain yang dipilih akan dikembalikan melalui PlayerSelectUICallback.

ShowPlayerSelectUIBlocking

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

Memblokir versi ShowPlayerSelectUI.

Memungkinkan pemanggil menentukan waktu tunggu dalam md. Setelah waktu yang ditentukan berlalu, fungsi akan menampilkan ERROR_TIMEOUT.

ShowPlayerSelectUIBlocking

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

Kelebihan ShowPlayerSelectUIBlocking, yang menggunakan waktu tunggu default selama 10 tahun.

SynchronizeData

void SynchronizeData()

Memaksa sinkronisasi data pencocokan TBMP dengan server.

Penerimaan data baru akan memicu OnTurnBasedMatchEventCallback atau OnMultiplayerInvitationReceivedCallback.

TakeMyTurn

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

Secara asinkron mengambil giliran peserta lokal.

Saat memberikan giliran, peserta dapat menentukan nilai baru untuk match_data, serta kumpulan ParticipantResults. Setelah giliran selesai, kecocokan yang diperbarui akan ditampilkan melalui TurnBasedMatchCallback. Fungsi ini hanya dapat dipanggil jika TurnBasedMatch::Status() adalah MatchStatus::MY_TURN.

Detail
Parameter
match
Pertandingan di mana giliran terjadi.
match_data
Blob data untuk dikirimkan ke peserta berikutnya.
results
Hasil yang diketahui untuk pertandingan saat ini. Perhatikan bahwa hasil untuk pemutar tertentu hanya dapat ditentukan sekali. Mencoba menetapkan hasil yang berbeda untuk pemain akan menghasilkan ERROR_INVALID_RESULTS.
next_participant
Peserta yang gilirannya berikutnya. TurnBasedMultiplayerManager::kAutomatchingPeserta dapat digunakan untuk menentukan bahwa peserta berikutnya harus dipilih melalui pencocokan otomatis.
callback
Callback yang menerima TurnBasedMatchResponse.

TakeMyTurnBlocking

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

Memblokir versi TakeMyTurn.

Memungkinkan pemanggil menentukan waktu tunggu dalam md. Setelah waktu yang ditentukan berlalu, fungsi akan menampilkan ERROR_TIMEOUT.

TakeMyTurnBlocking

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

Kelebihan TakeMyTurnBlocking, yang menggunakan waktu tunggu default selama 10 tahun.