Xác thực bằng Trung tâm trò chơi

Bạn có thể sử dụng Trung tâm trò chơi để đăng nhập người chơi vào một trò chơi trên nền tảng của Apple được xây dựng trên Firebase. Để sử dụng tính năng Đăng nhập vào Trung tâm trò chơi bằng Firebase, trước tiên, hãy đảm bảo người chơi cục bộ đã đăng nhập bằng Trung tâm trò chơi, sau đó sử dụng đối tượng GameCenterAuthProvider để tạo thông tin đăng nhập Firebase. Bạn có thể dùng thông tin này để xác thực bằng Firebase.

Trước khi bắt đầu

Sử dụng Trình quản lý gói Swift để cài đặt và quản lý các phần phụ thuộc Firebase.

  1. Trong Xcode, khi dự án ứng dụng của bạn đang mở, hãy chuyển đến File > Add Packages (Tệp > Thêm gói).
  2. Khi được nhắc, hãy thêm kho lưu trữ SDK nền tảng Apple của Firebase:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Chọn thư viện Xác thực Firebase.
  4. Thêm cờ -ObjC vào mục Cờ trình liên kết khác trong chế độ cài đặt bản dựng của mục tiêu.
  5. Khi hoàn tất, Xcode sẽ tự động bắt đầu phân giải và tải các phần phụ thuộc của bạn xuống ở chế độ nền.

Tiếp theo, hãy thực hiện một số bước định cấu hình:

  1. Hãy nhớ đăng ký ứng dụng Apple của bạn với Firebase. Điều này có nghĩa là bạn phải nhập mã nhận dạng gói của ứng dụng vào phần đăng ký cùng với các thông tin bổ sung không bắt buộc như Mã trên App Store và Mã nhóm, v.v. Đây là yêu cầu bắt buộc để xác minh một cách an toàn đối tượng của thông tin đăng nhập Trung tâm trò chơi của người dùng trước khi hoàn tất quy trình đăng nhập.
  2. Bật Trung tâm trò chơi làm nhà cung cấp dịch vụ đăng nhập cho dự án Firebase của bạn:
    1. Trong bảng điều khiển của Firebase, hãy mở phần Xác thực.
    2. Trên thẻ Sign in method (Phương thức đăng nhập), hãy bật trình cung cấp dịch vụ đăng nhập trong Game Center.

Tích hợp tính năng Đăng nhập vào Trung tâm trò chơi vào trò chơi

Trước tiên, nếu trò chơi của bạn chưa sử dụng Trung tâm trò chơi, hãy làm theo hướng dẫn trong bài viết Tích hợp Trung tâm trò chơi vào trò chơi và Xác thực một người chơi cục bộ trên thiết bị trên trang web dành cho nhà phát triển của Apple.

Hãy đảm bảo mã nhận dạng gói mà bạn cung cấp cho iTunes Connect khớp với mã nhận dạng gói mà bạn đã sử dụng khi kết nối ứng dụng với dự án Firebase.

Trong quá trình tích hợp Trung tâm trò chơi, bạn sẽ xác định một trình xử lý xác thực được gọi tại nhiều điểm trong quá trình xác thực Trung tâm trò chơi. Trong trình xử lý này, hãy kiểm tra xem người chơi đã đăng nhập bằng Trung tâm trò chơi hay chưa. Nếu vậy, bạn có thể tiếp tục đăng nhập vào Firebase.

Swift

let localPlayer = GKLocalPlayer.localPlayer()
localPlayer.authenticateHandler = { (gcAuthViewController?, error) in
  if let gcAuthViewController = gcAuthViewController {
    // Pause any activities that require user interaction, then present the
    // gcAuthViewController to the player.
  } else if localPlayer.isAuthenticated {
    // Player is signed in to Game Center. Get Firebase credentials from the
    // player's Game Center credentials (see below).
  } else {
    // Error
  }
}

Objective-C

__weak GKLocalPlayer *localPlayer = [GKLocalPlayer localPlayer];
localPlayer.authenticateHandler = ^(UIViewController *gcAuthViewController,
                                    NSError *error) {
  if (gcAuthViewController != nil) {
    // Pause any activities that require user interaction, then present the
    // gcAuthViewController to the player.
  } else if (localPlayer.isAuthenticated) {
    // Player is signed in to Game Center. Get Firebase credentials from the
    // player's Game Center credentials (see below).
  } else {
    // Error
  }
};

Xác thực bằng Firebase

Sau khi bạn xác định rằng người chơi cục bộ đã đăng nhập bằng Trung tâm trò chơi, hãy đăng nhập người chơi vào trò chơi của bạn bằng cách tạo một đối tượng AuthCredential có GameCenterAuthProvider.getCredential() và truyền đối tượng đó đến signIn(with:):

Swift

// Get Firebase credentials from the player's Game Center credentials
GameCenterAuthProvider.getCredential() { (credential, error) in
  if let error = error {
    return
  }
  // The credential can be used to sign in, or re-auth, or link or unlink.
  Auth.auth().signIn(with:credential) { (user, error) in
    if let error = error {
      return
    }
    // Player is signed in!
  }

Objective-C

// Get Firebase credentials from the player's Game Center credentials
[FIRGameCenterAuthProvider getCredentialWithCompletion:^(FIRAuthCredential *credential,
                                                         NSError *error) {
  // The credential can be used to sign in, or re-auth, or link or unlink.
  if (error == nil) {
    [[FIRAuth auth] signInWithCredential:credential
                              completion:^(FIRUser *user, NSError *error) {
      // If error is nil, player is signed in.
    }];
  }
}];

Các bước tiếp theo

Sau khi người dùng đăng nhập lần đầu tiên, tài khoản người dùng mới sẽ được tạo và liên kết với mã nhận dạng Trung tâm trò chơi của họ. Tài khoản mới này được lưu trữ như một phần trong dự án Firebase của bạn và có thể dùng để xác định người dùng trên mọi ứng dụng trong dự án của bạn.

Trong trò chơi của mình, bạn có thể lấy UID Firebase của người dùng từ đối tượng User:

Swift

let user = Auth.auth().currentUser
if let user = user {
  let playerName = user.displayName

  // The user's ID, unique to the Firebase project.
  // Do NOT use this value to authenticate with your backend server,
  // if you have one. Use getToken(with:) instead.
  let uid = user.uid
}

Objective-C

FIRUser *user = [FIRAuth auth].currentUser;
if (user) {
  NSString *playerName = user.displayName;

  // The user's ID, unique to the Firebase project.
  // Do NOT use this value to authenticate with your backend server,
  // if you have one. Use getTokenWithCompletion:completion: instead.
  NSString *uid = user.uid;
}

Trong các Quy tắc bảo mật của Cloud Storage và Cơ sở dữ liệu theo thời gian thực của Firebase, bạn có thể lấy mã nhận dạng người dùng riêng biệt của người dùng đã đăng nhập từ biến auth và sử dụng mã đó để kiểm soát dữ liệu mà người dùng có thể truy cập.

Để lấy thông tin về người chơi trên Trung tâm trò chơi của người dùng hoặc để truy cập vào các dịch vụ của Trung tâm trò chơi, hãy sử dụng các API do Bộ công cụ trò chơi cung cấp.

Để đăng xuất người dùng khỏi Firebase, hãy gọi Auth.signOut():

Swift

let firebaseAuth = Auth.auth()
do {
  try firebaseAuth.signOut()
} catch let signOutError as NSError {
  print ("Error signing out: %@", signOutError)
}

Objective-C

NSError *signOutError;
BOOL status = [[FIRAuth auth] signOut:&signOutError];
if (!status) {
  NSLog(@"Error signing out: %@", signOutError);
  return;
}