!22586 添加接口支持范围说明

Merge pull request !22586 from zhouhongli2023/OpenHarmony-3.2-Release

zh-cn/application-dev/reference/apis/js-apis-contact.md

@@ -19,6 +19,8 @@ addContact(contact:Contact, callback:AsyncCallback<number>): void
 
 添加联系人，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.WRITE_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -52,6 +54,8 @@ addContact(contact: Contact): Promise<number>
 
 添加联系人，使用Promise方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.WRITE_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -89,6 +93,8 @@ deleteContact(key: string, callback: AsyncCallback<void>): void
 
 删除联系人，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.WRITE_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -119,6 +125,8 @@ deleteContact(key: string): Promise<void>
 
 删除联系人，使用Promise方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.WRITE_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -153,6 +161,8 @@ updateContact(contact: Contact, callback: AsyncCallback<void>): void
 
 更新联系人，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.WRITE_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -187,6 +197,8 @@ updateContact(contact: Contact, attrs: ContactAttributes, callback: AsyncCallbac
 
 更新联系人，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.WRITE_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -224,6 +236,8 @@ updateContact(contact: Contact, attrs?: ContactAttributes): Promise<void>
 
 更新联系人，使用Promise方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.WRITE_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -264,6 +278,8 @@ isLocalContact(id: number, callback: AsyncCallback<boolean>): void
 
 判断当前联系人id是否在电话簿中，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -294,6 +310,8 @@ isLocalContact(id: number): Promise<boolean>
 
 判断当前联系人id是否在电话簿中，使用Promise方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -328,6 +346,8 @@ isMyCard(id: number, callback: AsyncCallback<boolean>): void
 
 判断是否为“我的名片”，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -358,6 +378,8 @@ isMyCard(id: number): Promise<boolean>
 
 判断是否为“我的名片”，使用Promise方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -392,6 +414,8 @@ queryMyCard(callback: AsyncCallback<Contact>): void
 
 查询“我的名片”，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -421,6 +445,8 @@ queryMyCard(attrs: ContactAttributes, callback: AsyncCallback<Contact>): v
 
 查询“我的名片”，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -453,6 +479,8 @@ queryMyCard(attrs?: ContactAttributes): Promise<Contact>
 
 查询“我的名片”，使用Promise方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -488,6 +516,8 @@ selectContact(callback: AsyncCallback<Array<Contact>>): void
 
 选择联系人，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **系统能力**：SystemCapability.Applications.Contacts
 
 **参数：**
@@ -515,6 +545,8 @@ selectContact(): Promise<Array<Contact>>
 
 选择联系人，使用Promise方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **系统能力**：SystemCapability.Applications.Contacts
 
 **返回值：**
@@ -541,6 +573,8 @@ queryContact(key: string,  callback: AsyncCallback<Contact>): void
 
 根据key查询联系人，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -571,6 +605,8 @@ queryContact(key: string, holder: Holder, callback: AsyncCallback<Contact>
 
 根据key查询联系人，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -606,6 +642,8 @@ queryContact(key: string,  attrs: ContactAttributes, callback: AsyncCallback<
 
 根据key查询联系人，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -639,6 +677,8 @@ queryContact(key: string, holder: Holder, attrs: ContactAttributes, callback: As
 
 根据key查询联系人，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -677,6 +717,8 @@ queryContact(key: string, holder?: Holder, attrs?: ContactAttributes): Promise&l
 
 根据key查询联系人，使用Promise方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -718,6 +760,8 @@ queryContacts(callback: AsyncCallback<Array<Contact>>): void
 
 查询所有联系人，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -747,6 +791,8 @@ queryContacts(holder: Holder, callback: AsyncCallback<Array<Contact>&gt
 
 查询所有联系人，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -781,6 +827,8 @@ queryContacts(attrs: ContactAttributes, callback: AsyncCallback<Array<Cont
 
 查询所有联系人，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -813,6 +861,8 @@ queryContacts(holder: Holder, attrs: ContactAttributes, callback: AsyncCallback&
 
 查询所有联系人，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -850,6 +900,8 @@ queryContacts(holder?: Holder, attrs?: ContactAttributes): Promise<Array<C
 
 查询所有联系人，使用Promise方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -890,6 +942,8 @@ queryContactsByPhoneNumber(phoneNumber: string, callback: AsyncCallback<Array
 
 根据电话号码查询联系人，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -920,6 +974,8 @@ queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, callback: AsyncC
 
 根据电话号码查询联系人，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -955,6 +1011,8 @@ queryContactsByPhoneNumber(phoneNumber: string, attrs: ContactAttributes, callba
 
 根据电话号码查询联系人，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -988,6 +1046,8 @@ queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, attrs: ContactAt
 
 根据电话号码查询联系人，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -1026,6 +1086,8 @@ queryContactsByPhoneNumber(phoneNumber: string, holder?: Holder, attrs?: Contact
 
 根据电话号码查询联系人，使用Promise方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -1068,6 +1130,8 @@ queryContactsByEmail(email: string, callback: AsyncCallback<Array<Contact&
 
 根据email查询联系人，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -1098,6 +1162,8 @@ queryContactsByEmail(email: string, holder: Holder, callback: AsyncCallback<A
 
 根据email查询联系人，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -1133,6 +1199,8 @@ queryContactsByEmail(email: string, attrs: ContactAttributes, callback: AsyncCal
 
 根据email查询联系人，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -1166,6 +1234,8 @@ queryContactsByEmail(email: string, holder: Holder, attrs: ContactAttributes, ca
 
 根据email查询联系人，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -1204,6 +1274,8 @@ queryContactsByEmail(email: string, holder?: Holder, attrs?: ContactAttributes):
 
 根据email查询联系人，使用Promise方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -1246,6 +1318,8 @@ queryGroups(callback: AsyncCallback<Array<Group>>): void
 
 查询联系人的所有群组，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -1275,6 +1349,8 @@ queryGroups(holder: Holder, callback: AsyncCallback<Array<Group>>):
 
 查询联系人的所有群组，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -1309,6 +1385,8 @@ queryGroups(holder?: Holder): Promise<Array<Group>>
 
 查询联系人的所有群组，使用Promise方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -1347,6 +1425,8 @@ queryHolders(callback: AsyncCallback<Array<Holder>>): void
 
 查询所有创建联系人的应用信息，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -1376,6 +1456,8 @@ queryHolders(): Promise<Array<Holder>>
 
 查询所有创建联系人的应用信息，使用Promise方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -1404,6 +1486,8 @@ queryKey(id: number, callback: AsyncCallback<string>): void
 
 根据联系人的id查询联系人的key，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -1434,6 +1518,8 @@ queryKey(id: number, holder: Holder, callback: AsyncCallback<string>): voi
 
 根据联系人的id查询联系人的key，使用callback方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData
@@ -1469,6 +1555,8 @@ queryKey(id: number, holder?: Holder): Promise<string>
 
 根据联系人的id查询联系人的key，使用Promise方式作为异步方法。
 
+该接口仅支持在FA模型中调用。
+
 **需要权限**：ohos.permission.READ_CONTACTS
 
 **系统能力**：SystemCapability.Applications.ContactsData