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 bisa diteruskan ke metode yang melakukan peserta".

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 selama 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 selama 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)
Versi pemblokiran ConfirmPendingCompletion.
ConfirmPendingCompletionBlocking(const TurnBasedMatch & match)
Kelebihan beban 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)
Versi pemblokiran CreateTurnBasedMatch.
CreateTurnBasedMatchBlocking(const gpg::TurnBasedMatchConfig & config)
Kelebihan beban 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 menurut 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 beban FinishMatchDuringMyTurnBlocking, yang menggunakan waktu tunggu default selama 10 tahun.
LeaveMatchDuringMyTurn(const TurnBasedMatch & match, const MultiplayerParticipant & next_participant, MultiplayerStatusCallback callback)
void
Meninggalkan pertandingan secara asinkron selama 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 beban LeaveMatchDuringMyTurnBlocking, yang menggunakan waktu tunggu default selama 10 tahun.
LeaveMatchDuringTheirTurn(const TurnBasedMatch & match, MultiplayerStatusCallback callback)
void
Meninggalkan pertandingan secara asinkron saat giliran peserta lain.
LeaveMatchDuringTheirTurnBlocking(Timeout timeout, const TurnBasedMatch & match)
Memblokir versi LeaveMatchDuringTheirTurn.
LeaveMatchDuringTheirTurnBlocking(const TurnBasedMatch & match)
Kelebihan beban LeaveMatchDuringTheirTurnBlocking, yang menggunakan waktu tunggu default selama 10 tahun.
Rematch(const TurnBasedMatch & match, TurnBasedMatchCallback callback)
void
Mencocokkan ulang kecocokan yang statusnya adalah MatchStatus::COMPLETED.
RematchBlocking(Timeout timeout, const TurnBasedMatch & match)
Memblokir versi Rematch.
RematchBlocking(const TurnBasedMatch & match)
Kelebihan RematchBlocking, yang menggunakan waktu tunggu default selama 10 tahun.
ShowMatchInboxUI(MatchInboxUICallback callback)
void
Menampilkan UI kotak masuk pertandingan secara asinkron, sehingga pemain dapat memilih pertandingan atau undangan.
ShowMatchInboxUIBlocking(Timeout timeout)
Versi pemblokiran 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 pemilihan pemain secara asinkron, sehingga pemain dapat memilih pemain lain untuk diajak bermain.
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
Ambil 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)
Kelebihan beban 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 cutMatch 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 bisa diteruskan ke metode yang melakukan peserta".

Hal ini menyebabkan metode memilih peserta berikutnya melalui pencocokan otomatis. Meneruskan kAutomatchingPeserta ke fungsi hanya valid 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 akan 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 selama 10 tahun.

CancelMatch

void CancelMatch(
  const TurnBasedMatch & match,
  MultiplayerStatusCallback callback
)

Membatalkan pencocokan secara asinkron.

Status yang ditampilkan melalui MultiplayerStatusCallback menunjukkan apakah operasi berhasil atau tidak. Status kecocokan 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 selama 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 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
)

Kelebihan beban 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
)

Versi pemblokiran 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 beban CreateTurnBasedMatchBlocking, yang menggunakan waktu tunggu default selama 10 tahun.

DeclineInvitation

void DeclineInvitation(
  const MultiplayerInvitation & invitation
)

Menolak MultiplayerInvitation ke TurnBasedMatch.

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

DismissInvitation

void DismissInvitation(
  const MultiplayerInvitation & invitation
)

Menutup MultiplayerInvitation untuk TurnBasedMatch.

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

DismissMatch

void DismissMatch(
  const TurnBasedMatch & match
)

Menutup TurnBasedMatch.

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

FetchMatch

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

Mengambil pencocokan tertentu secara asinkron menurut 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 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()

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 sebagai ganti TakeMyTurn selama putaran akhir 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 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
)

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 beban 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 selama 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 yang akan ditinggalkan.
next_participant
Peserta yang gilirannya 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
)

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

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

Tanding ulang

void Rematch(
  const TurnBasedMatch & match,
  TurnBasedMatchCallback callback
)

Mencocokkan ulang kecocokan yang statusnya adalah MatchStatus::COMPLETED.

Jika pertandingan ulang memungkinkan, TurnBasedMatchCallback akan menerima kecocokan baru.

Detail
Parameter
match
Pertandingan untuk dicocokkan ulang.
callback
Callback yang menerima TurnBasedMatchResponse.

RematchBlocking

TurnBasedMatchResponse RematchBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

Memblokir versi Rematch.

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
)

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

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

ShowMatchInboxUIBlocking

MatchInboxUIResponse ShowMatchInboxUIBlocking(
  Timeout timeout
)

Versi pemblokiran 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 pemilihan pemain secara asinkron, sehingga pemain dapat memilih pemain lain untuk diajak bermain.

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
)

Ambil giliran peserta lokal secara asinkron.

Saat mengambil giliran, peserta dapat menentukan nilai baru untuk match_data, serta kumpulan ParticipantResults. Setelah 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 di mana belokan dilakukan.
match_data
Gumpalan data untuk dikirim ke peserta berikutnya.
results
Hasil yang diketahui untuk pertandingan saat ini. Perhatikan bahwa hasil untuk pemain tertentu hanya dapat ditentukan sekali. Mencoba menetapkan hasil yang berbeda untuk pemain akan menghasilkan ERROR_INVALID_RESULTS.
next_participant
Peserta yang gilirannya 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
)

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