如果使用者尚未儲存憑證,或是尚未註冊您的應用程式,則擷取使用者憑證的要求可能會失敗。在這些情境中,請使用 Credentials API 擷取登入提示,例如使用者名稱和電子郵件地址。請按照下列提示預先填入應用程式的登入和申請表單,加快應用程式的新手上路流程。
在 Android 6.0 (Marshmallow) 以上版本中,您的應用程式不需要要求任何裝置或執行階段權限,才能透過 Certificate API 擷取登入提示。
事前準備
擷取登入提示
如要擷取登入提示,請先建立 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 驗證。