Lenguaje

AccountManager Clase

Definición

Esta clase proporciona acceso a un registro centralizado de las cuentas en línea del usuario.

[Android.Runtime.Register("android/accounts/AccountManager", DoNotGenerateAcw=true)]
public class AccountManager : Java.Lang.Object
[<Android.Runtime.Register("android/accounts/AccountManager", DoNotGenerateAcw=true)>]
type AccountManager = class
    inherit Object
Herencia
AccountManager
Atributos

Comentarios

Esta clase proporciona acceso a un registro centralizado de las cuentas en línea del usuario. El usuario escribe credenciales (nombre de usuario y contraseña) una vez por cuenta, concediéndole a las aplicaciones acceso a recursos en línea con la aprobación de "un solo clic".

Diferentes servicios en línea tienen diferentes formas de controlar cuentas y autenticación, por lo que el administrador de cuentas usa módulos em authenticator/em conectables <>para diferentes<> tipos< de cuenta em/em>.<> Los autenticadores (que pueden escribir terceros) controlan los detalles reales de validar las credenciales de la cuenta y almacenar la información de la cuenta. Por ejemplo, Google, Facebook y Microsoft Exchange cada uno tiene su propio autenticador.

Muchos servidores admiten cierta noción de un <token> de autenticación em</em>, que se puede usar para autenticar una solicitud al servidor sin enviar la contraseña real del usuario. (Normalmente, los tokens de autenticación se crean con una solicitud independiente que incluye las credenciales del usuario). AccountManager puede generar tokens de autenticación para aplicaciones, por lo que la aplicación no necesita controlar las contraseñas directamente. Los tokens de autenticación normalmente son reutilizables y almacenados en caché por AccountManager, pero deben actualizarse periódicamente. Es responsabilidad de las aplicaciones <invalidar>< o> em los tokens de autenticación cuando dejan de funcionar para que accountManager sepa que necesita regenerarlos.

Las aplicaciones que acceden a un servidor normalmente pasan por estos pasos:

<ul><li>Obtiene una instancia de AccountManager mediante #get(Context).

<li Enumere>las cuentas disponibles mediante #getAccountsByType o #getAccountsByTypeAndFeatures. Normalmente, las aplicaciones solo estarán interesadas en las cuentas con un <determinado tipo> em</em>, que identifica el autenticador. Las características<> de account <em>se usan para identificar subtipos y funcionalidades de cuenta concretos. Tanto el tipo de cuenta como las características son cadenas específicas del autenticador y la aplicación debe conocerla en coordinación con sus autenticadores preferidos.

<li>Seleccione una o varias de las cuentas disponibles, posiblemente pidiendo al usuario su preferencia. Si no hay cuentas adecuadas disponibles, #addAccount se puede llamar a para pedir al usuario que cree una cuenta del tipo adecuado.

<li><b>Importante:</b> Si la aplicación usa una selección de cuenta previamente recordada, debe asegurarse de que la cuenta todavía está en la lista de cuentas devueltas por #getAccountsByType. La solicitud de un token de autenticación para una cuenta ya no está en el dispositivo produce un error indefinido.

<li>Solicite un token de autenticación para las cuentas seleccionadas mediante uno de los #getAuthToken métodos o asistentes relacionados. Consulte la descripción de cada método para obtener detalles exactos de uso y control de errores.

<li>Realice la solicitud mediante el token de autenticación. El formato del token de autenticación, el formato de la solicitud y el protocolo usado son específicos del servicio al que accede. La aplicación puede usar las bibliotecas de red y protocolo que sean útiles.

<li><b>Importante:</b> Si la solicitud produce un error de autenticación, podría ser que un token de autenticación almacenado en caché esté obsoleto y ya no se respete por el servidor. La aplicación debe llamar #invalidateAuthToken a para quitar el token de la memoria caché; de lo contrario, las solicitudes seguirán fallando. Después de invalidar el token de autenticación, vuelva inmediatamente al paso "Solicitar un token de autenticación" anterior. Si se produce un error en el proceso por segunda vez, se puede tratar como un error de autenticación "genuino" y el usuario notificó u otras acciones adecuadas realizadas. </ul>

Es posible que algunos métodos accountManager necesiten interactuar con el usuario para solicitar credenciales, presentar opciones o pedir al usuario que agregue una cuenta. El autor de la llamada puede elegir si permitir que AccountManager inicie directamente la interfaz de usuario necesaria y espere a que el usuario, o bien devuelva una intención que el autor de la llamada pueda usar para iniciar la interfaz, o (en algunos casos) para instalar una notificación que el usuario puede seleccionar en cualquier momento para iniciar la interfaz. Para que AccountManager inicie la interfaz directamente, el autor de la llamada debe proporcionar el contexto de primer plano Activity actual.

Muchos métodos AccountManager toman AccountManagerCallback y Handler como parámetros. Estos métodos devuelven inmediatamente y se ejecutan de forma asincrónica. Si se proporciona una devolución de llamada, AccountManagerCallback#run se invocará en el subproceso del controlador cuando la solicitud se complete correctamente o no. El resultado se recupera llamando AccountManagerFuture#getResult() al AccountManagerFuture devuelto por el método (y también se pasa a la devolución de llamada). Este método espera a que se complete la operación (si es necesario) y devuelve el resultado o produce una excepción si se produjo un error durante la operación. Para realizar la solicitud de forma sincrónica, llame AccountManagerFuture#getResult() inmediatamente al recibir el futuro del método; no es necesario proporcionar ninguna devolución de llamada.

Las solicitudes que pueden bloquearse, incluidas AccountManagerFuture#getResult(), nunca deben llamarse en el subproceso de eventos principal de la aplicación. Estas operaciones inician IllegalStateException si se usan en el subproceso principal.

Java documentación para android.accounts.AccountManager.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Constructores

Nombre Description
AccountManager(IntPtr, JniHandleOwnership)

Constructor utilizado al crear representaciones administradas de objetos JNI; llamado por el tiempo de ejecución.

Campos

Nombre Description
ActionAccountRemoved

Acción enviada como intención de difusión por accountsService cuando se quita o cambia el nombre de cualquier cuenta.

ActionAuthenticatorIntent
AuthenticatorAttributesName
AuthenticatorMetaDataName
ErrorCodeBadArguments
ErrorCodeBadAuthentication
ErrorCodeBadRequest
ErrorCodeCanceled
ErrorCodeInvalidResponse
ErrorCodeNetworkError
ErrorCodeRemoteException
ErrorCodeUnsupportedOperation
KeyAccountAuthenticatorResponse
KeyAccountManagerResponse
KeyAccountName

Clave de agrupación usada para el nombre de la String cuenta en los resultados de los métodos que devuelven información sobre una cuenta determinada.

KeyAccounts
KeyAccountSessionBundle

Clave de agrupación usada para un Bundle resultado de #startAddAccountSession y amigos que devuelve datos de sesión para instalar una cuenta más adelante.

KeyAccountStatusToken

Clave de agrupación usada para el token de estado de la String cuenta como resultado de #startAddAccountSession y amigos, que devuelve información sobre una cuenta determinada.

KeyAccountType

Clave de agrupación usada para el String tipo de cuenta en los resultados de los métodos que devuelven información sobre una cuenta determinada.

KeyAndroidPackageName

El paquete de Android del autor de la llamada se establecerá en la agrupación de opciones por AccountManager y se pasará a AccountManagerService y a accountAuthenticators.

KeyAuthenticatorTypes
KeyAuthFailedMessage
KeyAuthtoken

Clave de agrupación usada para el valor del token de autenticación en los resultados de #getAuthToken y amigos.

KeyAuthTokenLabel
KeyBooleanResult
KeyCallerPid

Identificador de proceso de la aplicación de llamador.

KeyCallerUid

UiD de la aplicación de llamador.

KeyErrorCode
KeyErrorMessage
KeyIntent

Clave de agrupación usada para los Intent resultados de los métodos que pueden requerir que el autor de la llamada interactúe con el usuario.

KeyLastAuthenticatedTime

Clave de agrupación usada para proporcionar la última vez que las credenciales de la cuenta se autenticaron correctamente.

KeyPassword

Clave de agrupación que se usa para proporcionar la contraseña directamente en opciones a #confirmCredentials, en lugar de solicitar al usuario el mensaje de contraseña estándar.

KeyUserdata
LoginAccountsChangedAction

Acción enviada como intención de difusión por accountsService cuando se agregan cuentas, se quitan las cuentas o se cambian las credenciales de una cuenta (contraseña guardada, etc.).

PackageNameKeyLegacyNotVisible

Clave para establecer la visibilidad predeterminada de las aplicaciones que no cumplen las condiciones de #PACKAGE_NAME_KEY_LEGACY_VISIBLE.

PackageNameKeyLegacyVisible

Clave para establecer la visibilidad de las aplicaciones que cumplen una de las condiciones siguientes: <ul li Target API level below (Ul><li>Target API level belowandroid.os.Build.VERSION_CODES#O) y have deprecated permission (Permiso en desusoandroid.Manifest.permission#GET_ACCOUNTS).

Propiedades

Nombre Description
Class

Devuelve la clase en tiempo de ejecución de este Objectobjeto .

(Heredado de Object)
Handle

Identificador de la instancia de Android subyacente.

(Heredado de Object)
JniIdentityHashCode

Obtiene el código hash de identidad asignado a este Java del mismo nivel por el tiempo de ejecución de interoperabilidad.

(Heredado de Object)
JniManagedPeerState

Esta clase proporciona acceso a un registro centralizado de las cuentas en línea del usuario.

(Heredado de JavaObject)
JniPeerMembers

Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código.

PeerReference

Obtiene la referencia de objeto JNI para este Java del mismo nivel.

(Heredado de Object)
ThresholdClass

Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código.

ThresholdType

Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código.

Métodos

Nombre Description
AddAccount(String, String, String[], Bundle, Activity, IAccountManagerCallback, Handler)

Pide al usuario que agregue una cuenta de un tipo especificado.

AddAccountExplicitly(Account, String, Bundle, IDictionary<String,Integer>)

Agrega una cuenta directamente al AccountManager.

AddAccountExplicitly(Account, String, Bundle)

Agrega una cuenta directamente al AccountManager.

AddOnAccountsUpdatedListener(IOnAccountsUpdateListener, Handler, Boolean, String[])

Agrega un OnAccountsUpdateListener objeto a esta instancia de .AccountManager

AddOnAccountsUpdatedListener(IOnAccountsUpdateListener, Handler, Boolean)

Agrega un OnAccountsUpdateListener objeto a esta instancia de .AccountManager

BlockingGetAuthToken(Account, String, Boolean)

Este asistente de conveniencia obtiene de forma sincrónica un token de autenticación con #getAuthToken(Account, String, boolean, AccountManagerCallback, Handler).

ClearPassword(Account)

Olvida una contraseña guardada.

Clone()

Crea y devuelve una copia de este objeto.

(Heredado de Object)
ConfirmCredentials(Account, Bundle, Activity, IAccountManagerCallback, Handler)

Confirma que el usuario conoce la contraseña de una cuenta para asegurarse de que es el propietario de la cuenta.

Construct(JniObjectReference, JniObjectReferenceOptions)

Esta clase proporciona acceso a un registro centralizado de las cuentas en línea del usuario.

(Heredado de JavaObject)
Dispose()

Libera los recursos mantenidos por este Java del mismo nivel.

(Heredado de Object)
Dispose(Boolean)

Libera los recursos mantenidos por este Java del mismo nivel.

(Heredado de Object)
DisposeUnlessReferenced()

Esta clase proporciona acceso a un registro centralizado de las cuentas en línea del usuario.

(Heredado de JavaObject)
EditProperties(String, Activity, IAccountManagerCallback, Handler)

Ofrece al usuario una oportunidad para cambiar la configuración de un autenticador.

Equals(Object)

Esta clase proporciona acceso a un registro centralizado de las cuentas en línea del usuario.

(Heredado de JavaObject)
Equals(Object)

Indica si algún otro objeto es "igual a" este.

(Heredado de Object)
FinishSession(Bundle, Activity, IAccountManagerCallback, Handler)

Finaliza la sesión iniciada por #startAddAccountSession o #startUpdateCredentialsSession.

FromContext(Context)

Obtiene una instancia del administrador de cuentas asociada a un contexto.

Get(Context)

Obtiene una instancia de AccountManager asociada a un contexto.

GetAccounts()

Enumera todas las cuentas visibles para el autor de la llamada independientemente del tipo.

GetAccountsAndVisibilityForPackage(String, String)

Obtiene todas las cuentas de tipo especificado y su visibilidad para un paquete específico.

GetAccountsByType(String)

Enumera todas las cuentas de tipo determinado visibles para el autor de la llamada.

GetAccountsByTypeAndFeatures(String, String[], IAccountManagerCallback, Handler)

Enumera todas las cuentas de un tipo que tienen determinadas características.

GetAccountsByTypeForPackage(String, String)

Devuelve las cuentas visibles para el paquete especificado en un entorno en el que algunas aplicaciones no están autorizadas para ver todas las cuentas.

GetAccountVisibility(Account, String)

Obtenga visibilidad de determinadas cuentas para una aplicación determinada.

GetAuthenticatorTypes()

Enumera los autenticadores registrados actualmente.

GetAuthToken(Account, String, Boolean, IAccountManagerCallback, Handler)
Obsoletos.

Obtiene un token de autenticación del tipo especificado para una cuenta determinada, lo que opcionalmente genera una notificación si el usuario debe escribir credenciales.

GetAuthToken(Account, String, Bundle, Activity, IAccountManagerCallback, Handler)

Obtiene un token de autenticación del tipo especificado para una cuenta determinada, que solicita al usuario las credenciales si es necesario.

GetAuthToken(Account, String, Bundle, Boolean, IAccountManagerCallback, Handler)

Obtiene un token de autenticación del tipo especificado para una cuenta determinada, lo que opcionalmente genera una notificación si el usuario debe escribir credenciales.

GetAuthTokenByFeatures(String, String, String[], Activity, Bundle, Bundle, IAccountManagerCallback, Handler)

Este asistente de conveniencia combina la funcionalidad de #getAccountsByTypeAndFeatures, #getAuthTokeny #addAccount.

GetHashCode()

Devuelve un valor de código hash para el objeto .

(Heredado de Object)
GetPackagesAndVisibilityForAccount(Account)

Devuelve nombres de paquete y visibilidad que se establecieron explícitamente para una cuenta determinada.

GetPassword(Account)

Obtiene la contraseña guardada asociada a la cuenta.

GetPreviousName(Account)

Obtiene el nombre anterior asociado a la cuenta o null, si no existe.

GetUserData(Account, String)

Obtiene los datos de usuario denominados por "clave" asociados a la cuenta.

HasFeatures(Account, String[], IAccountManagerCallback, Handler)

Descubre si una cuenta determinada tiene todas las características especificadas.

InvalidateAuthToken(String, String)

Quita un token de autenticación de la memoria caché del AccountManager.

IsCredentialsUpdateSuggested(Account, String, IAccountManagerCallback, Handler)

Comprueba si #updateCredentials se debe llamar a o #startUpdateCredentialsSession con respecto a la cuenta especificada.

JavaFinalize()
Obsoletos.

Lo llama el recolector de elementos no utilizados en un objeto cuando la recolección de elementos no utilizados determina que no hay más referencias al objeto .

(Heredado de Object)
NewChooseAccountIntent(Account, IList<Account>, String[], Boolean, String, String, String[], Bundle)
Obsoletos.

En desuso en favor de #newChooseAccountIntent(Account, List, String[], String, String, String[], Bundle).

NewChooseAccountIntent(Account, IList<Account>, String[], String, String, String[], Bundle)

Devuelve una intención a un Activity objeto que pide al usuario que elija una lista de cuentas.

Notify()

Activa un único subproceso que está esperando en el monitor de este objeto.

(Heredado de Object)
NotifyAccountAuthenticated(Account)

Notifica al sistema que la cuenta acaba de autenticarse.

NotifyAll()

Activa todos los subprocesos que están esperando en el monitor de este objeto.

(Heredado de Object)
PeekAuthToken(Account, String)

Obtiene un token de autenticación de la memoria caché del AccountManager.

RemoveAccount(Account, Activity, IAccountManagerCallback, Handler)

Quita una cuenta del AccountManager.

RemoveAccount(Account, IAccountManagerCallback, Handler)
Obsoletos.

Quita una cuenta del AccountManager.

RemoveAccountExplicitly(Account)

Quita una cuenta directamente.

RemoveOnAccountsUpdatedListener(IOnAccountsUpdateListener)

Quita un objeto OnAccountsUpdateListener registrado anteriormente con #addOnAccountsUpdatedListener.

RenameAccount(Account, String, IAccountManagerCallback, Handler)

Cambie el nombre del especificado Account.

SetAccountVisibility(Account, String, AccountVisibility)

Establezca el valor de visibilidad de una cuenta determinada en un paquete determinado.

SetAuthToken(Account, String, String)

Agrega un token de autenticación a la caché de AccountManager para una cuenta.

SetHandle(IntPtr, JniHandleOwnership)

Establece la propiedad Handle.

(Heredado de Object)
SetPassword(Account, String)

Establece o olvida una contraseña guardada.

SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

Esta clase proporciona acceso a un registro centralizado de las cuentas en línea del usuario.

(Heredado de JavaObject)
SetUserData(Account, String, String)

Establece una clave userdata para una cuenta.

StartAddAccountSession(String, String, String[], Bundle, Activity, IAccountManagerCallback, Handler)

Pide al usuario que se autentique con una cuenta de un tipo especificado.

StartUpdateCredentialsSession(Account, String, Bundle, Activity, IAccountManagerCallback, Handler)

Pide al usuario que escriba una nueva contraseña para la cuenta, pero no actualice las credenciales guardadas de la cuenta hasta #finishSession que se llame a .

ToArray<T>()

Crea una matriz administrada a partir de este contenedor de matriz Java.

(Heredado de Object)
ToString()

Devuelve una representación de cadena del objeto .

(Heredado de Object)
UnregisterFromRuntime()

Anula el registro de este Java del mismo nivel del tiempo de ejecución de interoperabilidad.

(Heredado de Object)
UpdateCredentials(Account, String, Bundle, Activity, IAccountManagerCallback, Handler)

Pide al usuario que escriba una nueva contraseña para una cuenta y actualice las credenciales guardadas de la cuenta.

Wait()

Hace que el subproceso actual espere hasta que se despierte, normalmente por ser em notificado/em< o >em<interrumpido>/em<.><>

(Heredado de Object)
Wait(Int64, Int32)

Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real.

(Heredado de Object)
Wait(Int64)

Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real.

(Heredado de Object)

Eventos

Nombre Description
AccountsUpdated

Se produce cuando el administrador de cuentas se inicia y cada vez que cambia el conjunto de cuentas.

Implementaciones de interfaz explícitas

Nombre Description
IJavaPeerable.Disposed()

Esta clase proporciona acceso a un registro centralizado de las cuentas en línea del usuario.

(Heredado de JavaObject)
IJavaPeerable.Finalized()

Esta clase proporciona acceso a un registro centralizado de las cuentas en línea del usuario.

(Heredado de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

Esta clase proporciona acceso a un registro centralizado de las cuentas en línea del usuario.

(Heredado de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

Esta clase proporciona acceso a un registro centralizado de las cuentas en línea del usuario.

(Heredado de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

Esta clase proporciona acceso a un registro centralizado de las cuentas en línea del usuario.

(Heredado de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

Esta clase proporciona acceso a un registro centralizado de las cuentas en línea del usuario.

(Heredado de JavaObject)

Métodos de extensión

Nombre Description
GetJniTypeName(IJavaPeerable)

Obtiene el nombre JNI del tipo de la instancia self.

JavaAs<TResult>(IJavaPeerable)

Intente coerción self para escribir TResult, comprobando que la coerción es válida en el lado de Java.

JavaCast<TResult>(IJavaObject)

Realiza una conversión de tipos comprobados en tiempo de ejecución de Android.

JavaCast<TResult>(IJavaObject)

Esta clase proporciona acceso a un registro centralizado de las cuentas en línea del usuario.

TryJavaCast<TResult>(IJavaPeerable, TResult)

Intente coerción self para escribir TResult, comprobando que la coerción es válida en el lado de Java.

Se aplica a