ContactsContract.Contacts.Photo

public static final class ContactsContract.Contacts.Photo
extends Object implements BaseColumns, ContactsContract.DataColumnsWithJoins

包含联系人的主要照片的单个联系人的只读子目录。 照片可以以两种方式存储 - 默认的“照片”是直接存储在数据行中的缩略图大小的图像，而“显示照片”（如果存在）是存储为文件的较大版本。

用法示例：

Retrieving the thumbnail-sized photo

 public InputStream openPhoto(long contactId) {
     Uri contactUri = ContentUris.withAppendedId(Contacts.CONTENT_URI, contactId);
     Uri photoUri = Uri.withAppendedPath(contactUri, Contacts.Photo.CONTENT_DIRECTORY);
     Cursor cursor = getContentResolver().query(photoUri,
          new String[] {Contacts.Photo.PHOTO}, null, null, null);
     if (cursor == null) {
         return null;
     }
     try {
         if (cursor.moveToFirst()) {
             byte[] data = cursor.getBlob(0);
             if (data != null) {
                 return new ByteArrayInputStream(data);
             }
         }
     } finally {
         cursor.close();
     }
     return null;
 }
 

Retrieving the larger photo version

 public InputStream openDisplayPhoto(long contactId) {
     Uri contactUri = ContentUris.withAppendedId(Contacts.CONTENT_URI, contactId);
     Uri displayPhotoUri = Uri.withAppendedPath(contactUri, Contacts.Photo.DISPLAY_PHOTO);
     try {
         AssetFileDescriptor fd =
             getContentResolver().openAssetFileDescriptor(displayPhotoUri, "r");
         return fd.createInputStream();
     } catch (IOException e) {
         return null;
     }
 }
 

您也可以考虑使用便捷方法 openContactPhotoInputStream(ContentResolver, Uri, boolean)来检索缩略图大小或全尺寸照片的原始照片内容。

该目录可以与 CONTENT_URI或 CONTENT_LOOKUP_URI 。

摘要(Summary)

Inherited constants
From interface android.provider.BaseColumns String _COUNT 目录中的行数。 String _ID 一行的唯一ID。
From interface android.provider.ContactsContract.DataColumns String CARRIER_PRESENCE 运营商存在信息。 int CARRIER_PRESENCE_VT_CAPABLE 表示该条目是当前运营商的视频电话（VT）。 String DATA1 通用数据列，含义是 MIMETYPE具体 String DATA10 泛型数据列，含义是 MIMETYPE具体 String DATA11 泛型数据列，含义是 MIMETYPE具体 String DATA12 泛型数据列，含义是 MIMETYPE具体 String DATA13 泛型数据列，含义是 MIMETYPE具体 String DATA14 泛型数据列，含义是 MIMETYPE具体 String DATA15 泛型数据列，含义是 MIMETYPE具体。 String DATA2 泛型数据列，含义是 MIMETYPE具体 String DATA3 泛型数据列，含义是 MIMETYPE具体 String DATA4 泛型数据列，含义是 MIMETYPE具体 String DATA5 泛型数据列，含义是 MIMETYPE具体 String DATA6 泛型数据列，含义是 MIMETYPE具体 String DATA7 泛型数据列，含义是 MIMETYPE具体 String DATA8 泛型数据列，含义是 MIMETYPE具体 String DATA9 泛型数据列，含义是 MIMETYPE具体 String DATA_VERSION 此数据记录的版本。 String IS_PRIMARY 这是否属于其原始联系人的主要条目。 String IS_READ_ONLY “只读”标志：默认情况下为“0”，如果除了同步适配器以外不能修改或删除该行，则为“1”。 String IS_SUPER_PRIMARY 这是否属于它所属类别的主要入口。 String MIMETYPE 该行表示的项目的MIME类型。 String RAW_CONTACT_ID 对此数据所属的 _ID的引用。 String RES_PACKAGE 为此数据行创建 Resources对象时使用的软件包名称。 String SYNC1 同步适配器使用的通用列。 String SYNC2 同步适配器使用的通用列。 String SYNC3 同步适配器使用的通用列。 String SYNC4 同步适配器使用的通用列。
From interface android.provider.ContactsContract.StatusColumns int AVAILABLE 允许的值为 PRESENCE 。 int AWAY 允许的值为 PRESENCE 。 int CAPABILITY_HAS_CAMERA 允许标志为 CHAT_CAPABILITY 。 int CAPABILITY_HAS_VIDEO 允许标志为 CHAT_CAPABILITY 。 int CAPABILITY_HAS_VOICE 允许标志为 CHAT_CAPABILITY 。 String CHAT_CAPABILITY 联系人的音频/视频聊天功能级别。 int DO_NOT_DISTURB 允许的值为 PRESENCE 。 int IDLE 允许的值为 PRESENCE 。 int INVISIBLE 允许的值为 PRESENCE 。 int OFFLINE 允许的值为 PRESENCE 。 String PRESENCE 联系人的最新存在级别。 String PRESENCE_CUSTOM_STATUS 此常数在API级别8中已弃用。请使用STATUS String PRESENCE_STATUS 此常数在API级别8中已弃用。请使用PRESENCE String STATUS 联系最新状态更新。 String STATUS_ICON 状态更新源图标的资源ID。 String STATUS_LABEL 描述状态更新源的标签的资源ID，例如 String STATUS_RES_PACKAGE 包含此状态资源的包：标签和图标。 String STATUS_TIMESTAMP 插入/更新最新状态的绝对时间（以毫秒为单位）。
From interface android.provider.ContactsContract.RawContactsColumns String ACCOUNT_TYPE_AND_DATA_SET 帐户类型和数据集的串联（用正斜杠分隔） - 如果数据集为空，则与帐户类型相同。 String AGGREGATION_MODE 此联系人的聚合模式。 String BACKUP_ID 其帐户中每个raw_contact的持久性唯一标识。 String CONTACT_ID 对此数据所属的 _ID的引用。 String DATA_SET 该行属于该帐户内的数据集。 String DELETED “已删除”标志：默认为“0”，如果该行已被标记为删除，则为“1”。 String METADATA_DIRTY 表示原始联系人的元数据已更改的标志，并且其元数据需要由服务器同步。 String RAW_CONTACT_IS_READ_ONLY “只读”标志：默认情况下为“0”，如果除了同步适配器以外不能修改或删除该行，则为“1”。 String RAW_CONTACT_IS_USER_PROFILE 反映此原始联系人是否属于用户的个人资料条目的标志。
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.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.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.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 插入/更新最新状态的绝对时间（以毫秒为单位）。
From interface android.provider.ContactsContract.DataUsageStatColumns String LAST_TIME_USED 上次使用 ContactsContract.Contacts.Data （毫秒）。 String TIMES_USED 引用的 ContactsContract.Contacts.Data已被使用的次数。

继承方法(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)

String CONTENT_DIRECTORY

String DISPLAY_PHOTO

String PHOTO

String PHOTO_FILE_ID