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

注釈

アプリケーションが各 Data 行の使用状況情報を連絡先プロバイダーに送信できるようにする API。 アプリケーションは、すべての使用状況情報をクリアすることもできます。

<b>Caution: </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[])から構築された URI でDataUsageFeedback#FEEDBACK_URIを使用する必要があります。 URI には、最後のパスとして 1 つ以上のデータ ID が含まれている必要があります。 また、Uri にクエリ パラメーターを追加して通信の種類を指定する必要もあります。これにより、連絡先プロバイダーは同じ連絡先データ フィールドを使用して対話の種類を区別できます (たとえば、電話番号を使用して電話をかけ、SMS を送信できます)。

Selection と 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.DataUsageFeedbackの Java ドキュメント。

このページの一部は、Androidオープンソースプロジェクトによって作成および共有された作業に基づく変更でありCreative Commons 2.5属性ライセンスに記載されている条件に従って使用されます。