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