gpg:: RealTimeMultiplayerManager
#include <real_time_multiplayer_manager.h>
يجلب عناصر RealTimeRoom
ويعدّلها ويعالجها وينشئها.
ملخّص
الأنواع العامة |
|
---|---|
FetchInvitationsCallback
|
تعريف الكتابةstd::function< void(const FetchInvitationsResponse &)>
تحدد هذه السياسة معاودة الاتصال التي يمكن استخدامها لتلقّي WaitingRoomUIResponse من إحدى العمليات المتعددة اللاعبين في الوقت الفعلي. |
LeaveRoomCallback
|
تعريف الكتابةstd::function< void(const ResponseStatus &)>
تحدّد هذه السياسة معاودة اتصال يمكن أن تتلقّى ResponseStatus من LeaveRoom . |
PlayerSelectUICallback
|
تعريف الكتابةstd::function< void(const PlayerSelectUIResponse &)>
تحدّد هذه السياسة معاودة اتصال يمكن أن تتلقّى PlayerSelectUIResponse من ShowPlayerSelectUI . |
PlayerSelectUIResponse
|
تعريف الكتابةData وResponseStatus لعملية ShowPlayerSelectUI . |
RealTimeRoomCallback
|
تعريف الكتابةstd::function< void(const RealTimeRoomResponse &)>
تحدد هذه السياسة استدعاء يمكن استخدامه لتلقّي بنية RealTimeRoomResponse من إحدى عمليات اللاعبين المتعدّدين المستندة إلى تناوب الأدوار. |
RoomInboxUICallback
|
تعريف الكتابةstd::function< void(const RoomInboxUIResponse &)>
تحدّد هذه السياسة معاودة اتصال يمكن أن تتلقّى RoomInboxUIResponse من ShowRoomInboxUI . |
SendReliableMessageCallback
|
تعريف الكتابةstd::function< void(const MultiplayerStatus &)>
تحدّد هذه السياسة معاودة اتصال يمكن أن تتلقّى ResponseStatus من SendReliableMessage . |
WaitingRoomUICallback
|
تعريف الكتابةstd::function< void(const WaitingRoomUIResponse &)>
تحدد هذه السياسة معاودة الاتصال التي يمكن استخدامها لتلقّي WaitingRoomUIResponse من إحدى العمليات المتعددة اللاعبين في الوقت الفعلي. |
وظائف عامة |
|
---|---|
AcceptInvitation(const MultiplayerInvitation & invitation, IRealTimeEventListener *listener, RealTimeRoomCallback callback)
|
void
تقبل
MultiplayerInvitation بشكل غير متزامن، وتعرض النتيجة عبر RealTimeRoomCallback . |
AcceptInvitation(const MultiplayerInvitation & invitation, RealTimeEventListenerHelper helper, RealTimeRoomCallback callback)
|
void
تقبل
MultiplayerInvitation بشكل غير متزامن، وتعرض النتيجة عبر RealTimeRoomCallback . |
AcceptInvitationBlocking(Timeout timeout, const MultiplayerInvitation & invitation, IRealTimeEventListener *listener)
|
حظر إصدار AcceptInvitation
|
AcceptInvitationBlocking(const MultiplayerInvitation & invitation, IRealTimeEventListener *listener)
|
تحميل زائد لـ AcceptInvitationBlocking، تستخدم مهلة افتراضية تبلغ 10 سنوات.
|
AcceptInvitationBlocking(Timeout timeout, const MultiplayerInvitation & invitation, RealTimeEventListenerHelper helper)
|
حظر الإصدار من AcceptInvitation
|
AcceptInvitationBlocking(const MultiplayerInvitation & invitation, RealTimeEventListenerHelper helper)
|
التحميل الزائد لـ AcceptInvitationBlocking، الذي يستخدم مهلة افتراضية تبلغ 10 سنوات.
|
CreateRealTimeRoom(const gpg::RealTimeRoomConfig & config, IRealTimeEventListener *listener, RealTimeRoomCallback callback)
|
void
يتم إنشاء عنصر
RealTimeRoom بشكل غير متزامن باستخدام الفئة RealTimeRoomConfig المقدَّمة. |
CreateRealTimeRoom(const gpg::RealTimeRoomConfig & config, RealTimeEventListenerHelper helper, RealTimeRoomCallback callback)
|
void
يتم إنشاء عنصر
RealTimeRoom بشكل غير متزامن باستخدام الفئة RealTimeRoomConfig المقدَّمة. |
CreateRealTimeRoomBlocking(Timeout timeout, const RealTimeRoomConfig & config, IRealTimeEventListener *listener)
|
حظر إصدار CreateRealTimeRoom
|
CreateRealTimeRoomBlocking(const RealTimeRoomConfig & config, IRealTimeEventListener *listener)
|
التحميل الزائد على CreateRealTimeRoomBlocking، والذي يستخدم مهلة افتراضية تبلغ 10 سنوات.
|
CreateRealTimeRoomBlocking(Timeout timeout, const RealTimeRoomConfig & config, RealTimeEventListenerHelper helper)
|
حظر إصدار CreateRealTimeRoom
|
CreateRealTimeRoomBlocking(const RealTimeRoomConfig & config, RealTimeEventListenerHelper helper)
|
التحميل الزائد على CreateRealTimeRoomBlocking، والذي يستخدم مهلة افتراضية تبلغ 10 سنوات.
|
DeclineInvitation(const MultiplayerInvitation & invitation)
|
void
رفض
MultiplayerInvitation إلى RealTimeRoom |
DismissInvitation(const MultiplayerInvitation & invitation)
|
void
يؤدي هذا الإجراء إلى إزالة
MultiplayerInvitation إلى RealTimeRoom . |
FetchInvitations(FetchInvitationsCallback callback)
|
void
لجلب أي
MultiplayerInvitation للغرف في الوقت الفعلي. |
FetchInvitationsBlocking(Timeout timeout)
|
حظر إصدار FetchInvitations
|
FetchInvitationsBlocking()
|
تحميل زائد لـ FetchInvitationsBlocking ، والذي يستخدم مهلة افتراضية تبلغ 10 سنوات.
|
LeaveRoom(const RealTimeRoom & room, LeaveRoomCallback callback)
|
void
تتم مغادرة
RealTimeRoom . |
LeaveRoomBlocking(Timeout timeout, const RealTimeRoom & room)
|
حظر الإصدار من LeaveRoom
|
LeaveRoomBlocking(const RealTimeRoom & room)
|
التحميل الزائد للدالة LeaveRoomBlocking، التي تستخدم مهلة تلقائية مدتها 10 سنوات
|
SendReliableMessage(const RealTimeRoom & room, const MultiplayerParticipant & participant, std::vector< uint8_t > data, SendReliableMessageCallback callback)
|
void
يؤدي هذا الخيار إلى إرسال رسالة إلى جهة الاتصال
MultiplayerParticipant المحدّدة. |
SendReliableMessageBlocking(Timeout timeout, const RealTimeRoom & room, const MultiplayerParticipant & participant, std::vector< uint8_t > data)
|
حظر إصدار SendReliableMessage
|
SendReliableMessageBlocking(const RealTimeRoom & room, const MultiplayerParticipant & participant, std::vector< uint8_t > data)
|
تحميل زائد لـ SendReliableMessageBlocking، الذي يستخدم مهلة تلقائية تبلغ 10 سنوات.
|
SendUnreliableMessage(const RealTimeRoom & room, const std::vector< MultiplayerParticipant > & participants, std::vector< uint8_t > data)
|
void
يؤدي هذا الخيار إلى إرسال رسالة إلى أجهزة
MultiplayerParticipant المحدّدة. |
SendUnreliableMessageToOthers(const RealTimeRoom & room, std::vector< uint8_t > data)
|
void
لإرسال رسالة إلى جميع المشاركين باستثناء المستخدم الحالي
|
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 سنوات.
|
ShowRoomInboxUI(RoomInboxUICallback callback)
|
void
تعرض واجهة المستخدم في البريد الوارد للغرفة بشكل غير متزامن، ما يسمح للّاعب باختيار دعوة الانضمام إلى لاعبين متعددين.
|
ShowRoomInboxUIBlocking(Timeout timeout)
|
حظر إصدار ShowRoomInboxUI
|
ShowRoomInboxUIBlocking()
|
التحميل الزائد للعنصر ShowRoomInboxUIBlocking، والذي يستخدم مهلة تلقائية مدتها 10 سنوات
|
ShowWaitingRoomUI(const RealTimeRoom & room, uint32_t min_participants_to_start, WaitingRoomUICallback callback)
|
void
تعرِض واجهة المستخدم لغرفة الانتظار التي تعرض حالة "المشارِكون المتعددون" الذين ينضمون إلى هذه الغرفة.
|
ShowWaitingRoomUIBlocking(Timeout timeout, const RealTimeRoom & room, uint32_t min_participants_to_start)
|
حظر إصدار ShowWaitingRoomUI
|
ShowWaitingRoomUIBlocking(const RealTimeRoom & room, uint32_t min_participants_to_start)
|
التحميل الزائد لـ ShowWaitingRoomUIBlocking، حيث يتم استخدام مهلة افتراضية تبلغ 10 سنوات.
|
بُنى |
|
---|---|
gpg:: |
|
gpg:: |
|
gpg:: |
|
gpg:: |
|
الأنواع العامة
FetchInvitationsCallback
std::function< void(const FetchInvitationsResponse &)> FetchInvitationsCallback
تحدد هذه السياسة معاودة الاتصال التي يمكن استخدامها لتلقّي WaitingRoomUIResponse
من إحدى العمليات المتعددة اللاعبين في الوقت الفعلي.
LeaveRoomCallback
std::function< void(const ResponseStatus &)> LeaveRoomCallback
تحدّد هذه السياسة معاودة اتصال يمكن أن تتلقّى ResponseStatus
من LeaveRoom
.
PlayerSelectUICallback
std::function< void(const PlayerSelectUIResponse &)> PlayerSelectUICallback
تحدّد هذه السياسة معاودة اتصال يمكن أن تتلقّى PlayerSelectUIResponse
من ShowPlayerSelectUI
.
PlayerSelectUIResponse
TurnBasedMultiplayerManager::PlayerSelectUIResponse PlayerSelectUIResponse
Data
وResponseStatus
لعملية ShowPlayerSelectUI
.
تتم مشاركة هذه المعلومات مع اللاعبين المتعددين الذين يعتمدون على تناوب الأدوار.
RealTimeRoomCallback
std::function< void(const RealTimeRoomResponse &)> RealTimeRoomCallback
تحدد هذه السياسة استدعاء يمكن استخدامه لتلقّي بنية RealTimeRoomResponse
من إحدى عمليات اللاعبين المتعدّدين المستندة إلى تناوب الأدوار.
RoomInboxUICallback
std::function< void(const RoomInboxUIResponse &)> RoomInboxUICallback
تحدّد هذه السياسة معاودة اتصال يمكن أن تتلقّى RoomInboxUIResponse
من ShowRoomInboxUI
.
SendReliableMessageCallback
std::function< void(const MultiplayerStatus &)> SendReliableMessageCallback
تحدّد هذه السياسة معاودة اتصال يمكن أن تتلقّى ResponseStatus
من SendReliableMessage
.
WaitingRoomUICallback
std::function< void(const WaitingRoomUIResponse &)> WaitingRoomUICallback
تحدد هذه السياسة معاودة الاتصال التي يمكن استخدامها لتلقّي WaitingRoomUIResponse
من إحدى العمليات المتعددة اللاعبين في الوقت الفعلي.
وظائف عامة
AcceptInvitation
void AcceptInvitation( const MultiplayerInvitation & invitation, IRealTimeEventListener *listener, RealTimeRoomCallback callback )
تقبل MultiplayerInvitation
بشكل غير متزامن، وتعرض النتيجة عبر RealTimeRoomCallback
.
AcceptInvitation
void AcceptInvitation( const MultiplayerInvitation & invitation, RealTimeEventListenerHelper helper, RealTimeRoomCallback callback )
تقبل MultiplayerInvitation
بشكل غير متزامن، وتعرض النتيجة عبر RealTimeRoomCallback
.
AcceptInvitationBlocking
RealTimeRoomResponse AcceptInvitationBlocking( Timeout timeout, const MultiplayerInvitation & invitation, IRealTimeEventListener *listener )
حظر إصدار AcceptInvitation
السماح للمتصل بتحديد مهلة بالمللي ثانية. بعد انقضاء الوقت المحدد، تعرض الدالة ERROR_TIMEOUT
.
AcceptInvitationBlocking
RealTimeRoomResponse AcceptInvitationBlocking( const MultiplayerInvitation & invitation, IRealTimeEventListener *listener )
تحميل زائد لـ AcceptInvitationBlocking، تستخدم مهلة افتراضية تبلغ 10 سنوات.
AcceptInvitationBlocking
RealTimeRoomResponse AcceptInvitationBlocking( Timeout timeout, const MultiplayerInvitation & invitation, RealTimeEventListenerHelper helper )
حظر الإصدار من AcceptInvitation
السماح للمتصل بتحديد مهلة بالمللي ثانية. بعد انقضاء الوقت المحدد، تعرض الدالة ERROR_TIMEOUT
.
AcceptInvitationBlocking
RealTimeRoomResponse AcceptInvitationBlocking( const MultiplayerInvitation & invitation, RealTimeEventListenerHelper helper )
تحميل زائد لـ AcceptInvitationBlocking، تستخدم مهلة افتراضية تبلغ 10 سنوات.
CreateRealTimeRoom
void CreateRealTimeRoom( const gpg::RealTimeRoomConfig & config, IRealTimeEventListener *listener, RealTimeRoomCallback callback )
يتم إنشاء عنصر RealTimeRoom
بشكل غير متزامن باستخدام الفئة RealTimeRoomConfig
المقدَّمة.
إذا تم الإنشاء بنجاح، ستعرض هذه الدالة الكائن RealTimeRoom
من خلال RealTimeRoomCallback
المقدَّم.
CreateRealTimeRoom
void CreateRealTimeRoom( const gpg::RealTimeRoomConfig & config, RealTimeEventListenerHelper helper, RealTimeRoomCallback callback )
يتم إنشاء عنصر RealTimeRoom
بشكل غير متزامن باستخدام الفئة RealTimeRoomConfig
المقدَّمة.
إذا تم الإنشاء بنجاح، ستعرض هذه الدالة الكائن RealTimeRoom
من خلال RealTimeRoomCallback
المقدَّم.
CreateRealTimeRoomBlocking
RealTimeRoomResponse CreateRealTimeRoomBlocking( Timeout timeout, const RealTimeRoomConfig & config, IRealTimeEventListener *listener )
حظر إصدار CreateRealTimeRoom
السماح للمتصل بتحديد مهلة بالمللي ثانية. بعد انقضاء الوقت المحدد، تعرض الدالة ERROR_TIMEOUT
.
CreateRealTimeRoomBlocking
RealTimeRoomResponse CreateRealTimeRoomBlocking( const RealTimeRoomConfig & config, IRealTimeEventListener *listener )
التحميل الزائد على CreateRealTimeRoomBlocking، والذي يستخدم مهلة افتراضية تبلغ 10 سنوات.
CreateRealTimeRoomBlocking
RealTimeRoomResponse CreateRealTimeRoomBlocking( Timeout timeout, const RealTimeRoomConfig & config, RealTimeEventListenerHelper helper )
حظر إصدار CreateRealTimeRoom
السماح للمتصل بتحديد مهلة بالمللي ثانية. بعد انقضاء الوقت المحدد، تعرض الدالة ERROR_TIMEOUT
.
CreateRealTimeRoomBlocking
RealTimeRoomResponse CreateRealTimeRoomBlocking( const RealTimeRoomConfig & config, RealTimeEventListenerHelper helper )
التحميل الزائد على CreateRealTimeRoomBlocking، والذي يستخدم مهلة افتراضية تبلغ 10 سنوات.
DeclineInvitation
void DeclineInvitation( const MultiplayerInvitation & invitation )
رفض MultiplayerInvitation
إلى RealTimeRoom
يؤدي ذلك إلى إلغاء الغرفة الخاصة بالمشاركين الآخرين وإزالة الغرفة من جهاز المشغّل المحلي.
DismissInvitation
void DismissInvitation( const MultiplayerInvitation & invitation )
يؤدي هذا الإجراء إلى إزالة MultiplayerInvitation
إلى RealTimeRoom
.
لا يؤدي ذلك إلى تغيير الحالة المرئية لـ RealTimeRoom
للمشاركين الآخرين، ولكن ستتم إزالته من جهاز المشغّل المحلي.
FetchInvitations
void FetchInvitations( FetchInvitationsCallback callback )
لجلب أي MultiplayerInvitation
للغرف في الوقت الفعلي.
يتم إرجاع MultiplayerInvitation
التي تم استرجاعها من خلال FetchInvitationsCallback
المقدَّم.
FetchInvitationsBlocking
FetchInvitationsResponse FetchInvitationsBlocking( Timeout timeout )
حظر إصدار FetchInvitations
السماح للمتصل بتحديد مهلة بالمللي ثانية. بعد انقضاء الوقت المحدّد، ستعرض الدالة ERROR_TIMEOUT
.
FetchInvitationsBlocking
FetchInvitationsResponse FetchInvitationsBlocking()
تحميل زائد لـ FetchInvitationsBlocking ، والذي يستخدم مهلة افتراضية تبلغ 10 سنوات.
LeaveRoom
void LeaveRoom( const RealTimeRoom & room, LeaveRoomCallback callback )
تتم مغادرة RealTimeRoom
.
يجب عدم إنشاء غرفة جديدة أو محاولة الانضمام إلى غرفة أخرى إلى أن تكتمل هذه العملية. يتم عرض نتيجة هذه العملية عبر LeaveRoomCallback
.
LeaveRoomBlocking
ResponseStatus LeaveRoomBlocking( Timeout timeout, const RealTimeRoom & room )
حظر الإصدار من LeaveRoom
السماح للمتصل بتحديد مهلة بالمللي ثانية. بعد انقضاء الوقت المحدد، تعرض الدالة ERROR_TIMEOUT
.
LeaveRoomBlocking
ResponseStatus LeaveRoomBlocking( const RealTimeRoom & room )
التحميل الزائد للدالة LeaveRoomBlocking، التي تستخدم مهلة تلقائية مدتها 10 سنوات
SendReliableMessage
void SendReliableMessage( const RealTimeRoom & room, const MultiplayerParticipant & participant, std::vector< uint8_t > data, SendReliableMessageCallback callback )
يؤدي هذا الخيار إلى إرسال رسالة إلى جهة الاتصال MultiplayerParticipant
المحدّدة.
يستخدم طريقة موثوقة لإرسال الرسالة. قد تستغرق طريقة إرسال البيانات هذه وقتًا أطول من إرسال رسالة بشكل غير موثوق. ويتم الإبلاغ عن نتيجة الإرسال من خلال ميزة معاودة الاتصال المقدَّمة.
SendReliableMessageBlocking
MultiplayerStatus SendReliableMessageBlocking( Timeout timeout, const RealTimeRoom & room, const MultiplayerParticipant & participant, std::vector< uint8_t > data )
حظر إصدار SendReliableMessage
السماح للمتصل بتحديد مهلة بالمللي ثانية. بعد انقضاء الوقت المحدد، تعرض الدالة ERROR_TIMEOUT
.
SendReliableMessageBlocking
MultiplayerStatus SendReliableMessageBlocking( const RealTimeRoom & room, const MultiplayerParticipant & participant, std::vector< uint8_t > data )
تحميل زائد لـ SendReliableMessageBlocking، الذي يستخدم مهلة تلقائية تبلغ 10 سنوات.
SendUnreliableMessage
void SendUnreliableMessage( const RealTimeRoom & room, const std::vector< MultiplayerParticipant > & participants, std::vector< uint8_t > data )
يؤدي هذا الخيار إلى إرسال رسالة إلى أجهزة MultiplayerParticipant
المحدّدة.
يستخدم طريقة غير موثوقة لإرسال الرسالة. إنّ طريقة إرسال البيانات هذه أسرع من إرسال البيانات بشكل موثوق، ويجب تفضيلها إن أمكن.
SendUnreliableMessageToOthers
void SendUnreliableMessageToOthers( const RealTimeRoom & room, std::vector< uint8_t > data )
لإرسال رسالة إلى جميع المشاركين باستثناء المستخدم الحالي
يستخدم طريقة غير موثوقة لإرسال الرسالة. إنّ طريقة إرسال البيانات هذه أسرع من إرسال البيانات بشكل موثوق، ويجب تفضيلها إن أمكن.
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 سنوات.
ShowRoomInboxUI
void ShowRoomInboxUI( RoomInboxUICallback callback )
تعرض واجهة المستخدم في البريد الوارد للغرفة بشكل غير متزامن، ما يسمح للّاعب باختيار دعوة الانضمام إلى لاعبين متعددين.
بعد الانتهاء، سيتم إرجاع الدعوة التي تم اختيارها عبر RoomInboxUIResponse
.
ShowRoomInboxUIBlocking
RoomInboxUIResponse ShowRoomInboxUIBlocking( Timeout timeout )
حظر إصدار ShowRoomInboxUI
السماح للمتصل بتحديد مهلة بالمللي ثانية. بعد انقضاء الوقت المحدد، تعرض الدالة ERROR_TIMEOUT
.
ShowRoomInboxUIBlocking
RoomInboxUIResponse ShowRoomInboxUIBlocking()
التحميل الزائد للعنصر ShowRoomInboxUIBlocking، والذي يستخدم مهلة تلقائية مدتها 10 سنوات
ShowWaitingRoomUI
void ShowWaitingRoomUI( const RealTimeRoom & room, uint32_t min_participants_to_start, WaitingRoomUICallback callback )
تعرِض واجهة المستخدم لغرفة الانتظار التي تعرض حالة "المشارِكون المتعددون" الذين ينضمون إلى هذه الغرفة.
ShowWaitingRoomUIBlocking
WaitingRoomUIResponse ShowWaitingRoomUIBlocking( Timeout timeout, const RealTimeRoom & room, uint32_t min_participants_to_start )
حظر إصدار ShowWaitingRoomUI
السماح للمتصل بتحديد مهلة بالمللي ثانية. بعد انقضاء الوقت المحدّد، ستعرض الدالة ERROR_TIMEOUT
.
ShowWaitingRoomUIBlocking
WaitingRoomUIResponse ShowWaitingRoomUIBlocking( const RealTimeRoom & room, uint32_t min_participants_to_start )
التحميل الزائد لـ ShowWaitingRoomUIBlocking، حيث يتم استخدام مهلة افتراضية تبلغ 10 سنوات.