ContactsContract.DataUsageFeedback 類別

定義

[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

繼承

Object

JavaObject

Object

ContactsContract.DataUsageFeedback

屬性

RegisterAttribute

備註

API 允許應用程式將每一 Data 列的使用資訊傳送給聯絡人提供者。 應用程式也能清除所有使用資訊。

<b>注意： </b>如果你將應用程式發佈到 Google Play 商店，這個欄位將不再適用，無論 Android 版本為何。 欲了解更多資訊，請參閱聯絡人服務提供者頁面。

有了這些回饋，聯絡人提供者可能會回傳更符合上下文的資料列表結果，通常會以 ContactsContract.Contacts#CONTENT_FILTER_URI、 ContactsContract.CommonDataKinds.Email#CONTENT_FILTER_URI、 、 ContactsContract.CommonDataKinds.Phone#CONTENT_FILTER_URI，而使用者在顯示自動補全清單的應用程式中，也能從更佳的排序（排序）清單中受益。

這些回饋如何被使用，甚至是否被使用，沒有保證。 排名演算法會盡力利用回饋資料，但具體實作方式、儲存資料結構及排序順序會依裝置與版本而異，且可能隨時間改變。

在更新使用資訊時，使用此 API 的使用者需要使用 ContentResolver#update(Uri, ContentValues, String, String[]) 由 DataUsageFeedback#FEEDBACK_URI建構而成的 Uri 。 Uri 必須包含一個或多個資料 ID 作為其最後一條路徑。 他們還需要在 Uri 上附加查詢參數，以指定通訊類型，使聯絡人提供者能區分使用相同聯絡資料欄位的互動類型（例如電話號碼可用於撥打電話或發送簡訊）。

選擇與 selectionArgs 會被忽略，必須設為 null。 要取得資料ID，你可能需要呼叫ContentResolver#query(Uri, String[], String, String[], String)。Data#CONTENT_URI

ContentResolver#update(Uri, ContentValues, String, String[]) 成功時回傳正整數，若未找到該 ID 的聯絡，則回傳 0。

範例：

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>

應用程式還能透過以下方式清除所有使用資訊：

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

</p>

此會員已被棄用。 自 Android 版本 android.os.Build.VERSION_CODES#Q起，聯絡人親和資訊已不再支援。 更新和刪除的電話總是被忽略。

的 android.provider.ContactsContract.DataUsageFeedbackJava 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。