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

Object

ContactsContract.DataUsageFeedback

属性

RegisterAttribute

注釈

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

<p class="caution"><b>注意: </b>アプリを Google Play ストアに公開すると、Android のバージョンに関係なく、このフィールドは廃止されます。 詳細については、「連絡先プロバイダー」ページを参照してください。</P>

このフィードバックにより、連絡先プロバイダーは、通常は 、ContactsContract.CommonDataKinds.Email#CONTENT_FILTER_URIContactsContract.CommonDataKinds.Phone#CONTENT_FILTER_URIで提供されるデータの一覧に対してよりコンテキストに適したContactsContract.Contacts#CONTENT_FILTER_URI結果を返すことができます。また、ユーザーは、オートコンプリート リストを表示するアプリケーションでより適切なランク付け (並べ替えられた) リストを利用できます。

このフィードバックの使用方法や、使用されるかどうかに関する保証はありません。 ランク付けアルゴリズムでは、フィードバック データを使用するための最善の努力が行われますが、正確な実装、ストレージ データ構造、および結果の並べ替え順序はデバイスとバージョン固有であり、時間の経過と伴って変化する可能性があります。

使用状況情報を更新する場合、この API のユーザーは、からDataUsageFeedback#FEEDBACK_URI構築された URI で使用ContentResolver#update(Uri, ContentValues, String, String[])する必要があります。 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ではサポートされなくなりました。 更新呼び出しと削除呼び出しは常に無視されます。

の Java ドキュメントandroid.provider.ContactsContract.DataUsageFeedback

このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。

コンストラクター

フィールド

プロパティ

メソッド

明示的なインターフェイスの実装

拡張メソッド

適用対象