لدمج لعبتك مع "خدمات ألعاب Google Play"، عليك أولاً تنفيذ مصادقة المنصة. يجب إكمال هذه الخطوة للاستفادة من جميع الميزات الأخرى، مثل الإنجازات ولوحات الصدارة والأحداث.
للامتثال لإرشادات تجربة المستخدم في برنامج Level Up من "ألعاب Google Play"، يجب أن تتوافق لعبتك مع مسار المصادقة المقترَح.
الإعداد والمصادقة
هذه الخطوة مطلوبة لتهيئة لعبتك والمصادقة عليها:
- نفِّذ عملية مصادقة المنصة من خلال تهيئة الإصدار 2 من حزمة تطوير البرامج (SDK) الخاصة بـ "خدمات ألعاب Play" عند بدء التشغيل. لمزيد من المعلومات، يُرجى الاطّلاع على مصادقة النظام الأساسي لألعاب Android. هذه الخطوة مطلوبة للوصول إلى ميزات "خدمات ألعاب 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 في "خدمات ألعاب Google Play" ضمن لعبتك.
دمج عميل اللعبة
عند دمج المصادقة في مشروع لعبتك، ننصحك باتّباع مسار المستخدم التالي:
أثناء تسلسل بدء تشغيل لعبتك، يتم إطلاق عملية إنشاء الملف الشخصي ومحاولة مصادقة المستخدم أو إنشاء حساب جديد.
في حال تعذُّر المصادقة التلقائية أو رفضها، اعرض زر تسجيل الدخول يدويًا حتى تتمكّن من المصادقة لاحقًا.
للحصول على معلومات حول دمج المصادقة في مشروع لعبتك، راجِع المستندات الخاصة بنوع مشروعك:
دمج خادم اللعبة
يمكنك الحصول على رمز تفويض الخادم من خلال استدعاء requestServerSideAccess
بعد إثبات مصادقة اللاعب. مرِّر رمز مصادقة الخادم هذا إلى خادم الخلفية للعبة للتواصل مباشرةً مع خوادم "خدمات ألعاب Play". يتيح هذا التواصل لخادمك الوصول إلى بيانات اللاعبين، بما في ذلك:
- الاسم التعريفي للّاعب
- الملف الشخصي
- قائمة الأصدقاء
- مستوى التقدّم في اللعبة
- الإنجازات
يستخدم الخادم رمز التفويض هذا مع REST API للتفاعل بشكل آمن مع خوادم "خدمات ألعاب Play". لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الوصول إلى "خدمات ألعاب Play" من جهة الخادم.
الحدّ الأقصى لطلبات تسجيل الدخول
هناك حصة يومية لطلبات تسجيل الدخول باستخدام "خدمات ألعاب Play". لمزيد من المعلومات، يُرجى الاطّلاع على إدارة الحصة اليومية.