Login Terbatas untuk Unity

Bersama dengan v9.0 dari iOS SDK, Unity SDK telah diperbarui untuk memungkinkan developer iOS menawarkan Login Terbatas kepada penggunanya. Singkatnya, pembaruan ini menambahkan Token Autentikasi untuk digunakan memverifikasi identitas pengguna saat masuk, dengan fitur Graph API yang lain tersedia melalui produk Facebook Login klasik.

Izin

Login Terbatas menawarkan set izin terbatas yang dapat Anda minta:

  • 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

Menerapkan Login Terbatas

Untuk menggunakan Login Terbatas dengan Unity SDK, gunakan fungsi LoginWithTrackingPreference untuk menentukan bahwa preferensi LoginTracking adalah LIMITED untuk permintaan login tertentu. Selain itu, developer dapat menyertakan nonce opsional yang dimaksudkan untuk memverifikasi tanggapan dari Unity SDK. Untuk informasi tentang memvalidasi token OIDC, lihat Memvalidasi Token OIDC Login Terbatas.

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

Mengambil Data Profil

Setelah menyelesaikan Alur Login untuk Login Terbatas atau Facebook Login klasik, developer sekarang dapat mengambil AuthenticationToken dari Unity SDK. Untuk mengambil informasi profil dasar pengguna, developer dapat meminta objek Profile menggunakan fungsi CurrentProfile - yang membaca AuthenticationToken yang terkait.

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;
     }
}

Perlu diketahui bahwa Login Terbatas dan kelas "Profil" saat ini hanya tersedia untuk iOS SDK dan tidak tersedia untuk platform lain.

Referensi

Inti

Nama Deskripsi

LoginTracking

Nilai enum yang menunjukkan apakah permintaan Login harus mengaktifkan pelacakan. Nilai yang tersedia adalah ENABLED dan LIMITED.

AuthenticationToken

Kelas bantuan yang berisi string token autentikasi yang diberikan ke aplikasi Anda oleh pengguna saat ini. Token ini mencakup data untuk ID pengguna, nama, gambar profil, dan email (jika diberikan oleh pengguna).

Profile

Kelas bantuan digunakan untuk mengambil informasi profil dasar dari AuthenticationToken pengguna saat ini.

Metode

Nama Deskripsi

FB.Mobile.LoginWithTrackingPreference

Minta pengguna untuk mengotorisasi aplikasi Anda dengan izin yang diminta berdasarkan preferensi pelacakan yang dia pilih.

FB.Mobile.CurrentAuthenticationToken

Mengembalikan AuthenticationToken yang diberikan ke aplikasi Anda oleh pengguna saat ini.

FB.Mobile.CurrentProfile

Mengembalikan informasi profil dasar yang diberikan ke aplikasi Anda oleh pengguna saat ini.

FB.Mobile.LoginWithTrackingPreference

Parameter:

  1. LoginTracking - Enum memilih di antara ENABLED dan LIMITED
  2. Scopes - Permissions untuk permintaan ini
  3. Nonce - String opsional yang digunakan untuk memverifikasi tanggapan
  4. Penangan Hasil (IResult) - Fungsi callback yang akan memproses tanggapan login

Hasil: Menangani permintaan Login Pengguna dan menangani sesi pengguna

FB.Mobile.CurrentAuthenticationToken

Parameter: Tidak ada

Hasil: Mengembalikan "AutenticationToken" yang berisi informasi profil dasar pengguna, termasuk ID Pengguna, Nama Pengguna, Gambar Profil Pengguna, dan Email Pengguna (jika izin diberikan oleh pengguna).

FB.Mobile.CurrentProfile

Parameter: Tidak ada

Hasil: Mengembalikan objek Profil yang berisi informasi profil dasar pengguna. Ini secara otomatis diambil dari Token Autentikasi pengguna.

Validasi Token OIDC

Sebelum Anda menggunakan token OIDC di server, validasi token berdasarkan kunci publik Facebook dan pastikan nonce cocok dengan nonce yang Anda berikan.