Dataset Classe

Definição

[Android.Runtime.Register("android/service/autofill/Dataset", ApiSince=26, DoNotGenerateAcw=true)]
public sealed class Dataset : Java.Lang.Object, Android.OS.IParcelable, IDisposable

[<Android.Runtime.Register("android/service/autofill/Dataset", ApiSince=26, DoNotGenerateAcw=true)>]
type Dataset = class
    inherit Object
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Herança

Object

JavaObject

Object

Dataset

Atributos

RegisterAttribute

Implementações

IParcelable IJavaObject IJavaPeerable IDisposable

Comentários

Um Dataset objeto representa um grupo de campos (pares chave/valor) usados para armazenar automaticamente partes de uma tela.

Para obter mais informações sobre a função de conjuntos de dados no fluxo de trabalho de preenchimento automático, leia os serviços de preenchimento automático build e a <a href="/reference/android/service/autofill/AutofillService">AutofillService</a> documentação.

"BasicUsage"><h3>Uso< básico/h3>

Em sua forma mais simples, um conjunto de dados contém um ou mais campos (composto por um AutofillId id, um AutofillValue valuee um filtro Pattern regexopcional); e um ou mais RemoteViews presentations para esses campos (cada campo pode ter o seu próprio RemoteViews presentationou usar o padrão RemoteViews presentation associado ao conjunto de dados inteiro).

Quando um serviço de preenchimento automático retorna conjuntos de dados em um FillResponse e a entrada da tela é focada em uma exibição que está presente em pelo menos um desses conjuntos de dados, o Sistema Android exibe uma interface do usuário que contém todos RemoteViews presentation os pares de conjuntos de dados que têm essa exibição AutofillId. Em seguida, quando o usuário seleciona um conjunto de dados na interface do usuário, todas as exibições nesse conjunto de dados são preenchidas automaticamente.

Se o método de entrada atual e o serviço de preenchimento automático derem suporte a sugestões embutidas, o conjunto de dados poderá ser mostrado pelo teclado como uma sugestão. Para usar esse recurso, o conjunto de dados deve conter uma InlinePresentation representação de como a interface do usuário da sugestão embutida será renderizada.

"FillDialogUI"><h3>Fill Dialog UI</h3>

A interface do usuário da caixa de diálogo de preenchimento é uma interface mais visível e eficiente do que a interface do usuário suspensa. Se as sugestões de preenchimento automático estiverem disponíveis quando o usuário clicar em um campo que dê suporte ao preenchimento da interface do usuário da caixa de diálogo, o preenchimento automático aparecerá em uma caixa de diálogo de preenchimento. A caixa de diálogo ocupará uma área maior para exibir os conjuntos de dados, portanto, é fácil para os usuários prestar atenção aos conjuntos de dados e selecionar um conjunto de dados. Se o usuário se concentrar na exibição antes que as sugestões estejam disponíveis, retornará à interface do usuário suspensa ou às sugestões embutidas.

"Autenticação"><h3>Autenticação< de conjunto de dados/h3>

De forma mais sofisticada, os valores do conjunto de dados podem ser protegidos até que o usuário autentique o conjunto de dados— nesse caso, quando um conjunto de dados é selecionado pelo usuário, o Sistema Android inicia uma intenção definida pelo serviço para "desbloquear" 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 fornecer uma apresentação de conjunto de dados dizendo "Toque para autenticar". Em seguida, quando o usuário toca nessa opção, você inicia uma atividade solicitando que o usuário insira o código do cartão de crédito e, se o usuário inserir um código válido, você poderá então "desbloquear" o conjunto de dados.

Você também pode usar conjuntos de dados autenticados para oferecer uma interface do usuário interativa para o usuário. Por exemplo, se a atividade que está sendo preenchida automaticamente for uma tela de criação de conta, você poderá usar um conjunto de dados autenticado para gerar automaticamente uma senha aleatória para o usuário.

Consulte Dataset.Builder#setAuthentication(IntentSender) mais detalhes sobre o mecanismo de autenticação do conjunto de dados.

"Filtragem"><h3>Filtragem</h3>

A interface do usuário de preenchimento automático altera automaticamente quais valores são mostrados com base no valor da exibição que a ancora, seguindo as regras abaixo: <ol><li>Se a exibição android.view.View#getAutofillValue() autofill value não AutofillValue#isText() text estiver ou estiver vazia, todos os conjuntos de dados serão mostrados. <os conjuntos de dados li>que têm um regex de filtro (definido por meio Field.Builder#setFilter(Pattern) e Dataset.Builder#setField(AutofillId, Field)) e cujo regex corresponde ao valor de texto do modo de exibição convertido em letras minúsculas são mostrados. <os conjuntos de dados li>que não exigem autenticação, têm um valor de campo que é AutofillValue#isText() text e cujos AutofillValue#getTextValue() value inícios com o valor de maiúsculas e minúsculas do texto da exibição são mostrados. <li>Todos os outros conjuntos de dados estão ocultos. </ol>

Observação: se o usuário inserir quatro ou mais caracteres, todos os conjuntos de dados ficarão ocultos

Java documentação para android.service.autofill.Dataset.

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.