AccountManager Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
- 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 |
| KeyAccounts | |
| KeyAccountSessionBundle |
Clave de agrupación usada para un |
| KeyAccountStatusToken |
Clave de agrupación usada para el token de estado de la |
| KeyAccountType |
Clave de agrupación usada para el |
| KeyAndroidPackageName |
El paquete de Android del autor de la llamada se establecerá en la agrupación de opciones por |
| KeyAuthenticatorTypes | |
| KeyAuthFailedMessage | |
| KeyAuthtoken |
Clave de agrupación usada para el valor del token de autenticación en los resultados de |
| 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 |
| 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 |
| 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 |
| 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 below |
Propiedades
| Nombre | Description |
|---|---|
| Class |
Devuelve la clase en tiempo de ejecución de este |
| 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 |
| AddOnAccountsUpdatedListener(IOnAccountsUpdateListener, Handler, Boolean) |
Agrega un |
| BlockingGetAuthToken(Account, String, Boolean) |
Este asistente de conveniencia obtiene de forma sincrónica un token de autenticación con |
| 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 |
| 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 |
| 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 |
| 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 |
| 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, IList<Account>, String[], String, String, String[], Bundle) |
Devuelve una intención a un |
| 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 |
| RenameAccount(Account, String, IAccountManagerCallback, Handler) |
Cambie el nombre del especificado |
| 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 |
| 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 |
| JavaAs<TResult>(IJavaPeerable) |
Intente coerción |
| 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 |