لدمج لعبتك مع "خدمات ألعاب Google Play"، عليك أولاً تنفيذ عملية مصادقة على المنصة. يجب إكمال هذه الخطوة للاستفادة من جميع الميزات الأخرى، مثل الإنجازات ولوحات الصدارة والفعاليات.
للامتثال لإرشادات تجربة المستخدم في برنامج Level Up من "ألعاب Google Play"، يجب أن تتوافق لعبتك مع مسار المصادقة المقترَح.
الإعداد والمصادقة
هذه الخطوة مطلوبة لتهيئة لعبتك والمصادقة عليها:
- نفِّذ مصادقة المنصة من خلال تهيئة حزمة تطوير البرامج (SDK) الخاصة بالإصدار 2 من "خدمات ألعاب Play" عند بدء التشغيل. لمزيد من المعلومات، يُرجى الاطّلاع على مصادقة النظام الأساسي لألعاب Android. هذه الخطوة مطلوبة للوصول إلى ميزات "خدمات ألعاب Play"، مثل الإنجازات ولوحات الصدارة.
- تتم المصادقة كعملية خفية في الخلفية أثناء تشغيل اللعبة.
ستظهر رسالة ترحيب لمستخدمي "خدمات ألعاب Play" الحاليين عند إكمال عملية المصادقة بنجاح.
خيارات إنشاء الملف الشخصي
يجب أن يتوفّر لدى اللاعبين ملف شخصي على "خدمات ألعاب Play" كي يتمكّنوا من التفاعل مع المنصة. قد لا يتوفّر لدى بعض اللاعبين ملف شخصي على "خدمات ألعاب Play" عند بدء لعبتك. وسيُطلب من هؤلاء اللاعبين إنشاء حساب.
يمكنك تحديد التجربة المناسبة للمستخدمين من خلال اختيار أحد الخيارات التالية:
طلبات إنشاء الملف الشخصي التي يتم تشغيلها تلقائيًا تظهر طلبات إنشاء الملف الشخصي تلقائيًا عند تشغيل لعبة بدون ملف شخصي على "خدمات ألعاب Play".
طلب إنشاء ملف شخصي عند تشغيل إحدى الألعاب (انقر للتكبير). إيقاف طلبات إنشاء الملف الشخصي عند التشغيل وإضافة طلبات يدوية بعد تهيئة اللعبة يمكنك إيقاف طلبات إنشاء الملف الشخصي التي يتم تشغيلها تلقائيًا من خلال ملف البيان. يتيح ذلك للمستخدمين الذين ليس لديهم ملف شخصي على "خدمات ألعاب Play" مواصلة استخدام طرق المصادقة التي نفّذتها بدون أن يُطلب منهم على الفور إنشاء ملف شخصي على "خدمات ألعاب Play".
على الرغم من أنّه يمكن للمستخدمين تسجيل الدخول باستخدام أي خدمة توفير هوية، ننصحك بعرض طلب إنشاء ملف شخصي الحصول على نتيجة المصادقة لتشجيع المستخدمين على الاشتراك في "منصة ألعاب Play". يمكنك عرض هذا الطلب حسب تقديرك، ولكن تأكَّد من ظهوره قبل أن يحرز المستخدمون تقدّمًا كبيرًا في ميزات مثل الإنجازات وقوائم الصدارة.
ننصحك بعرض طلب إنشاء الملف الشخصي خلال اللحظات المقترَحة التالية:
- بعد إكمال برنامج تعليمي
- أثناء لحظة مكافأة (على سبيل المثال، الفوز بمباراة أو جمع عنصر نادر أو تحقيق إنجاز)
- عند بدء جلسة ثانية
مسار المصادقة المقترَح
للامتثال لإرشادات تجربة المستخدم في برنامج Level Up في "ألعاب Google Play"، تأكَّد من استيفاء متطلبات استمرار تجربة اللاعب. لتسجيل دخول اللاعبين إلى لعبتك بنجاح، اتّبِع خطوات المصادقة التالية:
- أثناء تسلسل بدء تشغيل لعبتك، راجِع خيارات إنشاء الملف الشخصي واختر خيارًا.
- إذا لم تنجح عملية تسجيل الدخول التلقائي أو رفضها المستخدم، اعرض زر تسجيل الدخول اليدوي في حال أراد المستخدم تسجيل الدخول لاحقًا.
الاسم التعريفي للّاعب
معرّف اللاعب هو معرّف لحساب لاعب على "خدمات ألعاب Play". يمكن أن تسترد لعبتك رقم تعريف اللاعب لأي لاعب يسجّل الدخول إلى لعبتك باستخدام مصادقة "خدمات ألعاب Play". يمكن لعملية الدمج مع برنامج تشغيل الألعاب وعملية الدمج مع خادم الألعاب وخدمة الحفظ على السحابة الإلكترونية استخدام المعرّف للوصول بشكل آمن إلى بيانات اللاعبين من "خدمات ألعاب Play".
يكون رقم تعريف اللاعب هو نفسه للمستخدم عندما يلعب لعبتك على أجهزة متعدّدة. ومع ذلك، لا يكون هذا السلوك متسقًا دائمًا بين الألعاب. لمزيد من المعلومات، يُرجى الاطّلاع على الجيل التالي من أرقام تعريف اللاعبين.
نطاقات OAuth
تعتمد "خدمات ألعاب Play" على
نظام OAuth
للسماح للاعبين بمنح لعبتك إذن الوصول إلى حساباتهم. تتضمّن "خدمات ألعاب Play" نطاقًا فريدًا للألعاب (games-lite) وتعتمد على نطاق آخر (drive.appdata) إذا كانت لعبتك تستخدم ميزة "حفظ التقدم في الألعاب". تتيح ميزة "الألعاب المحفوظة" الوصول إلى حساب المستخدم على Google Drive، حيث يتم تخزين بيانات اللعبة.
عند استخدام الإصدار 2 من حزمة تطوير البرامج (SDK) الخاصة "بخدمات ألعاب Play"، يمكنك طلب نطاقات OAuth إضافية.
إذا كنت بحاجة إلى نطاقات OAuth إضافية، ننصحك بالاتصال على requestServerSideAccess.
لمزيد من المعلومات، يُرجى الاطّلاع على الحصول على رمز مصادقة الخادم أو استرداد رموز مصادقة الخادم.
خدمات مصادقة متعدّدة
توفّر "خدمات ألعاب Play" هوية ألعاب للاعبين على Android، ولكن ليس من الضروري أن تكون الهوية الوحيدة المرتبطة بالمستخدمين. يمكنك مصادقة اللاعبين باستخدام "خدمات ألعاب Play" ومعرّف شبكة اجتماعية ونظام معرّف داخل اللعبة في الوقت نفسه.
Recall API
تتيح Recall API للألعاب إدارة الروابط بين مستخدمي "خدمات ألعاب Play" وحساباتهم داخل اللعبة من خلال تخزين الرموز المميزة لعملية تسجيل الدخول السريع على خوادم Google. لمزيد من المعلومات حول تفعيل هذه الميزة، يُرجى الاطّلاع على دمج واجهة برمجة التطبيقات Recall API في "خدمات ألعاب Play" ضمن لعبتك.
دمج عميل اللعبة
عند دمج المصادقة في مشروع لعبتك، ننصح باتّباع مسار المستخدم التالي:
أثناء تسلسل بدء تشغيل لعبتك، يتم تشغيل خيارات إنشاء الملف الشخصي ويتم محاولة تسجيل دخول المستخدم أو إنشاء حساب جديد.
إذا لم تنجح المصادقة التلقائية أو رفضها المستخدم، اعرض زر تسجيل دخول يدويًا في حال أراد المستخدم تسجيل الدخول لاحقًا.
للحصول على معلومات حول دمج المصادقة في مشروع لعبتك، يُرجى الاطّلاع على دليل بدء الاستخدام الخاص بنوع مشروعك:
دمج خادم اللعبة
يمكنك الحصول على رمز تفويض الخادم من خلال استدعاء requestServerSideAccess
بعد إثبات مصادقة اللاعب. مرِّر رمز تفويض الخادم هذا إلى خادم الخلفية للعبة للتواصل مباشرةً مع خوادم "خدمات ألعاب Play". يتيح هذا التواصل لخادمك الوصول إلى بيانات اللاعبين، بما في ذلك:
- الاسم التعريفي للّاعب
- الملف الشخصي
- قائمة الأصدقاء
- مستوى التقدّم في اللعبة
- الإنجازات
يستخدم الخادم رمز التفويض هذا مع REST API للتفاعل بأمان مع خوادم "خدمات ألعاب Play". لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الوصول إلى "خدمات ألعاب Play" من جهة الخادم.
الحدّ الأقصى لطلبات تسجيل الدخول
هناك حصة يومية لطلبات تسجيل الدخول باستخدام "خدمات ألعاب Play". لمزيد من المعلومات، يُرجى الاطّلاع على إدارة الحصة اليومية.