Windows Phone 8 人脉 people hub 通讯录管理

今天给大家介绍下Windows Phone 8 的 people hub - 人脉相关的API，了解Windows phone的同学一定都知道在windows phone7的API对通讯录的操作权限是只读的 不能直接向通讯录中添加联系人 只能通过其他方式同步联系人 例如：exchange， save deloge，这样对一些通讯录的应用带来了很多用户体验上制约，不过在microsoft最新的Windows phone 8 SDK中打开的这一限制，支持API级别的通讯录增删改查，下面我就给大家介绍一下。

当然在写代码之前不要忘记设置WMAppManifest文件

1. 通讯录中添加联系人

首先给大家介绍的是如何创建一个联系人至联系人列表，在SDK 8.0 中的 ContactStore 他用于联系人操作

ContactStore store = await ContactStore.CreateOrOpenAsync(
                    ContactStoreSystemAccessMode.ReadWrite,
                    ContactStoreApplicationAccessMode.ReadOnly);

可以看到CreateOrOpenAsync方法中有两个参数 分别是 ContactStoreSystemAccessMode 和 ContactStoreApplicationAccessMode 两个枚举值 这两个枚举值比较关键 前者是声明当前应用所创建的联系人十分可以在People hub中编辑改写，后者是声明在其他应用程序中的现实访问权限.

ReadOnly 在people hub中对于系统用户来说是只读的 ReadWrite 顾名思义就是可读写的。

 

LimitedReadOnly 对于其他应用程序来说能看到的信息只是描述信息和现实图片 ReadOnly则是可以读取全部信息的。

添加一个联系人的代码十分简单

async public void AddContact()
        {
            ContactStore store = await ContactStore.CreateOrOpenAsync(
                                ContactStoreSystemAccessMode.ReadWrite,
                                ContactStoreApplicationAccessMode.ReadOnly);
            StoredContact contact = new StoredContact(store);
            //contact.RemoteId = "123";
            //contact.Id 只读属性添加成功后系统会自动分配
            contact.GivenName = txtGivenName.Text;
            contact.FamilyName = txtFamilyName.Text;
            IDictionary<string, object> props = await contact.GetPropertiesAsync();
            props.Add(KnownContactProperties.Email, txtMail.Text);
            props.Add(KnownContactProperties.Telephone, txtPhone.Text);
            await contact.SaveAsync();
            MessageBox.Show("save done");
        }

这里给大家提一下RemoteId 是一个识别联系人的标示 可以是GUID进行同步修改的时候可以为mapping service上的数据所用，在应用中也支持RemoteId的查找联系人。

2. 修改联系人

async private void UpdateContact(string remoteId, string givenName, string familyName, string email, string codeName)
{
    ContactStore store = await ContactStore.CreateOrOpenAsync();
    StoredContact contact = await store.FindContactByRemoteIdAsync(remoteId);

    if (contact != null)
    {
        contact.GivenName = givenName;
        contact.FamilyName = familyName;

        IDictionary<string, object> props = await contact.GetPropertiesAsync();
        props[KnownContactProperties.Email] = email;

        IDictionary<string, object> extprops = await contact.GetExtendedPropertiesAsync();
        extprops["Codename"] = codeName;

        await contact.SaveAsync();
    }
}

修改联系人的过程和创建十分相似 区别就是可以通过一个RemoteId 或者 ID 获取到目标联系人对要修改的字段进行修改保存。

3. 删除联系人

ContactQueryResult result = store.CreateContactQuery();
IReadOnlyList<StoredContact> contacts = await result.GetContactsAsync();
List<StoredContact> listSC = contacts.ToList();
await store.DeleteContactAsync(listSC[0].Id);

删除联系人更为简单 只需要StoredContact的ID就可以进行删除操作。

4. 查询联系人

查询联系人仍然支持7.5的查询方式（支持过滤条件支持linq）

private void ButtonContacts_Click(object sender, RoutedEventArgs e)
{
    Contacts cons = new Contacts();

    //Identify the method that runs after the asynchronous search completes.
    cons.SearchCompleted += new EventHandler<ContactsSearchEventArgs>(Contacts_SearchCompleted);

    //Start the asynchronous search.
    cons.SearchAsync(String.Empty, FilterKind.None, "Contacts Test #1");
}

void Contacts_SearchCompleted(object sender, ContactsSearchEventArgs e)
{
    //Do something with the results.
    MessageBox.Show(e.Results.Count().ToString());
}

通讯录搜索：http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh286416(v=vs.105).aspx

过滤条件：http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh286417(v=vs.105).aspx

除此之外还支持使用

CreateContactQuery 获取ContactStore联系人列表 支持返回属性设置和排序

async private void QueryWithDesiredFields()
{
    ContactStore store = await ContactStore.CreateOrOpenAsync();

    ContactQueryOptions options = new ContactQueryOptions();
    options.DesiredFields.Add(KnownContactProperties.Email);
    options.OrderBy = ContactQueryResultOrdering.FamilyNameGivenName;

    ContactQueryResult result = store.CreateContactQuery(options);
    IReadOnlyList<StoredContact> contacts = await result.GetContactsAsync();
}

经过上述应用添加到people hub中的联系人显示也是可以筛选显示的

进入 人脉 - 设置 - 筛选我的联系人列表 - 选择要显示来自应用的联系人即可

 

默认都是选中的

MSDN连接：http://msdn.microsoft.com/en-us/library/windowsphone/develop/jj207024(v=vs.105).aspx

欢迎大家在这里和我沟通交流或者在新浪微博上 @王博_Nick