أصدقاء

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

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

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

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

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

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

الأساسيات

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

قبل البدء في استخدام Friends APIs، نفذ ما يلي: