AccountManager.StartAddAccountSession 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
要求使用者向指定類型的帳戶進行驗證。
[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
) 此帳戶必須能夠產生,null 表示無
- 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_INTENT
Intent
包含啟動實際帳戶建立程式所需的 。 如果驗證器不支援此方法,則傳回的套件組合只會 #KEY_ACCOUNT_SESSION_BUNDLE
包含稍後新增帳戶所需的加密 options
。 如果發生錯誤,AccountManagerFuture#getResult()
則會擲回:><<AuthenticatorException
>如果驗證器未針對此帳戶類型註冊驗證器,或驗證器因任何原因而無法回應 <li>OperationCanceledException
,包括取消建立程式或新增帳戶的使用者,如果驗證器遇到建立新帳戶的 I/O 問題,則 policy liIOException
> 已停用< 通常是因為網路問題 </ul>
- 屬性
備註
要求使用者向指定類型的帳戶進行驗證。 此帳戶類型的驗證器會使用適當的使用者介面來處理此要求。 如果用戶選擇使用新帳戶進行驗證,則稍後會使用選擇性帳戶密碼和帳戶狀態令牌傳回安裝帳戶的會話數據組合。
這個方法可以從任何線程呼叫,但傳回 AccountManagerFuture
的 不得在主線程上使用。
<b>注意:</b> 帳戶不會單獨呼叫此 API 來安裝到裝置。 應該在之後呼叫 #finishSession,以在裝置上安裝帳戶。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。