gpg::TurnBasedMultiplayerManager

#include <turn_based_multiplayer_manager.h>

لجلب عناصر TurnBasedMatch وتعديلها وإنشائها.

ملخّص

الأنواع العلنية
MatchInboxUICallback typedef
std::function< void(const MatchInboxUIResponse &)>
تحدِّد هذه السياسة معاودة الاتصال التي يمكنها تلقّي MatchInboxUIResponse من "ShowMatchInboxUI".
MultiplayerStatusCallback typedef
std::function< void(MultiplayerStatus)>
تحدِّد معاودة الاتصال التي يمكن استخدامها لتلقّي حالة "متعدد اللاعبين".
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
أحد المشاركين الذي يمكن تمريره إلى الأساليب التي تأخذ "المشارك التالي".

الدوال العامة
AcceptInvitation(const MultiplayerInvitation & invitation, TurnBasedMatchCallback callback)
void
تقبل MultiplayerInvitation بشكل غير متزامن، وتعرض النتيجة من خلال TurnBasedMatchCallback.
AcceptInvitationBlocking(Timeout timeout, const MultiplayerInvitation & invitation)
إصدار الحظر من AcceptInvitation
AcceptInvitationBlocking(const MultiplayerInvitation & invitation)
التحميل الزائد للرابط AcceptInvitationBlocking، والذي يستخدم مهلة افتراضية تبلغ 10 سنوات.
CancelMatch(const TurnBasedMatch & match, MultiplayerStatusCallback callback)
void
إلغاء مباراة بشكل غير متزامن
CancelMatchBlocking(Timeout timeout, const TurnBasedMatch & match)
إصدار الحظر من CancelMatch
CancelMatchBlocking(const TurnBasedMatch & match)
التحميل الزائد لـ CancelMatch الذي يستخدم مهلة تلقائية تبلغ 10 سنوات.
ConfirmPendingCompletion(const TurnBasedMatch & match, TurnBasedMatchCallback callback)
void
لتأكيد نتائج مباراة انتهت وفي انتظار الإكمال المحلي.
ConfirmPendingCompletionBlocking(Timeout timeout, const TurnBasedMatch & match)
حظر الإصدار من ConfirmPendingCompletion
ConfirmPendingCompletionBlocking(const TurnBasedMatch & match)
التحميل الزائد للتوجيه ConfirmPendingCompletionBlocking، والذي يستخدم مهلة تلقائية تبلغ 10 سنوات.
CreateTurnBasedMatch(const gpg::TurnBasedMatchConfig & config, TurnBasedMatchCallback callback)
void
يتم إنشاء TurnBasedMatch بشكلٍ غير متزامن باستخدام TurnBasedMatchConfig المقدَّمة.
CreateTurnBasedMatchBlocking(Timeout timeout, const gpg::TurnBasedMatchConfig & config)
إصدار الحظر من CreateTurnBasedMatch.
CreateTurnBasedMatchBlocking(const gpg::TurnBasedMatchConfig & config)
التحميل الزائد للدالة CreateTurnBasedMatchBlocking، والذي يستخدم مهلة تلقائية تبلغ 10 سنوات.
DeclineInvitation(const MultiplayerInvitation & invitation)
void
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)
حظر إصدار FetchMatch
FetchMatchBlocking(const std::string & match_id)
التحميل الزائد FetchMatchBlocking، والذي يستخدم مهلة تلقائية تبلغ 10 سنوات
FetchMatches(TurnBasedMatchesCallback callback)
void
يتم جلب عنصرَي TurnBasedMatch وInvitation بشكل غير متزامن للمشغّل الحالي.
FetchMatchesBlocking(Timeout timeout)
حظر الإصدار من FetchMatches
FetchMatchesBlocking()
التحميل الزائد للأداة 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)
حظر الإصدار من FinishMatchDuringMyTurn
FinishMatchDuringMyTurnBlocking(const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results)
الحمل الزائد FinishMatchDuringMyTurnBlocking: يستخدم مهلة افتراضية تبلغ 10 سنوات.
LeaveMatchDuringMyTurn(const TurnBasedMatch & match, const MultiplayerParticipant & next_participant, MultiplayerStatusCallback callback)
void
يؤدي هذا الخيار إلى ترك المباراة بشكل غير متزامن أثناء دور المشارك المحلي.
LeaveMatchDuringMyTurnBlocking(Timeout timeout, const TurnBasedMatch & match, const MultiplayerParticipant & next_participant)
إصدار الحظر من LeaveMatchDuringMyTurn
LeaveMatchDuringMyTurnBlocking(const TurnBasedMatch & match, const MultiplayerParticipant & next_participant)
التحميل الزائد لـ LeaveMatchDuringMyTurnBlocking، الذي يستخدم مهلة افتراضية تبلغ 10 سنوات.
LeaveMatchDuringTheirTurn(const TurnBasedMatch & match, MultiplayerStatusCallback callback)
void
يؤدي هذا الخيار إلى ترك المباراة بشكل غير متزامن أثناء دور مشارك آخر.
LeaveMatchDuringTheirTurnBlocking(Timeout timeout, const TurnBasedMatch & match)
إصدار الحظر من LeaveMatchDuringTheirTurn.
LeaveMatchDuringTheirTurnBlocking(const TurnBasedMatch & match)
الحمل الزائد LeaveMatchDuringTheirTurnBlocking، والذي يستخدم مهلة تلقائية تبلغ 10 سنوات.
Rematch(const TurnBasedMatch & match, TurnBasedMatchCallback callback)
void
لإعادة مطابقة مباراة تكون حالتها MatchStatus::COMPLETED
RematchBlocking(Timeout timeout, const TurnBasedMatch & match)
حظر الإصدار من إعادة المطابقة
RematchBlocking(const TurnBasedMatch & match)
التحميل الزائد RematchBlocking، الذي يستخدم مهلة تلقائية تبلغ 10 سنوات
ShowMatchInboxUI(MatchInboxUICallback callback)
void
يتم عرض واجهة المستخدم لصندوق الوارد أثناء المباراة بشكل غير متزامن، ما يتيح للّاعب اختيار مباراة أو دعوة.
ShowMatchInboxUIBlocking(Timeout timeout)
إصدار حظر من ShowMatchInboxUI
ShowMatchInboxUIBlocking()
التحميل الزائد 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)
إصدار حظر من ShowPlayerSelectUI
ShowPlayerSelectUIBlocking(uint32_t minimum_players, uint32_t maximum_players, bool allow_automatch)
التحميل الزائد للخيار 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)
إصدار الحظر من TakeMyTurn
TakeMyTurnBlocking(const TurnBasedMatch & match, std::vector< uint8_t > match_data, const ParticipantResults & results, const MultiplayerParticipant & next_participant)
الحمل الزائد TakeMyTurnBlocking، والذي يستخدم مهلة تلقائية تبلغ 10 سنوات.

الهياكل
gpg::TurnBasedMultiplayerManager::MatchInboxUIResponse

Data و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".

MultiplayerStatusCallback

std::function< void(MultiplayerStatus)> MultiplayerStatusCallback

تحدِّد معاودة الاتصال التي يمكن استخدامها لتلقّي حالة "متعدد اللاعبين".

تُستخدم بواسطة دالتي LetMatch و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

أحد المشاركين الذي يمكن تمريره إلى الأساليب التي تأخذ "المشارك التالي".

يؤدي هذا إلى اختيار الطريقة للمشارِك التالي عبر المطابقة التلقائية. يصلح فقط لتمرير kAutomatchingالمشارِك إلى دالة إذا كانت قيمة TurnBasedMatch::AutomatchingSlotsAvailable أعلى من 0 للمطابقة ذات الصلة.

الدوال العامة

AcceptInvitation

void AcceptInvitation(
  const MultiplayerInvitation & invitation,
  TurnBasedMatchCallback callback
)

تقبل MultiplayerInvitation بشكل غير متزامن، وتعرض النتيجة من خلال TurnBasedMatchCallback.

إذا نجحت العملية، ستكون حالة "TurnBasedMatch" التي يتم عرضها من خلال معاودة الاتصال بالحالة TurnBasedMatchState::MY_TURN.

AcceptInvitationBlocking

TurnBasedMatchResponse AcceptInvitationBlocking(
  Timeout timeout,
  const MultiplayerInvitation & invitation
)

إصدار الحظر من AcceptInvitation

للسماح للمتصل بتحديد المهلة بالملي ثانية. وبعد انقضاء الوقت المحدد، تعرض الدالة ERROR_TIMEOUT.

AcceptInvitationBlocking

TurnBasedMatchResponse AcceptInvitationBlocking(
  const MultiplayerInvitation & invitation
)

التحميل الزائد للرابط AcceptInvitationBlocking، والذي يستخدم مهلة افتراضية تبلغ 10 سنوات.

CancelMatch

void CancelMatch(
  const TurnBasedMatch & match,
  MultiplayerStatusCallback callback
)

إلغاء مباراة بشكل غير متزامن

تشير الحالة التي تظهر من خلال MultiplayerStatusCallback إلى ما إذا كانت العملية قد نجحت أم لا. يجب أن تكون حالة المطابقة المدعوون أو THEIR_TAG أو MY_TAG حتى تكون هذه الوظيفة قابلة للاستخدام.

CancelMatchBlocking

MultiplayerStatus CancelMatchBlocking(
  Timeout timeout,
  const TurnBasedMatch & match
)

إصدار الحظر من CancelMatch

للسماح للمتصل بتحديد المهلة بالملي ثانية. وبعد انقضاء الوقت المحدد، تعرض الدالة ERROR_TIMEOUT.

CancelMatchBlocking

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

للسماح للمتصل بتحديد المهلة بالملي ثانية. وبعد انقضاء الوقت المحدد، تعرض الدالة ERROR_TIMEOUT.

ConfirmPendingCompletionBlocking

TurnBasedMatchResponse ConfirmPendingCompletionBlocking(
  const TurnBasedMatch & match
)

التحميل الزائد للتوجيه ConfirmPendingCompletionBlocking، والذي يستخدم مهلة تلقائية تبلغ 10 سنوات.

CreateTurnBasedMatch

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

يتم إنشاء TurnBasedMatch بشكلٍ غير متزامن باستخدام TurnBasedMatchConfig المقدَّمة.

إذا تم الإنشاء بنجاح، تعرِض هذه الدالة TurnBasedMatch من خلال قيمة TurnBasedMatchCallback المقدَّمة. تبدأ سياسة TurnBasedMatch التي تم إنشاؤها حديثًا دائمًا بالحالة TurnBasedMatchState::MY_TURN.

CreateTurnBasedMatchBlocking

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

إصدار الحظر من CreateTurnBasedMatch.

للسماح للمتصل بتحديد المهلة بالملي ثانية. وبعد انقضاء الوقت المحدد، تعرض الدالة ERROR_TIMEOUT.

CreateTurnBasedMatchBlocking

TurnBasedMatchResponse CreateTurnBasedMatchBlocking(
  const gpg::TurnBasedMatchConfig & config
)

التحميل الزائد للدالة CreateTurnBasedMatchBlocking، والذي يستخدم مهلة تلقائية تبلغ 10 سنوات.

DeclineInvitation

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

للسماح للمتصل بتحديد المهلة بالملي ثانية. وبعد انقضاء الوقت المحدد، تعرض الدالة 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

للسماح للمتصل بتحديد المهلة بالملي ثانية. وبعد انقضاء الوقت المحدد، تعرض الدالة 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

للسماح للمتصل بتحديد المهلة بالملي ثانية. وبعد انقضاء الوقت المحدد، تعرض الدالة 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
المشارِك الذي يلي دوره. يمكن استخدام TurnBased MultiplayerManager::kAutomatching مِن لتحديد وجوب اختيار المشارك التالي من خلال ميزة المطابقة التلقائية.
callback
معاودة الاتصال التي تتلقّى TurnBasedMatchResponse

LeaveMatchDuringMyTurnBlocking

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

إصدار الحظر من LeaveMatchDuringMyTurn

للسماح للمتصل بتحديد المهلة بالملي ثانية. وبعد انقضاء الوقت المحدد، تعرض الدالة 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.

للسماح للمتصل بتحديد المهلة بالملي ثانية. وبعد انقضاء الوقت المحدد، تعرض الدالة 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
)

حظر الإصدار من إعادة المطابقة

للسماح للمتصل بتحديد المهلة بالملي ثانية. وبعد انقضاء الوقت المحدد، تعرض الدالة ERROR_TIMEOUT.

RematchBlocking

TurnBasedMatchResponse RematchBlocking(
  const TurnBasedMatch & match
)

التحميل الزائد RematchBlocking، الذي يستخدم مهلة تلقائية تبلغ 10 سنوات

ShowMatchInboxUI

void ShowMatchInboxUI(
  MatchInboxUICallback callback
)

يتم عرض واجهة المستخدم لصندوق الوارد أثناء المباراة بشكل غير متزامن، ما يتيح للّاعب اختيار مباراة أو دعوة.

بعد الانتهاء، يتم عرض المباراة أو الدعوة التي تم اختيارها من خلال MatchInboxUICallback.

ShowMatchInboxUIBlocking

MatchInboxUIResponse ShowMatchInboxUIBlocking(
  Timeout timeout
)

إصدار حظر من ShowMatchInboxUI

للسماح للمتصل بتحديد المهلة بالملي ثانية. وبعد انقضاء الوقت المحدد، تعرض الدالة 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

للسماح للمتصل بتحديد المهلة بالملي ثانية. وبعد انقضاء الوقت المحدد، تعرض الدالة ERROR_TIMEOUT.

ShowPlayerSelectUIBlocking

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

التحميل الزائد للخيار ShowPlayerSelectUIBlocking، الذي يستخدم مهلة تلقائية تبلغ 10 سنوات.

SynchronizeData

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
المشارِك الذي يلي دوره. يمكن استخدام TurnBased MultiplayerManager::kAutomatching مِن لتحديد وجوب اختيار المشارك التالي من خلال ميزة المطابقة التلقائية.
callback
معاودة الاتصال التي تتلقّى TurnBasedMatchResponse.

TakeMyTurnBlocking

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

إصدار الحظر من TakeMyTurn

للسماح للمتصل بتحديد المهلة بالملي ثانية. وبعد انقضاء الوقت المحدد، تعرض الدالة ERROR_TIMEOUT.

TakeMyTurnBlocking

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

الحمل الزائد TakeMyTurnBlocking، والذي يستخدم مهلة تلقائية تبلغ 10 سنوات.