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