gpg:: TurnBasedMultiplayerManager
#include <turn_based_multiplayer_manager.h>
لجلب عناصر TurnBasedMatch
وتعديلها وإنشائها.
ملخّص
الأنواع العلنية |
|
---|---|
MatchInboxUICallback
|
typedefstd::function< void(const MatchInboxUIResponse &)>
تحدِّد هذه السياسة معاودة الاتصال التي يمكنها تلقّي MatchInboxUIResponse من "ShowMatchInboxUI ". |
MultiplayerStatusCallback
|
typedefstd::function< void(MultiplayerStatus)>
تحدِّد معاودة الاتصال التي يمكن استخدامها لتلقّي حالة "متعدد اللاعبين". |
PlayerSelectUICallback
|
typedefstd::function< void(const PlayerSelectUIResponse &)>
تحدِّد هذه السياسة معاودة الاتصال التي يمكنها تلقّي PlayerSelectUIResponse من "ShowPlayerSelectUI ". |
TurnBasedMatchCallback
|
typedefstd::function< void(const TurnBasedMatchResponse &)>
لتحديد معاودة الاتصال التي يمكن استخدامها لتلقي TurnBasedMatchResponse من إحدى عمليات اللاعبين المتعددين استنادًا إلى تناوب الأدوار. |
TurnBasedMatchesCallback
|
typedefstd::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
تحدِّد معاودة الاتصال التي يمكن استخدامها لتلقّي حالة "متعدد اللاعبين".
تُستخدم بواسطة دالتي 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
.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
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 سنوات.