根据用户是否为调用应用程序存储了凭据,调用的结果状态代码CredentialsApi.request()
会有所不同。查看API 概述以获取详细信息,但可以快速总结一下:
当用户有多个存储的凭据(可能存储在设备上的一个或多个 Google 帐户中)时,RESOLUTION_REQUIRED
会返回结果,并且可以通过显示多个已保存凭据的对话框来解析结果,允许用户选择一个。细节
当没有存储的凭据可用时,将SIGN_IN_REQUIRED
返回结果并可以通过显示电子邮件地址列表的对话框来解决(用于电子邮件地址自动填充,如果可用,还包括名称或图片)。这不需要设备权限(在 Android M 上非常有用,否则需要运行时 GET_ACCOUNTS 提示),并帮助用户轻松填写登录或注册表单。细节
Auth.CredentialsApi.request(apiClient, request).setResultCallback(
new ResultCallback<CredentialRequestResult>() {
public void onResult(CredentialRequestResult result) {
Status status = result.getStatus();
if (status.isSuccess()) {
// Successfully read credential without any user interaction, this
// means there was only a single credential and user has auto
// sign-in enabled.
processRetrievedCredential(result.getCredential(), false);
} else if (status.getStatusCode() == CommonStatusCodes.RESOLUTION_REQUIRED) {
// This is the case where the user has multiple saved
// credentials and needs to pick one
resolveResult(status, RC_READ);
} else if (status.getStatusCode() == CommonStatusCodes.SIGN_IN_REQUIRED) {
// User has no saved credentials, but a dialog to select email
// address (a "hint") is available (optional)
resolveResult(status, RC_HINT);
}
}
});
对于两个结果都hasResolution()
返回true
,因为两者都可以解决,尽管结果不同,不幸的是令人困惑。我们将更新文档以更好地解释。
在任何一种情况下,用户的选择都将在 中返回onActivityResult()
,但“提示”只会设置标识符(电子邮件地址)而没有密码。
public void onActivityResult(int requestCode, int resultCode, Intent data) {
...
if (resultCode == RESULT_OK) {
Credential result = data.getParcelableExtra(Credential.EXTRA_KEY);
if (requestCode == RC_HINT) {
String email = result.getId(); // for auto-fill
} else if (requestCode == RC_READ) {
String email = result.getId(); // for auto sign-in
String password = result.getPassword(); // only for saved credentials
在 a 中返回仅电子邮件对话框的原因CredentialsApi.request()
是保存额外的 API 调用以获取上述详细信息中描述的电子邮件“提示”选择器对话框,以防应用程序需要按顺序进行 API 调用。但是,这是可选的,因为对于许多应用程序的 UX,在应用程序启动时检索凭据以进行自动登录更有意义,然后稍后在用户开始登录或注册时单独请求电子邮件选择器对话框,如示例代码所示。