gpg::TurnBasedMultiplayerManager

#include <turn_based_multiplayer_manager.h>

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

ملخّص

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

تحدد هذه السياسة معاودة اتصال يمكن استخدامها لتلقّي حالة MultiplayerStatus.

يتم استخدامه من خلال الدالتين 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 إلى ما إذا كانت العملية قد نجحت. يجب أن تكون حالة المطابقة INVITED أو THEIR_VALUE أو MY_VALUE لكي تكون هذه الدالة قابلة للاستخدام.

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
المشارك الذي يأتي دوره التالي. يمكن استخدام TurnBasedMultiplayerManager::kAutomatchingParticipant لتحديد أنه يجب اختيار المشارك التالي من خلال المطابقة التلقائية.
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
المشارك الذي يأتي دوره التالي. يمكن استخدام 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

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

TakeMyTurnBlocking

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

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