gpg::RealTimeMultiplayerManager

#include <real_time_multiplayer_manager.h>

يجلب كائنات RealTimeRoom ويعدّلها ويعالجها وينشئها.

ملخّص

الأنواع العلنية
FetchInvitationsCallback typedef
std::function< void(const FetchInvitationsResponse &)>
لتحديد معاودة الاتصال التي يمكن استخدامها لتلقي WaitingRoomUIResponse من إحدى عمليات اللاعبين المتعددين في الوقت الفعلي.
LeaveRoomCallback typedef
std::function< void(const ResponseStatus &)>
تحدِّد هذه السياسة معاودة الاتصال التي يمكنها تلقّي ResponseStatus من "LeaveRoom".
PlayerSelectUICallback typedef
std::function< void(const PlayerSelectUIResponse &)>
تحدِّد هذه السياسة معاودة الاتصال التي يمكنها تلقّي PlayerSelectUIResponse من "ShowPlayerSelectUI".
PlayerSelectUIResponse typedef
Data وResponseStatus لعملية ShowPlayerSelectUI.
RealTimeRoomCallback typedef
std::function< void(const RealTimeRoomResponse &)>
تحدِّد هذه السياسة معاودة الاتصال التي يمكن استخدامها لتلقّي بنية RealTimeRoomResponse من إحدى عمليات اللاعبين المتعددين استنادًا إلى تناوب الأدوار.
RoomInboxUICallback typedef
std::function< void(const RoomInboxUIResponse &)>
تحدِّد هذه السياسة معاودة الاتصال التي يمكنها تلقّي RoomInboxUIResponse من "ShowRoomInboxUI".
SendReliableMessageCallback typedef
std::function< void(const MultiplayerStatus &)>
تحدِّد هذه السياسة معاودة الاتصال التي يمكنها تلقّي ResponseStatus من "SendReliableMessage".
WaitingRoomUICallback typedef
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
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::RealTimeMultiplayerManager::FetchInvitationsResponse

Data وResponseStatus لعملية FetchInvitations.

gpg::RealTimeMultiplayerManager::RealTimeRoomResponse

Data وResponseStatus لعنصر RealTimeRoom محدّد

gpg::RealTimeMultiplayerManager::RoomInboxUIResponse

Data وResponseStatus لعملية ShowRoomInboxUI.

gpg::RealTimeMultiplayerManager::WaitingRoomUIResponse

Data وResponseStatus لعملية ShowWaitingRoomUI.

الأنواع العلنية

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 سنوات