Giới hạn đăng nhập dành cho Unity

Cùng với iOS SDK v9.0, chúng tôi đã cập nhật Unity SDK để các nhà phát triển iOS có thể mang đến cho người dùng trải nghiệm Giới hạn đăng nhập. Nói ngắn gọn, bản cập nhật này bổ sung Mã xác thực dùng để xác minh danh tính của người dùng khi đăng nhập, đồng thời cung cấp các tính năng API Đồ thị khác khi sử dụng sản phẩm Đăng nhập bằng Facebook thông thường.

Quyền

Phương thức Giới hạn đăng nhập cung cấp một nhóm quyền nhất định mà bạn có thể yêu cầu:

  • 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

Triển khai phương thức Giới hạn đăng nhập

Nếu muốn sử dụng phương thức Giới hạn đăng nhập với Unity SDK, hãy dùng hàm LoginWithTrackingPreference để chỉ định tùy chọn LoginTracking thành LIMITED đối với yêu cầu đăng nhập cụ thể. Ngoài ra, các nhà phát triển có thể thêm một chuỗi nonce không bắt buộc để xác minh phản hồi từ Unity SDK. Để biết thêm thông tin về cách xác thực mã OIDC, hãy xem bài viết Xác thực mã OIDC cho phương thức Giới hạn đăng nhập.

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

Truy xuất dữ liệu trang cá nhân

Sau khi hoàn thành Quy trình đăng nhập cho phương thức Giới hạn đăng nhập hoặc phương thức Đăng nhập bằng Facebook thông thường, các nhà phát triển hiện có thể truy xuất AuthenticationToken từ Unity SDK. Để truy xuất thông tin cơ bản trên trang cá nhân của người dùng, các nhà phát triển có thể yêu cầu đối tượng Profile bằng hàm CurrentProfile - hàm này sẽ đọc AuthenticationToken được liên kết.

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

Lưu ý rằng phương thức Giới hạn đăng nhập và lớp "Trang cá nhân" hiện chỉ dùng được cho iOS SDK, chứ không dùng được trên các nền tảng khác.

Tài liệu tham khảo

Giá trị chính

Tên Mô tả

LoginTracking

Giá trị enum cho biết liệu yêu cầu Đăng nhập có bật tính năng theo dõi hay không. Các giá trị có thể dùng là ENABLEDLIMITED.

AuthenticationToken

Lớp Trình trợ giúp chứa chuỗi mã xác thực mà người dùng hiện tại cấp cho ứng dụng của bạn. Mã này bao gồm dữ liệu về ID, tên, ảnh đại diện và email của người dùng (nếu người dùng cấp quyền).

Profile

Lớp Trình trợ giúp dùng để truy xuất thông tin cơ bản trên trang cá nhân từ AuthenticationToken của người dùng hiện tại.

Phương thức

Tên Mô tả

FB.Mobile.LoginWithTrackingPreference

Nhắc người dùng cấp cho ứng dụng của bạn các quyền được yêu cầu dựa trên tùy chọn theo dõi mà họ đã chọn.

FB.Mobile.CurrentAuthenticationToken

Trả về AuthenticationToken mà người dùng hiện tại cấp cho ứng dụng của bạn.

FB.Mobile.CurrentProfile

Trả về thông tin cơ bản trên trang cá nhân mà người dùng hiện tại cấp cho ứng dụng của bạn.

FB.Mobile.LoginWithTrackingPreference

Thông số:

  1. LoginTracking - Chọn giá trị enum là ENABLED hoặc LIMITED
  2. Scopes - Permissions cho yêu cầu này
  3. Nonce - Chuỗi không bắt buộc dùng để xác minh phản hồi
  4. Trình xử lý kết quả (IResult) - Hàm gọi lại sẽ xử lý phản hồi đăng nhập

Kết quả: Xử lý yêu cầu Đăng nhập người dùng và xử lý phiên người dùng

FB.Mobile.CurrentAuthenticationToken

Thông số: Không có

Kết quả: Trả về "AuthenticationToken" chứa thông tin cơ bản trên trang cá nhân của người dùng, bao gồm cả ID, Tên, Ảnh đại diện và Email của Người dùng (nếu người dùng cấp quyền).

FB.Mobile.CurrentProfile

Thông số: Không có

Kết quả: Trả về đối tượng Trang cá nhân có chứa thông tin cơ bản trên trang cá nhân của người dùng. Hệ thống tự động truy xuất dữ liệu này từ Mã xác thực của người dùng.

Xác thực mã OIDC

Trước khi bạn sử dụng mã OIDC ở phía máy chủ, hãy xác thực mã này dựa trên khóa công khai của Facebook và đảm bảo rằng nonce khớp với nonce bạn cung cấp.