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