AccountManager.StartAddAccountSession 方法

定义

要求用户使用指定类型的帐户进行身份验证。

[Android.Runtime.Register("startAddAccountSession", "(Ljava/lang/String;Ljava/lang/String;[Ljava/lang/String;Landroid/os/Bundle;Landroid/app/Activity;Landroid/accounts/AccountManagerCallback;Landroid/os/Handler;)Landroid/accounts/AccountManagerFuture;", "GetStartAddAccountSession_Ljava_lang_String_Ljava_lang_String_arrayLjava_lang_String_Landroid_os_Bundle_Landroid_app_Activity_Landroid_accounts_AccountManagerCallback_Landroid_os_Handler_Handler", ApiSince=26)]
public virtual Android.Accounts.IAccountManagerFuture? StartAddAccountSession (string? accountType, string? authTokenType, string[]? requiredFeatures, Android.OS.Bundle? options, Android.App.Activity? activity, Android.Accounts.IAccountManagerCallback? callback, Android.OS.Handler? handler);
[<Android.Runtime.Register("startAddAccountSession", "(Ljava/lang/String;Ljava/lang/String;[Ljava/lang/String;Landroid/os/Bundle;Landroid/app/Activity;Landroid/accounts/AccountManagerCallback;Landroid/os/Handler;)Landroid/accounts/AccountManagerFuture;", "GetStartAddAccountSession_Ljava_lang_String_Ljava_lang_String_arrayLjava_lang_String_Landroid_os_Bundle_Landroid_app_Activity_Landroid_accounts_AccountManagerCallback_Landroid_os_Handler_Handler", ApiSince=26)>]
abstract member StartAddAccountSession : string * string * string[] * Android.OS.Bundle * Android.App.Activity * Android.Accounts.IAccountManagerCallback * Android.OS.Handler -> Android.Accounts.IAccountManagerFuture
override this.StartAddAccountSession : string * string * string[] * Android.OS.Bundle * Android.App.Activity * Android.Accounts.IAccountManagerCallback * Android.OS.Handler -> Android.Accounts.IAccountManagerFuture

参数

accountType
String

要添加的帐户的类型;不得为 null

authTokenType
String

身份验证令牌的类型(请参阅 #getAuthToken) 此帐户需要能够生成,无

requiredFeatures
String[]

功能(请参阅 #hasFeatures) 此帐户必须具有,无 null

options
Bundle

请求的特定于验证器的选项可能为 null 或为空

activity
Activity

Activity用于启动新的验证器定义的子活动的上下文,以提示用户创建帐户;仅用于调用 startActivity();如果为 null,则不会直接启动提示,但需要Intent改为返回到调用方

callback
IAccountManagerCallback

请求完成时要调用的回调,无回调为 null

handler
Handler

Handler 标识回调线程,主线程为 null

返回

AccountManagerFuture如果指定了活动并使用帐户对用户进行身份验证,则解析为包含这些字段的捆绑包:<ul><li>#KEY_ACCOUNT_SESSION_BUNDLE - 加密的捆绑包,以便稍后将设备添加到设备。 <li>#KEY_ACCOUNT_STATUS_TOKEN - 可选,用于检查帐户 </ul> 状态的令牌(如果未指定任何活动),则返回的捆绑包仅#KEY_INTENTIntent包含启动实际帐户创建过程所需的令牌。 如果验证器不支持此方法,则返回的捆绑包仅 #KEY_ACCOUNT_SESSION_BUNDLE 包含稍后添加帐户所需的加密 options 包。 如果发生错误,AccountManagerFuture#getResult()则引发:<如果未><>AuthenticatorException为此帐户类型注册验证器,或者验证器因任何原因取消操作而无法响应 <li>OperationCanceledException,包括用户取消创建过程或添加帐户(此类型)已被策略 <li>IOException 禁用(如果验证器遇到创建新帐户的 I/O 问题), 通常是因为网络问题 </ul>

属性

注解

要求用户使用指定类型的帐户进行身份验证。 此帐户类型的验证器使用适当的用户界面处理此请求。 如果用户确实选择使用新帐户进行身份验证,则会使用可选的帐户密码和帐户状态令牌返回一组用于安装该帐户的会话数据。

此方法可以从任何线程调用,但返回 AccountManagerFuture 的不能在主线程上使用。

<b>注意:</b> 仅通过调用此 API 将帐户安装到设备。 应在此之后调用 #finishSession 以在设备上安装帐户。

适用于 . 的 android.accounts.AccountManager.startAddAccountSession(java.lang.String, java.lang.String, java.lang.String[], android.os.Bundle, android.app.Activity, android.accounts.AccountManagerCallback<android.os.Bundle>, android.os.Handler)Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于