gpg::PlayerManager

#include <player_manager.h>

الحصول على العديد من البيانات المتعلقة باللاعبين وتعيينها.

ملخّص

الأنواع العلنية
FetchCallback typedef
std::function< void(const FetchResponse &)>
تحدد نوع معاودة الاتصال الذي يتلقى FetchResponse.
FetchListCallback typedef
std::function< void(const FetchListResponse &)>
تحدد نوع معاودة الاتصال الذي يتلقى FetchListResponse.
FetchSelfCallback typedef
std::function< void(const FetchSelfResponse &)>
تحدِّد هذه السمة نوع معاودة الاتصال الذي يتلقّى FetchSelfResponse.

الدوال العامة
Fetch(const std::string & player_id, FetchCallback callback)
void
تحميل كل البيانات الخاصة بمشغل معين بشكل غير متزامن.
Fetch(DataSource data_source, const std::string & player_id, FetchCallback callback)
void
تحميل كل البيانات الخاصة بمشغل معين بشكل غير متزامن.
FetchBlocking(const std::string & player_id)
يتم تحميل كل البيانات بشكل متزامن لمشغِّل معين، ما يؤدي مباشرةً إلى عرض FetchResponse.
FetchBlocking(DataSource data_source, const std::string & player_id)
يتم تحميل كل البيانات بشكل متزامن لمشغِّل معين، ما يؤدي مباشرةً إلى عرض FetchResponse.
FetchBlocking(Timeout timeout, const std::string & player_id)
يتم تحميل كل البيانات بشكل متزامن لمشغِّل معين، ما يؤدي مباشرةً إلى عرض FetchResponse.
FetchBlocking(DataSource data_source, Timeout timeout, const std::string & player_id)
تحميل كل البيانات الخاصة بمشغّل معيّن بشكل متزامن مع عرض FetchResponse مباشرةً
FetchConnected(DataSource data_source, FetchListCallback callback)
void
تمت إزالة هذا العمود.
يتم تحميل بيانات جميع اللاعبين بشكل غير متزامن والذين لديهم إذن بمعرفتهم باللعبة الحالية، والذين لديهم إذن بمعرفتها.
FetchConnected(FetchListCallback callback)
void
تمت إزالة هذا العمود.
تحميل زائد من FetchConnected الذي يستخدم مصدر بيانات تلقائي لـ CACHE_OR_NETWORK.
FetchConnectedBlocking(DataSource data_Source, Timeout timeout) تمت إزالة هذا العمود.
إصدار محظور من FetchConnected
FetchConnectedBlocking(DataSource data_source) تمت إزالة هذا العمود.
تحميل زائد من FetchConnectedBlocking الذي يستخدم مهلة تلقائية تبلغ 10 سنوات.
FetchConnectedBlocking(Timeout timeout) تمت إزالة هذا العمود.
تحميل زائد من FetchConnectedBlocking الذي يستخدم مصدر بيانات تلقائي لـ CACHE_OR_NETWORK.
FetchConnectedBlocking() تمت إزالة هذا العمود.
تحميل زائد من FetchConnectedBlocking التي تستخدم مصدر بيانات افتراضي لـ CACHE_OR_NETWORK ومهلة افتراضية تبلغ 10 سنوات.
FetchInvitable(DataSource data_source, FetchListCallback callback)
void
تمت إزالة هذا العمود.
تحميل كل اللاعبين في دوائرهم بشكل غير متزامن (ويمكنه تلقي دعوات من اللاعب المحلي).
FetchInvitable(FetchListCallback callback)
void
تمت إزالة هذا العمود.
تحميل زائد من FetchInvitable يستخدم مصدر بيانات تلقائي لـ CACHE_OR_NETWORK.
FetchInvitableBlocking(DataSource data_source, Timeout timeout) تمت إزالة هذا العمود.
حظر إصدار FetchInvitable
FetchInvitableBlocking(DataSource data_source) تمت إزالة هذا العمود.
زيادة الحمل على أداة FetchInvitableBlocking التي تستخدم مهلة تلقائية تبلغ 10 سنوات.
FetchInvitableBlocking(Timeout timeout) تمت إزالة هذا العمود.
تحميل زائد من FetchInvitableBlocking الذي يستخدم مصدر بيانات تلقائي لـ CACHE_OR_NETWORK.
FetchInvitableBlocking() تمت إزالة هذا العمود.
زيادة الحمل على دالة FetchInvitableBlocking التي تستخدم مصدر بيانات تلقائي من نوع CACHE_OR_NETWORK ومهلة تلقائية تبلغ 10 سنوات.
FetchRecentlyPlayed(DataSource data_source, FetchListCallback callback)
void
يتم تحميل كل المشغلات التي تم تشغيلها مؤخرًا بشكل غير متزامن.
FetchRecentlyPlayed(FetchListCallback callback)
void
تحميل زائد من FetchRecentlyPlayed الذي يستخدم مصدر بيانات تلقائي لـ CACHE_OR_NETWORK.
FetchRecentlyPlayedBlocking(DataSource data_source, Timeout timeout)
إصدار محظور من FetchRecentlyPlayed
FetchRecentlyPlayedBlocking(DataSource data_source)
تحميل زائد من FetchRecentlyPlayedBlocking الذي يستخدم مهلة افتراضية تبلغ 10 سنوات.
FetchRecentlyPlayedBlocking(Timeout timeout)
تحميل زائد من FetchRecentlyPlayedBlocking الذي يستخدم مصدر بيانات افتراضيًا لـ CACHE_OR_NETWORK.
FetchRecentlyPlayedBlocking()
تحميل زائد من FetchRecentlyPlayedBlocking الذي يستخدم مصدر بيانات تلقائي لـ CACHE_OR_NETWORK ومهلة افتراضية تبلغ 10 سنوات.
FetchSelf(FetchSelfCallback callback)
void
تحميل كل البيانات الخاصة بكل المشغّلات التي سجّلت الدخول إليها حاليًا بشكل غير متزامن
FetchSelf(DataSource data_source, FetchSelfCallback callback)
void
تحميل كل البيانات الخاصة بكل المشغّلات التي سجّلت الدخول إليها حاليًا بشكل غير متزامن
FetchSelfBlocking()
تحميل كل البيانات بشكل متزامن لكل المشغلات المسجّلة الدخول حاليًا، مع عرض FetchSelfResponse مباشرةً
FetchSelfBlocking(DataSource data_source)
تحميل كل البيانات بشكل متزامن لكل المشغلات المسجّلة الدخول حاليًا، مع عرض FetchSelfResponse مباشرةً
FetchSelfBlocking(Timeout timeout)
تحميل كل البيانات بشكل متزامن لكل المشغلات المسجّلة الدخول حاليًا، مع عرض FetchSelfResponse مباشرةً
FetchSelfBlocking(DataSource data_source, Timeout timeout)
تحميل كل البيانات بشكل متزامن لكل المشغلات المسجّلة الدخول حاليًا، مع عرض FetchSelfResponse مباشرةً

الهياكل
gpg::PlayerManager::FetchListResponse

تمثّل هذه السمة استجابة تحتوي على متجه لعدد اللاعبين.

gpg::PlayerManager::FetchResponse

data وResponseStatus لمشغّل محدّد

gpg::PlayerManager::FetchSelfResponse

يحتفظ بجميع بيانات اللاعب، إلى جانب حالة الاستجابة.

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

FetchCallback

std::function< void(const FetchResponse &)> FetchCallback

تحدد نوع معاودة الاتصال الذي يتلقى FetchResponse.

يتوفّر هذا النوع من معاودة الاتصال لدوال Fetch(*) أدناه.

FetchListCallback

std::function< void(const FetchListResponse &)> FetchListCallback

تحدد نوع معاودة الاتصال الذي يتلقى FetchListResponse.

يتوفّر هذا النوع من معاودة الاتصال لدوال Fetch(*) أدناه.

FetchSelfCallback

std::function< void(const FetchSelfResponse &)> FetchSelfCallback

تحدِّد هذه السمة نوع معاودة الاتصال الذي يتلقّى FetchSelfResponse.

يتوفّر هذا النوع من معاودة الاتصال لدوال FetchSelf(*) أدناه.

الدوال العامة

استدعاء

void Fetch(
  const std::string & player_id,
  FetchCallback callback
)

تحميل كل البيانات الخاصة بمشغل معين بشكل غير متزامن.

يتم استدعاء استدعاء FetchCallback المقدّم عند اكتمال العملية. يؤدي عدم تحديد data_source إلى جعل استدعاء الدالة هذا مكافئًا لاستدعاء Fetch(DataSource data_source, const std::string& player_id, FetchCallback callback)، مع تحديد data_source على أنه CACHE_OR_NETWORK.

استدعاء

void Fetch(
  DataSource data_source,
  const std::string & player_id,
  FetchCallback callback
)

تحميل كل البيانات الخاصة بمشغل معين بشكل غير متزامن.

يتم استدعاء استدعاء FetchCallback المقدّم عند اكتمال العملية. حدد data_source على أنه CACHE_OR_NETWORK أو NETWORK_ONLY.

FetchBlocking

FetchResponse FetchBlocking(
  const std::string & player_id
)

يتم تحميل كل البيانات بشكل متزامن لمشغِّل معين، ما يؤدي مباشرةً إلى عرض FetchResponse.

في حال عدم تحديد مصدر data_source أو انتهاء مهلة، يصبح استدعاء الدالة هذه مكافئًا لاستدعاء FetchResponse FetchBlocked(DataSource data_source, المهلة الزمنية)، مع تحديد DataSource على هيئة CACHE_OR_NETWORK، والمهلة المحدّدة على أنّها 10 سنوات.

FetchBlocking

FetchResponse FetchBlocking(
  DataSource data_source,
  const std::string & player_id
)

يتم تحميل كل البيانات بشكل متزامن لمشغِّل معين، ما يؤدي مباشرةً إلى عرض FetchResponse.

حدد data_source على أنه CACHE_OR_NETWORK أو NETWORK_ONLY. إن ترك المهلة بدون تحديد يجعل استدعاء الدالة هذا مكافئًا لاستدعاء FetchResponse FetchBlock(DataSource data_source, Timeout(Timeout)) في قيمة data_source المحددة، وضبط المهلة على 10 سنوات.

FetchBlocking

FetchResponse FetchBlocking(
  Timeout timeout,
  const std::string & player_id
)

يتم تحميل كل البيانات بشكل متزامن لمشغِّل معين، ما يؤدي مباشرةً إلى عرض FetchResponse.

حدد المهلة كعدد عشوائي من المللي ثانية. ويؤدي ترك data_source بدون تحديد إلى أن يكون استدعاء الدالة هذا معادلاً لاستدعاء FetchResponse FetchBlock(DataSource data_source, Timeout(Timeout)) ، مع تحديد data_source على أنّه CACHE_OR_NETWORK وانتهاء المهلة، مع تضمين القيمة المحدَّدة.

FetchBlocking

FetchResponse FetchBlocking(
  DataSource data_source,
  Timeout timeout,
  const std::string & player_id
)

تحميل كل البيانات الخاصة بمشغّل معيّن بشكل متزامن مع عرض FetchResponse مباشرةً

حدد data_source على أنه CACHE_OR_NETWORK أو NETWORK_ONLY. حدد المهلة كعدد عشوائي من المللي ثانية.

FetchConnected

void FetchConnected(
  DataSource data_source,
  FetchListCallback callback
)

يتم تحميل بيانات جميع اللاعبين بشكل غير متزامن والذين لديهم إذن بمعرفتهم باللعبة الحالية، والذين لديهم إذن بمعرفتها.

يتم استدعاء استدعاء FetchCallback المقدّم عند اكتمال العملية. حدد data_source على أنه CACHE_OR_NETWORK أو NETWORK_ONLY.

تجدر الإشارة إلى أنّ هذه الدالة قد تعرض كائنات Player حيث تعرض Player.HasLevelInfo false. وفي مثل هذه الحالات، يمكن استرداد معلومات المستوى من خلال طلب إعادة الطلب من المشغّل المحدّد عبر واجهة برمجة تطبيقات Fetch. تمت إزالة هذا العمود.

FetchConnected

void FetchConnected(
  FetchListCallback callback
)

تحميل زائد من FetchConnected الذي يستخدم مصدر بيانات تلقائي لـ CACHE_OR_NETWORK.

تمت إزالة هذا العمود.

FetchConnectedBlocking

FetchListResponse FetchConnectedBlocking(
  DataSource data_Source,
  Timeout timeout
)

إصدار محظور من FetchConnected

للسماح للمتصل بتحديد المهلة بالملي ثانية. وبعد انقضاء الوقت المحدد، تعرض الدالة ERROR_TIMEOUT. تجدر الإشارة إلى أنّه لا يمكن استدعاء إصدار الحظر هذا على نظام التشغيل iOS من سلسلة محادثات واجهة المستخدم، لأنّ خدمة الإضافة الأساسية التي توفّر البيانات يجب أن تعمل على سلسلة محادثات واجهة المستخدم. تمت إزالة هذا العمود.

FetchConnectedBlocking

FetchListResponse FetchConnectedBlocking(
  DataSource data_source
)

تحميل زائد من FetchConnectedBlocking الذي يستخدم مهلة تلقائية تبلغ 10 سنوات.

تمت إزالة هذا العمود.

FetchConnectedBlocking

FetchListResponse FetchConnectedBlocking(
  Timeout timeout
)

تحميل زائد من FetchConnectedBlocking الذي يستخدم مصدر بيانات تلقائي لـ CACHE_OR_NETWORK.

تمت إزالة هذا العمود.

FetchConnectedBlocking

FetchListResponse FetchConnectedBlocking()

تحميل زائد من FetchConnectedBlocking التي تستخدم مصدر بيانات افتراضي لـ CACHE_OR_NETWORK ومهلة افتراضية تبلغ 10 سنوات.

تمت إزالة هذا العمود.

FetchInvitable

void FetchInvitable(
  DataSource data_source,
  FetchListCallback callback
)

تحميل كل اللاعبين في دوائرهم بشكل غير متزامن (ويمكنه تلقي دعوات من اللاعب المحلي).

تجدر الإشارة إلى أنّه إذا لم يتصل أحد اللاعبين باللعبة الحالية، قد لا يتلقّى أي إشعار بأنّه تمّت دعوته.

يتم استدعاء استدعاء FetchCallback المقدّم عند اكتمال العملية. حدد data_source على أنه CACHE_OR_NETWORK أو NETWORK_ONLY.

تجدر الإشارة إلى أنّ هذه الدالة قد تعرض كائنات Player حيث تعرض Player.HasLevelInfo false. وفي مثل هذه الحالات، يمكن استرداد معلومات المستوى من خلال طلب إعادة الطلب من المشغّل المحدّد عبر واجهة برمجة تطبيقات Fetch. تمت إزالة هذا العمود.

FetchInvitable

void FetchInvitable(
  FetchListCallback callback
)

تحميل زائد من FetchInvitable يستخدم مصدر بيانات تلقائي لـ CACHE_OR_NETWORK.

تمت إزالة هذا العمود.

FetchInvitableBlocking

FetchListResponse FetchInvitableBlocking(
  DataSource data_source,
  Timeout timeout
)

حظر إصدار FetchInvitable

للسماح للمتصل بتحديد المهلة بالملي ثانية. وبعد انقضاء الوقت المحدد، تعرض الدالة ERROR_TIMEOUT. تجدر الإشارة إلى أنّه لا يمكن استدعاء إصدار الحظر هذا على نظام التشغيل iOS من سلسلة محادثات واجهة المستخدم، لأنّ خدمة الإضافة الأساسية التي توفّر البيانات يجب أن تعمل على سلسلة محادثات واجهة المستخدم. تمت إزالة هذا العمود.

FetchInvitableBlocking

FetchListResponse FetchInvitableBlocking(
  DataSource data_source
)

زيادة الحمل على أداة FetchInvitableBlocking التي تستخدم مهلة تلقائية تبلغ 10 سنوات.

تمت إزالة هذا العمود.

FetchInvitableBlocking

FetchListResponse FetchInvitableBlocking(
  Timeout timeout
)

تحميل زائد من FetchInvitableBlocking الذي يستخدم مصدر بيانات تلقائي لـ CACHE_OR_NETWORK.

تمت إزالة هذا العمود.

FetchInvitableBlocking

FetchListResponse FetchInvitableBlocking()

زيادة الحمل على دالة FetchInvitableBlocking التي تستخدم مصدر بيانات تلقائي من نوع CACHE_OR_NETWORK ومهلة تلقائية تبلغ 10 سنوات.

تمت إزالة هذا العمود.

FetchRecentlyPlayed

void FetchRecentlyPlayed(
  DataSource data_source,
  FetchListCallback callback
)

يتم تحميل كل المشغلات التي تم تشغيلها مؤخرًا بشكل غير متزامن.

يتم استدعاء استدعاء FetchCallback المقدّم عند اكتمال العملية. حدد data_source على أنه CACHE_OR_NETWORK أو NETWORK_ONLY.

FetchRecentlyPlayed

void FetchRecentlyPlayed(
  FetchListCallback callback
)

تحميل زائد من FetchRecentlyPlayed الذي يستخدم مصدر بيانات تلقائي لـ CACHE_OR_NETWORK.

FetchRecentlyPlayedBlocking

FetchListResponse FetchRecentlyPlayedBlocking(
  DataSource data_source,
  Timeout timeout
)

إصدار محظور من FetchRecentlyPlayed

للسماح للمتصل بتحديد المهلة بالملي ثانية. وبعد انقضاء الوقت المحدد، تعرض الدالة ERROR_TIMEOUT.

FetchRecentlyPlayedBlocking

FetchListResponse FetchRecentlyPlayedBlocking(
  DataSource data_source
)

تحميل زائد من FetchRecentlyPlayedBlocking الذي يستخدم مهلة افتراضية تبلغ 10 سنوات.

FetchRecentlyPlayedBlocking

FetchListResponse FetchRecentlyPlayedBlocking(
  Timeout timeout
)

تحميل زائد من FetchRecentlyPlayedBlocking الذي يستخدم مصدر بيانات افتراضيًا لـ CACHE_OR_NETWORK.

FetchRecentlyPlayedBlocking

FetchListResponse FetchRecentlyPlayedBlocking()

تحميل زائد من FetchRecentlyPlayedBlocking الذي يستخدم مصدر بيانات تلقائي لـ CACHE_OR_NETWORK ومهلة افتراضية تبلغ 10 سنوات.

FetchSelf

void FetchSelf(
  FetchSelfCallback callback
)

تحميل كل البيانات الخاصة بكل المشغّلات التي سجّلت الدخول إليها حاليًا بشكل غير متزامن

تستدعي FetchSelfCallback المُقدّمة عند اكتمال العملية. يؤدي عدم تحديد data_source إلى جعل استدعاء الدالة هذا مكافئًا لاستدعاء FetchSelf(DataSource data_source, FetchSelfCallback callback)، مع تحديد data_source على أنه CACHE_OR_NETWORK.

FetchSelf

void FetchSelf(
  DataSource data_source,
  FetchSelfCallback callback
)

تحميل كل البيانات الخاصة بكل المشغّلات التي سجّلت الدخول إليها حاليًا بشكل غير متزامن

تستدعي FetchSelfCallback المُقدّمة عند اكتمال العملية. حدد data_source على أنه CACHE_OR_NETWORK أو NETWORK_ONLY.

FetchSelfBlocking

FetchSelfResponse FetchSelfBlocking()

تحميل كل البيانات بشكل متزامن لكل المشغلات المسجّلة الدخول حاليًا، مع عرض FetchSelfResponse مباشرةً

في حال عدم تحديد data_source أو انتهاء المهلة، تصبح استدعاء الدالة هذه مكافئًا لاستدعاء FetchSelfResponse FetchSelfBlocked(DataSource data_source, Timeoutآخر)، مع تحديد data_source على أنّه CACHE_OR_NETWORK، والمهلة المحدّدة على أنّها 10 سنوات.

FetchSelfBlocking

FetchSelfResponse FetchSelfBlocking(
  DataSource data_source
)

تحميل كل البيانات بشكل متزامن لكل المشغلات المسجّلة الدخول حاليًا، مع عرض FetchSelfResponse مباشرةً

حدد data_source على أنه CACHE_OR_NETWORK أو NETWORK_ONLY. يؤدي عدم تحديد المهلة إلى جعل استدعاء الدالة هذه مكافئًا لاستدعاء FetchSelfResponse FetchSelfBlock(DataSource data_source, Timeoutآخر)، بالإضافة إلى قيمة data_source المحدَّدة، والمهلة المحدَّدة على 10 سنوات.

FetchSelfBlocking

FetchSelfResponse FetchSelfBlocking(
  Timeout timeout
)

تحميل كل البيانات بشكل متزامن لكل المشغلات المسجّلة الدخول حاليًا، مع عرض FetchSelfResponse مباشرةً

حدد المهلة كعدد عشوائي من المللي ثانية. يؤدي عدم تحديد data_source إلى جعل استدعاء الدالة هذا مكافئًا لاستدعاء FetchSelfResponse FetchSelfBlocked(DataSource data_source, Timeoutآخر)، مع ضبط data_source على النحو CACHE_OR_NETWORK، والمهلة التي تحتوي على القيمة المحددة.

FetchSelfBlocking

FetchSelfResponse FetchSelfBlocking(
  DataSource data_source,
  Timeout timeout
)

تحميل كل البيانات بشكل متزامن لكل المشغلات المسجّلة الدخول حاليًا، مع عرض FetchSelfResponse مباشرةً

حدد data_source على أنه CACHE_OR_NETWORK أو NETWORK_ONLY. حدد المهلة كعدد عشوائي من المللي ثانية.