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 menggunakan "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)
Versi pemblokiran AcceptInvitation.
AcceptInvitationBlocking(const MultiplayerInvitation & invitation)
Overload 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)
Versi pemblokiran CancelMatch.
CancelMatchBlocking(const TurnBasedMatch & match)
Overload CancelMatch yang menggunakan waktu tunggu default 10 tahun.
ConfirmPendingCompletion(const TurnBasedMatch & match, TurnBasedMatchCallback callback)
void
Mengonfirmasi hasil kecocokan yang telah berakhir dan menunggu penyelesaian lokal.
ConfirmPendingCompletionBlocking(Timeout timeout, const TurnBasedMatch & match)
Versi pemblokiran ConfirmPendingCompletion.
ConfirmPendingCompletionBlocking(const TurnBasedMatch & match)
Overload ConfirmPendingCompletionBlocking, yang menggunakan waktu tunggu default 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)
Overload CreateTurnBasedMatchBlocking, yang menggunakan waktu tunggu default 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 beban FetchMatchBlocking, yang menggunakan waktu tunggu default 10 tahun.
FetchMatches(TurnBasedMatchesCallback callback)
void
Mengambil objek TurnBasedMatch dan Invitation secara asinkron untuk pemain saat ini.
FetchMatchesBlocking(Timeout timeout)
Memblokir versi FetchMatches.
FetchMatchesBlocking()
Overload FetchMatchesBlocking, yang menggunakan waktu tunggu default 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)
Versi pemblokiran FinishMatchDuringMyTurn.
FinishMatchDuringMyTurnBlocking(const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results)
Overload FinishMatchDuringMyTurnBlocking, yang menggunakan waktu tunggu default 10 tahun.
LeaveMatchDuringMyTurn(const TurnBasedMatch & match, const MultiplayerParticipant & next_participant, MultiplayerStatusCallback callback)
void
Keluar dari pertandingan secara asinkron selama giliran peserta lokal.
LeaveMatchDuringMyTurnBlocking(Timeout timeout, const TurnBasedMatch & match, const MultiplayerParticipant & next_participant)
Versi pemblokiran LeaveMatchDuringMyTurn.
LeaveMatchDuringMyTurnBlocking(const TurnBasedMatch & match, const MultiplayerParticipant & next_participant)
Overload LeaveMatchDuringMyTurnBlocking, yang menggunakan waktu tunggu default 10 tahun.
LeaveMatchDuringTheirTurn(const TurnBasedMatch & match, MultiplayerStatusCallback callback)
void
Keluar dari pertandingan secara asinkron selama giliran peserta lain.
LeaveMatchDuringTheirTurnBlocking(Timeout timeout, const TurnBasedMatch & match)
Memblokir versi LeaveMatchDuringTheirTurn.
LeaveMatchDuringTheirTurnBlocking(const TurnBasedMatch & match)
Overload LeaveMatchDuringTheirTurnBlocking, yang menggunakan waktu tunggu default 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 beban RematchBlocking, yang menggunakan waktu tunggu default 10 tahun.
ShowMatchInboxUI(MatchInboxUICallback callback)
void
Menampilkan UI kotak masuk kecocokan secara asinkron, sehingga pemain dapat memilih kecocokan atau undangan.
ShowMatchInboxUIBlocking(Timeout timeout)
Memblokir versi ShowMatchInboxUI.
ShowMatchInboxUIBlocking()
Overload ShowMatchInboxUIBlocking, yang menggunakan waktu tunggu default 10 tahun.
ShowPlayerSelectUI(uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch, PlayerSelectUICallback callback)
void
Menampilkan UI pilih pemain secara asinkron, sehingga pemain dapat memilih pemain lain untuk bermain pertandingan.
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)
Overload ShowPlayerSelectUIBlocking, yang menggunakan waktu tunggu default 10 tahun.
SynchronizeData()
void
Memaksa sinkronisasi data kecocokan TBMP dengan server.
TakeMyTurn(const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, const MultiplayerParticipant & next_participant, TurnBasedMatchCallback callback)
void
Mengambil giliran peserta lokal secara asinkron.
TakeMyTurnBlocking(Timeout timeout, const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, const MultiplayerParticipant & next_participant)
Versi pemblokiran TakeMyTurn.
TakeMyTurnBlocking(const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, const MultiplayerParticipant & next_participant)
Overload TakeMyTurnBlocking, yang menggunakan waktu tunggu default 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 LeaveMatch 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 menggunakan "peserta berikutnya".

Hal ini menyebabkan metode memilih peserta berikutnya melalui pencocokan otomatis. Anda hanya boleh meneruskan kAutomatchingParticipant ke fungsi jika TurnBasedMatch::AutomatchingSlotsAvailable lebih dari 0 untuk kecocokan 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
)

Versi pemblokiran AcceptInvitation.

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

AcceptInvitationBlocking

TurnBasedMatchResponse AcceptInvitationBlocking(
  const MultiplayerInvitation & invitation
)

Overload 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 pertandingan harus INVITED, THEIR_TURN, atau MY_TURN agar fungsi ini dapat digunakan.

CancelMatchBlocking

MultiplayerStatus CancelMatchBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

Versi pemblokiran CancelMatch.

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

CancelMatchBlocking

MultiplayerStatus CancelMatchBlocking(
  const TurnBasedMatch & match
)

Overload CancelMatch yang menggunakan waktu tunggu default 10 tahun.

ConfirmPendingCompletion

void ConfirmPendingCompletion(
  const TurnBasedMatch & match,
  TurnBasedMatchCallback callback
)

Mengonfirmasi hasil kecocokan yang telah berakhir dan menunggu penyelesaian lokal.

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

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

ConfirmPendingCompletionBlocking

TurnBasedMatchResponse ConfirmPendingCompletionBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

Versi pemblokiran ConfirmPendingCompletion.

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

ConfirmPendingCompletionBlocking

TurnBasedMatchResponse ConfirmPendingCompletionBlocking(
  const TurnBasedMatch & match
)

Overload ConfirmPendingCompletionBlocking, yang menggunakan waktu tunggu default 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
)

Overload CreateTurnBasedMatchBlocking, yang menggunakan waktu tunggu default 10 tahun.

DeclineInvitation

void DeclineInvitation(
  const MultiplayerInvitation & invitation
)

Menolak MultiplayerInvitation menjadi TurnBasedMatch.

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

DismissInvitation

void DismissInvitation(
  const MultiplayerInvitation & invitation
)

Menutup MultiplayerInvitation ke TurnBasedMatch.

Tindakan 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.

Tindakan 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 beban FetchMatchBlocking, yang menggunakan waktu tunggu default 10 tahun.

FetchMatches

void FetchMatches(
  TurnBasedMatchesCallback callback
)

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

Semua kecocokan aktif dan maksimal 10 kecocokan 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()

Overload FetchMatchesBlocking, yang menggunakan waktu tunggu default 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 sebagai ganti 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 akan selesai.
match_data
Blob data yang mewakili status akhir kecocokan.
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
)

Versi pemblokiran 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
)

Overload FinishMatchDuringMyTurnBlocking, yang menggunakan waktu tunggu default 10 tahun.

LeaveMatchDuringMyTurn

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

Keluar dari pertandingan secara asinkron selama giliran peserta lokal.

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

Detail
Parameter
match
Kecocokan yang akan dihapus.
next_participant
Peserta yang giliran berikutnya. TurnBasedMultiplayerManager::kAutomatchingParticipant 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
)

Versi pemblokiran 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
)

Overload LeaveMatchDuringMyTurnBlocking, yang menggunakan waktu tunggu default 10 tahun.

LeaveMatchDuringTheirTurn

void LeaveMatchDuringTheirTurn(
  const TurnBasedMatch & match,
  MultiplayerStatusCallback callback
)

Keluar dari pertandingan secara asinkron selama giliran peserta lain.

Respons yang ditampilkan melalui MultiplayerStatusCallback berisi apakah peserta lokal berhasil keluar dari pertandingan. Jika kepergian ini membuat pertandingan hanya memiliki 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
)

Overload LeaveMatchDuringTheirTurnBlocking, yang menggunakan waktu tunggu default 10 tahun.

Ulangi

void Rematch(
  const TurnBasedMatch & match,
  TurnBasedMatchCallback callback
)

Mencocokkan ulang kecocokan yang statusnya MatchStatus::COMPLETED.

Jika pertandingan ulang memungkinkan, TurnBasedMatchCallback akan menerima pertandingan baru.

Detail
Parameter
match
Pertandingan yang akan diulang.
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 beban RematchBlocking, yang menggunakan waktu tunggu default 10 tahun.

ShowMatchInboxUI

void ShowMatchInboxUI(
  MatchInboxUICallback callback
)

Menampilkan UI kotak masuk kecocokan secara asinkron, sehingga pemain dapat memilih kecocokan atau undangan.

Setelah selesai, pencocokan 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()

Overload ShowMatchInboxUIBlocking, yang menggunakan waktu tunggu default 10 tahun.

ShowPlayerSelectUI

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

Menampilkan UI pilih pemain secara asinkron, sehingga pemain dapat memilih pemain lain untuk bermain pertandingan.

Setelah selesai, pemain yang dipilih akan ditampilkan 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
)

Overload ShowPlayerSelectUIBlocking, yang menggunakan waktu tunggu default 10 tahun.

SynchronizeData

void SynchronizeData()

Memaksa sinkronisasi data kecocokan 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
)

Mengambil giliran peserta lokal secara asinkron.

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

Detail
Parameter
match
Pertandingan tempat giliran berlangsung.
match_data
Blob data yang akan dikirim ke peserta berikutnya.
results
Semua hasil yang diketahui untuk pertandingan saat ini. Perhatikan bahwa hasil untuk pemain tertentu hanya boleh ditentukan satu kali. Mencoba menetapkan hasil yang berbeda untuk pemain akan menghasilkan ERROR_INVALID_RESULTS.
next_participant
Peserta yang giliran berikutnya. TurnBasedMultiplayerManager::kAutomatchingParticipant 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
)

Versi pemblokiran 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
)

Overload TakeMyTurnBlocking, yang menggunakan waktu tunggu default 10 tahun.