Idioma

AccountManager Classe

Definição

Essa classe fornece acesso a um registro centralizado das contas online do usuário.

[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
Herança
AccountManager
Atributos

Comentários

Essa classe fornece acesso a um registro centralizado das contas online do usuário. O usuário insere credenciais (nome de usuário e senha) uma vez por conta, concedendo aos aplicativos acesso a recursos online com aprovação de "um clique".

Diferentes serviços online têm diferentes maneiras de lidar com contas e autenticação, portanto, o gerenciador de contas usa módulos de autenticador conectáveis para diferentes tipos de conta. Os autenticadores (que podem ser gravados por terceiros) lidam com os detalhes reais da validação das credenciais da conta e do armazenamento de informações da conta. Por exemplo, Google, Facebook e Microsoft Exchange cada um tem seu próprio autenticador.

Muitos servidores dão suporte a alguma noção de um token de autenticação, que pode ser usado para autenticar uma solicitação no servidor sem enviar a senha real do usuário. (Os tokens de autenticação normalmente são criados com uma solicitação separada que inclui as credenciais do usuário.) AccountManager pode gerar tokens de autenticação para aplicativos, portanto, o aplicativo não precisa lidar diretamente com senhas. Os tokens de autenticação normalmente são reutilizáveis e armazenados em cache pelo AccountManager, mas devem ser atualizados periodicamente. É responsabilidade dos aplicativos invalidar tokens de autenticação quando eles param de funcionar para que o AccountManager saiba que precisa regenerizá-los.

Os aplicativos que acessam um servidor normalmente passam por estas etapas:

<ul><li>Obter uma instância de AccountManager usando #get(Context).

<li>Listar as contas disponíveis usando #getAccountsByType ou #getAccountsByTypeAndFeatures. Normalmente, os aplicativos só estarão interessados em contas com um tipo específico, que identifica o autenticador. Os recursos da conta são usados para identificar subtipos e recursos de conta específicos. O tipo de conta e os recursos são cadeias de caracteres específicas do autenticador e devem ser conhecidos pelo aplicativo em coordenação com seus autenticadores preferenciais.

<li>Selecione uma ou mais das contas disponíveis, possivelmente solicitando ao usuário sua preferência. Se nenhuma conta adequada estiver disponível, #addAccount poderá ser chamada para solicitar que o usuário crie uma conta do tipo apropriado.

<li><b>Importante:</b> Se o aplicativo estiver usando uma seleção de conta lembrada anteriormente, ele deve verificar se a conta ainda está na lista de contas retornadas por #getAccountsByType. A solicitação de um token de autenticação para uma conta que não está mais no dispositivo resulta em uma falha indefinida.

<li>Solicitar um token de autenticação para as contas selecionadas usando um dos #getAuthToken métodos ou auxiliares relacionados. Consulte a descrição de cada método para obter detalhes exatos de uso e tratamento de erros.

<li>Fazer a solicitação usando o token de autenticação. A forma do token de autenticação, o formato da solicitação e o protocolo usado são todos específicos para o serviço que você está acessando. O aplicativo pode usar qualquer rede e bibliotecas de protocolo que sejam úteis.

<li><b>Importante:</b> Se a solicitação falhar com um erro de autenticação, pode ser que um token de autenticação armazenado em cache esteja obsoleto e não seja mais respeitado pelo servidor. O aplicativo deve chamar #invalidateAuthToken para remover o token do cache, caso contrário, as solicitações continuarão falhando! Depois de invalidar o token de autenticação, volte imediatamente para a etapa "Solicitar um token de autenticação" acima. Se o processo falhar na segunda vez, ele poderá ser tratado como uma falha de autenticação "genuína" e o usuário notificado ou outras ações apropriadas tomadas. </ul>

Alguns métodos AccountManager podem precisar interagir com o usuário para solicitar credenciais, apresentar opções ou solicitar que o usuário adicione uma conta. O chamador pode escolher se deseja permitir que AccountManager inicie diretamente a interface do usuário necessária e aguarde o usuário ou retorne uma Intenção que o chamador pode usar para iniciar a interface ou (em alguns casos) para instalar uma notificação que o usuário pode selecionar a qualquer momento para iniciar a interface. Para que o AccountManager inicie a interface diretamente, o chamador deve fornecer o contexto de primeiro plano Activity atual.

Muitos métodos AccountManager tomam AccountManagerCallback e Handler como parâmetros. Esses métodos retornam imediatamente e são executados de forma assíncrona. Se um retorno de chamada for fornecido, será AccountManagerCallback#run invocado no thread do Manipulador quando a solicitação for concluída, com êxito ou não. O resultado é recuperado chamando AccountManagerFuture#getResult() o AccountManagerFuture método retornado (e também passado para o retorno de chamada). Esse método aguarda a conclusão da operação (se necessário) e retorna o resultado ou gera uma exceção se ocorreu um erro durante a operação. Para fazer a solicitação de forma síncrona, chame AccountManagerFuture#getResult() imediatamente ao receber o futuro do método; nenhum retorno de chamada precisa ser fornecido.

As solicitações que podem bloquear, inclusive AccountManagerFuture#getResult(), nunca devem ser chamadas no thread de evento principal do aplicativo. Essas operações serão geradas IllegalStateException se forem usadas no thread principal.

Java documentação para android.accounts.AccountManager.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Construtores

Nome Descrição
AccountManager(IntPtr, JniHandleOwnership)

Um construtor usado ao criar representações gerenciadas de objetos JNI; chamado pelo runtime.

Campos

Nome Descrição
ActionAccountRemoved

Ação enviada como uma intenção de difusão pelo AccountsService quando qualquer conta é removida ou renomeada.

ActionAuthenticatorIntent

Identifica a ação de intenção usada para descobrir serviços de autenticador de conta.

AuthenticatorAttributesName

Identifica o elemento XML raiz usado ao analisar os metadados de serviço de um autenticador.

AuthenticatorMetaDataName

Identifica a entrada de metadados de serviço que contém uma descrição de autenticador de conta.

ErrorCodeBadArguments
Obsoleto.

Identifica um erro de conta que o tratamento de resultados converte em uma exceção de argumento inválido.

ErrorCodeBadAuthentication
Obsoleto.

O identificador de erro da API de ERROR_CODE_BAD_AUTHENTICATION conta nativa, com valor 9.

ErrorCodeBadRequest
Obsoleto.

Identifica uma solicitação de conta incorreta, incluindo um pacote de sessão de conta que não pode ser descriptografado.

ErrorCodeCanceled
Obsoleto.

Identifica uma solicitação de conta que foi cancelada.

ErrorCodeInvalidResponse
Obsoleto.

Identifica uma resposta ausente ou inválida de um autenticador de conta.

ErrorCodeNetworkError
Obsoleto.

Identifica um erro de conta que o tratamento de resultados converte em uma falha de E/S.

ErrorCodeRemoteException
Obsoleto.

Identifica uma chamada de serviço de conta ou falha de conexão, incluindo exceções remotas e desconexão.

ErrorCodeUnsupportedOperation
Obsoleto.

Identifica uma solicitação de conta para uma operação que o autenticador não dá suporte.

KeyAccountAuthenticatorResponse

Identifica o extra de intenção que leva a resposta do autenticador de conta a uma atividade de autenticação.

KeyAccountManagerResponse

Identifica o extra de intenção que carrega a resposta usada para retornar uma opção de conta ao gerenciador de contas.

KeyAccountName

Chave de pacote usada para o nome da String conta em resultados de métodos que retornam informações sobre uma conta específica.

KeyAccounts

Identifica a entrada de pacote que contém objetos de conta retornados por uma consulta de conta.

KeyAccountSessionBundle

Chave de pacote usada para um Bundle resultado de e amigos que retorna dados de #startAddAccountSession sessão para instalar uma conta posteriormente.

KeyAccountStatusToken

Chave de pacote usada para o String token de status da conta em resultado de #startAddAccountSession amigos e que retorna informações sobre uma conta específica.

KeyAccountType

Chave de pacote usada para o String tipo de conta em resultados de métodos que retornam informações sobre uma conta específica.

KeyAndroidPackageName

O pacote android do chamador será definido no pacote de opções pelo AccountManager e será passado para o AccountManagerService e para os AccountAuthenticators.

KeyAuthenticatorTypes

A constante de cadeia de caracteres da API de KEY_AUTHENTICATOR_TYPES conta nativa, com valor authenticator_types.

KeyAuthFailedMessage

Identifica a mensagem de pacote de resultados usada em uma notificação de falha de entrada da conta.

KeyAuthtoken

Chave de pacote usada para o valor do token de autenticação em resultados de #getAuthToken e amigos.

KeyAuthTokenLabel

Identifica a entrada de pacote de resultados que contém um rótulo de token de autenticação.

KeyBooleanResult

Identifica a entrada de pacote de resultados que contém um resultado de operação de conta booliana.

KeyCallerPid

A ID do processo do aplicativo de chamador.

KeyCallerUid

A UID do aplicativo de chamadas.

KeyErrorCode

Identifica a entrada do pacote de resultados que contém um código de erro de conta.

KeyErrorMessage

Identifica a entrada do pacote de resultados que contém uma mensagem de erro de conta.

KeyIntent

Chave de pacote usada para resultados Intent de métodos que podem exigir que o chamador interaja com o usuário.

KeyLastAuthenticatedTime

Chave de pacote usada para fornecer a última vez que as credenciais da conta foram autenticadas com êxito.

KeyPassword

Chave de pacote usada para fornecer a senha diretamente em opções para #confirmCredentials, em vez de solicitar ao usuário o prompt de senha padrão.

KeyUserdata

A constante de cadeia de caracteres da API de KEY_USERDATA conta nativa, com valor userdata.

LoginAccountsChangedAction

Ação enviada como uma intenção de difusão pelo AccountsService quando as contas são adicionadas, as contas são removidas ou as credenciais de uma conta (senha salva etc) são alteradas.

PackageNameKeyLegacyNotVisible

Chave para definir a visibilidade padrão para aplicativos que não atendem às condições em #PACKAGE_NAME_KEY_LEGACY_VISIBLE.

PackageNameKeyLegacyVisible

Chave para definir a visibilidade de aplicativos que atendem a uma das seguintes condições: <ul><li>nível de API de destino abaixo android.os.Build.VERSION_CODES#O e ter permissão preterida android.Manifest.permission#GET_ACCOUNTS .

Propriedades

Nome Descrição
Class

Retorna a classe de runtime deste Object.

(Herdado de Object)
Handle

O identificador para a instância subjacente do Android.

(Herdado de Object)
JniIdentityHashCode

Obtém o código de hash de identidade atribuído a esse par Java pelo runtime de interoperabilidade.

(Herdado de Object)
JniManagedPeerState

Obtém os sinalizadores de estado atribuídos pela última vez pelo runtime.

(Herdado de JavaObject)
JniPeerMembers

Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código.

PeerReference

Obtém a referência de objeto JNI para este par Java.

(Herdado de Object)
ThresholdClass

Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código.

ThresholdType

Essa API dá suporte à infraestrutura do Mono para Android e não se destina a ser usada diretamente do seu código.

Métodos

Nome Descrição
AddAccount(String, String, String[], Bundle, Activity, IAccountManagerCallback, Handler)

Pede ao usuário para adicionar uma conta de um tipo especificado.

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

Adiciona uma conta diretamente ao AccountManager.

AddAccountExplicitly(Account, String, Bundle)

Adiciona uma conta diretamente ao AccountManager.

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

Adiciona uma OnAccountsUpdateListener a esta instância do AccountManager.

AddOnAccountsUpdatedListener(IOnAccountsUpdateListener, Handler, Boolean)

Adiciona uma OnAccountsUpdateListener a esta instância do AccountManager.

BlockingGetAuthToken(Account, String, Boolean)

Esse auxiliar de conveniência obtém de forma síncrona um token de autenticação com #getAuthToken(Account, String, boolean, AccountManagerCallback, Handler).

ClearPassword(Account)

Esquece uma senha salva.

Clone()

Cria e retorna uma cópia desse objeto.

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

Confirma que o usuário sabe a senha de uma conta para garantir que ele seja o proprietário da conta.

Construct(JniObjectReference, JniObjectReferenceOptions)

Delega a construção desse par ao gerenciador de valores do runtime.

(Herdado de JavaObject)
Dispose()

Libera os recursos mantidos por esse par Java.

(Herdado de Object)
Dispose(Boolean)

Libera os recursos mantidos por esse par Java.

(Herdado de Object)
DisposeUnlessReferenced()

Pede ao gerenciador de valores para descartar esse par, a menos que seu mapeamento mantenha essa mesma instância gerenciada.

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

Oferece ao usuário uma oportunidade de alterar as configurações de um autenticador.

Equals(Object)

Testa se outro par gerenciado se refere ao mesmo objeto Java.

(Herdado de JavaObject)
Equals(Object)

Indica se algum outro objeto é "igual a" este.

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

Conclui a sessão iniciada por #startAddAccountSession ou #startUpdateCredentialsSession.

FromContext(Context)

Obtém uma instância do gerenciador de contas associada a um contexto.

Get(Context)

Obtém uma instância AccountManager associada a um Contexto.

GetAccounts()

Lista todas as contas visíveis para o chamador, independentemente do tipo.

GetAccountsAndVisibilityForPackage(String, String)

Obtém todas as contas de determinado tipo e sua visibilidade para um pacote específico.

GetAccountsByType(String)

Lista todas as contas de determinado tipo visíveis para o chamador.

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

Lista todas as contas de um tipo que têm determinados recursos.

GetAccountsByTypeForPackage(String, String)

Retorna as contas visíveis para o pacote especificado em um ambiente em que alguns aplicativos não estão autorizados a exibir todas as contas.

GetAccountVisibility(Account, String)

Obtenha visibilidade de determinada conta para determinado aplicativo.

GetAuthenticatorTypes()

Lista os autenticadores registrados no momento.

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

Obtém um token de autenticação do tipo especificado para uma conta específica, opcionalmente, gerando uma notificação se o usuário precisar inserir credenciais.

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

Obtém um token de autenticação do tipo especificado para uma conta específica, solicitando ao usuário credenciais, se necessário.

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

Obtém um token de autenticação do tipo especificado para uma conta específica, opcionalmente, gerando uma notificação se o usuário precisar inserir credenciais.

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

Esse auxiliar de conveniência combina a funcionalidade de #getAccountsByTypeAndFeatures, #getAuthTokene #addAccount.

GetHashCode()

Retorna um valor de código hash para o objeto.

(Herdado de Object)
GetPackagesAndVisibilityForAccount(Account)

Retorna nomes de pacote e visibilidade que foram explicitamente definidos para determinada conta.

GetPassword(Account)

Obtém a senha salva associada à conta.

GetPreviousName(Account)

Obtém o nome anterior associado à conta ou null, se nenhum.

GetUserData(Account, String)

Obtém os dados do usuário nomeados por "chave" associados à conta.

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

Descobre se uma conta específica tem todos os recursos especificados.

InvalidateAuthToken(String, String)

Remove um token de autenticação do cache do AccountManager.

IsCredentialsUpdateSuggested(Account, String, IAccountManagerCallback, Handler)

Verifica se #updateCredentials#startUpdateCredentialsSession ou deve ser chamado em relação à conta especificada.

JavaFinalize()
Obsoleto.

Chamado pelo coletor de lixo em um objeto quando a coleta de lixo determina que não há mais referências ao objeto.

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

Preterido em favor de #newChooseAccountIntent(Account, List, String[], String, String, String[], Bundle).

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

Retorna uma intenção para um Activity que solicita que o usuário escolha entre uma lista de contas.

Notify()

Ativa um único thread que está aguardando no monitor deste objeto.

(Herdado de Object)
NotifyAccountAuthenticated(Account)

Notifica o sistema de que a conta acabou de ser autenticada.

NotifyAll()

Ativa todos os threads que estão aguardando no monitor deste objeto.

(Herdado de Object)
PeekAuthToken(Account, String)

Obtém um token de autenticação do cache do AccountManager.

RemoveAccount(Account, Activity, IAccountManagerCallback, Handler)

Remove uma conta do AccountManager.

RemoveAccount(Account, IAccountManagerCallback, Handler)
Obsoleto.

Remove uma conta do AccountManager.

RemoveAccountExplicitly(Account)

Remove uma conta diretamente.

RemoveOnAccountsUpdatedListener(IOnAccountsUpdateListener)

Remove um OnAccountsUpdateListener registrado anteriormente com #addOnAccountsUpdatedListener.

RenameAccount(Account, String, IAccountManagerCallback, Handler)

Renomeie o especificado Account.

SetAccountVisibility(Account, String, AccountVisibility)

Defina o valor de visibilidade de determinada conta para determinado pacote.

SetAuthToken(Account, String, String)

Adiciona um token de autenticação ao cache AccountManager para uma conta.

SetHandle(IntPtr, JniHandleOwnership)

Define a propriedade Handle

(Herdado de Object)
SetPassword(Account, String)

Define ou esquece uma senha salva.

SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

Armazena um valor de referência no bloco de controle sem criar uma cópia de referência JNI.

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

Define uma chave userdata para uma conta.

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

Solicita que o usuário se autentique com uma conta de um tipo especificado.

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

Solicita que o usuário insira uma nova senha para a conta, mas não atualize as credenciais salvas para a conta até #finishSession que seja chamada.

ToArray<T>()

Cria uma matriz gerenciada com base nesse wrapper de matriz Java.

(Herdado de Object)
ToString()

Retorna uma representação de cadeia de caracteres do objeto.

(Herdado de Object)
UnregisterFromRuntime()

Cancela o registro desse par Java do runtime de interoperabilidade.

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

Solicita que o usuário insira uma nova senha para uma conta, atualizando as credenciais salvas para a conta.

Wait()

Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser notificado ou interrompido.

(Herdado de Object)
Wait(Int64, Int32)

Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser notificado ou interrompido, ou até que uma determinada quantidade de tempo real tenha decorrido.

(Herdado de Object)
Wait(Int64)

Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser notificado ou interrompido, ou até que uma determinada quantidade de tempo real tenha decorrido.

(Herdado de Object)

Eventos

Nome Descrição
AccountsUpdated

Ocorre quando o usuário ou um autenticador altera contas relacionadas ao chamador.

Implantações explícitas de interface

Nome Descrição
IJavaPeerable.Disposed()

Marca esse par como descartado e chama Dispose com disposing set to true.

(Herdado de JavaObject)
IJavaPeerable.Finalized()

Marca esse par como descartado e chama Dispose com disposing set to false.

(Herdado de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

Obtém o ponteiro de bloco de controle nativo usado por esse par.

(Herdado de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

Armazena o código de hash de identidade fornecido pelo runtime.

(Herdado de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

Substitui os sinalizadores de estado de par gerenciado armazenados.

(Herdado de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

Atualiza a referência de par e libera o bloco de controle de um par descartado quando a referência é inválida.

(Herdado de JavaObject)

Métodos de Extensão

Nome Descrição
GetJniTypeName(IJavaPeerable)

Obtém o nome JNI do tipo da instância self.

JavaAs<TResult>(IJavaPeerable)

Tente coagir a digitar selfTResult, verificando se a coerção é válida no lado Java.

JavaCast<TResult>(IJavaObject)

Executa uma conversão de tipo marcada por runtime do Android.

JavaCast<TResult>(IJavaObject)

Reutiliza um par gerenciado compatível ou obtém um wrapper do tipo solicitado.

TryJavaCast<TResult>(IJavaPeerable, TResult)

Tente coagir a digitar selfTResult, verificando se a coerção é válida no lado Java.

Aplica-se a