تتيح Recall API للألعاب استخدام "خدمات ألعاب Play" (PGS) كمحتوى مصاحب آليات تسجيل الدخول الحالية، مثل تسجيل الدخول بحساب Google، والمزامنة بسلاسة اللاعبين معلومات تسجيل الدخول على مختلف الأجهزة لتقليل معدّل إيقاف عملية الإعداد وزيادة معدّل الحفاظ على المستخدمين بعد اليوم الأول تدير واجهة برمجة التطبيقات عمليات الربط بين حساب المستخدم على "خدمات ألعاب Play" (PGS). حساباتهم داخل اللعبة من خلال تخزين الرموز المميّزة لتذكُّر الحسابات في خوادم Google. إليك سيناريو نموذجي لكيفية استخدام Recall API:
يلعب أحد المستخدمين لعبة حيث يمتلك المطوِّر نظام هوية لتتبعه مستوى تقدّم المستخدم، وتستخدم "خدمات ألعاب Play" بالتوازي مع طرق المصادقة الأخرى لتسجيل دخول المستخدمين إلى لعبتهم. في هذا المثال، سجَّل مستخدِم الدخول إلى "خدمات ألعاب Play". Laura، وتنشئ حسابًا داخل اللعبة باستخدام حساب ما يُعرف باسم Racer94. عندما يلعب المستخدم اللعبة، يعمل خادم اللعبة التابع للمطوِّر على مزامنة مستوى التقدّم.
يحفظ هذا المطوّر بشكل منفصل رمزًا مميّزًا لتذكُّر بيانات الألعاب في Google مع حساب المستخدم داخل اللعبة. تخزّن Google تلقائيًا هذا الرمز المميّز من أجل الاستدعاء مقارنةً بالملف الشخصي على "خدمات ألعاب Play" (PGS) للمستخدم.
يقرِّر المستخدم الآن تشغيل اللعبة على ألعاب Google Play على كمبيوتر شخصي الوقت. يتم تسجيل دخول المستخدم تلقائيًا باستخدام حسابه على "خدمات ألعاب Play" يتحقّق عميل اللعبة من توفُّر أي مستوى تقدّم في "خدمات ألعاب Play" هذه. المستخدم. ثم يستفسر خادم اللعبة من Google لمعرفة ما إذا كانت هناك أي رموز حساب "خدمات ألعاب Play" هذا. نظرًا لوجود هذا الرمز، ترسل Google مرة أخرى الرمز المميز للاستدعاء، يستخدم خادم اللعبة هذا الرمز المميّز للعثور على الحساب المرتبط بالمستخدم Racer94 واستعادة مستوى التقدم. نظرًا لأنّ تسجيل الدخول باستخدام "خدمات ألعاب Play" ليس تجربة سلسة، تتم استعادة مستوى تقدم المستخدم من خلال التطبيق يحتاج المستخدم إلى إدخال اسم مستخدم أو كلمة مرور. علاوة على ذلك، يحتاج المطور تسجيل الدخول إلى "خدمات ألعاب Play" من خلال نظام الهوية الحالي، والاعتماد على خدمات Google لتخزين الرابط بين مستوى تقدّم اللاعب وحسابه على "خدمات ألعاب Play".
كما هو موضح في المثال أعلاه، هناك إجراءان رئيسيان ينفذهما واجهة برمجة تطبيقات Recall:
- تخزين الرمز المميّز مع Google عندما يسجّل المستخدم الدخول باستخدام إحدى الألعاب داخل اللعبة الحسابات.
- استرداد الرمز المميّز للمستخدم لاستعادته داخل اللعبة الحسابات.
بالإضافة إلى الرموز المميّزة لتذكُّر بيانات الألعاب، تتطلّب واجهة Recall API أيضًا معرّفًا ثابتًا. مطابق للحساب داخل اللعبة، المعروف باسم الشخصية، لفرض القيود المفروضة على القيم الفريدة للسمة. قد تفكر في شخصية باعتبارها شركة تمثّل حساب المستخدم داخل اللعبة ضمن حساب المطوّر والهوية، والرمز المميز للتذكر كمفتاح يستخدم لاستعادة حساب المستخدم داخل اللعبة على اللعبة. يجب عدم إعادة استخدام قيم الشخصية والرمز المميز عبر مختلف مشاريع PGS: أيضًا، بينما قد تتغير رموز التذكر المميزة بمرور الوقت، يجب أن تكون الشخصية مستقرة وفقًا لحساب المستخدم داخل اللعبة
قواعد عدد القيم الفريدة للسمة
تفرض Recall API علاقة مباشرة بين الملفات الشخصية على "خدمات ألعاب Play" وداخل اللعبة. الحسابات (يُشار إليها باسم قواعد التعددية في الغالب)، حيث يمكن لشخصية واحدة فقط مرتبطًا بملف شخصي واحد على "خدمات ألعاب Play"، ويمكن ربط ملف شخصي واحد فقط على "خدمات ألعاب Play" بملف واحد الشخصية. يتم استخدام الشخصية كمعرّف ثابت للحساب داخل اللعبة، نظرًا لأن الرموز المميزة للتذكر قد تتغير بمرور الوقت.
يمكن أيضًا تغيير الشخصية المرتبطة بالملف الشخصي على "خدمات ألعاب Play" بمرور الوقت (بشكل مختلف تكون الحسابات داخل اللعبة مرتبطة بالملف الشخصي على "خدمات ألعاب Play").
التدفقات الفنية التفصيلية للتخزين استرداد رموز التذكُّر المميزة
يتناول هذا القسم التدفق التقني بين عميل اللعبة وخادم اللعبة وخوادم Google عند تخزين واسترداد رموز Recall المميّزة:
الخطوة 1: تسجيل الدخول إلى "مستخدم PGS" واسترداد رقم تعريف الجلسة
تعمل اللعبة على إعداد حزمة تطوير البرامج (SDK) لـ "خدمات ألعاب Play" وتحاول تسجيل دخول المستخدم باستخدام "خدمات ألعاب Play".
على افتراض أنّ المستخدم قد سجّل الدخول، عليك طلب رقم تعريف الجلسة من "حزمة تطوير البرامج (SDK) للألعاب" على اللعبة، وطلب رمز OAuth 2.0 المميز من خلفية Google OAuth. تشير رسالة الأشكال البيانية يتم استخدام رقم تعريف الجلسة ورموز OAuth 2.0 المميزة للاتصال بألعاب Google. الخلفية.
الخطوة 2: استرداد أي رمز مميّز متاح لتذكُّر بيانات الألعاب
يمكنك طلب أي رمز مميَّز لتذكُّر بيانات الألعاب مرتبط بحساب مستخدم "خدمات ألعاب Play". إذا كان الرمز المميز انتقِل إلى الخطوة 3(أ) واستعادة مستوى التقدّم. أما إذا كان هذا المستخدم جديدًا، وليس لديه رمز مميز، فتابع إلى الخطوة 3 (ب) وتخزين رمز مميّز جديد
الخطوة 3 (أ): في حال توفّر الرمز المميّز، تقدّم عملية الاستعادة
في حال توفّر رمز مميّز، يمكنك استرداده وفك تشفيره واستعادة بيانات المستخدم.
الخطوة 3 (ب): تخزين رمز مميّز في حال عدم توفُّره
بسبب عدم توفّر رمز مميّز، لا تتم استعادة أي تقدّم. يتابع المستخدم عملية تسجيل الدخول. بنظام هوية المطوِّر، أو ينشئ حسابًا جديدًا إذا لم الموجودة.
إنشاء رمز مميّز مشفّر لتذكُّر بيانات الألعاب يتم من خلاله ترميز حساب المستخدم داخل اللعبة إرساله إلى Google مع معرّف الجلسة ورمز OAuth 2.0 المميز في هذه المرحلة، تنشئ Google رابطًا بين الرمز المميّز لتذكُّر بيانات الألعاب الذي تم إرساله حساب "خدمات ألعاب Play" للاعب.
مسارات للمستخدمين الذين ليس لديهم ملف شخصي على "خدمات ألعاب Play"
يمكنك تخزين الرموز المميّزة لتذكُّر بيانات الألعاب لمستخدم لم ينشئ ملفًا شخصيًا على "خدمات ألعاب Play" بعد من خلال باستخدام وضع الملف الشخصي. ومع ذلك، هناك تحذيران مهمان:
- لا يمكنك استرداد الرموز المميّزة لمستخدم ليس لديه ملف شخصي على "خدمات ألعاب Play". الملف الشخصي يُطلب الإنشاء تلقائيًا عندما يحاول المستخدم تسجيل الدخول إلى لعبتك. مع "خدمات ألعاب Play" على جهاز ثانٍ.
- عليك اتّباع إرشادات إضافية.
لضمان حصولك على إشعار مناسب يصف البنود التالية
الحصول على الموافقة المناسبة للمستخدم النهائي:
- مشاركتك للبيانات مع Google لتفعيل حساب "ألعاب Play" .
- مدى توفُّر الإعدادات لإدارة هذه المشاركة، مثلاً "ألعاب Play" الإعدادات.
- معالجة هذه البيانات بموجب سياسة خصوصية Google السياسة:
تخزين زوج من الشخصية والرمز المميز
- مستخدم ليس لديه ملف شخصي في "خدمات ألعاب Play" يفتح لعبة لا يمكن استردادها من خلال ملف شخصي مفعّلة.
- تعمل حزمة تطوير البرامج (SDK) الخاصة بالألعاب على تشغيل عملية تسجيل دخول تلقائي، ويتعذّر تسجيل الدخول تلقائيًا لأنّ المستخدم ليس هناك ملف شخصي على "خدمات ألعاب Play".
- تعرض "حزمة تطوير البرامج (SDK) للألعاب" شريطًا صغيرًا يُعلِم المستخدم بأنّ اللعبة التكامل مع Google. شريط الإعلام السريع هذا قابل للتنفيذ - يمكن للمستخدم تعطيل تذكرها حتى يتم إنشاء ملف تعريف.
- تطلب اللعبة إذن سحب اللعبة. تجدُر الإشارة إلى أنّ "خدمات ألعاب Play" ترفض طلبات الوصول إلى بيانات الاعتماد على الأجهزة الجوّالة. في حال توفُّر ملفات شخصية على "خدمات ألعاب Play" على الجهاز أو في حال عدم توفّر حساب على "خدمات ألعاب Play" الحسابات على الجهاز في هذه الحالة، يجب متابعة اللعبة بدون استخدام "خدمات ألعاب Play".
- بعد أن يسجّل المستخدم الدخول باستخدام حساب داخل اللعبة، تنشئ اللعبة رمزًا مميّزًا زوجًا من الشخصية للمستخدم يتوافق مع حسابه داخل اللعبة. اللعبة تقوم بتخزين هذا الزوج مع Google. قد تخزّن اللعبة المزيد من الرموز المميزة لاحقًا إذا تسجيل دخول المستخدم إلى حسابات أخرى داخل اللعبة
تشغيل لعبة على جهاز جديد
- مستخدم ليس لديه ملف شخصي في "خدمات ألعاب Play" يفتح لعبة تم تفعيل ميزة "التذكُّر من دون ملف شخصي" لها على الجهاز.
- تسجِّل اللعبة رمزًا مميّزًا لتذكُّر بيانات الألعاب بدون ملف شخصي على النحو الموضّح في القسم تخزين رمز مميّز. وزوجًا من الشخصيات.
- فتح المستخدم اللعبة نفسها على جهاز آخر لديه الحساب نفسه الإعداد.
- تؤدي "حزمة تطوير البرامج (SDK) للألعاب" إلى إنشاء الملف الشخصي. يمكن للمستخدم المراجعة والرفض رموز Recall المميّزة المخزنة مسبقًا. ينشئ المستخدم ملفًا شخصيًا في "خدمات ألعاب Play" في الوقت الحالي.
- يكتمل تسجيل الدخول التلقائي إلى "خدمات ألعاب Play"، وتتلقّى اللعبة حالة المصادقة.
- تسترد اللعبة الرموز المميّزة لتذكُّر بيانات الألعاب للمستخدم كالمعتاد.
الخطوات التالية
لدمج Recall API مع خادم العميل وخادم اللعبة، اتّبِع الخطوات التالية: دليل التنفيذ هذا.