Pobieranie zapisanych danych logowania użytkownika

Automatycznie loguj użytkowników w aplikacji za pomocą interfejsu Credentials API, aby żądać i pobierać zapisane dane logowania.

Zanim zaczniesz

Skonfiguruj projekt Android Studio.

Tworzenie obiektu CredentialsClient

Aby poprosić o zapisane dane logowania, musisz utworzyć instancję CredentialsClient z dostępem do interfejsu Credentials API:

CredentialsClient mCredentialsClient;

// ...

mCredentialsApiClient = Credentials.getClient(this);

Tworzenie obiektu CredentialRequest

Obiekt CredentialRequest określa systemy logowania, z których chcesz prosić o dane logowania. Utwórz CredentialRequest za pomocą metody setPasswordLoginSupported do logowania przy użyciu hasła i metody setAccountTypes() do usług sfederowanego logowania, takich jak Logowanie przez Google.

mCredentialRequest = new CredentialRequest.Builder()
    .setPasswordLoginSupported(true)
    .setAccountTypes(IdentityProviders.GOOGLE, IdentityProviders.TWITTER)
    .build();

Użyj stałych zdefiniowanych w IdentityProviders, aby określić często wybieranych dostawców logowania. W przypadku innych dostawców logowania użyj dowolnego ciągu, który jednoznacznie identyfikuje dostawcę. Aby przechowywać dane logowania, których używasz do pobierania danych logowania, musisz używać tego samego identyfikatora dostawcy.

Prośba o zapisane dane logowania

Po utworzeniu obiektów CredentialsClient i CredentialRequest przekaż obiekt żądania do metody CredentialsClient.request(), aby zażądać danych logowania przechowywanych dla Twojej aplikacji.

  mCredentialsClient.request(mCredentialRequest).addOnCompleteListener(
      new OnCompleteListener<CredentialRequestResponse>() {
          @Override
          public void onComplete(@NonNull Task<CredentialRequestResponse> task) {

              if (task.isSuccessful()) {
                  // See "Handle successful credential requests"
                  onCredentialRetrieved(task.getResult().getCredential());
                  return;
              }

              // See "Handle unsuccessful and incomplete credential requests"
              // ...
          }
      });

Zdefiniuj wywołanie zwrotne do obsługi nieudanych i nieudanych żądań za pomocą metody addOnCompleteListener().

Obsługuj udane żądania danych logowania

Komunikat informujący o udanym logowaniuW odpowiedzi na żądanie dotyczące danych logowania użyj wyświetlonego obiektu Credential, aby zakończyć logowanie użytkownika w aplikacji. Użyj metody getAccountType(), aby określić typ pobranych danych logowania, a następnie przeprowadź odpowiedni proces logowania. Na przykład w przypadku Logowania przez Google utwórz obiekt GoogleSignInClient zawierający identyfikator użytkownika, a następnie użyj tego obiektu, aby rozpocząć proces logowania. W przypadku logowania na podstawie hasła użyj identyfikatora użytkownika i hasła z obiektu Dane logowania, aby ukończyć proces logowania aplikacji.

private void onCredentialRetrieved(Credential credential) {
    String accountType = credential.getAccountType();
    if (accountType == null) {
        // Sign the user in with information from the Credential.
        signInWithPassword(credential.getId(), credential.getPassword());
    } else if (accountType.equals(IdentityProviders.GOOGLE)) {
        // The user has previously signed in with Google Sign-In. Silently
        // sign in the user with the same ID.
        // See https://developers.google.com/identity/sign-in/android/
        GoogleSignInOptions gso =
                new GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_SIGN_IN)
                        .requestEmail()
                        .build();

        GoogleSignInClient signInClient = GoogleSignIn.getClient(this, gso);
        Task<GoogleSignInAccount> task = signInClient.silentSignIn();
        // ...
    }
}

Obsługiwanie wielu zapisanych danych logowania

Wybór konta Smart Lock

Gdy do wybrania danych logowania wymagane jest podanie danych użytkownika, zadanie request() nie powiedzie się z ResolvableApiException. Sprawdź, czy obiekt getStatusCode() zwraca RESOLUTION_REQUIRED i wywołaj metodę startResolutionForResult(), aby poprosić użytkownika o wybór konta. Następnie pobierz dane logowania użytkownika z metody onActivityResult(), przekazując Credential.EXTRA_KEY do metody getParcelableExtra().

mCredentialsClient.request(request).addOnCompleteListener(
        new OnCompleteListener() {
            @Override
            public void onComplete(@NonNull Task task) {
                if (task.isSuccessful()) {
                    // ...
                    return;
                }

                Exception e = task.getException();
                if (e instanceof ResolvableApiException) {
                    // This is most likely the case where the user has multiple saved
                    // credentials and needs to pick one. This requires showing UI to
                    // resolve the read request.
                    ResolvableApiException rae = (ResolvableApiException) e;
                    resolveResult(rae, RC_READ);
                } else if (e instanceof ApiException) {
                    // The user must create an account or sign in manually.
                    Log.e(TAG, "Unsuccessful credential request.", e);

                    ApiException ae = (ApiException) e;
                    int code = ae.getStatusCode();
                    // ...
                }
            }
        });
private void resolveResult(ResolvableApiException rae, int requestCode) {
    try {
        rae.startResolutionForResult(MainActivity.this, requestCode);
        mIsResolving = true;
    } catch (IntentSender.SendIntentException e) {
        Log.e(TAG, "Failed to send resolution.", e);
        hideProgress();
    }
}
@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);

    // ...

    if (requestCode == RC_READ) {
        if (resultCode == RESULT_OK) {
            Credential credential = data.getParcelableExtra(Credential.EXTRA_KEY);
            onCredentialRetrieved(credential);
        } else {
            Log.e(TAG, "Credential Read: NOT OK");
            Toast.makeText(this, "Credential Read Failed", Toast.LENGTH_SHORT).show();
        }
    }

    // ...

}

W przypadku braku przechowywanych danych logowania użytkownicy muszą utworzyć konto lub zalogować się ręcznie. Jeśli narzędzie getStatusCode() zwraca kod SIGN_IN_REQUIRED, możesz opcjonalnie przyspieszyć proces rejestracji i logowania, prosząc użytkownika o wybranie ostatnio używanych danych logowania, takich jak adres e-mail i imię, i automatyczne wypełnianie niektórych pól formularza tymi informacjami. Więcej informacji znajdziesz w artykule Wskazówki dla użytkowników dotyczące logowania.

Po zalogowaniu się zezwalaj użytkownikom na zapisywanie danych logowania, aby zautomatyzować uwierzytelnianie na wszystkich urządzeniach.