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 pluggable em authenticator</em> para diferentes <>tipos< de conta/em>.<> 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</em> de autenticação em, que pode ser usado para autenticar uma solicitação para o 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 <em invalidar>/emuth< tokens 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</em> específico<>, que identifica o autenticador. <Os >recursos</em> 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 Description
AccountManager(IntPtr, JniHandleOwnership)

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

Campos

Nome Description
ActionAccountRemoved

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

ActionAuthenticatorIntent
AuthenticatorAttributesName
AuthenticatorMetaDataName
ErrorCodeBadArguments
ErrorCodeBadAuthentication
ErrorCodeBadRequest
ErrorCodeCanceled
ErrorCodeInvalidResponse
ErrorCodeNetworkError
ErrorCodeRemoteException
ErrorCodeUnsupportedOperation
KeyAccountAuthenticatorResponse
KeyAccountManagerResponse
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
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
KeyAuthFailedMessage
KeyAuthtoken

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

KeyAuthTokenLabel
KeyBooleanResult
KeyCallerPid

A ID do processo do aplicativo de chamador.

KeyCallerUid

A UID do aplicativo de chamadas.

KeyErrorCode
KeyErrorMessage
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
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 Description
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

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

(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 Description
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)

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

(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()

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

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

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

Equals(Object)

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

(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)

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

(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é ser despertado, normalmente por ser <notificado/em> ou <em>interrompido</em>.<>

(Herdado de Object)
Wait(Int64, Int32)

Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, 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</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido.

(Herdado de Object)

Eventos

Nome Description
AccountsUpdated

Ocorre quando o gerenciador de contas é iniciado e sempre que o conjunto de contas é alterado.

Implantações explícitas de interface

Nome Description
IJavaPeerable.Disposed()

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

(Herdado de JavaObject)
IJavaPeerable.Finalized()

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

(Herdado de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

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

(Herdado de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

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

(Herdado de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

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

(Herdado de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

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

(Herdado de JavaObject)

Métodos de Extensão

Nome Description
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)

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

TryJavaCast<TResult>(IJavaPeerable, TResult)

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

Aplica-se a