SaveInfo Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Informationen, die verwendet werden, um anzugeben, dass ein AutofillService Interesse daran besteht, die vom Benutzer eingegebenen Daten für die zukünftige Verwendung über eine
AutofillService#onSaveRequest(SaveRequest, SaveCallback) call.
[Android.Runtime.Register("android/service/autofill/SaveInfo", ApiSince=26, DoNotGenerateAcw=true)]
public sealed class SaveInfo : Java.Lang.Object, Android.OS.IParcelable, IDisposable
[<Android.Runtime.Register("android/service/autofill/SaveInfo", ApiSince=26, DoNotGenerateAcw=true)>]
type SaveInfo = class
inherit Object
interface IParcelable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- Vererbung
- Attribute
- Implementiert
Hinweise
Informationen, die verwendet werden, um anzugeben, dass ein AutofillService Benutzer über einen AutofillService#onSaveRequest(SaveRequest, SaveCallback) Anruf die vom Benutzer eingegebenen Daten für die zukünftige Verwendung speichert.
A SaveInfo ist immer mit einem FillResponseElement verknüpft und enthält mindestens zwei Informationen:
<ol><li>Die Art(n) von Benutzerdaten (z. B. Kennwort- oder Kreditkarteninformationen), die gespeichert werden.
<li>Die minimale Gruppe von Ansichten (dargestellt durch ihre AutofillId) die geändert werden müssen, um eine Speicheranforderung auszulösen.
</ol>
In der Regel enthält die SaveInfo gleichen idElemente wie die:Dataset
new FillResponse.Builder()
.addDataset(new Dataset.Builder()
.setValue(id1, AutofillValue.forText("homer"), createPresentation("homer")) // username
.setValue(id2, AutofillValue.forText("D'OH!"), createPresentation("password for homer")) // password
.build())
.setSaveInfo(new SaveInfo.Builder(
SaveInfo.SAVE_DATA_TYPE_USERNAME | SaveInfo.SAVE_DATA_TYPE_PASSWORD,
new AutofillId[] { id1, id2 }).build())
.build();
Die Kennzeichnungen des Speichertyps werden verwendet, um die entsprechenden Zeichenfolgen in der Benutzeroberfläche zum speichern von AutoAusfüllen anzuzeigen. Sie können mehrere Werte übergeben, aber versuchen Sie, es möglichst kurz zu halten. Im obigen Beispiel wäre einfach SaveInfo.SAVE_DATA_TYPE_PASSWORD genug.
Es kann Fälle geben, in denen der AutofillService Benutzer weiß, wie der Bildschirm ausgefüllt wird, aber der Benutzer hat keine Daten dafür. In diesem Fall sollte dies FillResponse nur das SaveInfo, aber nein Dataset Datasetsenthalten:
new FillResponse.Builder()
.setSaveInfo(new SaveInfo.Builder(SaveInfo.SAVE_DATA_TYPE_PASSWORD,
new AutofillId[] { id1, id2 }).build())
.build();
Es kann Vorkommen geben, in denen die Benutzerdaten in der AutofillService Betreffenden ausreichend sind, um einige Felder, aber nicht alle aufzufüllen, und der Dienst würde weiterhin daran interessiert sein, die anderen Felder zu speichern. In diesem Fall könnte der Dienst auch folgendes SaveInfo.Builder#setOptionalIds(AutofillId[]) festlegen:
new FillResponse.Builder()
.addDataset(new Dataset.Builder()
.setValue(id1, AutofillValue.forText("742 Evergreen Terrace"),
createPresentation("742 Evergreen Terrace")) // street
.setValue(id2, AutofillValue.forText("Springfield"),
createPresentation("Springfield")) // city
.build())
.setSaveInfo(new SaveInfo.Builder(SaveInfo.SAVE_DATA_TYPE_ADDRESS,
new AutofillId[] { id1, id2 }) // street and city
.setOptionalIds(new AutofillId[] { id3, id4 }) // state and zipcode
.build())
.build();
"TriggeringSaveRequest"><h3>Triggering a save request</h3>
Dies AutofillService#onSaveRequest(SaveRequest, SaveCallback) kann nach einem der folgenden Ereignisse ausgelöst werden: <ul><li>The Activity finishes.
<li>Die App ruft explizit auf AutofillManager#commit().
<li>Alle erforderlichen Ansichten werden unsichtbar (wenn dies SaveInfo mit der #FLAG_SAVE_ON_ALL_VIEWS_INVISIBLE Kennzeichnung erstellt wurde).
<li>Der Benutzer klickt auf eine bestimmte Ansicht (definiert durch Builder#setTriggerId(AutofillId).
</ul>
Dies wird jedoch nur ausgelöst, wenn alle unten aufgeführten Bedingungen erfüllt sind: <ul><li>Der SaveInfo zugeordnete FillResponse Wert ist nicht null mit der #FLAG_DELAY_SAVE Kennzeichnung verbunden.
<li>Die AutofillValues aller erforderlichen Ansichten (wie durch den requiredIds an den SaveInfo.Builder Konstruktor übergebenen sind nicht leer.
<li>Die AutofillValue Mindestens eine Ansicht (sei es erforderlich oder optional) hat sich geändert (d. h., es ist weder derselbe Wert, der in einer DatasetAnsicht übergeben wird, noch der in der Ansicht dargestellte Anfangswert).
<li>Es gibt in Dataset der letzten FillResponse , die vollständig mit dem Bildschirmzustand übereinstimmt (d. h., alle erforderlichen und optionalen Felder im Dataset haben den gleichen Wert wie die Felder auf dem Bildschirm).
<li>Der Benutzer hat explizit auf die Benutzeroberfläche für das automatische Ausfüllen getippt, in der Sie aufgefordert werden, Daten für das automatische Ausfüllen zu speichern.
</ul>
"CustomizingSaveUI"><h3>Customizing the autofill save UI</h3>
Der Dienst kann auch einige Aspekte der Benutzeroberfläche zum speichern von AutoAusfüllen anpassen: <ul><li>Fügen Sie einen einfachen Untertitel hinzu, indem Sie aufrufenBuilder#setDescription(CharSequence).
<li>Fügen Sie einen benutzerdefinierten Untertitel durch Aufrufen hinzu Builder#setCustomDescription(CustomDescription).
<li>Passen Sie die Schaltfläche an, die zum Ablehnen der Speicheranforderung durch Aufrufen Builder#setNegativeAction(int, IntentSender)verwendet wird.
<li>Entscheiden Sie, ob die Benutzeroberfläche basierend auf der Benutzereingabeüberprüfung durch Aufrufen Builder#setValidator(Validator)angezeigt werden soll.
</ul>
Java Dokumentation für android.service.autofill.SaveInfo.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.
Felder
| Name | Beschreibung |
|---|---|
| NegativeButtonStyleNever |
Veraltet.
Formatvorlage für die negative Schaltfläche der Benutzeroberfläche zum Speichern, um den Speichervorgang nie auszuführen. |
| PositiveButtonStyleContinue |
Veraltet.
Formatvorlage für die positive Schaltfläche "Ui speichern", damit vor dem Speichervorgang die nächste Aktion ausgeführt wird. |
| PositiveButtonStyleSave |
Veraltet.
Formatvorlage für die positive Schaltfläche "Ui speichern", um den Speichervorgang anzufordern. |
| SaveDataTypeDebitCard |
Veraltet.
Typ, der |
| SaveDataTypeGenericCard |
Veraltet.
Typ, der verwendet wird, wenn die |
| SaveDataTypePaymentCard |
Veraltet.
Typ, der verwendet wird, wenn die |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Class |
Gibt die Laufzeitklasse dieses Werts |
| Creator |
Informationen, die verwendet werden, um anzugeben, dass ein |
| Handle |
Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object) |
| JniIdentityHashCode |
Ruft den Identitätshashcode ab, der diesem Java Peer von der Interop-Laufzeit zugewiesen ist. (Geerbt von Object) |
| JniManagedPeerState |
Informationen, die verwendet werden, um anzugeben, dass ein |
| JniPeerMembers |
Informationen, die verwendet werden, um anzugeben, dass ein |
| PeerReference |
Ruft den JNI-Objektverweis für diesen Java Peer ab. (Geerbt von Object) |
| ThresholdClass |
Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von Object) |
| ThresholdType |
Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von Object) |
Methoden
| Name | Beschreibung |
|---|---|
| Clone() |
Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Informationen, die verwendet werden, um anzugeben, dass ein |
| DescribeContents() |
Beschreiben Sie die Arten spezieller Objekte, die in der Marshall-Darstellung dieser Paketable-Instanz enthalten sind. |
| Dispose() |
Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object) |
| Dispose(Boolean) |
Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object) |
| DisposeUnlessReferenced() |
Informationen, die verwendet werden, um anzugeben, dass ein |
| Equals(Object) |
Informationen, die verwendet werden, um anzugeben, dass ein |
| Equals(Object) |
Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object) |
| GetHashCode() |
Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object) |
| JavaFinalize() |
Veraltet.
Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object) |
| Notify() |
Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object) |
| NotifyAll() |
Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object) |
| SetHandle(IntPtr, JniHandleOwnership) |
Legt die Handle-Eigenschaft fest. (Geerbt von Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Informationen, die verwendet werden, um anzugeben, dass ein |
| ToArray<T>() |
Erstellt ein verwaltetes Array aus diesem Java Arraywrapper. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object) |
| UnregisterFromRuntime() |
Hebt die Registrierung dieses Java Peers aus der Interop-Laufzeit auf. (Geerbt von Object) |
| Wait() |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em< oder >em<unterbrochen>/em<.><> (Geerbt von Object) |
| Wait(Int64, Int32) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
| Wait(Int64) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
| WriteToParcel(Parcel, ParcelableWriteFlags) |
Flachen Sie dieses Objekt in ein Paket. |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IJavaPeerable.Disposed() |
Informationen, die verwendet werden, um anzugeben, dass ein |
| IJavaPeerable.Finalized() |
Informationen, die verwendet werden, um anzugeben, dass ein |
| IJavaPeerable.JniObjectReferenceControlBlock |
Informationen, die verwendet werden, um anzugeben, dass ein |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Informationen, die verwendet werden, um anzugeben, dass ein |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Informationen, die verwendet werden, um anzugeben, dass ein |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Informationen, die verwendet werden, um anzugeben, dass ein |
| IJavaPeerable.UnregisterFromRuntime() |
Informationen, die verwendet werden, um anzugeben, dass ein |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Ruft den JNI-Namen des Typs der Instanz |
| JavaAs<TResult>(IJavaPeerable) |
Versuchen Sie, die Eingabe |
| JavaCast<TResult>(IJavaObject) |
Führt eine android-laufzeitgecheckte Typkonvertierung aus. |
| JavaCast<TResult>(IJavaObject) |
Informationen, die verwendet werden, um anzugeben, dass ein |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Versuchen Sie, die Eingabe |