الأصدقاء

استخدم واجهات برمجة التطبيقات Friends API لتكملة وتحسين نظام الأصدقاء داخل اللعبة والأنظمة الاجتماعية الأخرى التي يمكن أن تصل لعبتك إليها. ويتيح لك ذلك للّاعبين إجراء ما يلي:

  • يمكنك العثور على أصدقائهم في لعبتك.

  • قارن النتائج مع أصدقائهم في قوائم الصدارة.

  • يمكنك دمج قائمة أصدقائهم في "ألعاب Play" مع قوائم الأصدقاء الحالية داخل اللعبة.

  • حدِّد لاعبًا آخر من خلال نافذة منبثقة للملف الشخصي داخل اللعبة. تعرض هذه النافذة المنبثقة اللقب الذي منحه اللاعب الحالي لصديقه حتى يعرف من هو اللاعب.

استيراد أصدقاء

الأساسيات

تسمح لك واجهات برمجة التطبيقات هذه بتنفيذ الإجراءات التالية:

  • تحميل الأصدقاء: يمكنك التحقّق ممّا إذا كان اللاعب قد سمح للّعبة بالوصول إلى معلومات قائمة الأصدقاء. وإذا تم منحك إمكانية الوصول، يمكنك الحصول على قائمة بكائنات اللاعب المتوافقة مع أصدقاء المشغّل الذي تم تسجيل الدخول إليه.
  • عرض الملف الشخصي للاعب آخر على تطبيق "ألعاب Play": يمكنك فتح هذا العرض لعرض الاسم الذي أُطلق على اللاعب الآخر من خلال المشغّل الذي سجّل الدخول. توفر طريقة العرض هذه أيضًا عناصر تحكم في إدارة الصداقات ولن تخرج اللاعب من لعبتك.
  • توفير عناصر تحكُّم للمستخدم: يمتلك المستخدم عناصر تحكُّم لإدارة طريقة رؤية ملفه الشخصي على تطبيق "ألعاب Play" للأصدقاء وكيفية ظهور قائمة أصدقائه للألعاب. بالنسبة إلى إمكانية الوصول إلى قائمة الأصدقاء، يمكن للمستخدم اختيار منح إمكانية الوصول إلى جميع الألعاب تلقائيًا أو اختيار منح إذن الوصول لكل لعبة على حدة. وبالتالي، عند تحميل قائمة الأصدقاء، قد تكون النتيجة معاودة الاتصال لعرض طلب للوصول.

استيراد قائمة أصدقاء على "ألعاب Play"

يمكنك استخدام واجهة برمجة تطبيقات Friends API للحصول على قائمة بأصدقاء اللاعبين في ألعاب Play وإضافتهم إلى قائمة أصدقائك داخل اللعبة.

سيكون لدى المستخدمين الجدد قائمة بداية للأصدقاء للّعب معهم، كما يمكن للمستخدمين الحاليين استيراد أصدقائهم في "ألعاب Play" إلى أي قائمة من الأصدقاء داخل اللعبة. ونتيجة لذلك، سيكون لدى المستخدمين أكبر مجموعة ممكنة من اللاعبين للعب معهم أو التنافس ضدهم.

إضافة أصدقاء في "ألعاب Play" إلى لعبتك

يمكنك إضافة الأصدقاء في "ألعاب Play" إلى أي قائمة أصدقاء حاليين داخل اللعبة من خلال ربط رقم تعريف "ألعاب Play" الخاص بهم بمعلومات اللاعب المطابقة في قاعدة بياناتك الداخلية. تأكد من وجود زر به رمز ألعاب Play بجانب هؤلاء الأصدقاء، والذي يعرض الملف الشخصي للاعب الآخر عند الضغط عليه، حتى يتمكن المستخدمون من معرفة الأصدقاء.

عند استخدام قائمة الأصدقاء من خادم خلفية، يمكنك تحميلها بأمان باستخدام واجهة برمجة تطبيقات REST بدلاً من تمرير نتيجة واجهة برمجة تطبيقات Android. احرص على استخدام رقم تعريف اللاعب الذي يعرضه players.get(me) في واجهة برمجة تطبيقات REST للمشغّل الذي سجّلت الدخول إليه حاليًا، لأنّه سيكون متسقًا مع المعرّف الذي يظهر للاعبين الآخرين.

إذا لم يتم تخزين قائمة الأصدقاء المعزَّزين (ولكنها تُستخدم فقط في وقت المشاهدة)، فلا حاجة إلى اتخاذ أي إجراء إضافي.

منح إذن الوصول إلى "ألعاب Play"

إذا لم تحظى لعبتك بإمكانية الوصول إلى "ألعاب Play"، من الأفضل أن تطلب من المستخدمين موافقتهم عندما يطّلعون على قائمة الأصدقاء داخل اللعبة. على سبيل المثال، يمكنك إضافة زر باسم استيراد الأصدقاء على "ألعاب Play" ويطلب منهم الموافقة عند النقر على الزر. (احرص على استخدام شعار "ألعاب Play" على أي زر يشير إلى الخدمة.

عرض الملف الشخصي للاعب آخر

يمكنك السماح للّاعب الذي سجّلت الدخول به بالاطّلاع على الملف الشخصي للاعب آخر على تطبيق "ألعاب Play". ويتيح ذلك للّاعب الذي سجّل الدخول رؤية الاسم الذي أطلقه على اللاعب الآخر ومعرفة ما إذا كان صديقًا له أم لا، ما يمنحه سياقًا إضافيًا حول العلاقة. إذا لم يصبح اللاعبون أصدقاء بعد، سيرى اللاعب الذي سجّل الدخول عناصر التحكم في إدارة الصداقات ضمن عرض الملف الشخصي. عند إنشاء صداقات من داخل اللعبة، يكون الاسمان التلقائيان للّاعبَين هي الأسماء التي يظهران داخل اللعبة (إذا توفّرت). يظهر أيضًا اسم اللعبة التي بدأت فيها الصداقة.

عرض الملف الشخصي للاعب آخر

لوحات الصدارة على الشبكات الاجتماعية

يمكن أيضًا استخدام واجهات برمجة التطبيقات Friends API للوحات الصدارة. استخدِم هذه الميزة لعرض ترتيب اللاعب الحالي بين أصدقائه في "ألعاب Play" يُرجى ملاحظة أنّ هذا الإجراء لا ينطبق إلا على المستخدمين الذين اختاروا مشاركة هذه المعلومات مع تطبيقك، وعلى المستخدمين الذين لديهم أصدقاء في "ألعاب Play". ولدعم هذه الميزة، تعرض اللعبة عنصر تحكّم للمستخدم. يستخدم عنصر التحكّم هذا الوسيطة collection لاختيار طريقة العرض الاجتماعية للوحة الصدارة. لمعرفة المزيد، راجع القسم الخاص بلوحات الصدارة العامة والاجتماعية.

الأصدقاء في لوحة الصدارة

في حال نفَّذت مجموعة "لوحات الصدارة" على الشبكات الاجتماعية، قد يعرض الاستدعاء لتحميل نتائج لوحة الصدارة استثناءً للدقة مطلوب الحصول على موافقة، ويكون ذلك الاستثناء من الطلب المرجوّ من loadFriends(). في حال نفَّذت واجهة المستخدم التلقائية التي يوفّرها تطبيق "ألعاب Play" (على سبيل المثال، getLeaderboardIntent())، سيتم التعامل مع هذا الأمر تلقائيًا بالنيابة عنك.

الخطوات التالية

قبل البدء في استخدام واجهات برمجة التطبيقات Friends API، عليك تنفيذ ما يلي: