gpg:: TurnBasedMultiplayerManager

#include <turn_based_multiplayer_manager.h>

اشیاء TurnBasedMatch را واکشی، اصلاح و ایجاد می کند.

خلاصه

انواع عمومی
MatchInboxUICallback	typedef std::function< void(const MatchInboxUIResponse &)> پاسخ تماسی را تعریف می کند که می تواند MatchInboxUIResponse را از ShowMatchInboxUI دریافت کند.
MultiplayerStatusCallback	typedef std::function< void( MultiplayerStatus )> یک تماس برگشتی را تعریف می کند که می تواند برای دریافت وضعیت Multiplayer استفاده شود.
PlayerSelectUICallback	typedef std::function< void(const PlayerSelectUIResponse &)> پاسخ تماسی را تعریف می کند که می تواند PlayerSelectUIResponse از ShowPlayerSelectUI دریافت کند.
TurnBasedMatchCallback	typedef std::function< void(const TurnBasedMatchResponse &)> یک تماس برگشتی را تعریف می کند که می تواند برای دریافت TurnBasedMatchResponse از یکی از عملیات چند نفره مبتنی بر نوبت استفاده شود.
TurnBasedMatchesCallback	typedef std::function< void(const TurnBasedMatchesResponse &)> یک تماس برگشتی را تعریف می کند که می تواند یک TurnBasedMatchesResponse را از یکی از عملیات چند نفره مبتنی بر نوبت دریافت کند.

صفات استاتیک عمومی
kAutomatchingParticipant	const MultiplayerParticipant یک شرکت‌کننده که می‌تواند به روش‌هایی منتقل شود که «شرکت‌کننده بعدی» را می‌گیرند.

توابع عمومی
AcceptInvitation (const MultiplayerInvitation & invitation, TurnBasedMatchCallback callback)	void به طور ناهمزمان یک MultiplayerInvitation می پذیرد و نتیجه را از طریق TurnBasedMatchCallback برمی گرداند.
AcceptInvitationBlocking ( Timeout timeout, const MultiplayerInvitation & invitation)	TurnBasedMatchResponse مسدود کردن نسخه AcceptInvitation .
AcceptInvitationBlocking (const MultiplayerInvitation & invitation)	TurnBasedMatchResponse اضافه بار AcceptInvitationBlocking ، که از مهلت زمانی پیش‌فرض 10 ساله استفاده می‌کند.
CancelMatch (const TurnBasedMatch & match, MultiplayerStatusCallback callback)	void به طور ناهمزمان یک مسابقه را لغو می کند.
CancelMatchBlocking ( Timeout timeout, const TurnBasedMatch & match)	MultiplayerStatus مسدود کردن نسخه CancelMatch .
CancelMatchBlocking (const TurnBasedMatch & match)	MultiplayerStatus اضافه بار CancelMatch که از مهلت زمانی پیش فرض 10 ساله استفاده می کند.
ConfirmPendingCompletion (const TurnBasedMatch & match, TurnBasedMatchCallback callback)	void نتایج مسابقه ای را که به پایان رسیده است و در انتظار تکمیل محلی است را تأیید می کند.
ConfirmPendingCompletionBlocking ( Timeout timeout, const TurnBasedMatch & match)	TurnBasedMatchResponse مسدود کردن نسخه ConfirmPendingCompletion .
ConfirmPendingCompletionBlocking (const TurnBasedMatch & match)	TurnBasedMatchResponse اضافه بار ConfirmPendingCompletionBlocking ، که از مهلت زمانی پیش فرض 10 ساله استفاده می کند.
CreateTurnBasedMatch (const gpg::TurnBasedMatchConfig & config, TurnBasedMatchCallback callback)	void با استفاده از TurnBasedMatchConfig ارائه شده به صورت ناهمزمان یک TurnBasedMatch ایجاد می کند.
CreateTurnBasedMatchBlocking ( Timeout timeout, const gpg::TurnBasedMatchConfig & config)	TurnBasedMatchResponse مسدود کردن نسخه CreateTurnBasedMatch .
CreateTurnBasedMatchBlocking (const gpg::TurnBasedMatchConfig & config)	TurnBasedMatchResponse بارگذاری بیش از حد CreateTurnBasedMatchBlocking ، که از مهلت زمانی پیش‌فرض 10 ساله استفاده می‌کند.
DeclineInvitation (const MultiplayerInvitation & invitation)	void MultiplayerInvitation به TurnBasedMatch را رد می کند.
DismissInvitation (const MultiplayerInvitation & invitation)	void MultiplayerInvitation به TurnBasedMatch را رد می کند.
DismissMatch (const TurnBasedMatch & match)	void یک TurnBasedMatch را رد می کند.
FetchMatch (const std::string & match_id, TurnBasedMatchCallback callback)	void به طور ناهمزمان یک تطابق خاص را با شناسه واکشی می کند.
FetchMatchBlocking ( Timeout timeout, const std::string & match_id)	TurnBasedMatchResponse مسدود کردن نسخه FetchMatch .
FetchMatchBlocking (const std::string & match_id)	TurnBasedMatchResponse بارگیری بیش از حد FetchMatchBlocking ، که از مهلت زمانی پیش‌فرض 10 ساله استفاده می‌کند.
FetchMatches ( TurnBasedMatchesCallback callback)	void به طور ناهمزمان اشیاء TurnBasedMatch و Invitation را برای پخش کننده فعلی واکشی می کند.
FetchMatchesBlocking ( Timeout timeout)	TurnBasedMatchesResponse مسدود کردن نسخه FetchMatches .
FetchMatchesBlocking ()	TurnBasedMatchesResponse بارگیری بیش از حد FetchMatchesBlocking ، که از مهلت زمانی پیش‌فرض 10 ساله استفاده می‌کند.
FinishMatchDuringMyTurn (const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, TurnBasedMatchCallback callback)	void به صورت ناهمزمان مسابقه مشخص شده را به پایان می رساند.
FinishMatchDuringMyTurnBlocking ( Timeout timeout, const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results)	TurnBasedMatchResponse مسدود کردن نسخه FinishMatchDuringMyTurn .
FinishMatchDuringMyTurnBlocking (const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results)	TurnBasedMatchResponse بارگذاری بیش از حد FinishMatchDuringMyTurnBlocking ، که از مهلت زمانی پیش‌فرض 10 ساله استفاده می‌کند.
LeaveMatchDuringMyTurn (const TurnBasedMatch & match, const MultiplayerParticipant & next_participant, MultiplayerStatusCallback callback)	void به طور ناهمزمان یک مسابقه را در طول نوبت شرکت کننده محلی ترک می کند.
LeaveMatchDuringMyTurnBlocking ( Timeout timeout, const TurnBasedMatch & match, const MultiplayerParticipant & next_participant)	MultiplayerStatus مسدود کردن نسخه LeaveMatchDuringMyTurn .
LeaveMatchDuringMyTurnBlocking (const TurnBasedMatch & match, const MultiplayerParticipant & next_participant)	MultiplayerStatus بارگذاری بیش از حد LeaveMatchDuringMyTurnBlocking ، که از مهلت زمانی پیش‌فرض 10 ساله استفاده می‌کند.
LeaveMatchDuringTheirTurn (const TurnBasedMatch & match, MultiplayerStatusCallback callback)	void به طور ناهمزمان یک مسابقه را در نوبت یک شرکت‌کننده دیگر ترک می‌کند.
LeaveMatchDuringTheirTurnBlocking ( Timeout timeout, const TurnBasedMatch & match)	MultiplayerStatus مسدود کردن نسخه LeaveMatchDuringTheirTurn .
LeaveMatchDuringTheirTurnBlocking (const TurnBasedMatch & match)	MultiplayerStatus بارگذاری بیش از حد LeaveMatchDuringTheirTurnBlocking ، که از مهلت زمانی پیش‌فرض 10 ساله استفاده می‌کند.
Rematch (const TurnBasedMatch & match, TurnBasedMatchCallback callback)	void مسابقه ای را که وضعیت آن MatchStatus::COMPLETED است مجدداً مطابقت می دهد.
RematchBlocking ( Timeout timeout, const TurnBasedMatch & match)	TurnBasedMatchResponse نسخه مسدود کننده Rematch .
RematchBlocking (const TurnBasedMatch & match)	TurnBasedMatchResponse بارگذاری بیش از حد RematchBlocking ، که از مهلت زمانی پیش‌فرض 10 ساله استفاده می‌کند.
ShowMatchInboxUI ( MatchInboxUICallback callback)	void به طور ناهمزمان رابط کاربری صندوق ورودی مسابقه را نشان می دهد و به بازیکن امکان می دهد مسابقه یا دعوت نامه را انتخاب کند.
ShowMatchInboxUIBlocking ( Timeout timeout)	MatchInboxUIResponse مسدود کردن نسخه ShowMatchInboxUI .
ShowMatchInboxUIBlocking ()	MatchInboxUIResponse اضافه بار ShowMatchInboxUIBlocking ، که از مهلت زمانی پیش‌فرض 10 ساله استفاده می‌کند.
ShowPlayerSelectUI (uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch, PlayerSelectUICallback callback)	void به طور ناهمزمان رابط کاربری انتخابی بازیکن را نشان می‌دهد و به بازیکن اجازه می‌دهد بازیکنان دیگری را برای بازی با آنها انتخاب کند.
ShowPlayerSelectUIBlocking ( Timeout timeout, uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch)	PlayerSelectUIResponse مسدود کردن نسخه ShowPlayerSelectUI .
ShowPlayerSelectUIBlocking (uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch)	PlayerSelectUIResponse اضافه بار ShowPlayerSelectUIBlocking ، که از مهلت زمانی پیش‌فرض 10 ساله استفاده می‌کند.
SynchronizeData ()	void همگام سازی داده های مطابقت TBMP با سرور را مجبور می کند.
TakeMyTurn (const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, const MultiplayerParticipant & next_participant, TurnBasedMatchCallback callback)	void ناهمزمان نوبت شرکت کننده محلی را می گیرد.
TakeMyTurnBlocking ( Timeout timeout, const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, const MultiplayerParticipant & next_participant)	TurnBasedMatchResponse مسدود کردن نسخه TakeMyTurn .
TakeMyTurnBlocking (const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, const MultiplayerParticipant & next_participant)	TurnBasedMatchResponse Overload TakeMyTurnBlocking ، که از مهلت زمانی پیش‌فرض 10 ساله استفاده می‌کند.

سازه ها
gpg:: TurnBasedMultiplayerManager:: MatchInboxUIResponse	Data and ResponseStatus برای عملیات ShowMatchInboxUI .
gpg:: TurnBasedMultiplayerManager:: PlayerSelectUIResponse	Data و ResponseStatus برای عملیات ShowPlayerSelectUI .
gpg:: TurnBasedMultiplayerManager:: TurnBasedMatchResponse	Data و ResponseStatus برای یک TurnBasedMatch خاص.
gpg:: TurnBasedMultiplayerManager:: TurnBasedMatchesResponse	Data و ResponseStatus برای TurnBasedMatches و دعوتنامه ها .

انواع عمومی

MatchInboxUICallback

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

پاسخ تماسی را تعریف می کند که می تواند MatchInboxUIResponse را از ShowMatchInboxUI دریافت کند.

چند نفره StatusCallback

std::function< void(MultiplayerStatus)> MultiplayerStatusCallback

یک تماس برگشتی را تعریف می کند که می تواند برای دریافت وضعیت Multiplayer استفاده شود.

توسط توابع LeaveMatch و CancelMatch استفاده می شود.

PlayerSelectUICallback

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

پاسخ تماسی را تعریف می کند که می تواند PlayerSelectUIResponse از ShowPlayerSelectUI دریافت کند.

TurnBasedMatchCallback

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

یک تماس برگشتی را تعریف می کند که می تواند برای دریافت TurnBasedMatchResponse از یکی از عملیات چند نفره مبتنی بر نوبت استفاده شود.

TurnBasedMatchesCallback

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

یک تماس برگشتی را تعریف می کند که می تواند یک TurnBasedMatchesResponse را از یکی از عملیات چند نفره مبتنی بر نوبت دریافت کند.

صفات استاتیک عمومی

kAutomatchingParticipant

const MultiplayerParticipant kAutomatchingParticipant

یک شرکت‌کننده که می‌تواند به روش‌هایی منتقل شود که «شرکت‌کننده بعدی» را می‌گیرند.

این باعث می شود که روش از طریق خودکارسازی، شرکت کننده بعدی را انتخاب کند. در صورتی که TurnBasedMatch::AutomatchingSlotsAvailable برای مطابقت مربوطه بیش از 0 باشد، انتقال kAutomatchingParticipant به یک تابع معتبر است.

توابع عمومی

قبول دعوت

void AcceptInvitation(
  const MultiplayerInvitation & invitation,
  TurnBasedMatchCallback callback
)

به طور ناهمزمان یک MultiplayerInvitation می پذیرد و نتیجه را از طریق TurnBasedMatchCallback برمی گرداند.

اگر عملیات موفقیت آمیز باشد، TurnBasedMatch که از طریق تماس برگشتی برگردانده می شود در وضعیت TurnBasedMatchState::MY_TURN قرار دارد.

AcceptInvitationBlocking

TurnBasedMatchResponse AcceptInvitationBlocking(
  Timeout timeout,
  const MultiplayerInvitation & invitation
)

مسدود کردن نسخه AcceptInvitation .

به تماس‌گیرنده اجازه می‌دهد تا مدت زمانی را بر حسب ms تعیین کند. پس از سپری شدن زمان مشخص شده، تابع ERROR_TIMEOUT را برمی‌گرداند.

AcceptInvitationBlocking

TurnBasedMatchResponse AcceptInvitationBlocking(
  const MultiplayerInvitation & invitation
)

اضافه بار AcceptInvitationBlocking ، که از مهلت زمانی پیش‌فرض 10 ساله استفاده می‌کند.

لغو مسابقه

void CancelMatch(
  const TurnBasedMatch & match,
  MultiplayerStatusCallback callback
)

به طور ناهمزمان یک مسابقه را لغو می کند.

وضعیت بازگشتی از طریق MultiplayerStatusCallback نشان می دهد که آیا عملیات موفقیت آمیز بوده است یا خیر. وضعیت مطابقت باید INVITED، THEIR_TURN یا MY_TURN باشد تا این تابع قابل استفاده باشد.

لغوMatchBlocking

MultiplayerStatus CancelMatchBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

مسدود کردن نسخه CancelMatch .

به تماس‌گیرنده اجازه می‌دهد تا مدت زمانی را بر حسب ms تعیین کند. پس از سپری شدن زمان مشخص شده، تابع ERROR_TIMEOUT را برمی‌گرداند.

لغوMatchBlocking

MultiplayerStatus CancelMatchBlocking(
  const TurnBasedMatch & match
)

اضافه بار CancelMatch که از مهلت زمانی پیش فرض 10 ساله استفاده می کند.

ConfirmPendingCompletion

void ConfirmPendingCompletion(
  const TurnBasedMatch & match,
  TurnBasedMatchCallback callback
)

نتایج مسابقه ای را که به پایان رسیده است و در انتظار تکمیل محلی است را تأیید می کند.

این تابع فقط زمانی فراخوانی می شود که TurnBasedMatch::Status() MatchStatus::PENDING_COMPLETION را برمی گرداند.

جزئیات
مولفه های	match مسابقه ای که تکمیل آن تایید می شود. callback پاسخ به تماس یک TurnBasedMatchResponse دریافت می کند.

ConfirmPendingCompletionBlocking

TurnBasedMatchResponse ConfirmPendingCompletionBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

مسدود کردن نسخه ConfirmPendingCompletion .

به تماس‌گیرنده اجازه می‌دهد تا مدت زمانی را بر حسب ms تعیین کند. پس از سپری شدن زمان مشخص شده، تابع ERROR_TIMEOUT را برمی‌گرداند.

ConfirmPendingCompletionBlocking

TurnBasedMatchResponse ConfirmPendingCompletionBlocking(
  const TurnBasedMatch & match
)

اضافه بار ConfirmPendingCompletionBlocking ، که از مهلت زمانی پیش فرض 10 ساله استفاده می کند.

CreateTurnBasedMatch

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

با استفاده از TurnBasedMatchConfig ارائه شده به صورت ناهمزمان یک TurnBasedMatch ایجاد می کند.

اگر ایجاد موفقیت آمیز باشد، این تابع TurnBasedMatch را از طریق TurnBasedMatchCallback ارائه شده برمی گرداند. یک TurnBasedMatch تازه ایجاد شده همیشه در حالت TurnBasedMatchState::MY_TURN شروع می شود.

CreateTurnBasedMatchBlocking

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

مسدود کردن نسخه CreateTurnBasedMatch .

به تماس‌گیرنده اجازه می‌دهد تا مدت زمانی را بر حسب ms تعیین کند. پس از سپری شدن زمان مشخص شده، تابع ERROR_TIMEOUT را برمی‌گرداند.

CreateTurnBasedMatchBlocking

TurnBasedMatchResponse CreateTurnBasedMatchBlocking(
  const gpg::TurnBasedMatchConfig & config
)

بارگذاری بیش از حد CreateTurnBasedMatchBlocking ، که از مهلت زمانی پیش‌فرض 10 ساله استفاده می‌کند.

رد دعوت

void DeclineInvitation(
  const MultiplayerInvitation & invitation
)

MultiplayerInvitation به TurnBasedMatch را رد می کند.

انجام این کار باعث لغو مسابقه برای سایر شرکت کنندگان و حذف مسابقه از دستگاه بازیکن محلی می شود.

DismissInvitation

void DismissInvitation(
  const MultiplayerInvitation & invitation
)

MultiplayerInvitation به TurnBasedMatch را رد می کند.

این حالت قابل مشاهده TurnBasedMatch برای سایر شرکت کنندگان تغییر نمی دهد، اما TurnBasedMatch از دستگاه پخش کننده محلی حذف می کند.

DismissMatch

void DismissMatch(
  const TurnBasedMatch & match
)

یک TurnBasedMatch را رد می کند.

این حالت قابل مشاهده TurnBasedMatch برای سایر شرکت کنندگان تغییر نمی دهد، اما TurnBasedMatch از دستگاه پخش کننده محلی حذف می کند.

FetchMatch

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

به طور ناهمزمان یک تطابق خاص را با شناسه واکشی می کند.

نتیجه این عملیات از طریق TurnBasedMatchCallback برگردانده می شود.

FetchMatchBlocking

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

مسدود کردن نسخه FetchMatch .

به تماس‌گیرنده اجازه می‌دهد تا مدت زمانی را بر حسب ms تعیین کند. پس از سپری شدن زمان مشخص شده، تابع ERROR_TIMEOUT را برمی‌گرداند.

FetchMatchBlocking

TurnBasedMatchResponse FetchMatchBlocking(
  const std::string & match_id
)

بارگیری بیش از حد FetchMatchBlocking ، که از مهلت زمانی پیش‌فرض 10 ساله استفاده می‌کند.

FetchMatches

void FetchMatches(
  TurnBasedMatchesCallback callback
)

به طور ناهمزمان اشیاء TurnBasedMatch و Invitation را برای پخش کننده فعلی واکشی می کند.

همه مسابقات فعال و حداکثر 10 مسابقه تکمیل شده برگردانده می شوند.

FetchMatchesBlocking

TurnBasedMatchesResponse FetchMatchesBlocking(
  Timeout timeout
)

مسدود کردن نسخه FetchMatches .

به تماس‌گیرنده اجازه می‌دهد تا مدت زمانی را بر حسب ms تعیین کند. پس از سپری شدن زمان مشخص شده، تابع ERROR_TIMEOUT را برمی‌گرداند.

FetchMatchesBlocking

TurnBasedMatchesResponse FetchMatchesBlocking()

بارگیری بیش از حد FetchMatchesBlocking ، که از مهلت زمانی پیش‌فرض 10 ساله استفاده می‌کند.

FinishMatchDuringMyTurn

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

به صورت ناهمزمان مسابقه مشخص شده را به پایان می رساند.

این را می توان به جای TakeMyTurn در آخرین نوبت مسابقه استفاده کرد. به تماس‌گیرنده اجازه می‌دهد یک مقدار نهایی برای match_data و همچنین مجموعه‌ای از مقادیر نهایی برای ParticipantResults تعیین کند. پس از تکمیل این عملیات، مطابقت به روز شده از طریق TurnBasedMatchCallback. این تابع فقط زمانی فراخوانی می شود که TurnBasedMatch::Status() MatchStatus::MY_TURN .

جزئیات
مولفه های	match مسابقه تمام شود match_data لکه ای از داده ها که وضعیت نهایی مسابقه را نشان می دهد. results هر نتیجه ای برای هر بازیکن در مسابقه. توجه داشته باشید که این نتایج نباید با هیچ نتیجه ای که قبلاً از طریق TakeTurn مشخص شده بود مغایرت داشته باشد. تلاش برای تنظیم نتایج متفاوت برای یک بازیکن در ERROR_INVALID_RESULTS نتیجه می شود. callback تماسی که TurnBasedMatchResponse را دریافت می کند.

FinishMatchDuringMyTurnBlocking

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

مسدود کردن نسخه FinishMatchDuringMyTurn .

به تماس‌گیرنده اجازه می‌دهد تا مدت زمانی را بر حسب ms تعیین کند. پس از سپری شدن زمان مشخص شده، تابع ERROR_TIMEOUT را برمی‌گرداند.

FinishMatchDuringMyTurnBlocking

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

بارگذاری بیش از حد FinishMatchDuringMyTurnBlocking ، که از مهلت زمانی پیش‌فرض 10 ساله استفاده می‌کند.

LeaveMatchDuringMyTurn

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

به طور ناهمزمان یک مسابقه را در طول نوبت شرکت کننده محلی ترک می کند.

پاسخی که از طریق TurnBasedMatchCallback برگردانده می شود شامل وضعیت مسابقه پس از رفتن بازیکن محلی است. اگر این حرکت با کمتر از دو شرکت کننده مسابقه را ترک کند، مسابقه لغو می شود. match.Status() باید MatchStatus::MY_TURN برگرداند تا این تابع قابل استفاده باشد.

جزئیات
مولفه های	match مسابقه برای ترک. next_participant شرکت کننده ای که نوبت بعدی است. TurnBasedMultiplayerManager::kAutomatchingParticipant ممکن است برای تعیین اینکه شرکت‌کننده بعدی باید از طریق تطبیق خودکار انتخاب شود، استفاده شود. callback تماسی که TurnBasedMatchResponse را دریافت می کند

LeaveMatchDuringMyTurnBlocking

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

مسدود کردن نسخه LeaveMatchDuringMyTurn .

به تماس‌گیرنده اجازه می‌دهد تا مدت زمانی را بر حسب ms تعیین کند. پس از سپری شدن زمان مشخص شده، تابع ERROR_TIMEOUT را برمی‌گرداند.

LeaveMatchDuringMyTurnBlocking

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

بارگذاری بیش از حد LeaveMatchDuringMyTurnBlocking ، که از مهلت زمانی پیش‌فرض 10 ساله استفاده می‌کند.

LeaveMatchDuringTheirTurn

void LeaveMatchDuringTheirTurn(
  const TurnBasedMatch & match,
  MultiplayerStatusCallback callback
)

به طور ناهمزمان یک مسابقه را در نوبت یک شرکت‌کننده دیگر ترک می‌کند.

پاسخی که از طریق MultiplayerStatusCallback برگردانده می‌شود شامل این است که آیا شرکت‌کننده محلی مسابقه را با موفقیت ترک کرده است یا خیر. اگر این حرکت با کمتر از دو شرکت کننده مسابقه را ترک کند، مسابقه لغو می شود. match.Status() باید MatchStatus::THEIR_TURN برگرداند تا این تابع قابل استفاده باشد.

LeaveMatchDuringTheirTurnBlocking

MultiplayerStatus LeaveMatchDuringTheirTurnBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

مسدود کردن نسخه LeaveMatchDuringTheirTurn .

به تماس‌گیرنده اجازه می‌دهد تا مدت زمانی را بر حسب ms تعیین کند. پس از سپری شدن زمان مشخص شده، تابع ERROR_TIMEOUT را برمی‌گرداند.

LeaveMatchDuringTheirTurnBlocking

MultiplayerStatus LeaveMatchDuringTheirTurnBlocking(
  const TurnBasedMatch & match
)

بارگذاری بیش از حد LeaveMatchDuringTheirTurnBlocking ، که از مهلت زمانی پیش‌فرض 10 ساله استفاده می‌کند.

مسابقه برگشت

void Rematch(
  const TurnBasedMatch & match,
  TurnBasedMatchCallback callback
)

مسابقه ای را که وضعیت آن MatchStatus::COMPLETED است مجدداً مطابقت می دهد.

اگر مسابقه مجدد امکان پذیر باشد، TurnBasedMatchCallback مسابقه جدید را دریافت می کند.

جزئیات
مولفه های	match مسابقه برای بازی برگشت callback پاسخ تماسی که TurnBasedMatchResponse را دریافت می کند.

RematchBlocking

TurnBasedMatchResponse RematchBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

نسخه مسدود کننده Rematch .

به تماس‌گیرنده اجازه می‌دهد تا مدت زمانی را بر حسب ms تعیین کند. پس از سپری شدن زمان مشخص شده، تابع ERROR_TIMEOUT را برمی‌گرداند.

RematchBlocking

TurnBasedMatchResponse RematchBlocking(
  const TurnBasedMatch & match
)

بارگذاری بیش از حد RematchBlocking ، که از مهلت زمانی پیش‌فرض 10 ساله استفاده می‌کند.

ShowMatchInboxUI

void ShowMatchInboxUI(
  MatchInboxUICallback callback
)

به طور ناهمزمان رابط کاربری صندوق ورودی مسابقه را نشان می دهد و به بازیکن امکان می دهد مسابقه یا دعوت نامه را انتخاب کند.

پس از تکمیل، مسابقه یا دعوتنامه انتخاب شده از طریق MatchInboxUICallback برگردانده می شود.

ShowMatchInboxUIBlocking

MatchInboxUIResponse ShowMatchInboxUIBlocking(
  Timeout timeout
)

مسدود کردن نسخه ShowMatchInboxUI .

به تماس‌گیرنده اجازه می‌دهد تا مدت زمانی را بر حسب ms تعیین کند. پس از سپری شدن زمان مشخص شده، تابع ERROR_TIMEOUT را برمی‌گرداند.

ShowMatchInboxUIBlocking

MatchInboxUIResponse ShowMatchInboxUIBlocking()

اضافه بار ShowMatchInboxUIBlocking ، که از مهلت زمانی پیش‌فرض 10 ساله استفاده می‌کند.

ShowPlayerSelectUI

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

به طور ناهمزمان رابط کاربری انتخابی بازیکن را نشان می‌دهد و به بازیکن اجازه می‌دهد بازیکنان دیگری را برای بازی با آنها انتخاب کند.

پس از تکمیل، بازیکنان انتخاب شده از طریق PlayerSelectUICallback بازگردانده خواهند شد.

ShowPlayerSelectUIBlocking

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

مسدود کردن نسخه ShowPlayerSelectUI .

به تماس‌گیرنده اجازه می‌دهد تا مدت زمانی را بر حسب ms تعیین کند. پس از سپری شدن زمان مشخص شده، تابع ERROR_TIMEOUT را برمی‌گرداند.

ShowPlayerSelectUIBlocking

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

اضافه بار ShowPlayerSelectUIBlocking ، که از مهلت زمانی پیش‌فرض 10 ساله استفاده می‌کند.

همگام سازی داده ها

void SynchronizeData()

همگام سازی داده های مطابقت TBMP با سرور را مجبور می کند.

دریافت داده‌های جدید یک OnTurnBasedMatchEventCallback یا یک OnMultiplayerInvitationReceivedCallback را راه‌اندازی می‌کند.

TakeMyTurn

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

ناهمزمان نوبت شرکت کننده محلی را می گیرد.

هنگام گرفتن نوبت، شرکت‌کننده ممکن است مقدار جدیدی را برای match_data و همچنین مجموعه‌ای از ParticipantResults تعیین کند. وقتی نوبت تمام شد، مطابقت به روز شده از طریق TurnBasedMatchCallback برگردانده می شود. این تابع فقط زمانی فراخوانی می شود که TurnBasedMatch::Status() MatchStatus::MY_TURN باشد.

جزئیات

مولفه های

match مسابقه ای که نوبت در آن انجام می شود. match_data لکه ای از داده ها برای ارسال به شرکت کننده بعدی. results هر گونه نتایج شناخته شده برای مسابقه در زمان فعلی. توجه داشته باشید که نتیجه برای یک بازیکن معین ممکن است فقط یک بار مشخص شود. تلاش برای تنظیم نتایج متفاوت برای بازیکن در ERROR_INVALID_RESULTS نتیجه می‌شود. next_participant شرکت کننده ای که نوبت بعدی است. TurnBasedMultiplayerManager::kAutomatchingParticipant ممکن است برای تعیین اینکه شرکت‌کننده بعدی باید از طریق تطبیق خودکار انتخاب شود، استفاده شود. callback تماسی که TurnBasedMatchResponse را دریافت می کند.

TakeMyTurnBlocking

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

مسدود کردن نسخه TakeMyTurn .

به تماس‌گیرنده اجازه می‌دهد تا مدت زمانی را بر حسب ms تعیین کند. پس از سپری شدن زمان مشخص شده، تابع ERROR_TIMEOUT را برمی‌گرداند.

TakeMyTurnBlocking

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

اضافه بار TakeMyTurnBlocking ، که از مهلت زمانی پیش فرض 10 ساله استفاده می کند.