Android添加联系人到通讯录

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

字段

联系人名字

名字不知道为什么，值设置了之后传过去没有，于是自己通过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);

复制代码

2.添加到现有联系人

将上边的所有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"/>

复制代码

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