الأصدقاء

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

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

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

  • اجمع بين قائمة أصدقائهم على تطبيق "ألعاب Play" مع قوائم حالية داخل اللعبة تضم أصدقاؤنا.

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

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

الأساسيات

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

أصدقاء في قائمة الصدارة

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

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

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