public static final class ContactsContract.DataUsageFeedback
extends Object
| java.lang.Object | |
| ↳ | android.provider.ContactsContract.DataUsageFeedback |
API允许应用程序将每个ContactsContract.Contacts.Data行的使用信息发送到联系人提供程序。 应用程序也可以清除所有使用信息。
与反馈，联系供应商可以返回上下文更合适的结果数据列表，通常提供的 CONTENT_FILTER_URI ， CONTENT_FILTER_URI ， CONTENT_FILTER_URI ，并且用户可以从排名更高（排序）列表中，显示自动完成列表应用中受益。
无法保证如何使用此反馈，甚至不管它是否被使用。 排名算法将尽最大努力使用反馈数据，但确切的实现，存储数据结构以及结果排序顺序是设备和版本特定的，并且可以随时间变化。
在更新使用信息时，该API的用户需要使用update(Uri, ContentValues, String, String[]) ，其中Uri由FEEDBACK_URI构建。 Uri必须包含一个或多个数据ID作为其最后的路径。 他们还需要在Uri中附加一个查询参数，以指定通信类型，从而使联系供应商能够区分使用同一联系人数据字段的各种交互（例如，电话号码可用于拨打电话或发送短信）。
选择和选择Args被忽略，并且必须设置为null。 要获取数据ID，您可能需要致电query(Uri, String[], String, String[], String) ，致电CONTENT_URI 。
update(Uri, ContentValues, String, String[])成功时返回正整数，如果未找到与该ID的联系，则返回0。
例：
Android开发手册
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;
应用程序也可以通过以下方式清除所有使用信
boolean successful = resolver.delete(DataUsageFeedback.DELETE_USAGE_URI, null, null) > 0;
Constants |
|
|---|---|
String |
USAGE_TYPE 查询参数的名称，用于指定数据使用的类型。 |
String |
USAGE_TYPE_CALL 语音交互的使用类型，包括电话呼叫，语音聊天和视频聊天。 |
String |
USAGE_TYPE_LONG_TEXT 包含较长邮件的文本交互的使用类型，其中包括电子邮件。 |
String |
USAGE_TYPE_SHORT_TEXT 涉及短信息的文本交互的使用类型，其中包括短信，文本聊天和电子邮件地址。 |
Fields |
|
|---|---|
public static final Uri |
DELETE_USAGE_URI 内容：//样式URI，用于删除所有使用信息。 |
public static final Uri |
FEEDBACK_URI 内容：//发送使用反馈的样式URI。 |
Public constructors |
|
|---|---|
ContactsContract.DataUsageFeedback() |
|
Inherited methods |
|
|---|---|
 From class java.lang.Object
|
|
String USAGE_TYPE_LONG_TEXT
Type of usage for text interaction involving longer messages, which includes email.
常量值：“long_text”
String USAGE_TYPE_SHORT_TEXT
涉及短信息的文本交互的使用类型，其中包括短信，文本聊天和电子邮件地址。
常量值：“short_text”
Uri DELETE_USAGE_URI
内容：//样式URI，用于删除所有使用信息。 必须与delete(Uri, String, String[])一起使用。 where和selectionArgs参数被忽略。
Uri FEEDBACK_URI
内容：//发送使用反馈的样式URI。 必须与update(Uri, ContentValues, String, String[])一起使用。