ContactsContract.Profile

public static final class ContactsContract.Profile
extends Object implements BaseColumns, ContactsContract.ContactsColumns, ContactsContract.ContactOptionsColumns, ContactsContract.ContactNameColumns, ContactsContract.ContactStatusColumns

用户配置文件数据的常量，表示为代表用户的设备上的单个联系人。 配置文件联系人不会像普通联系人一样自动聚合在一起; 相反，设备上的每个账户（包括数据集，如果适用的话）可以贡献代表来自该来源的用户个人简档数据的单个原始联系人。

通过这些URI访问配置文件条目（或者如果通过ID直接检索，则可以附带访问配置文件的某些部分）需要超出提供者所要求的读/写联系人权限的额外权限。 查询配置文件数据需要android.permission.READ_PROFILE权限，插入或更新配置文件数据需要android.permission.WRITE_PROFILE权限。

Operations

Insert

The user's profile entry cannot be created explicitly (attempting to do so will throw an exception). When a raw contact is inserted into the profile, the provider will check for the existence of a profile on the device. If one is found, the raw contact's CONTACT_ID column gets the _ID of the profile Contact. If no match is found, the profile Contact is created and its _ID is put into the CONTACT_ID column of the newly inserted raw contact.

Update

The profile Contact has the same update restrictions as Contacts in general, but requires the android.permission.WRITE_PROFILE permission.

Delete

The profile Contact cannot be explicitly deleted. It will be removed automatically if all of its constituent raw contact entries are deleted.

Query

• The CONTENT_URI for profiles behaves in much the same way as retrieving a contact by ID, except that it will only ever return the user's profile contact.
• The profile contact supports all of the same sub-paths as an individual contact does - the content of the profile contact can be retrieved as entities or data rows. Similarly, specific raw contact entries can be retrieved by appending the desired raw contact ID within the profile.

Summary

Inherited constants
From interface android.provider.BaseColumns String _COUNT 目录中的行数。 String _ID 一行的唯一ID。
From interface android.provider.ContactsContract.ContactsColumns String CONTACT_LAST_UPDATED_TIMESTAMP 此联系人上次更新时的时间戳（自纪元起的毫秒数）。 String DISPLAY_NAME 联系人的显示名称。 String HAS_PHONE_NUMBER 指示该联系人是否至少有一个电话号码的指示符。 String IN_DEFAULT_DIRECTORY 反映联系人是否存在于默认目录内的标志。 String IN_VISIBLE_GROUP 反映该 GROUP_VISIBLE的任何 ContactsContract.CommonDataKinds.GroupMembership的 GROUP_VISIBLE状态的标志。 String IS_USER_PROFILE 反映该联系人是否代表用户的个人资料条目的标志。 String LOOKUP_KEY 一个不透明的值，包含有关如何查找联系人（如果其行ID由于同步或聚合而更改）的提示。 String NAME_RAW_CONTACT_ID 参考RawContacts表中保存联系人姓名的行。 String PHOTO_FILE_ID 全尺寸照片的照片文件ID。 String PHOTO_ID 参照保存照片的数据表中的行。 String PHOTO_THUMBNAIL_URI 可用于检索联系人照片缩略图的URI。 String PHOTO_URI 可用于检索联系人的全尺寸照片的URI。
From interface android.provider.ContactsContract.ContactOptionsColumns String CUSTOM_RINGTONE 与联系人关联的自定义铃声的URI。 String LAST_TIME_CONTACTED 上次与联系人联系的时间。 String PINNED 触点被固定的位置。 String SEND_TO_VOICEMAIL 是否应始终将联系人发送到语音邮件。 String STARRED 该联系人是否已主演？ 类型：INTEGER（布尔值） String TIMES_CONTACTED 联系人联系的次数 类型：INTEGER
From interface android.provider.ContactsContract.ContactNameColumns String DISPLAY_NAME_ALTERNATIVE 显示名称的替代表示，例如“姓氏优先”，而不是“西方名字的第一个名字”。 String DISPLAY_NAME_PRIMARY 基于联系人的最佳可用信息（例如，如果名称不可用，可能是电子邮件地址），显示标准文本作为联系人的显示名称。 String DISPLAY_NAME_SOURCE 用作联系人显示名称的数据种类，如结构化名称或电子邮件地址。 String PHONETIC_NAME 在 PHONETIC_NAME_STYLE指定的拼音字母表中全名的发音。 String PHONETIC_NAME_STYLE 用于表示 PHONETIC_NAME的拼音字母。 String SORT_KEY_ALTERNATIVE 根据全名的替代表示排序键， DISPLAY_NAME_ALTERNATIVE 。 String SORT_KEY_PRIMARY 排序键考虑了基于地区的传统，用于在地址簿中对姓名进行排序。
From interface android.provider.ContactsContract.ContactStatusColumns String CONTACT_CHAT_CAPABILITY 联系聊天功能。 String CONTACT_PRESENCE 联系人在线状态。 String CONTACT_STATUS 联系人的最新状态更新。 String CONTACT_STATUS_ICON 联系人状态图标的资源ID。 String CONTACT_STATUS_LABEL 描述联系人状态来源的标签的资源ID，例如 String CONTACT_STATUS_RES_PACKAGE 包含此状态资源的包：标签和图标。 String CONTACT_STATUS_TIMESTAMP 插入/更新最新状态的绝对时间（以毫秒为单位）。

Inherited methods

From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到其他线程调用 notify()方法或 notifyAll()方法此对象，或一些其它线程中断当前线程，或实时一定量已过去。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过了指定的时间量。 final void wait() 导致当前线程等待，直到另一个线程调用此对象的方法 notify()或方法 notifyAll() 。

Constants

long MIN_ID

Fields

Uri CONTENT_RAW_CONTACTS_URI

Uri CONTENT_URI

Uri CONTENT_VCARD_URI