搜索历史

清空
搜索热词
      0
      • 聊天消息
      • 系统消息
      • 评论与回复
      查看更多
      查看更多
      查看更多
      VIP于 到期 续费
      登录后你可以
      • 下载海量资料
      • 学习在线课程
      • 观看技术视频
      • 写文章/发帖/加入社区
      会员中心
      创作中心
      发布
      创作活动

      完善资料让更多小伙伴认识你，还能领取20积分哦，立即完善>

      3天内不再提示

      鸿蒙开发电话服务：【@ohos.contact (联系人)】

      jf_46214456 • 来源：jf_46214456 • 作者：jf_46214456 • 2024-06-14 09:41 • 次阅读

      联系人

      说明：
      开发前请熟悉鸿蒙开发指导文档 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
      本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

      导入模块

      import contact from '@ohos.contact';

      contact.addContact

      addContact(contact:Contact, callback:AsyncCallback): void

      添加联系人，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.WRITE_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      contact[Contact]是联系人信息。
      callbackAsyncCallback是回调函数，返回添加的联系人id。

      示例：

      contact.addContact({
    fullName: {fullName: 'xxx'},
    phoneNumbers: [{phoneNumber: '138xxxxxxxx'}]
}, (err, data) = > {
    if (err) {
        console.log(`addContact callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`addContact callback: success data- >${JSON.stringify(data)}`);
});

      contact.addContact

      addContact(contact: Contact): Promise

      添加联系人，使用Promise方式作为异步方法。

      需要权限 ：ohos.permission.WRITE_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      contact[Contact]是联系人信息。

      返回值：

      类型说明
      Promise以Promise形式返回结果，返回添加的联系人id。

      示例：

      let promise = contact.addContact({
    name: {fullName: 'xxx'},
    phoneNumbers: [{phoneNumber: '138xxxxxxxx'}]
});
promise.then((data) = > {
    console.log(`addContact success: data- >${JSON.stringify(data)}`);
}).catch((err) = > {
    console.error(`addContact fail: err- >${JSON.stringify(err)}`);
});

      contact.deleteContact

      deleteContact(key: string, callback: AsyncCallback): void

      删除联系人，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.WRITE_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      keystring是联系人key值，一个联系人对应一个key。
      callbackAsyncCallback是回调函数，返回删除联系人的结果。

      示例：

      contact.deleteContact('xxx', (err) = > {
    if (err) {
        console.log(`deleteContact callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log('deleteContact success');
});

      contact.deleteContact

      deleteContact(key: string): Promise

      删除联系人，使用Promise方式作为异步方法。

      需要权限 ：ohos.permission.WRITE_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      keystring是联系人的key值，一个联系人对应一个key。

      返回值：

      类型说明
      Promise以Promise形式返回结果，返回删除联系人的结果。

      示例：

      let promise = contact.deleteContact('xxx');
promise.then(() = > {
    console.log(`deleteContact success`);
}).catch((err) = > {
    console.error(`deleteContact fail: err- >${JSON.stringify(err)}`);
});

      contact.updateContact

      updateContact(contact: Contact, callback: AsyncCallback): void

      更新联系人，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.WRITE_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      contact[Contact]是联系人信息。
      callbackAsyncCallback是回调函数，返回更新联系人的更新结果。

      示例：

      contact.updateContact({
    name: {fullName: 'xxx'},
    phoneNumbers: [{phoneNumber: '138xxxxxxxx'}]
}, (err) = > {
    if (err) {
        console.log('updateContact callback: err- >${JSON.stringify(err)}');
        return;
    }
    console.log('updateContact success');
});

      contact.updateContact

      updateContact(contact: Contact, attrs: ContactAttributes, callback: AsyncCallback): void

      更新联系人，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.WRITE_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      contact[Contact]是联系人信息。
      attrs[ContactAttributes]是联系人的属性列表。
      callbackAsyncCallback是回调函数，返回更新联系人的更新结果。

      示例：

      contact.updateContact({
    fullName: {fullName: 'xxx'},
    phoneNumbers: [{phoneNumber: '138xxxxxxxx'}]
},{
    attributes:['ATTR_EMAIL', 'ATTR_NAME']
}, (err) = > {
    if (err) {
        console.log('updateContact callback: err- >${JSON.stringify(err)}');
        return;
    }
    console.log('updateContact success');
});

      contact.updateContact

      updateContact(contact: Contact, attrs?: ContactAttributes): Promise

      更新联系人，使用Promise方式作为异步方法。

      需要权限 ：ohos.permission.WRITE_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      contact[Contact]是联系人信息。
      attrs[ContactAttributes]否联系人的属性列表。

      返回值：

      类型说明
      Promise以Promise形式返回结果，返回更新联系人的更新结果。

      示例：

      let promise = contact.updateContact({
    fullName: {fullName: 'xxx'},
    phoneNumbers: [{phoneNumber: '138xxxxxxxx'}]
}, {
    attributes: ["ATTR_EMAIL", "ATTR_NAME"]
});
promise.then(() = > {
    console.log('updateContact success');
}).catch((err) = > {
    console.error(`updateContact fail: err- >${JSON.stringify(err)}`);
});

      contact.isLocalContact

      isLocalContact(id: number, callback: AsyncCallback): void

      判断当前联系人id是否在电话簿中，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      idnumber是联系人对象的id属性，一个联系人对应一个id。
      callbackAsyncCallback是回调函数，返回布尔值。true代表联系人id在本地电话簿中，false则代表联系人id不在本地电话簿中。

      示例：

      contact.isLocalContact(/*id*/1, (err, data) = > {
    if (err) {
        console.log(`isLocalContact callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`isLocalContact callback: success data- >${JSON.stringify(data)}`);
});

      contact.isLocalContact

      isLocalContact(id: number): Promise

      判断当前联系人id是否在电话簿中，使用Promise方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      idnumber是联系人对象的id属性，一个联系人对应一个id。

      返回值：

      类型说明
      Promise以Promise形式返回结果，返回布尔值。true代表联系人id在本地电话簿中，false则代表联系人id不在本地电话簿中。

      示例：

      let promise = contact.isLocalContact(/*id*/1);
promise.then((data) = > {
    console.log(`isLocalContact success: data- >${JSON.stringify(data)}`);
}).catch((err) = > {
    console.error(`isLocalContact fail: err- >${JSON.stringify(err)}`);
});

      contact.isMyCard

      isMyCard(id: number, callback: AsyncCallback): void

      判断是否为“我的名片”，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      idnumber是联系人对象的id属性。
      callbackAsyncCallback是回调函数，返回是否为“我的名片”的布尔值。true代表此联系人是“我的名片”，false则代表不是。

      示例：

      contact.isMyCard(/*id*/1, (err, data) = > {
    if (err) {
        console.log(`isMyCard callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`isMyCard callback: success data- >${JSON.stringify(data)}`);
});

      contact.isMyCard

      isMyCard(id: number): Promise

      判断是否为“我的名片”，使用Promise方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      idnumber是联系人对象的id属性。

      返回值：

      类型说明
      Promise以Promise形式返回结果，返回是否为“我的名片”的布尔值。true代表此联系人是“我的名片”，false则代表不是。

      示例：

      let promise = contact.isMyCard(/*id*/1);
promise.then((data) = > {
    console.log(`isMyCard success: data- >${JSON.stringify(data)}`);
}).catch((err) = > {
    console.error(`isMyCard fail: err- >${JSON.stringify(err)}`);
});

      contact.queryMyCard

      queryMyCard(callback: AsyncCallback): void

      查询“我的名片”，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      callbackAsyncCallback<[Contact]>是回调函数，返回“我的名片”信息。

      示例：

      contact.queryMyCard((err, data) = > {
    if (err) {
        console.log(`queryMyCard callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryMyCard callback: success data- >${JSON.stringify(data)}`);
});

      contact.queryMyCard

      queryMyCard(attrs: ContactAttributes, callback: AsyncCallback): void

      查询“我的名片”，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      attrs[ContactAttributes]是联系人的属性列表。
      callbackAsyncCallback<[Contact]>是回调函数，返回“我的名片”信息。

      示例：

      contact.queryMyCard({
    attributes:['ATTR_EMAIL', 'ATTR_NAME']
}, (err, data) = > {
    if (err) {
        console.log(`queryMyCard callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryMyCard callback: success data- >${JSON.stringify(data)}`);
});

      contact.queryMyCard

      queryMyCard(attrs?: ContactAttributes): Promise

      查询“我的名片”，使用Promise方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      attrs[ContactAttributes]否联系人的属性列表。

      返回值：

      类型说明
      Promise<[Contact]>以Promise形式返回结果，返回“我的名片”信息。

      示例：

      let promise = contact.queryMyCard({
    attributes:['ATTR_EMAIL', 'ATTR_NAME']
});
promise.then((data) = > {
    console.log(`queryMyCard success: data- >${JSON.stringify(data)}`);
}).catch((err) = > {
    console.error(`queryMyCard fail: err- >${JSON.stringify(err)}`);
});

      contact.selectContact

      selectContact(callback: AsyncCallback>): void

      选择联系人，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.Contacts、SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      callbackAsyncCallback>是回调函数，返回选择的联系人对象数组。

      示例：

      contact.selectContact((err, data) = > {
    if (err) {
        console.log(`selectContact callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`selectContact callback: success data- >${JSON.stringify(data)}`);
});

      contact.selectContact

      selectContact(): Promise>

      选择联系人，使用Promise方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.Contacts、SystemCapability.Applications.ContactsData

      返回值：

      类型说明
      Promise>以Promise形式返回结果，返回选择的联系人对象数组。

      示例：

      let promise = contact.selectContact();
promise.then((data) = > {
    console.log(`selectContact success: data- >${JSON.stringify(data)}`);
}).catch((err) = > {
    console.error(`selectContact fail: err- >${JSON.stringify(err)}`);
});

      contact.queryContact

      queryContact(key: string, callback: AsyncCallback): void

      根据key查询联系人，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      keystring是联系人的key值，一个联系人对应一个key。
      callbackAsyncCallback<[Contact]>是回调函数，返回查询的联系人对象。

      示例：

      contact.queryContact('xxx', (err, data) = > {
    if (err) {
        console.log(`queryContact callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContact callback: success data- >${JSON.stringify(data)}`);
});

      contact.queryContact

      queryContact(key: string, holder: Holder, callback: AsyncCallback): void

      根据key查询联系人，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      keystring是联系人的key值，一个联系人对应一个key。
      holder[Holder]是创建联系人的应用信息。
      callbackAsyncCallback<[Contact]>是回调函数，返回查询的联系人对象。

      示例：

      contact.queryContact('xxx', {
    holderId: 0
}, (err, data) = > {
    if (err) {
        console.log(`queryContact callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContact callback: success data- >${JSON.stringify(data)}`);
});

      contact.queryContact

      queryContact(key: string, attrs: ContactAttributes, callback: AsyncCallback): void

      根据key查询联系人，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      keystring是联系人的key值，一个联系人对应一个key。
      attrs[ContactAttributes]是联系人的属性列表。
      callbackAsyncCallback<[Contact]>是回调函数，返回查询的联系人对象。

      示例：

      contact.queryContact('xxx', {
    attributes: ["ATTR_EMAIL", "ATTR_NAME"]
}, (err, data) = > {
    if (err) {
        console.log(`queryContact callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContact callback: success data- >${JSON.stringify(data)}`);
});

      contact.queryContact

      queryContact(key: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback): void

      根据key查询联系人，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      keystring是联系人的key值，一个联系人对应一个key。
      holder[Holder]是创建联系人的应用信息。
      attrs[ContactAttributes]是联系人的属性列表。
      callbackAsyncCallback<[Contact]>是回调函数，返回查询的联系人对象。

      示例：

      contact.queryContact('xxx', {
    holderId: 0
}, {
    attributes: ["ATTR_EMAIL", "ATTR_NAME"]
}, (err, data) = > {
    if (err) {
        console.log(`queryContact callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContact callback: success data- >${JSON.stringify(data)}`);
});

      contact.queryContact

      queryContact(key: string, holder?: Holder, attrs?: ContactAttributes): Promise

      根据key查询联系人，使用Promise方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      keystring是联系人的key值，一个联系人对应一个key。
      holder[Holder]否创建联系人的应用信息。
      attrs[ContactAttributes]否联系人的属性列表。

      返回值：

      类型说明
      Promise<[Contact]>以Promise形式返回结果，返回查询到的联系人对象。

      示例：

      let promise = contact.queryContact('xxx', {
    holderId: 0
}, {
    attributes: ["ATTR_EMAIL", "ATTR_NAME"]
});
promise.then((data) = > {
    console.log(`queryContact success: data- >${JSON.stringify(data)}`);
}).catch((err) = > {
    console.error(`queryContact fail: err- >${JSON.stringify(err)}`);
});

      contact.queryContacts

      queryContacts(callback: AsyncCallback>): void

      查询所有联系人，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      callbackAsyncCallback>是回调函数，返回查询到的联系人对象数组。

      示例：

      contact.queryContacts((err, data) = > {
    if (err) {
        console.log(`queryContacts callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContacts callback: success data- >${JSON.stringify(data)}`);
});

      contact.queryContacts

      queryContacts(holder: Holder, callback: AsyncCallback>): void

      查询所有联系人，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      holder[Holder]是创建联系人的应用信息。
      callbackAsyncCallback>是回调函数，返回查询到的联系人对象数组。

      示例：

      contact.queryContacts({
    holderId: 0
}, (err, data) = > {
    if (err) {
        console.log(`queryContacts callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContacts callback: success data- >${JSON.stringify(data)}`);
});

      contact.queryContacts

      queryContacts(attrs: ContactAttributes, callback: AsyncCallback>): void

      查询所有联系人，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      attrs[ContactAttributes]是联系人的属性列表。
      callbackAsyncCallback>是回调函数，返回查询到的联系人对象数组。

      示例：

      contact.queryContacts({
    attributes: ["ATTR_EMAIL", "ATTR_NAME"]
}, (err, data) = > {
    if (err) {
        console.log(`queryContacts callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContacts callback: success data- >${JSON.stringify(data)}`);
});

      contact.queryContacts

      queryContacts(holder: Holder, attrs: ContactAttributes, callback: AsyncCallback>): void

      查询所有联系人，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      holder[Holder]是创建联系人的应用信息。
      attrs[ContactAttributes]是联系人的属性列表。
      callbackAsyncCallback>是回调函数，返回查询到的联系人对象数组。

      示例：

      contact.queryContacts({
    holderId: 0
}, {
    attributes: ["ATTR_EMAIL", "ATTR_NAME"]
}, (err, data) = > {
    if (err) {
        console.log(`queryContacts callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContacts callback: success data- >${JSON.stringify(data)}`);
});

      contact.queryContacts

      queryContacts(holder?: Holder, attrs?: ContactAttributes): Promise>

      查询所有联系人，使用Promise方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      holder[Holder]否创建联系人的应用信息。
      attrs[ContactAttributes]否联系人的属性列表。

      返回值：

      类型说明
      Promise>以Promise形式返回结果，返回查询到的联系人对象数组。

      示例：

      let promise = contact.queryContacts({
    holderId: 0
}, {
    attributes: ["ATTR_EMAIL", "ATTR_NAME"]
});
promise.then((data) = > {
    console.log(`queryContacts success: data- >${JSON.stringify(data)}`);
}).catch((err) = > {
    console.error(`queryContacts fail: err- >${JSON.stringify(err)}`);
});

      ontact.queryContactsByPhoneNumber

      queryContactsByPhoneNumber(phoneNumber: string, callback: AsyncCallback>): void

      根据电话号码查询联系人，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      phoneNumberstring是联系人的电话号码。
      callbackAsyncCallback>是回调函数，返回查询到的联系人对象数组。

      示例：

      contact.queryContactsByPhoneNumber('138xxxxxxxx', (err, data) = > {
    if (err) {
        console.log(`queryContactsByPhoneNumber callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContactsByPhoneNumber callback: success data- >${JSON.stringify(data)}`);
});

      contact.queryContactsByPhoneNumber

      queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, callback: AsyncCallback>): void

      根据电话号码查询联系人，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      phoneNumberstring是联系人的电话号码。
      holder[Holder]是创建联系人的应用信息。
      callbackAsyncCallback>是回调函数，返回查询到的联系人对象数组。

      示例：

      contact.queryContactsByPhoneNumber('138xxxxxxxx', {
    holderId: 0
}, (err, data) = > {
    if (err) {
        console.log(`queryContactsByPhoneNumber callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContactsByPhoneNumber callback: success data- >${JSON.stringify(data)}`);
});

      contact.queryContactsByPhoneNumber

      queryContactsByPhoneNumber(phoneNumber: string, attrs: ContactAttributes, callback: AsyncCallback>): void

      根据电话号码查询联系人，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      phoneNumberstring是联系人的电话号码。
      attrs[ContactAttributes]是联系人的属性列表。
      callbackAsyncCallback>是回调函数，返回查询到的联系人对象数组。

      示例：

      contact.queryContactsByPhoneNumber('138xxxxxxxx', {
    attributes: ["ATTR_EMAIL", "ATTR_NAME"]
}, (err, data) = > {
    if (err) {
        console.log(`queryContactsByPhoneNumber callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContactsByPhoneNumber callback: success data- >${JSON.stringify(data)}`);
});

      contact.queryContactsByPhoneNumber

      queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback>): void

      根据电话号码查询联系人，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      phoneNumberstring是联系人的电话号码。
      holder[Holder]是创建联系人的应用信息。
      attrs[ContactAttributes]是联系人的属性列表。
      callbackAsyncCallback>是回调函数，返回查询到的联系人对象数组。

      示例：

      contact.queryContactsByPhoneNumber('138xxxxxxxx', {
    holderId: 0
}, {
    attributes: ["ATTR_EMAIL", "ATTR_NAME"]
}, (err, data) = > {
    if (err) {
        console.log(`queryContactsByPhoneNumber callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContactsByPhoneNumber callback: success data- >${JSON.stringify(data)}`);
});

      contact.queryContactsByPhoneNumber

      queryContactsByPhoneNumber(phoneNumber: string, holder?: Holder, attrs?: ContactAttributes): Promise>

      根据电话号码查询联系人，使用Promise方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      phoneNumberstring是联系人的电话号码。
      holder[Holder]否创建联系人的应用信息。
      attrs[ContactAttributes]否联系人的属性列表。

      返回值：

      类型说明
      Promise>以Promise形式返回结果，返回查询到的联系人对象数组。

      示例：

      let promise = contact.queryContactsByPhoneNumber('138xxxxxxxx', {
    holderId: 0
}, {
    attributes: ["ATTR_EMAIL", "ATTR_NAME"]
});
promise.then((data) = > {
    console.log(`queryContactsByPhoneNumber success: data- >${JSON.stringify(data)}`);
}).catch((err) = > {
    console.error(`queryContactsByPhoneNumber fail: err- >${JSON.stringify(err)}`);
});

      contact.queryContactsByEmail

      queryContactsByEmail(email: string, callback: AsyncCallback>): void

      根据email查询联系人，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      emailstring是联系人的邮箱地址。
      callbackAsyncCallback>是回调函数，返回查询到的联系人对象数组。

      示例：

      contact.queryContactsByEmail('xxx@email.com', (err, data) = > {
    if (err) {
        console.log(`queryContactsByEmail callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContactsByEmail callback: success data- >${JSON.stringify(data)}`);
});

      contact.queryContactsByEmail

      queryContactsByEmail(email: string, holder: Holder, callback: AsyncCallback>): void

      根据email查询联系人，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      emailstring是联系人的邮箱地址。
      holder[Holder]是创建联系人的应用信息。
      callbackAsyncCallback>是回调函数，返回查询到的联系人对象数组。

      示例：

      contact.queryContactsByEmail('xxx@email.com', {
    holderId: 0
}, (err, data) = > {
    if (err) {
        console.log(`queryContactsByEmail callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContactsByEmail callback: success data- >${JSON.stringify(data)}`);
});

      contact.queryContactsByEmail

      queryContactsByEmail(email: string, attrs: ContactAttributes, callback: AsyncCallback>): void

      根据email查询联系人，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      emailstring是联系人的邮箱地址。
      attrs[ContactAttributes]是联系人的属性列表。
      callbackAsyncCallback>是回调函数，返回查询到联系人对象数组。

      示例：

      contact.queryContactsByEmail('xxx@email.com', {
    attributes: ["ATTR_EMAIL", "ATTR_NAME"]
}, (err, data) = > {
    if (err) {
        console.log(`queryContactsByEmail callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContactsByEmail callback: success data- >${JSON.stringify(data)}`);
});

      contact.queryContactsByEmail

      queryContactsByEmail(email: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback>): void

      根据email查询联系人，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      emailstring是联系人的邮箱地址。
      holder[Holder]是创建联系人的应用信息。
      attrs[ContactAttributes]是联系人的属性列表。
      callbackAsyncCallback>是回调函数，返回查询到联系人对象数组。

      示例：

      contact.queryContactsByEmail('xxx@email.com', {
    holderId: 0
}, {
    attributes: ["ATTR_EMAIL", "ATTR_NAME"]
}, (err, data) = > {
    if (err) {
        console.log(`queryContactsByEmail callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryContactsByEmail callback: success data- >${JSON.stringify(data)}`);
});

      contact.queryContactsByEmail

      queryContactsByEmail(email: string, holder?: Holder, attrs?: ContactAttributes): Promise>

      根据email查询联系人，使用Promise方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      emailstring是联系人的邮箱地址。
      holder[Holder]否创建联系人的应用信息。
      attrs[ContactAttributes]否联系人的属性列表。

      返回值：

      类型说明
      Promise>以Promise形式返回结果，返回查询到的联系人对象数组。

      示例：

      let promise = contact.queryContactsByEmail('xxx@email.com', {
    holderId: 0
}, {
    attributes: ["ATTR_EMAIL", "ATTR_NAME"]
});
promise.then((data) = > {
    console.log(`queryContactsByEmail success: data- >${JSON.stringify(data)}`);
}).catch((err) = > {
    console.error(`queryContactsByEmail fail: err- >${JSON.stringify(err)}`);
});

      contact.queryGroups

      queryGroups(callback: AsyncCallback>): void

      查询联系人的所有群组，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      callbackAsyncCallback>是回调函数，返回查询到的群组对象数组。

      示例：

      contact.queryGroups((err, data) = > {
    if (err) {
        console.log(`queryGroups callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryGroups callback: success data- >${JSON.stringify(data)}`);
});

      contact.queryGroups

      queryGroups(holder: Holder, callback: AsyncCallback>): void

      查询联系人的所有群组，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      holderHolder是创建联系人的应用信息。
      callbackAsyncCallback>是回调函数，返回查询到的群组对象数组。

      示例：

      contact.queryGroups({
    holderId: 0
}, (err, data) = > {
    if (err) {
        console.log(`queryGroups callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryGroups callback: success data- >${JSON.stringify(data)}`);
});

      contact.queryGroups

      queryGroups(holder?: Holder): Promise>

      查询联系人的所有群组，使用Promise方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      holder[Holder]否创建联系人的应用信息。

      返回值：

      类型说明
      Promise>以Promise形式返回结果，返回查询到的群组对象数组。

      示例：

      let promise = contact.queryGroups({
    holderId: 0
});
promise.then((data) = > {
    console.log(`queryGroups success: data- >${JSON.stringify(data)}`);
}).catch((err) = > {
    console.error(`queryGroups fail: err- >${JSON.stringify(err)}`);
});

      contact.queryHolders

      queryHolders(callback: AsyncCallback>): void

      查询所有创建联系人的应用信息，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      callbackAsyncCallback>是回调函数，返回查询到的创建联系人应用信息的对象数组。

      示例：

      contact.queryHolders((err, data) = > {
    if (err) {
        console.log(`queryHolders callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryHolders callback: success data- >${JSON.stringify(data)}`);
});

      contact.queryHolders

      queryHolders(): Promise>

      查询所有创建联系人的应用信息，使用Promise方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      返回值：

      类型说明
      Promise>以Promise形式返回结果，返回查询到的创建联系人应用信息的对象数组。

      示例：

      let promise = contact.queryHolders();
promise.then((data) = > {
    console.log(`queryHolders success: data- >${JSON.stringify(data)}`);
}).catch((err) = > {
    console.error(`queryHolders fail: err- >${JSON.stringify(err)}`);
});

      contact.queryKey

      queryKey(id: number, callback: AsyncCallback): void

      根据联系人的id查询联系人的key，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      idnumber是联系人对象的id属性。
      callbackAsyncCallback是回调函数，返回查询到的联系人对应的key。

      示例：

      contact.queryKey(/*id*/1, (err, data) = > {
    if (err) {
        console.log(`queryKey callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryKey callback: success data- >${JSON.stringify(data)}`);
});

      contact.queryKey

      queryKey(id: number, holder: Holder, callback: AsyncCallback): void

      根据联系人的id查询联系人的key，使用callback方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      idnumber是联系人对象的id属性。
      holder[Holder]是创建联系人的应用信息。
      callbackAsyncCallback是回调函数，返回查询到的联系人对应的key。

      示例：

      contact.queryKey(id, {
    holderId:1
}, (err, data) = > {
    if (err) {
        console.log(`queryKey callback: err- >${JSON.stringify(err)}`);
        return;
    }
    console.log(`queryKey callback: success data- >${JSON.stringify(data)}`);
});

      contact.queryKey

      queryKey(id: number, holder?: Holder): Promise

      根据联系人的id查询联系人的key，使用Promise方式作为异步方法。

      需要权限 ：ohos.permission.READ_CONTACTS

      系统能力 ：SystemCapability.Applications.ContactsData

      参数：

      参数名类型必填说明
      idnumber是联系人对象的id属性。
      holder[Holder]否创建联系人的应用信息。

      返回值：

      类型说明
      Promise以Promise形式返回结果，返回查询到的联系人对应的key。

      示例：

      let promise = contact.queryKey(id, {
    holderId: 0
});
promise.then((data) = > {
    console.log(`queryKey success: data- >${JSON.stringify(data)}`);
}).catch((err) = > {
    console.error(`queryKey fail: err- >${JSON.stringify(err)}`);
});

      Contact

      联系人对象类。

      系统能力 ：以下各项对应的系统能力均为SystemCapability.Applications.ContactsData。

      常量

      名称值说明
      INVALID_CONTACT_ID-1默认联系人的id。

      属性

      名称参数类型可读可写说明
      idnumber是否联系人的id。
      keystring是否联系人的key。
      contactAttributes[ContactAttributes]是是联系人的属性列表。
      emails[Email]是是联系人的邮箱地址列表。
      events[Event]是是联系人的生日、周年纪念等重要日期列表。
      groups[Group]是是联系人的群组列表。
      imAddresses[ImAddress]是是联系人的即时消息地址列表。
      phoneNumbers[PhoneNumber]是是联系人的电话号码列表。
      portrait[Portrait]是是联系人的头像。
      postalAddresses[PostalAddress]是是联系人的邮政地址列表。
      relations[Relation]是是联系人的关系列表。
      sipAddresses[SipAddress]是是联系人的会话发起协议（SIP）地址列表。
      websites[Website]是是联系人的网站列表。
      name[Name]是是联系人的姓名。
      nickName[NickName]是是联系人的昵称。
      note[Note]是是联系人的备注。
      organization[Organization]是是联系人的组织信息。

      对象创建示例：

      使用JSON格式创建联系人数据：

      let myContact = {
    phoneNumbers: [{
        phoneNumber: "138xxxxxxxx"
    }],
    name: {
        fullName: "fullName",
        namePrefix: "namePrefix"
    },
    nickName: {
        nickName: "nickName"
    }
};

      或使用new一个Contact对象的方式创建数据：

      let myContact = new contact.Contact();
let name = new contact.Name();
name.fullName = "fullName";
let phoneNumber = new contact.PhoneNumber();
phoneNumber.phoneNumber = "138xxxxxxxx";
myContact.name = name;
myContact.phoneNumbers = [phoneNumber];

      ContactAttributes

      联系人属性列表，一般作为入参用来标识希望查询的联系人属性。 当传入为null时，默认查询全部属性。

      系统能力 ：以下各项对应的系统能力均为SystemCapability.Applications.ContactsData。

      名称参数类型可读可写说明
      attributes[Attribute][]是是联系人属性列表。

      对象创建示例：

      使用JSON格式创建数据：

      let contactAttributes = {
    attributes: [
        contact.Attribute.ATTR_EMAIL,
        contact.Attribute.ATTR_NAME,
        contact.Attribute.ATTR_PHONE
    ]
};

      或使用new一个ContactAttributes对象的方式创建数据：

      let contactAttributes = new contact.ContactAttributes();
contactAttributes.attributes = ["ATTR_EMAIL"];

      Attribute

      枚举，联系人属性列表。

      系统能力 ：以下各项对应的系统能力均为SystemCapability.Applications.ContactsData。

      名称说明
      ATTR_CONTACT_EVENT联系人的生日、周年纪念等重要日期。
      ATTR_EMAIL联系人的邮箱地址。
      ATTR_GROUP_MEMBERSHIP联系人的群组。
      ATTR_IM联系人的即时消息地址。
      ATTR_NAME联系人的姓名。
      ATTR_NICKNAME联系人的昵称。
      ATTR_NOTE联系人的备注。
      ATTR_ORGANIZATION联系人的组织信息。
      ATTR_PHONE联系人的电话号码。
      ATTR_PORTRAIT联系人的头像。
      ATTR_POSTAL_ADDRESS联系人的邮政地址。
      ATTR_RELATION联系人的关系。
      ATTR_SIP_ADDRESS联系人的会话发起协议（SIP）地址。
      ATTR_WEBSITE联系人的网站。

      对象创建示例：

      使用JSON格式创建数据：

      let attributes = [contact.Attribute.ATTR_EMAIL, contact.Attribute.ATTR_NAME, contact.Attribute.ATTR_PHONE];

      Email

      联系人的邮箱。

      系统能力 ：以下各项对应的系统能力均为SystemCapability.Applications.ContactsData。

      常量

      名称值说明
      CUSTOM_LABEL0自定义邮箱类型。
      EMAIL_HOME1家庭邮箱类型。
      EMAIL_WORK2工作邮箱类型。
      EMAIL_OTHER3其它邮箱类型。
      INVALID_LABEL_ID-1无效邮箱类型。

      属性

      名称参数类型可读可写说明
      emailstring是是邮箱地址。
      labelNamestring是是邮箱的类型名称。
      displayNamestring是是邮箱的显示名称。
      labelIdnumber是是邮箱的类型。

      对象创建示例：

      使用JSON格式创建数据：

      let email = {
    email: "xxx@email.com",
    displayName: "displayName"
}

      或使用new一个Email对象的方式创建数据：

      let email = new contact.Email();
email.email = "xxx@email.com";

      Holder

      创建联系人的应用信息类。

      系统能力 ：以下各项对应的系统能力均为SystemCapability.Applications.ContactsData。

      名称参数类型可读可写说明
      bundleNamestring是否包名。
      displayNamestring是否应用名称。
      holderIdnumber是是应用id。

      对象创建示例：

      使用JSON格式创建数据：

      let holder = {
  holderId: 0
};

      或使用new一个Holder对象的方式创建数据：

      let holder = new contact.Holder();
holder.holderId = 0;

      Event

      联系人事件类。

      系统能力 ：以下各项对应的系统能力均为SystemCapability.Applications.ContactsData。

      常量

      名称值说明
      CUSTOM_LABEL0自定义事件类型。
      EVENT_ANNIVERSARY1周年纪念事件类型。
      EVENT_OTHER2其它事件类型。
      EVENT_BIRTHDAY3生日事件类型。
      INVALID_LABEL_ID-1无效事件类型。

      属性

      名称参数类型可读可写说明
      eventDatestring是是事件的日期。
      labelNamestring是是事件类型名称。
      labelIdnumber是是事件类型。

      对象创建示例：

      使用JSON格式创建数据：

      let event = {
    eventDate: "xxxxxx"
};

      或使用new一个Event对象的方式创建数据：

      let event = new contact.Event();
event.eventDate = "xxxxxx";

      Group

      联系人的群组类。

      系统能力 ：以下各项对应的系统能力均为SystemCapability.Applications.ContactsData。

      名称参数类型可读可写说明
      groupIdnumber是是联系人群组的id。
      titlestring是是联系人群组的名称。

      对象创建示例：

      使用JSON格式创建数据：

      let group = {
    groupId: 1,
    title: "title"
};

      或使用new一个Group对象的方式创建数据：

      let group = new contact.Group();
group.title = "title";

      ImAddress

      联系人的即时消息地址。

      系统能力 ：以下各项对应的系统能力均为SystemCapability.Applications.ContactsData。

      常量

      名称值说明
      CUSTOM_LABEL-1自定义即时消息类型。
      IM_AIM0AIM即时消息类型。
      IM_MSN1MSN即时消息类型。
      IM_YAHOO2YAHOO即时消息类型。
      IM_SKYPE3SKYPE即时消息类型。
      IM_QQ4QQ即时消息类型。
      IM_ICQ6ICQ即时消息类型。
      IM_JABBER7JABBER即时消息类型。
      INVALID_LABEL_ID-2无效的即时消息类型。

      属性

      名称参数类型可读可写说明
      imAddressstring是是即时消息地址。
      labelNamestring是是即时消息类型名称。
      labelIdnumber是是即时消息类型。

      对象创建示例：

      使用JSON格式创建数据：

      let imAddress = {
    imAddress: "imAddress",
    labelName: "labelName"
};

      或使用new一个ImAddress对象的方式创建数据：

      let imAddress = new contact.ImAddress();
imAddress.imAddress = "imAddress";

      Name

      联系人的名字类。

      系统能力 ：以下各项对应的系统能力均为SystemCapability.Applications.ContactsData。

      名称参数类型可读可写说明
      familyNamestring是是联系人的家庭姓名。
      familyNamePhoneticstring是是联系人的家庭姓名拼音。
      fullNamestring是是联系人的全名。
      givenNamestring是是联系人的名称（firstName）。
      givenNamePhoneticstring是是联系人的名称拼音。
      middleNamestring是是联系人的中间名。
      middleNamePhoneticstring是是联系人的中间名拼音。
      namePrefixstring是是联系人的姓名前缀。
      nameSuffixstring是是联系人的姓名后缀。

      对象创建示例：

      使用JSON格式创建数据：

      let name = {
    familyName: "familyName",
    fullName: "fullName"
};

      或使用new一个name对象的方式创建数据：

      let name = new contact.Name();
name.familyName = "familyName";
name.fullName = "fullName";

      NickName

      联系人的昵称类。

      系统能力 ：以下各项对应的系统能力均为SystemCapability.Applications.ContactsData。

      名称参数类型可读可写说明
      nickNamestring是是联系人的昵称。

      对象创建示例：

      使用JSON格式创建数据：

      let nickName = {
    nickName: "nickName"
};

      或使用new一个NickName对象的方式创建数据：

      let nickName = new contact.NickName();
nickName.nickName = "nickName";

      Note

      联系人的备注类。

      系统能力 ：以下各项对应的系统能力均为SystemCapability.Applications.ContactsData。

      名称参数类型可读可写说明
      noteContentstring是是联系人的备注内容。

      对象创建示例：

      使用JSON格式创建数据：

      let note = {
    noteContent: "noteContent"
};

      或使用new一个Note对象的方式创建数据：

      let note = new contact.Note();
note.noteContent = "noteContent";

      Organization

      联系人的组织类。

      系统能力 ：以下各项对应的系统能力均为SystemCapability.Applications.ContactsData。

      名称参数类型可读可写说明
      namestring是是组织名称。
      titlestring是是组织标题。

      对象创建示例：

      使用JSON格式创建数据：

      let organization = {
    name: "name",
    title: "title"
};

      或使用new一个Organization对象的方式创建数据：

      let organization = new contact.Organization();
organization.name = "name";
organization.title = "title";

      PhoneNumber

      联系人电话号码类。

      系统能力 ：以下各项对应的系统能力均为SystemCapability.Applications.ContactsData。

      常量

      名称值说明
      CUSTOM_LABEL0自定义电话类型。
      NUM_HOME1家庭电话类型。
      NUM_MOBILE2移动电话类型。
      NUM_WORK3工作电话类型。
      NUM_FAX_WORK4工作传真电话类型。
      NUM_FAX_HOME5家庭传真电话类型。
      NUM_PAGER6寻呼机电话类型。
      NUM_OTHER7其它电话类型。
      NUM_CALLBACK8回呼电话类型。
      NUM_CAR9车机电话类型。
      NUM_COMPANY_MAIN10公司电话类型。
      NUM_ISDN11综合业务数字网（ISDN）电话类型。
      NUM_MAIN12主电话类型。
      NUM_OTHER_FAX13其它传真类型。
      NUM_RADIO14无线电话类型。
      NUM_TELEX15电传电话类型。
      NUM_TTY_TDD16电传打字机（TTY）或测试驱动开发（TDD）电话类型。
      NUM_WORK_MOBILE17工作移动电话类型。
      NUM_WORK_PAGER18工作寻呼机电话类型。
      NUM_ASSISTANT19助理电话类型。
      NUM_MMS20彩信电话类型。
      INVALID_LABEL_ID-1无效电话类型。

      属性

      名称参数类型可读可写说明
      labelNamestring是是电话号码类型名称。
      phoneNumberstring是是电话号码。
      labelIdnumber是是电话号码类型。

      对象创建示例：

      使用JSON格式创建数据：

      let phoneNumber = {
    phoneNumber: "138xxxxxxxx",
    labelId: contact.PhoneNumber.NUM_HOME
};

      或使用new一个PhoneNumber对象的方式创建数据：

      let phoneNumber = new contact.PhoneNumber();
phoneNumber.phoneNumber = "138xxxxxxxx";

      Portrait

      联系人的头像类。

      系统能力 ：以下各项对应的系统能力均为SystemCapability.Applications.ContactsData。

      名称参数类型可读可写说明
      uristring是是联系人的头像。

      对象创建示例：

      使用JSON格式创建数据：

      let portrait = {
    uri: "uri"
};

      或使用new一个Portrait对象的方式创建数据：

      let portrait = new contact.Portrait();
portrait.uri = "uri";

      PostalAddress

      联系人的邮政地址类。

      系统能力 ：以下各项对应的系统能力均为SystemCapability.Applications.ContactsData。

      常量

      名称值说明
      CUSTOM_LABEL0自定义邮政地址类型。
      ADDR_HOME1家庭地址类型。
      ADDR_WORK2工作地址类型。
      ADDR_OTHER3其它地址类型。
      INVALID_LABEL_ID-1无效地址类型。

      属性

      名称参数类型可读可写说明
      citystring是是联系人所在的城市。
      countrystring是是联系人所在的国家。
      labelNamestring是是邮政地址类型名称。
      neighborhoodstring是是联系人的邻居。
      poboxstring是是联系人的邮箱。
      postalAddressstring是是联系人的邮政地址。
      postcodestring是是联系人所在区域的邮政编码。
      regionstring是是联系人所在的区域。
      streetstring是是联系人所在的街道。
      labelIdnumber是是邮政地址名称。

      对象创建示例：

      使用JSON格式创建数据：

      let postalAddress = {
    city: "city"
};

      或使用new一个PostalAddress对象的方式创建数据：

      let postalAddress = new contact.PostalAddress();
postalAddress.city = "city";

      Relation

      联系人的关系类。

      系统能力 ：以下各项对应的系统能力均为SystemCapability.Applications.ContactsData。

      常量

      名称值说明
      CUSTOM_LABEL0自定义关系类型。
      RELATION_ASSISTANT1助手关系类型。
      RELATION_BROTHER2兄弟关系类型。
      RELATION_CHILD3子女关系类型。
      RELATION_DOMESTIC_PARTNER4同居同伴关系类型。
      RELATION_FATHER5父亲关系类型。
      RELATION_FRIEND6朋友关系类型。
      RELATION_MANAGER7管理者关系类型。
      RELATION_MOTHER8母亲关系类型。
      RELATION_PARENT9父母关系类型。
      RELATION_PARTNER10合作伙伴关系类型。
      RELATION_REFERRED_BY11推荐人关系类型。
      RELATION_RELATIVE12亲属关系类型。
      RELATION_SISTER13姐妹关系类型。
      RELATION_SPOUSE14配偶关系类型。
      INVALID_LABEL_ID-1无效的关系类型。

      属性

      名称参数类型可读可写说明
      labelNamestring是是关系类型名称。
      relationNamestring是是关系名称。
      labelIdnumber是是关系类型。

      对象创建示例：

      使用JSON格式创建数据：

      let relation = {
    relationName: "relationName",
    labelId: contact.Relation.RELATION_ASSISTANT
};

      或使用new一个Relation对象的方式创建数据：

      let relation = new contact.Relation();
relation.relationName = "relationName";
relation.labelId = contact.Relation.RELATION_ASSISTANT;

      SipAddress

      联系人的会话发起协议（SIP）地址类。

      系统能力 ：以下各项对应的系统能力均为SystemCapability.Applications.ContactsData。

      常量

      名称值说明
      CUSTOM_LABEL0自定义会话发起协议（SIP）地址类型。
      SIP_HOME1家庭会话发起协议（SIP）地址类型。
      SIP_WORK2工作会话发起协议（SIP）地址类型。
      SIP_OTHER3其它会话发起协议（SIP）地址类型。
      INVALID_LABEL_ID-1无效会话发起协议（SIP）地址类型。

      属性

      名称参数类型可读可写说明
      labelNamestring是是会话发起协议（SIP）地址类型名称。
      sipAddressstring是是会话发起协议（SIP）地址。
      labelIdnumber是是会话发起协议（SIP）地址类型。

      对象创建示例：

      使用JSON格式创建数据：

      var sipAddress = {
    sipAddress: "sipAddress"
};

      或使用new一个SipAddress对象的方式创建数据：

      let sipAddress = new contact.SipAddress();
sipAddress.sipAddress = "sipAddress";

      Website

      联系人的网站信息类。

      系统能力 ：以下各项对应的系统能力均为SystemCapability.Applications.ContactsData。

      名称参数类型可读可写说明
      websitestring是是联系人的网站信息。HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿

      搜狗高速浏览器截图20240326151450.png

      对象创建示例：

      使用JSON格式创建数据：

      let website = {
    website: "website"
};

      或使用new一个Website对象的方式创建数据：

      let website = new contact.Website();
website.website = "website";

      审核编辑 黄宇

      声明：本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人，不代表电子发烧友网立场。文章及其配图仅供工程师学习之用，如有内容侵权或者其他违规问题，请联系本站处理。 举报投诉
      • 接口
        接口
        +关注

        关注

        33

        文章

        7963

        浏览量

        149211
      • 鸿蒙
        鸿蒙
        +关注

        关注

        55

        文章

        2090

        浏览量

        42261
      收藏 人收藏

        评论

        相关推荐

        OpenHarmony开发实例：【电话簿联系人Contacts】

        Contacts应用是基于OpenHarmony SDK开发的安装在润和HiSpark Taurus AI Camera(Hi3516d)开发板标准系统上的应用；应用主要功能是展示联系人列表，并点击某一列弹出
        的头像 发表于 04-23 09:44 •450次阅读
        OpenHarmony<b class='flag-5'>开发</b>实例：【<b class='flag-5'>电话</b>簿<b class='flag-5'>联系人</b>Contacts】

        鸿蒙实战项目开发：【短信服务】

        送短信的功能。 效果预览 新建联系人 首页 短信页 使用说明： 首页点击创建联系人，弹框输入联系人姓名和电话，点击确定按钮后，联系人列
        发表于 03-03 21:29

        鸿蒙原生应用元服务开发-位置服务申请权限

        申请位置权限开发指导 场景概述 应用在使用位置服务系统能力前，需要检查是否已经获取用户授权访问设备位置信息。如未获得授权，可以向用户申请需要的位置权限。 系统提供的定位权限有
        发表于 06-18 15:27

        [9.3.1]--电话本和联系人

        操作系统Andriod系统
        jf_75936199
        发布于 :2023年03月06日 00:35:31

        [9.3.1]--电话本和联系人

        操作系统Andriod系统
        jf_75936199
        发布于 :2023年03月06日 00:36:13

        msn联系人列表错误不可能用,错误号是81000378

        msn联系人列表错误不可能用msn登录时都出现了 “联系人列表不可用”的错误，错误号是81000378，这种错误一般出现在局域网里，我的解决方法是：拔掉网线，通过拨号或其他方式上网，登录msn，登录
        发表于 06-30 09:25

        基于Labview的电话薄

        本帖最后由 wellsun 于 2013-4-9 15:54 编辑 用Labview软件编写的电话薄程序！使用说明：1、在工具栏，选择”添加联系人（ADD）“，将联系人相关信息输入表格内，确认
        发表于 04-09 15:29

        联旭银河厂家直销各种LED开关电源，量大从优，联系人单经理，电话***，微信15940140279

        联旭银河厂家直销各种LED开关电源，量大从优，和明伟、恒孚、创联质量一样的好电源，高性价比，联系人单经理，电话***，微信15940140279
        发表于 07-30 12:22

        魅族手机删除的联系人怎么恢复，还有办法能用吗

        解决，如果你想要将已经删除的手机联系人不费吹灰之力恢复的话，我建议你用这个方法。 第一步：打开手机浏览器或是应用市场，搜索“手机数据恢复精灵”，手机恢复精灵官网：,将其下载至手机上。 第二步：运行软件
        发表于 10-13 14:13

        雅虎邮箱增导入Facebook联系人功能

        雅虎邮箱增导入Facebook联系人功能 业界人士认为，雅虎邮箱增加导入Facebook联系人功能，意在吸引更多微软Hotmail和谷歌Gmail用户转用雅虎邮箱，虽然雅虎并不一定能够实
        发表于 03-06 09:04 •998次阅读

        iPhone6/plus和iPhone7/plus误删联系人，秒召回的办法，百试不爽！

        iPhone误删，这是一个人人都会遇到的问题，有时候是短信，有时候是通话或者聊天记录，还有时候就是联系人了，明明记得存过电话，怎么需要找的时候找不到？
        发表于 05-19 10:20 •2995次阅读

        谷歌通讯录应用允许用户备份和同步设备上的联系人

        好消息是，近日更新的 Google Contacts 应用，已经允许用户选择备份和同步本地存储的联系人信息了。
        的头像 发表于 02-29 15:33 •2353次阅读
        谷歌通讯录应用允许用户备份和同步设备上的<b class='flag-5'>联系人</b>

        鸿蒙开发实战：【电话服务子系统】

        电话服务子系统，提供了一系列的API用于获取无线蜂窝网络和SIM卡相关的一些信息。应用可以通过调用API来获取当前注册网络名称、网络服务状态、信号强度以及SIM卡的相关信息。
        的头像 发表于 03-14 21:49 •181次阅读
        <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b>实战：【<b class='flag-5'>电话</b><b class='flag-5'>服务</b>子系统】

        鸿蒙开发电话服务：【@ohos.telephony.call (拨打电话)】

        call模块提供呼叫管理功能，包括拨打电话、跳转到拨号界面、获取通话状态、格式化电话号码等。
        的头像 发表于 06-15 09:13 •309次阅读
        <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发电话</b><b class='flag-5'>服务</b>：【@<b class='flag-5'>ohos</b>.telephony.call (拨打<b class='flag-5'>电话</b>)】

        鸿蒙开发电话服务：【@ohos.telephony.observer (observer)】

        订阅网络状态变化事件，使用callback方式作为异步方法。
        的头像 发表于 06-15 09:18 •345次阅读
        <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发电话</b><b class='flag-5'>服务</b>：【@<b class='flag-5'>ohos</b>.telephony.observer (observer)】
        华秋（原“华强聚丰”）：
        电子发烧友
        华秋开发
        华秋电路(原"华强PCB")
        华秋商城(原"华强芯城")
        华秋智造
        My ElecFans
        APP
        网站地图
        设计技术
        可编程逻辑
        电源/新能源
        MEMS/传感技术
        测量仪表
        嵌入式技术
        制造/封装
        模拟技术
        RF/无线
        接口/总线/驱动
        处理器/DSP
        EDA/IC设计
        存储技术
        光电显示
        EMC/EMI设计
        连接器
        行业应用
        LEDs
        汽车电子
        音视频及家电
        通信网络
        医疗电子
        人工智能
        虚拟现实
        可穿戴设备
        机器人
        安全设备/系统
        军用/航空电子
        移动通信
        工业控制
        便携设备
        触控感测
        物联网
        智能电网
        区块链
        新科技
        特色内容
        专栏推荐
        学院
        设计资源
        设计技术
        电子百科
        电子视频
        元器件知识
        工具箱
        VIP会员
        最新技术文章
        社区
        小组
        论坛
        问答
        评测试用
        企业服务
        产品
        资料
        文章
        方案
        企业
        供应链服务
        硬件开发
        华秋电路
        华秋商城
        华秋智造
        nextPCB
        BOM配单
        媒体服务
        网站广告
        在线研讨会
        活动策划
        新闻发布
        新品发布
        小测验
        设计大赛
        华秋
        关于我们
        投资关系
        新闻动态
        加入我们
        联系我们
        举报投诉
        社交网络
        微博
        移动端
        发烧友APP
        硬声APP
        WAP
        联系我们
        广告合作
        王婉珠：wangwanzhu@elecfans.com
        内容合作
        黄晶晶：huangjingjing@elecfans.com
        内容合作（海外）
        张迎辉：mikezhang@elecfans.com
        供应链服务 PCB/IC/PCBA
        江良华：lanhu@huaqiu.com
        投资合作
        曾海银：zenghaiyin@huaqiu.com
        社区合作
        刘勇：liuyong@huaqiu.com
        华秋发烧友
        电子工程师社区
        华秋电路
        1-32层PCB打样·中小批量
        华秋商城
        元器件现货·全球代购·SmartBOM
        华秋智造
        SMT贴片·PCBA加工
        NextPCB
        PCB Manufacturer

        版权所有 © 湖南华秋数字科技有限公司

        电子发烧友 （电路图） 湘公网安备43011202000918 电信与信息服务业务经营许可证：合字B2-20210191 工商网监认证工商网监 湘ICP备 2023018690 号