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
|
const MultiplayerParticipant
مشارك يمكن تمريره إلى الطرق التي تتخذ "التالي
مشارك".
|
وظائف عامة |
|
---|---|
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
رفض
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)
|
حظر إصدار 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:: |
|
gpg:: |
|
gpg:: |
|
gpg:: |
|
الأنواع العامة
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
.
التفاصيل | |||||
---|---|---|---|---|---|
المعلمات |
|
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.
.
التفاصيل | |||||||||
---|---|---|---|---|---|---|---|---|---|
المعلمات |
|
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
لكي تكون هذه الدالة قابلة للاستخدام.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المعلمات |
|
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
" المطابقة الجديدة.
التفاصيل | |||||
---|---|---|---|---|---|
المعلمات |
|
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
.
التفاصيل | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
المعلمات |
|
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 سنوات.