Android添加联系人到通讯录

本周项目中遇到了需要添加联系人或者添加到已有联系人的需求，联系人中需要保存的字段有很多，之前不太熟悉，在这里总结一下。
@[toc]

字段

联系人名字

名字不知道为什么，值设置了之后传过去没有，于是自己通过Intent最后又单独传了一次

// 联系人名字
ContentValues row1 = new ContentValues();String name = lastName + middleName + firstName;row1.put(ContactsContract.Data.MIMETYPE, 
ContactsContract.CommonDataKinds.StructuredName.CONTENT_ITEM_TYPE);row1.put(ContactsContract.CommonDataKinds.StructuredName.DISPLAY_NAME, 
name);row1.put(ContactsContract.CommonDataKinds.StructuredName.GIVEN_NAME, 
firstName);row1.put(ContactsContract.CommonDataKinds.StructuredName.FAMILY_NAME, 
lastName);row1.put(ContactsContract.CommonDataKinds.StructuredName.MIDDLE_NAME, 
middleName);

联系人昵称

// 联系人昵称
ContentValues row2 = new ContentValues();
row2.put(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.Nickname.CONTENT_ITEM_TYPE);
row2.put(ContactsContract.CommonDataKinds.Nickname.NAME, nickName);

联系人头像

这里需要将图片的byte数组传进去

ContentValues row3 = new ContentValues();
//添加头像
row3.put(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.Photo.CONTENT_ITEM_TYPE);
Bitmap bitmap = BitmapFactory.decodeFile(photoFilePath);
ByteArrayOutputStream baos = new ByteArrayOutputStream();
bitmap.compress(Bitmap.CompressFormat.JPEG, 100, baos);
row3.put(ContactsContract.CommonDataKinds.Photo.PHOTO, baos.toByteArray());

联系人备注

// 联系人备注
ContentValues row4 = new ContentValues();
row4.put(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.Note.CONTENT_ITEM_TYPE);
row4.put(ContactsContract.CommonDataKinds.Note.NOTE, remark);

联系人号码

号码有很多种类型，电话，手机，传真，公司，家庭，等

ContentValues row5 = new ContentValues();
// 联系人的电话号码
addPhoneNumber(row5, values, mobilePhoneNumber, 
ContactsContract.CommonDataKinds.Phone.TYPE_MOBILE);ContentValues row6 = new ContentValues();
// 联系人的公司电话
addPhoneNumber(row6, values, hostNumber, 
ContactsContract.CommonDataKinds.Phone.TYPE_COMPANY_MAIN);ContentValues row7 = new ContentValues();
// 联系人的工作号码
addPhoneNumber(row7, values, workPhoneNumber, 
ContactsContract.CommonDataKinds.Phone.TYPE_WORK_MOBILE);ContentValues row8 = new ContentValues();
// 联系人的工作传真
addPhoneNumber(row8, values, workFaxNumber, 
ContactsContract.CommonDataKinds.Phone.TYPE_FAX_WORK);ContentValues row9 = new ContentValues();
// 联系人的住宅号码
addPhoneNumber(row9, values, homePhoneNumber, 
ContactsContract.CommonDataKinds.Phone.TYPE_HOME);ContentValues row10 = new ContentValues();
// 联系人的住宅传真
addPhoneNumber(row10, values, homeFaxNumber, 
ContactsContract.CommonDataKinds.Phone.TYPE_FAX_HOME);

//封装的添加方法
private void addPhoneNumber(
    ContentValues row, ArrayList<ContentValues> values, String phoneNumber, int type) {    
    row.put(ContactsContract.Data.MIMETYPE, 
    ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE);    
    row.put(ContactsContract.CommonDataKinds.Phone.NUMBER, phoneNumber);    
    row.put(ContactsContract.CommonDataKinds.Phone.TYPE, type);    
    values.add(row);
}

联系人公司和职位

// 联系人公司和职位
ContentValues row11 = new ContentValues();
row11.put(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.Organization.CONTENT_ITEM_TYPE);
row11.put(ContactsContract.CommonDataKinds.Organization.COMPANY, organization);
row11.put(ContactsContract.CommonDataKinds.Organization.TITLE, title);

网站

// 联系人网站
ContentValues row12 = new ContentValues();
row12.put(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.Website.CONTENT_ITEM_TYPE);
row12.put(ContactsContract.CommonDataKinds.Website.URL, url);

联系人邮箱

// 插入Email数据
ContentValues row13 = new ContentValues();
row13.put(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.Email.CONTENT_ITEM_TYPE);
row13.put(ContactsContract.CommonDataKinds.Email.DATA, email);
row13.put(ContactsContract.CommonDataKinds.Email.TYPE, ContactsContract.CommonDataKinds.Email.TYPE_WORK);

联系人地址

地址分为家庭，工作和其他。有个问题，这里分段传入之后添加完成无法显示，只能自己将国家省市街道拼接，传入到了地址字段，这样就可以显示出来，但是邮政编码是无法显示的

//其他地址
ContentValues row14 = new ContentValues();
addAddress(row14, values, addressCountry, addressState, addressCity, addressStreet, addressPostalCode, ContactsContract.CommonDataKinds.StructuredPostal.TYPE_OTHER);
//家庭地址
ContentValues row15 = new ContentValues();
addAddress(row15, values, homeAddressCountry, homeAddressState, homeAddressCity, homeAddressStreet, homeAddressPostalCode, ContactsContract.CommonDataKinds.StructuredPostal.TYPE_HOME);
//工作地址
ContentValues row16 = new ContentValues();
addAddress(row16, values, workAddressCountry, workAddressState, workAddressCity, workAddressStreet, workAddressPostalCode, ContactsContract.CommonDataKinds.StructuredPostal.TYPE_WORK);

//添加地址方法
private void addAddress(ContentValues row, ArrayList<ContentValues> values, String country, String region, String city, String street, String addressPostalCode, int type) {
    row.put(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.StructuredPostal.CONTENT_ITEM_TYPE);
    row.put(ContactsContract.CommonDataKinds.StructuredPostal.FORMATTED_ADDRESS, country + region + city + street);
    row.put(ContactsContract.CommonDataKinds.StructuredPostal.COUNTRY, country);
    row.put(ContactsContract.CommonDataKinds.StructuredPostal.REGION, region);
    row.put(ContactsContract.CommonDataKinds.StructuredPostal.CITY, city);
    row.put(ContactsContract.CommonDataKinds.StructuredPostal.STREET, street);
    row.put(ContactsContract.CommonDataKinds.StructuredPostal.POSTCODE, addressPostalCode);
    row.put(ContactsContract.CommonDataKinds.StructuredPostal.TYPE, type);
    values.add(row);
}

添加方式

添加方式分为三种，一种是静默添加，直接存入数据库中，另外两种是跳转，直接新增或者添加到现有联系人中

1.静默添加

以添加名字为例，直接插入到数据库中

// 向RawContacts.CONTENT_URI空值插入，
// 先获取Android系统返回的rawContactId
// 后面要基于此id插入值
Uri rawContactUri = mActivity.getContentResolver().insert(ContactsContract.RawContacts.CONTENT_URI, values);
long rawContactId = ContentUris.parseId(rawContactUri);
values.put(ContactsContract.Data.RAW_CONTACT_ID, rawContactId);
// 内容类型
values.put(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.StructuredName.CONTENT_ITEM_TYPE);
// 联系人名字
values.put(ContactsContract.CommonDataKinds.StructuredName.GIVEN_NAME, firstName);
values.put(ContactsContract.CommonDataKinds.StructuredName.FAMILY_NAME, lastName);
values.put(ContactsContract.CommonDataKinds.StructuredName.MIDDLE_NAME, middleName);
// 向联系人URI添加联系人名字
mActivity.getContentResolver().insert(ContactsContract.Data.CONTENT_URI, values);

2.跳转添加

将上边的所有row添加到数组中，一起传递

List<ContentValues> values = new ArrayList<>();
//添加需要设置的数据
...
Intent intent = new Intent(Intent.ACTION_INSERT, ContactsContract.Contacts.CONTENT_URI);
intent.putExtra(ContactsContract.Intents.Insert.NAME, name);
intent.putParcelableArrayListExtra(ContactsContract.Intents.Insert.DATA, values);
mActivity.startActivity(intent);

3.添加到现有联系人

将上边的所有row添加到数组中，一起传递，跳转后需要选择联系人

List<ContentValues> values = new ArrayList<>();
//添加需要设置的数据
...
Intent intent = new Intent(Intent.ACTION_INSERT_OR_EDIT);
intent.setType(ContactsContract.Contacts.CONTENT_ITEM_TYPE);
intent.putParcelableArrayListExtra(ContactsContract.Intents.Insert.DATA, values);
startActivity(intent);

权限

权限不能忘了，不然会闪退报错的，分别是联系人的读写权限

    <uses-permission android:name="android.permission.READ_CONTACTS"/>
    <uses-permission android:name="android.permission.WRITE_CONTACTS"/>

总结到此为止，还算比较详细，有补充欢迎评论。