Contacts Kit(联系人服务):可以帮助开发者轻松实现联系人的增删改查等功能。该Kit提供了一系列API,可以让开发者在应用中快速集成联系人管理功能。
当前能力受限开放,需要申请受限开放权限ohos.permission.READ_CONTACTS或ohos.permission.WRITE_CONTACTS。该权限通常不允许三方应用申请,仅符合指定场景的应用可申请该权限。
通过startAbility的方式拉起通讯录新建联系人,支持contactName、phoneNumber和newContactData全字段,newContactData数据类型为Contact。
通过picker的方式拉起新建联系人,参数列表如下:
字段名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
pageFlag | string | 是 | 通过want拉起新建联系人界面,使用“page_flag_save_contact”。 |
phoneNumber | string | 是 | 预填写新建联系人手机号码。 |
contactName | string | 是 | 预填写新建联系人姓名。 |
newContactData | Contact | 否 | 如果phoneNumber、contactName与Contact同时配置,在新建联系人时,优先显示Contact中的数据。 |
import common from '@ohos.app.ability.common'; import { BusinessError } from '@kit.BasicServicesKit'; import { contact } from '@kit.ContactsKit'; @Entry @Component struct ContactPage { build() { Row() { Column() { Button('拉起新建联系人界面').fontSize(24).fontWeight(FontWeight.Bold) .onClick(() => { let context = this.getUIContext().getHostContext() as common.UIAbilityContext; startContact(context); }).margin(10) }.width('100%') }.height('100%') } } const contactInfo: contact.Contact = { name: { fullName: 'xxx' }, phoneNumbers: [{ phoneNumber: '138xxxxxxxx' }], emails: [{ email: 'xxx@email.com' }] }; function startContact(context: common.UIAbilityContext): void { context.startAbility({ bundleName: 'com.ohos.contacts', abilityName: 'com.ohos.contacts.MainAbility', parameters: { contactName: 'xxx', phoneNumber: '136xxxxxxxx', // 通过page_flag_save_contact的方式可以拉起“新建联系人”页面 pageFlag: 'page_flag_save_contact', newContactData: contactInfo } }).then(() => { console.info('ok'); }).catch((err: BusinessError) => { console.error(`Failed Code: ${err.code}, message: ${err.message}`); }); }