向使用者提供登入提示

如果使用者尚未儲存憑證，或是尚未註冊您的應用程式，則擷取使用者憑證的要求可能會失敗。在這些情境中，請使用 Credentials API 擷取登入提示，例如使用者名稱和電子郵件地址。請按照下列提示預先填入應用程式的登入和申請表單，加快應用程式的新手上路流程。

在 Android 6.0 (Marshmallow) 以上版本中，您的應用程式不需要要求任何裝置或執行階段權限，才能透過 Certificate API 擷取登入提示。

事前準備

設定 Android Studio 專案。

擷取登入提示

如要擷取登入提示，請先建立 HintRequest 物件來設定提示選取器對話方塊。然後，將 HintRequest 物件傳遞至 CredentialsClient.getHintPickerIntent()，即可取得意圖提示使用者選擇電子郵件地址的意圖。最後，請使用 startIntentSenderForResult() 啟動意圖。

HintRequest hintRequest = new HintRequest.Builder()
        .setHintPickerConfig(new CredentialPickerConfig.Builder()
                .setShowCancelButton(true)
                .build())
        .setEmailAddressIdentifierSupported(true)
        .setAccountTypes(IdentityProviders.GOOGLE)
        .build();

PendingIntent intent = mCredentialsClient.getHintPickerIntent(hintRequest);
try {
    startIntentSenderForResult(intent.getIntentSender(), RC_HINT, null, 0, 0, 0);
} catch (IntentSender.SendIntentException e) {
    Log.e(TAG, "Could not start hint picker Intent", e);
}

系統會提示使用者選擇要使用的電子郵件地址。

然後在活動的 onActivityResult() 方法中，從 Credential.EXTRA_KEY 包裹擷取提示，檢查使用者是否在您的使用者資料庫中，然後以憑證提示啟動適當的活動。

@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);

    if (requestCode == RC_HINT) {
        if (resultCode == RESULT_OK) {
            Credential credential = data.getParcelableExtra(Credential.EXTRA_KEY);
            Intent intent;
            // Check for the user ID in your user database.
            if (userDatabaseContains(credential.getId())) {
                intent = new Intent(this, SignInActivity.class);
            } else {
                intent = new Intent(this, SignUpNewUserActivity.class);
            }
            intent.putExtra("com.mycompany.myapp.SIGNIN_HINTS", credential);
            startActivity(intent);
        } else {
            Log.e(TAG, "Hint Read: NOT OK");
            Toast.makeText(this, "Hint Read Failed", Toast.LENGTH_SHORT).show();
        }
    }

    ...

}

預先填入登入表單

如果使用者位於使用者資料庫中，且啟動了應用程式的登入活動，您可以選擇 (選填) 檢查 Credential 物件是否包含 ID 憑證。如果是的話，您可以使用 ID 憑證登入使用者，而使用者不必輸入密碼。

如果 Credential 物件不包含 ID 憑證 (或者您不想使用 ID 憑證)，請在登入欄位預先填入您在意圖中新增的提示。

public class SignInActivity extends Activity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        Intent intent = getIntent();
        Credential credential = intent.getParcelableExtra("com.mycompany.myapp.SIGNIN_HINTS");

        // Pre-fill ID field
        mUsernameView.setText(credential.getId());

        ...
    }

    ...
}

填寫申請表單

如果使用者不在使用者資料庫中，而您啟動了應用程式的註冊活動，請在註冊欄位中填入您新增到意圖的登入提示。

public class SignUpNewUserActivity extends Activity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        Intent intent = getIntent();
        Credential credential = intent.getParcelableExtra("com.mycompany.myapp.SIGNIN_HINTS");

        // Pre-fill sign-up fields
        mUsernameView.setText(credential.getId());
        mDisplaynameView.setText(credential.getName()); // Might be null.

        ...
    }

    ...
}

或者，您也可以檢查 Credential 物件是否包含具有已驗證電子郵件地址的 ID 憑證。如果有，您可以略過應用程式的電子郵件驗證步驟，因為電子郵件地址已經過 Google 驗證。