Trang này được dịch bởi Cloud Translation API.

Đăng nhập vào các trò chơi trên Android

Để truy cập chức năng Dịch vụ trò chơi của Google Play, trò chơi của bạn cần cung cấp tài khoản người chơi đã đăng nhập. Nếu người chơi không được xác thực, trò chơi của bạn có thể gặp lỗi khi thực hiện lệnh gọi đến API Dịch vụ trò chơi của Google Play. Tài liệu này mô tả cách triển khai trải nghiệm đăng nhập liền mạch trong trò chơi của bạn.

Triển khai tính năng đăng nhập của người chơi

Lớp GoogleSignInClient là điểm truy cập chính để truy xuất tài khoản của người chơi hiện đã đăng nhập và để đăng nhập người chơi nếu họ chưa từng đăng nhập trên ứng dụng của bạn trong thiết bị.

Để tạo một ứng dụng đăng nhập, hãy làm theo các bước sau:

Tạo ứng dụng đăng nhập thông qua đối tượng GoogleSignInOptions, như minh hoạ trong đoạn mã sau. Trong GoogleSignInOptions.Builder để định cấu hình tính năng đăng nhập, bạn phải chỉ định GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN.
```
GoogleSignInOptions signInOptions = GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN;
```
Nếu bạn muốn sử dụng SnapshotsClient, hãy thêm .requestScopes(Games.SCOPE_GAMES_SNAPSHOTS) vào GoogleSignInOptions.Builder như minh hoạ trong đoạn mã sau:
```
GoogleSignInOptions  signInOptions =
    new GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN)
        .requestScopes(Games.SCOPE_GAMES_SNAPSHOTS)
        .build();
```
Thận trọng: Đừng yêu cầu bất kỳ phạm vi hoặc dữ liệu hồ sơ trên Google nào khác, trừ phi những phạm vi đó cần thiết cho trường hợp sử dụng của bạn. Mọi phạm vi khác đều khiến lần đăng nhập thầm lặng đầu tiên không thành công, ngoại trừ những người dùng đã đăng nhập thành công trên một thiết bị khác.
Gọi phương thức GoogleSignIn.getClient() và truyền vào các tuỳ chọn mà bạn đã định cấu hình ở các bước trước. Nếu lệnh gọi thành công, API Đăng nhập bằng Google sẽ trả về một thực thể của GoogleSignInClient.

Kiểm tra xem người chơi đã đăng nhập hay chưa

Bạn có thể kiểm tra xem một tài khoản đã đăng nhập trên thiết bị hiện tại hay chưa bằng cách sử dụng GoogleSignIn.getLastSignedInAccount() và xem tài khoản này đã được cấp các quyền cần thiết hay chưa bằng cách sử dụng GoogleSignIn.hasPermissions(). Nếu cả hai điều kiện đều đúng, tức là getLastSignedInAccount() trả về một giá trị khác rỗng và hasPermissions() trả về true, thì bạn có thể sử dụng tài khoản được trả về từ getLastSignedInAccount() một cách an toàn, ngay cả khi thiết bị đang ngoại tuyến.

Bạn có thể gọi silentSignIn() để truy xuất tài khoản của người chơi hiện đang đăng nhập và cố gắng đăng nhập người chơi mà không hiển thị giao diện người dùng nếu họ đã đăng nhập thành công vào ứng dụng của bạn trên một thiết bị khác.

Phương thức silentSignIn() trả về một Task<GoogleSignInAccount>. Khi tác vụ hoàn tất, bạn đặt trường GoogleSignInAccount mà bạn đã khai báo trước đó cho tài khoản đăng nhập mà tác vụ sẽ trả về dưới dạng kết quả hoặc thành null, cho biết không có người dùng đã đăng nhập.

Nếu không đăng nhập được ở chế độ im lặng, bạn có thể tuỳ ý gửi ý định đăng nhập để hiển thị giao diện người dùng đăng nhập, như mô tả trong phần Thực hiện quy trình đăng nhập tương tác.

Do trạng thái của người chơi đã đăng nhập có thể thay đổi khi hoạt động không chạy ở nền trước, bạn nên gọi silentSignIn() từ phương thức onResume() của hoạt động.

Để đăng nhập thầm, hãy làm theo các bước sau:

Gọi phương thức silentSignIn() trên GoogleSignInClient để bắt đầu quy trình đăng nhập không gây phiền toái. Lệnh gọi này trả về một đối tượng Task<GoogleSignInAccount> chứa GoogleSignInAccount nếu đăng nhập không cần xác thực thành công.
Xử lý việc đăng nhập thành công hoặc không thành công của người chơi bằng cách ghi đè OnCompleteListener.
- Nếu tác vụ đăng nhập thành công, hãy lấy đối tượng GoogleSignInAccount bằng cách gọi getResult().
- Nếu đăng nhập không thành công, bạn có thể gửi ý định đăng nhập để bắt đầu một quy trình đăng nhập có tính tương tác. Để biết danh sách các trình nghe gọi lại khác mà bạn có thể sử dụng, hãy xem Hướng dẫn cho nhà phát triển API Tasks và tài liệu tham khảo API Task.

Đoạn mã sau đây cho thấy cách ứng dụng của bạn có thể thực hiện đăng nhập không gây phiền toái:

private void signInSilently() {
  GoogleSignInOptions signInOptions = GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN;
  GoogleSignInAccount account = GoogleSignIn.getLastSignedInAccount(this);
  if (GoogleSignIn.hasPermissions(account, signInOptions.getScopeArray())) {
    // Already signed in.
    // The signed in account is stored in the 'account' variable.
    GoogleSignInAccount signedInAccount = account;
  } else {
    // Haven't been signed-in before. Try the silent sign-in first.
    GoogleSignInClient signInClient = GoogleSignIn.getClient(this, signInOptions);
    signInClient
        .silentSignIn()
        .addOnCompleteListener(
            this,
            new OnCompleteListener<GoogleSignInAccount>() {
              @Override
              public void onComplete(@NonNull Task<GoogleSignInAccount> task) {
                if (task.isSuccessful()) {
                  // The signed in account is stored in the task's result.
                  GoogleSignInAccount signedInAccount = task.getResult();
                } else {
                  // Player will need to sign-in explicitly using via UI.
                  // See [sign-in best practices](http://developers.google.com/games/services/checklist) for guidance on how and when to implement Interactive Sign-in,
                  // and [Performing Interactive Sign-in](http://developers.google.com/games/services/android/signin#performing_interactive_sign-in) for details on how to implement
                  // Interactive Sign-in.
                }
              }
            });
  }
}

@Override
protected void onResume() {
  super.onResume();
  signInSilently();
}

Nếu không thể đăng nhập ngầm, bạn có thể gọi getException() để lấy ApiException kèm theo mã trạng thái chi tiết. Mã trạng thái CommonStatusCodes.SIGN_IN_REQUIRED cho biết người chơi cần thực hiện hành động rõ ràng để đăng nhập. Trong trường hợp này, ứng dụng của bạn sẽ chạy quy trình đăng nhập tương tác như mô tả trong phần tiếp theo.

Để đăng nhập bằng hoạt động tương tác của người chơi, ứng dụng của bạn cần khởi chạy ý định đăng nhập. Nếu thành công, API Đăng nhập bằng Google sẽ hiển thị một giao diện người dùng nhắc người chơi nhập thông tin xác thực để đăng nhập. Phương pháp này đơn giản hoá việc phát triển ứng dụng, vì hoạt động đăng nhập xử lý các tình huống như cần cập nhật Dịch vụ Google Play hoặc hiển thị lời nhắc đồng ý thay mặt cho ứng dụng. Kết quả được trả về thông qua lệnh gọi lại onActivityResult.

Để thực hiện quy trình đăng nhập có tương tác, hãy làm theo các bước sau:

Gọi getSigninIntent() trên GoogleSignInClient để lấy ý định đăng nhập, sau đó gọi startActivity() và truyền ý định đó vào. Đoạn mã sau đây cho thấy cách ứng dụng của bạn có thể chạy quy trình đăng nhập tương tác:
```
private void startSignInIntent() {
  GoogleSignInClient signInClient = GoogleSignIn.getClient(this,
      GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN);
  Intent intent = signInClient.getSignInIntent();
  startActivityForResult(intent, RC_SIGN_IN);
}
```

Trong lệnh gọi lại onActivityResult(), hãy xử lý kết quả từ ý định được trả về.

Nếu kết quả đăng nhập thành công, hãy lấy đối tượng GoogleSignInAccount từ GoogleSignInResult.
Nếu kết quả đăng nhập không thành công, bạn nên xử lý lỗi đăng nhập (ví dụ: bằng cách hiển thị thông báo lỗi trong cảnh báo). Đoạn mã sau đây cho thấy cách ứng dụng của bạn có thể xử lý kết quả đăng nhập của người chơi:

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
  super.onActivityResult(requestCode, resultCode, data);
  if (requestCode == RC_SIGN_IN) {
    GoogleSignInResult result = Auth.GoogleSignInApi.getSignInResultFromIntent(data);
    if (result.isSuccess()) {
      // The signed in account is stored in the result.
      GoogleSignInAccount signedInAccount = result.getSignInAccount();
    } else {
      String message = result.getStatus().getStatusMessage();
      if (message == null || message.isEmpty()) {
        message = getString(R.string.signin_other_error);
      }
      new AlertDialog.Builder(this).setMessage(message)
          .setNeutralButton(android.R.string.ok, null).show();
    }
  }
}

Truy xuất thông tin người chơi

GoogleSignInAccount mà API Đăng nhập bằng Google trả về không chứa thông tin nào về người chơi. Nếu trò chơi của bạn sử dụng thông tin người chơi, chẳng hạn như tên hiển thị và mã nhận dạng người chơi, bạn có thể làm theo các bước sau để truy xuất thông tin này.

Lấy đối tượng PlayersClient bằng cách gọi phương thức getPlayersClient() và truyền vào GoogleSignInAccount dưới dạng tham số.
Sử dụng các phương thức PlayersClient để tải không đồng bộ đối tượng Player chứa thông tin của người chơi. Ví dụ: bạn có thể gọi getCurrentPlayer() để tải người chơi hiện đã đăng nhập. Nếu tác vụ trả về một ApiException có mã trạng thái là SIGN_IN_REQUIRED, thì điều này cho biết người chơi cần được xác thực lại. Để thực hiện việc này, hãy gọi GoogleSignInClient.getSignInIntent() để đăng nhập người chơi một cách tương tác.
Nếu tác vụ trả về thành công đối tượng Player, thì bạn có thể gọi các phương thức của đối tượng Player để truy xuất thông tin chi tiết cụ thể về người chơi (ví dụ: getDisplayName() hoặc getPlayerId().

Để cung cấp nút đăng nhập bằng Google tiêu chuẩn trong trò chơi, bạn có thể sử dụng một trong những phương pháp sau:

Thêm com.google.android.gms.common.SignInButton vào bố cục hoạt động chính; hoặc
Thiết kế nút đăng nhập tuỳ chỉnh theo Nguyên tắc sử dụng thương hiệu khi đăng nhập bằng Google.

Khi người dùng nhấp vào nút đăng nhập, trò chơi của bạn sẽ bắt đầu quy trình đăng nhập bằng cách gửi ý định đăng nhập, như mô tả trong phần Thực hiện quy trình đăng nhập tương tác.

Đoạn mã này cho biết cách bạn có thể thêm nút đăng nhập trong phương thức onCreate() cho hoạt động của mình.

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  setContentView(R.layout.activity_sign_in);
  findViewById(R.id.sign_in_button).setOnClickListener(this);
  findViewById(R.id.sign_out_button).setOnClickListener(this);
}

Đoạn mã sau đây cho biết cách bạn có thể gửi ý định đăng nhập khi người dùng nhấp vào nút đăng nhập.

@Override
public void onClick(View view) {
  if (view.getId() == R.id.sign_in_button) {
    // start the asynchronous sign in flow
    startSignInIntent();
  } else if (view.getId() == R.id.sign_out_button) {
    // sign out.
    signOut();
    // show sign-in button, hide the sign-out button
    findViewById(R.id.sign_in_button).setVisibility(View.VISIBLE);
    findViewById(R.id.sign_out_button).setVisibility(View.GONE);
  }
}

Hiển thị cửa sổ bật lên trò chơi

Bạn có thể hiển thị các thành phần hiển thị bật lên trong trò chơi bằng cách sử dụng lớp GamesClient. Ví dụ: trò chơi của bạn có thể hiển thị cửa sổ bật lên "Chào mừng trở lại" hoặc "Mở khoá thành tích". Để cho phép Dịch vụ trò chơi của Google Play chạy cửa sổ bật lên trong các thành phần hiển thị trong trò chơi, hãy gọi phương thức setViewForPopups(). Bạn có thể tuỳ chỉnh thêm vị trí cửa sổ bật lên xuất hiện trên màn hình bằng cách gọi setGravityForPopups().

Đăng xuất người chơi

Bạn có thể đăng xuất bằng cách gọi phương thức signOut() trên GoogleSignInClient.

private void signOut() {
  GoogleSignInClient signInClient = GoogleSignIn.getClient(this,
      GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN);
  signInClient.signOut().addOnCompleteListener(this,
      new OnCompleteListener<Void>() {
        @Override
        public void onComplete(@NonNull Task<Void> task) {
          // at this point, the user is signed out.
        }
      });
}