Dataset Klasse

Definition

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

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

Vererbung

Object

Object

Dataset

Attribute

RegisterAttribute

Implementiert

IParcelable IJavaObject IJavaPeerable IDisposable

Hinweise

Ein Dataset Objekt stellt eine Gruppe von Feldern (Schlüssel-/Wertpaare) dar, die zum automatischen Ausfüllen von Teilen eines Bildschirms verwendet werden.

Weitere Informationen zur Rolle von Datasets im Workflow zum automatischen Ausfüllen finden Sie unter "Erstellen von AutoAusfülldiensten" und der <a href="/reference/android/service/autofill/AutofillService">AutofillService</a> Dokumentation.

"BasicUsage"><h3>Basic usage</h3>

In seiner einfachsten Form enthält ein Dataset ein oder mehrere Felder (bestehend aus einem , einem AutofillId id, einem AutofillValue valueund einem optionalen Filter Pattern regex), und mindestens einem RemoteViews presentations für diese Felder (jedes Feld könnte über einen eigenen RemoteViews presentationverfügen oder den Standard RemoteViews presentation verwenden, der dem gesamten Dataset zugeordnet ist).

Wenn ein AutoAusfülldienst Datasets in einer FillResponse Ansicht zurückgibt und die Bildschirmeingabe in einer Ansicht fokussiert ist, die in mindestens einem dieser Datasets vorhanden ist, zeigt das Android-System eine Benutzeroberfläche mit allen RemoteViews presentation Datasets-Paaren an, die diese Ansicht AutofillIdaufweisen. Wenn der Benutzer dann ein Dataset aus der Benutzeroberfläche auswählt, werden alle Ansichten in diesem Dataset automatisch ausgefüllt.

Wenn sowohl die aktuelle Eingabemethode als auch der AutoAusfülldienst Inlinevorschläge unterstützt, kann das Dataset von der Tastatur als Vorschlag angezeigt werden. Um dieses Feature zu verwenden, sollte das Dataset eine InlinePresentation Darstellung enthalten, wie die Inlinevorschlagsbenutzeroberfläche gerendert wird.

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

Die Benutzeroberfläche des Fülldialogfelds ist eine auffälligere und effizientere Schnittstelle als die Dropdown-UI. Wenn Vorschläge zum automatischen Ausfüllen verfügbar sind, wenn der Benutzer auf ein Feld klickt, das das Ausfüllen der Dialogfeldbenutzeroberfläche unterstützt, wird ein Fülldialogfeld angezeigt. Das Dialogfeld nimmt einen größeren Bereich auf, um die Datasets anzuzeigen. Daher ist es für Benutzer einfach, die Datasets zu berücksichtigen und ein Dataset auszuwählen. Wenn der Benutzer sich auf die Ansicht konzentriert, bevor Vorschläge verfügbar sind, fällt er auf die Dropdown-UI oder Inlinevorschläge zurück.

"Authentifizierung"><h3>Dataset-Authentifizierung</h3>

In komplexerer Form können die Datasetwerte geschützt werden, bis der Benutzer das Dataset&mdash authentifiziert; In diesem Fall startet das Android-System, wenn ein Dataset vom Benutzer ausgewählt wird, eine Vom Dienst festgelegte Absicht, das Dataset zu entsperren.

Wenn ein Datensatz beispielsweise Kreditkarteninformationen enthält (z. B. Zahl, Ablaufdatum und Überprüfungscode), können Sie eine Datasetpräsentation mit dem Hinweis "Zum Authentifizieren tippen" bereitstellen. Wenn der Benutzer dann auf diese Option tippt, würden Sie eine Aktivität starten, die den Benutzer auffordern, den Kreditkartencode einzugeben, und wenn der Benutzer einen gültigen Code eingibt, könnten Sie das Dataset dann "entsperren".

Sie können auch authentifizierte Datasets verwenden, um dem Benutzer eine interaktive Benutzeroberfläche anzubieten. Wenn die Aktivität, die automatisch ausgefüllt wird, beispielsweise ein Kontoerstellungsbildschirm ist, können Sie ein authentifiziertes Dataset verwenden, um automatisch ein zufälliges Kennwort für den Benutzer zu generieren.

Weitere Informationen zum Datasetauthentifizierungsmechanismus finden Sie Dataset.Builder#setAuthentication(IntentSender) unter.

"Filterung"><h3>Filterung</h3>

Die Benutzeroberfläche für automatisches Ausfüllen ändert automatisch, welche Werte basierend auf dem Wert der Ansicht angezeigt werden, die sie verankert. Die folgenden Regeln folgen: <ol><li>Wenn die Ansicht android.view.View#getAutofillValue() autofill value nicht AutofillValue#isText() text oder leer ist, werden alle Datasets angezeigt. <li>Datasets mit einem Filter regex (festgelegt durch Field.Builder#setFilter(Pattern) und Dataset.Builder#setField(AutofillId, Field)) und dessen regex mit dem Textwert der Ansicht übereinstimmt, der in Kleinbuchstaben konvertiert wird. <li-Datasets>, die keine Authentifizierung erfordern, haben einen Feldwert AutofillValue#isText() text AutofillValue#getTextValue() value , der mit dem Kleinbuchstabewert des Texts der Ansicht beginnt. <li>Alle anderen Datasets sind ausgeblendet. </Ol>

Java-Dokumentation für android.service.autofill.Dataset.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Erweiterungsmethoden

Gilt für: