الأصدقاء

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

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

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

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

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

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

الأساسيات

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

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

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

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

سيحصل المستخدمون الجدد على قائمة أساسية بالأصدقاء للعب معهم، ويمكن للمستخدمين الحاليين استيراد أصدقائهم في "ألعاب 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، عليك إجراء ما يلي: