‏تسجيل دخول فيسبوك المحدود‏

تسجيل الدخول المحدود في منصة Unity

إلى جانب الإصدار 9.0 من مجموعة SDK لنظام iOS، تم تحديث مجموعة SDK في منصة Unity لتمكين مطوّري نظام iOS من توفير ميزة تسجيل الدخول للمستخدمين. باختصار، يضيف هذا التحديث رمز مصادقة لاستخدامه في التحقق من هوية المستخدم عند تسجيل الدخول، مع ميزات Graph API الأخرى المتوفرة عند استخدام منتج تسجيل دخول فيسبوك التقليدي.

الأذونات

توفر ميزة التسجيل المحدود مجموعة محدودة من الأذونات التي يمكنك طلبها:

  • public_profile
  • email
  • gaming_profile
  • gaming_user_picture
  • user_age_range
  • user_birthday
  • user_friends
  • user_gender
  • user_hometown
  • user_link
  • user_location
  • user_messenger_contact

تنفيذ تسجيل الدخول المحدود

لاستخدام تسجيل الدخول المحدود مع مجموعة SDK في منصة Unity، استخدم الوظيفة LoginWithTrackingPreference في تحديد أن تفضيل LoginTracking هو LIMITED بالنسبة لطلب تسجيل دخول محدد. بالإضافة إلى ذلك، يمكن للمطوّرين تضمين رقم nonce اختياري بهدف التحقق من الاستجابة من مجموعة SDK في منصة Unity. للحصول على المزيد من المعلومات حول التحقق من صحة رمز OIDC، راجع التحقق من صحة رمز OIDC لتسجيل الدخول المحدود.

FB.Mobile.LoginWithTrackingPreference(LoginTracking.LIMITED, scopes, "nonce123", this.HandleResult);

استرداد بيانات الملف الشخصي

بعد إكمال دفق تسجيل الدخول لتسجيل الدخول المحدود أو تسجيل دخول فيسبوك التقليدي، يمكن للمطوّرين استرداد AuthenticationToken الآن من مجموعة SDK في منصة Unity. لاسترداد المعلومات الأساسية حول الملف الشخصي للمستخدم، يمكن للمطوّرين طلب الكائن Profile باستخدام الوظيفة CurrentProfile والتي تقرأ الرمز AuthenticationToken المرتبط.

private void GetProfileInfo()
{
     var profile = FB.Mobile.CurrentProfile();
     if(profile != null) {
          this.userName = profile.Name;
          this.userId = profile.UserID
          this.userEmail = profile.Email;
          this.profileImageUrl = profile.ImageURL;
          this.userBirthday = profile.Birthday;
          this.userAgeRange = profile.AgeRange;
          this.userFriendIDs = profile.FriendIDs;
          this.userGender = profile.Gender;
          this.userLink = profile.LinkURL;
          this.userHometown = profile.Hometown;
          this.userLocation = profile.Location;
     }
}

لاحظ أن تسجيل الدخول المحدود وفئة "الملف الشخصي" متوفران حاليًا فقط لمجموعة SDK في نظام iOS، وغير متوفرين للمنصات الأخرى في الوقت الحالي.

المرجع

الأساسي

الاسم الوصف

LoginTracking

قيمة تعدادية تشير إلى ما إذا كان يجب تمكين التتبع في طلب تسجيل الدخول أم لا. علمًا بأن القيم المتوفرة هي ENABLED وLIMITED.

AuthenticationToken

فئة أداة المساعدة التي تتضمن سلسلة رمز المصادقة التي منحها المستخدم الحالي إلى تطبيقك. يتضمن هذا الرمز بيانات حول معرف المستخدم واسمه وصورة الملف الشخصي والبريد الإلكتروني (إذا منحها المستخدم).

Profile

فئة أداة المساعدة المُستخدمة في استرداد معلومات الملف الشخصي الأساسية من رمز AuthenticationToken للمستخدم الحالي.

الأساليب

الاسم الوصف

FB.Mobile.LoginWithTrackingPreference

تتم مطالبة المستخدم بتفويض تطبيقك بالأذونات المطلوبة بناءً على تفضيل التتبع المحدد.

FB.Mobile.CurrentAuthenticationToken

يتم إرجاع رمز المصادقة الذي منحه المستخدم الحالي إلى تطبيقك.

FB.Mobile.CurrentProfile

يتم إرجاع معلومات الملف الشخصي الأساسية التي منحها المستخدم الحالي إلى تطبيقك.

FB.Mobile.LoginWithTrackingPreference

المعلمات:

  1. LoginTracking - تحديد التعداد بين ENABLED وLIMITED
  2. Scopes - Permissions لهذا الطلب
  3. Nonce - سلسلة اختيارية يتم استخدامها للتحقق من الاستجابة
  4. معالج النتيجة (IResult) - وظيفة الاستدعاء التي ستعالج استجابة تسجيل الدخول

النتيجة: تعالج طلبات تسجيل دخول المستخدم وجلسة المستخدم

FB.Mobile.CurrentAuthenticationToken

المعلمات: بلا

النتيجة: يتم إرجاع "رمز المصادقة" الذي يحتوي على معلومات الملف الشخصي الأساسية والتي تتضمن معرف المستخدم واسم المستخدم وصورة الملف الشخصي للمستخدم والبريد الإلكتروني للمستخدم (إذا منح المستخدم الإذن اللازم).

FB.Mobile.CurrentProfile

المعلمات: بلا

النتيجة: يتم إرجاع كائن الملف الشخصي الذي يحتوي على معلومات الملف الشخصي الأساسية للمستخدم. يتم استرداده تلقائيًا من رمز المصادقة للمستخدم.

التحقق من صحة رمز OIDC

قبل استخدام رمز OIDC من جانب الخادم، يمكنك التحقق من صحة الرمز مقابل مفاتيح فيسبوك العامة والتأكد من مطابقة nonce لـ nonce الذي قدمته.

راجع أيضًا