واجهة برمجة التطبيقات Recall

تتيح Recall API للألعاب إدارة الروابط بين مستخدمي "خدمات ألعاب Play" وحساباتهم داخل الألعاب من خلال تخزين الرموز المميّزة لتذكُّر الحسابات المُستخدَمة في خوادم Google. إليك سيناريو نموذجي حول كيفية استخدام Recall API.

1. يلعب أحد المستخدمين لعبة يكون لدى المطوّر نظام هويات لتتبّع مدى تقدّم المستخدمين، ويستخدم "خدمات ألعاب Play" بالتوازي مع طرق مصادقة أخرى لتسجيل دخول المستخدمين إلى اللعبة. في هذا المثال، يتم تسجيل دخول مستخدم إلى حسابه على "خدمات ألعاب Play" وهو Laura، وينشئ حسابًا داخل اللعبة باستخدام نظام هوية المطوّر المسمى Racer94. أثناء تشغيل المستخدِم للّعبة، يعمل خادم اللعبة لدى المطوّر على مزامنة مستوى تقدُّمه.

   

2. ويحفظ المطوّر، بشكل منفصل، رمزًا مميزًا لتذكُّر الحسابات المُستخدَمة في Google، يكون متوافقًا مع حساب المستخدم داخل اللعبة. تقوم Google تلقائيًا بتخزين هذا الرمز المميّز مقابل الملف الشخصي في "خدمات ألعاب Play" للمستخدم.

   

3. يقرر المستخدم الآن تشغيل اللعبة على GPG على الكمبيوتر الشخصي لأول مرة. يتم تسجيل دخول المستخدم تلقائيًا باستخدام حسابه على "خدمات ألعاب Play"، ويتحقّق عميل اللعبة من مستوى التقدّم الذي أحرزه مستخدم "خدمات ألعاب Play". بعد ذلك، يطلب خادم اللعبة من Google معرفة ما إذا كانت هناك أي رموز مميّزة لحساب "خدمات ألعاب Play" هذا. ونظرًا لذلك، تعيد Google الرمز لتذكُّر بيانات الألعاب، ويستخدم خادم اللعبة هذا الرمز للعثور على حساب المستخدم Racer94 المرتبط به واستعادة مستوى التقدّم. وبما أنّ تسجيل الدخول باستخدام "خدمات ألعاب Play" هو تجربة سلسة، تتم استعادة مستوى تقدّم المستخدم من خلال التطبيق بدون الحاجة إلى إدخال اسم مستخدم أو كلمة مرور. بالإضافة إلى ذلك، يمكن للمطوّر استخدام ميزة تسجيل الدخول إلى "خدمات ألعاب Play" من خلال نظام الهوية الحالي الخاص به والاعتماد على Google لتخزين الرابط بين مستوى تقدّم اللاعب وحساب "خدمات ألعاب Play".

   

كما هو موضّح في المثال أعلاه، هناك إجراءان أساسيان يتم تنفيذهما من خلال Recall API: تخزين الرمز المميّز لدى Google عندما يسجّل المستخدم الدخول باستخدام أحد الحسابات داخل اللعبة، واسترداد الرمز المميّز للمستخدم لاستعادة حسابه داخل اللعبة.

بالإضافة إلى الرموز المميّزة لتذكُّر بيانات الألعاب، تتطلّب Recall API أيضًا معرّفًا ثابتًا يتوافق مع الحساب داخل اللعبة، والمعروف باسم الشخصية، وذلك لفرض القيود على عدد القيم الفريدة للسمة. قد تنظر إلى الشخصية على أنها التصنيف الذي يمثّل حساب المستخدم داخل اللعبة ضمن نظام هوية المطوّر، والرمز المميّز للتذكُّر هو المفتاح الذي يُستخدم لاستعادة حساب المستخدم داخل اللعبة. يجب عدم إعادة استخدام قيم الشخصية والرموز المميّزة في مشاريع "خدمات ألعاب 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.

الخطوة 2: استرداد أي رمز مميّز متوفّر لتذكُّر الحسابات المُستخدَمة

هي طلب للحصول على أي رمز مميّز مرتبط بحساب مستخدم "خدمات ألعاب Play". في حال وجود رمز مميز، انتقِل إلى الخطوة 3 (أ) واستعد التقدم. بخلاف ذلك، إذا كان هذا مستخدمًا جديدًا وليس لديه رمز مميز، يمكنك الانتقال إلى الخطوة 3 (ب) وتخزين رمز مميز جديد.

الخطوة 3 (أ): في حال توفّر الرمز المميّز، استعادة مستوى التقدّم

وفي حال توفّره، يمكنك استرداد الرمز وفك تشفيره واستعادة بيانات المستخدم.

الخطوة 3 (ب): تخزين رمز مميّز في حال عدم توفّر رمز مميّز

نظرًا لعدم وجود أي رمز مميز، لا تتم استعادة أي تقدم. يتابع المستخدم تسجيل الدخول باستخدام نظام الهوية للمطوّر أو ينشئ حسابًا جديدًا في حال عدم توفّر حساب. ملاحظة: لا يتم تسجيل الدخول باستخدام "خدمات ألعاب Play" (التي تم إجراؤها من قبل)، ولكن من خلال نظام هويات المطوّرين خارج "خدمات ألعاب Play".

أنشئ رمزًا مميزًا لتذكُّر بيانات الألعاب يشفّر حساب المستخدم داخل اللعبة، وأرسِله إلى Google مع معرّف الجلسة ورمز OAuth 2.0 المميّز. في هذه المرحلة، تنشئ Google ارتباطًا بين الرمز المميّز الذي تم إرساله من أجل تذكُّر بيانات الألعاب وحساب "خدمات ألعاب Play" للّاعب.

الخطوات التالية

لدمج Recall API مع العميل وخادم اللعبة، يُرجى اتّباع هذه الإرشادات.