Dataset.Builder.SetAuthentication(IntentSender) Método

[Android.Runtime.Register("setAuthentication", "(Landroid/content/IntentSender;)Landroid/service/autofill/Dataset$Builder;", "", ApiSince=26)]
public Android.Service.Autofill.Dataset.Builder SetAuthentication(Android.Content.IntentSender? authentication);

[<Android.Runtime.Register("setAuthentication", "(Landroid/content/IntentSender;)Landroid/service/autofill/Dataset$Builder;", "", ApiSince=26)>]
member this.SetAuthentication : Android.Content.IntentSender -> Android.Service.Autofill.Dataset.Builder

Parâmetros

Retornos

este construtor. Este valor não pode ser nulo.

Atributos

RegisterAttribute

Comentários

Dispara uma interface do usuário personalizada antes de filtrar automaticamente a tela com o conteúdo desse conjunto de dados.

Observação: embora o nome desse método sugira que ele deve ser usado apenas para o fluxo de autenticação, ele pode ser usado para outros fluxos avançados; consulte AutofillService para obter exemplos.

Esse método é chamado quando você precisa fornecer uma interface do usuário de autenticação para o conjunto de dados. Por exemplo, quando um conjunto de dados contém informações de cartão de crédito (como número, data de validade e código de verificação), você pode exibir a interface do usuário solicitando o código de verificação antes de arquivar nos dados. Mesmo que o conjunto de dados seja completamente preenchido, o sistema iniciará a intenção de autenticação especificada e precisará de sua aprovação para preenchê-la. Como o conjunto de dados é "bloqueado" até que o usuário o autentique, normalmente esse nome do conjunto de dados é mascarado (por exemplo, "VISA.... 1234"). Normalmente, você deseja armazenar os rótulos do conjunto de dados não criptografados e os dados confidenciais reais criptografados e não na memória. Isso permite mostrar os rótulos na interface do usuário ao envolver o usuário se um dos itens com esses rótulos for escolhido. Observe que, se você usar dados confidenciais como um rótulo, por exemplo, um endereço de email, ele também deverá ser criptografado.

Quando um usuário dispara o preenchimento automático, o sistema inicia a intenção fornecida cujos extras terão o conteúdo da tela e o estado do cliente. Depois de concluir o fluxo de autenticação, você deverá definir o resultado da atividade como Activity.RESULT_OK e fornecer o conjunto de dados totalmente preenchido ou uma resposta totalmente preenchida definindo-o como o AutofillManager.EXTRA_AUTHENTICATION_RESULT extra. Se você fornecer um conjunto de dados no resultado, ele substituirá o conjunto de dados autenticado e será preenchido imediatamente. Uma exceção a esse comportamento é se o conjunto de dados original representa uma sugestão embutida fixa (ou seja, qualquer um dos campos no conjunto de dados tem uma apresentação embutida fixa, consulte InlinePresentation.isPinned()), então o conjunto de dados original não será substituído, de modo que ele possa ser disparado como uma intenção pendente novamente. Se você fornecer uma resposta, ela substituirá a resposta atual e a interface do usuário será atualizada. Por exemplo, se você forneceu informações de cartão de crédito sem o CVV para o conjunto de dados na resposta, o conjunto de dados retornado deverá conter a entrada CVV.

Observação: não torne a intenção pendente fornecida imutável usando PendingIntent.FLAG_IMMUTABLE, pois a plataforma precisa preencher os argumentos de autenticação.

Referência do Android para android.service.autofill.Dataset.Builder.setAuthentication.

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.