ContactsContract.DataUsageFeedback Klasse

Definition

[Android.Runtime.Register("android/provider/ContactsContract$DataUsageFeedback", DoNotGenerateAcw=true)]
public sealed class ContactsContract.DataUsageFeedback : Java.Lang.Object

[<Android.Runtime.Register("android/provider/ContactsContract$DataUsageFeedback", DoNotGenerateAcw=true)>]
type ContactsContract.DataUsageFeedback = class
    inherit Object

Vererbung

Object

Object

ContactsContract.DataUsageFeedback

Attribute

RegisterAttribute

Hinweise

API, mit der Anwendungen Nutzungsinformationen für jede Data Zeile an den Kontaktanbieter senden können. Anwendungen können auch alle Nutzungsinformationen löschen.

<b>Vorsicht: </b>Wenn Sie Ihre App im Google Play Store veröffentlichen, ist dieses Feld unabhängig von der Android-Version veraltet. Weitere Informationen finden Sie auf der Seite "Kontaktanbieter".

Mit dem Feedback gibt der Kontaktanbieter möglicherweise kontextbezogenere Ergebnisse für die Datenauflistung zurück, die in der Regel mit ContactsContract.Contacts#CONTENT_FILTER_URI, ContactsContract.CommonDataKinds.Email#CONTENT_FILTER_URI, ContactsContract.CommonDataKinds.Phone#CONTENT_FILTER_URIund Benutzern von besser bewerteten (sortierten) Listen in Anwendungen profitieren können, die die AutoVervollständigen-Liste anzeigen.

Es gibt keine Garantie dafür, wie dieses Feedback verwendet wird oder ob es überhaupt verwendet wird. Der Bewertungsalgorithmus bemüht sich am besten, die Feedbackdaten zu verwenden, aber die genaue Implementierung, die Speicherdatenstrukturen sowie die resultierende Sortierreihenfolge ist geräte- und versionsspezifisch und kann sich im Laufe der Zeit ändern.

Beim Aktualisieren von Nutzungsinformationen müssen Benutzer dieser API mit einem URI verwendet werden ContentResolver#update(Uri, ContentValues, String, String[]) , der aus DataUsageFeedback#FEEDBACK_URI. Der URI muss eine oder mehrere Daten-IDs als letzten Pfad enthalten. Sie müssen auch einen Abfrageparameter an den URI anfügen, um den Typ der Kommunikation anzugeben, mit dem der Kontaktanbieter zwischen Arten von Interaktionen unter Verwendung desselben Kontaktdatenfelds unterscheiden kann (z. B. eine Telefonnummer kann zum Tätigen von Telefonanrufen oder zum Senden von SMS verwendet werden).

Selection und selectionArgs werden ignoriert und müssen auf NULL festgelegt werden. Um Daten-IDs abzurufen, müssen Sie möglicherweise aufrufenContentResolver#query(Uri, String[], String, String[], String).Data#CONTENT_URI

ContentResolver#update(Uri, ContentValues, String, String[]) gibt bei erfolgreicher Ausführung eine positive ganze Zahl zurück und gibt 0 zurück, wenn kein Kontakt mit dieser ID gefunden wurde.

Beispiel:

Uri uri = DataUsageFeedback.FEEDBACK_URI.buildUpon()
                    .appendPath(TextUtils.join(",", dataIds))
                    .appendQueryParameter(DataUsageFeedback.USAGE_TYPE,
                            DataUsageFeedback.USAGE_TYPE_CALL)
                    .build();
            boolean successful = resolver.update(uri, new ContentValues(), null, null) > 0;

</p>

Anwendungen können auch alle Nutzungsinformationen löschen mit:

boolean successful = resolver.delete(DataUsageFeedback.DELETE_USAGE_URI, null, null) > 0;

</p>

Dieses Element ist veraltet. Kontaktaffinitätsinformationen werden ab Android-Version android.os.Build.VERSION_CODES#Qnicht mehr unterstützt. Sowohl Aktualisierungs- als auch Löschaufrufe werden immer ignoriert.

Java Dokumentation für android.provider.ContactsContract.DataUsageFeedback.

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.