الأصدقاء

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

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

  • مقارنة النتائج مع الأصدقاء على لوحات الصدارة

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

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

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

الأساسيات

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

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

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

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

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

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

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

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

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

منح تطبيق "ألعاب Play" الإذن بالوصول

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

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

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

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

قوائم الصدارة في وسائل التواصل الاجتماعي

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

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

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

قبل بدء استخدام Friends APIs، عليك إجراء ما يلي: