Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
e4ae26cf
D
Docs
项目概览
OpenHarmony
/
Docs
大约 2 年 前同步成功
通知
161
Star
293
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
提交
e4ae26cf
编写于
8月 23, 2023
作者:
Z
zhouhongli2023
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update
Signed-off-by:
N
zhouhongli2023
<
zhouhongli5@huawei.com
>
上级
31583289
变更
1
显示空白变更内容
内联
并排
Showing
1 changed file
with
2240 addition
and
153 deletion
+2240
-153
zh-cn/application-dev/reference/apis/js-apis-contact.md
zh-cn/application-dev/reference/apis/js-apis-contact.md
+2240
-153
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-contact.md
浏览文件 @
e4ae26cf
...
@@ -13,7 +13,57 @@
...
@@ -13,7 +13,57 @@
import contact from '@ohos.contact';
import contact from '@ohos.contact';
```
```
## contact.addContact
## contact.addContact<sup>10+<sup>
addContact(context: Context, contact: Contact, callback: AsyncCallback
<number>
): void
添加联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.WRITE_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| contact |
[
Contact
](
#contact
)
| 是 | 联系人信息。 |
| callback | AsyncCallback
<
number
>
| 是 | 回调函数,返回添加的联系人id。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
contact
.
addContact
(
globalThis
.
context
as
Context
,
{
name
:
{
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(deprecated)
addContact(contact:Contact, callback:AsyncCallback
<
number
>
): void
addContact(contact:Contact, callback:AsyncCallback
<
number
>
): void
...
@@ -45,8 +95,61 @@ addContact(contact:Contact, callback:AsyncCallback<number>): void
...
@@ -45,8 +95,61 @@ addContact(contact:Contact, callback:AsyncCallback<number>): void
});
});
```
```
## contact.addContact<sup>10+<sup>
addContact(context: Context, contact: Contact): Promise<number
>
添加联系人,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.WRITE_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| contact |
[
Contact
](
#contact
)
| 是 | 联系人信息。 |
**返回值:**
| 类型 | 说明 |
| --------------------- | ------------------------------------------- |
| Promise
<
number
>
| 以Promise形式返回结果,返回添加的联系人id。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
let
promise
=
contact
.
addContact
(
globalThis
.
context
as
Context
,
{
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.addContact
## contact.addContact
(deprecated)
addContact(contact: Contact): Promise
<
number
>
addContact(contact: Contact): Promise
<
number
>
...
@@ -82,8 +185,53 @@ addContact(contact: Contact): Promise<number>
...
@@ -82,8 +185,53 @@ addContact(contact: Contact): Promise<number>
});
});
```
```
## contact.deleteContact<sup>10+<sup>
deleteContact(context: Context, key: string, callback: AsyncCallback
<
void
>
): void
删除联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.WRITE_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| key | string | 是 | 联系人key值,一个联系人对应一个key。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数,返回删除联系人的结果。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
contact
.
deleteContact
(
globalThis
.
context
as
Context
,
'
xxx
'
,
(
err
)
=>
{
if
(
err
)
{
console
.
log
(
`deleteContact callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
}
console
.
log
(
'
deleteContact success
'
);
});
```
## contact.deleteContact
## contact.deleteContact
(deprecated)
deleteContact(key: string, callback: AsyncCallback
<
void
>
): void
deleteContact(key: string, callback: AsyncCallback
<
void
>
): void
...
@@ -113,7 +261,57 @@ deleteContact(key: string, callback: AsyncCallback<void>): void
...
@@ -113,7 +261,57 @@ deleteContact(key: string, callback: AsyncCallback<void>): void
```
```
## contact.deleteContact
## contact.deleteContact<sup>10+<sup>
deleteContact(context: Context, key: string): Promise
<
void
>
删除联系人,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.WRITE_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| key | string | 是 | 联系人的key值,一个联系人对应一个key。 |
**返回值:**
| 类型 | 说明 |
| ------------------- | --------------------------------------------- |
| Promise
<
void
>
| 以Promise形式返回结果,返回删除联系人的结果。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
let
promise
=
contact
.
deleteContact
(
globalThis
.
context
as
Context
,
'
xxx
'
);
promise
.
then
(()
=>
{
console
.
log
(
`deleteContact success`
);
}).
catch
((
err
)
=>
{
console
.
error
(
`deleteContact fail: err->
${
JSON
.
stringify
(
err
)}
`
);
});
```
## contact.deleteContact(deprecated)
deleteContact(key: string): Promise
<
void
>
deleteContact(key: string): Promise
<
void
>
...
@@ -147,7 +345,57 @@ deleteContact(key: string): Promise<void>
...
@@ -147,7 +345,57 @@ deleteContact(key: string): Promise<void>
```
```
## contact.updateContact
## contact.updateContact<sup>10+<sup>
updateContact(context: Context, contact: Contact, callback: AsyncCallback
<
void
>
): void
更新联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.WRITE_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| contact |
[
Contact
](
#contact
)
| 是 | 联系人信息。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数,返回更新联系人的更新结果。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
contact
.
updateContact
(
globalThis
.
context
as
Context
,
{
id
:
1
,
name
:
{
fullName
:
'
xxx
'
},
phoneNumbers
:
[{
phoneNumber
:
'
138xxxxxxxx
'
}]
},
(
err
)
=>
{
if
(
err
)
{
console
.
log
(
'
updateContact callback: err->${JSON.stringify(err)}
'
);
return
;
}
console
.
log
(
'
updateContact success
'
);
});
```
## contact.updateContact(deprecated)
updateContact(contact: Contact, callback: AsyncCallback
<
void
>
): void
updateContact(contact: Contact, callback: AsyncCallback
<
void
>
): void
...
@@ -181,7 +429,60 @@ updateContact(contact: Contact, callback: AsyncCallback<void>): void
...
@@ -181,7 +429,60 @@ updateContact(contact: Contact, callback: AsyncCallback<void>): void
```
```
## contact.updateContact
## contact.updateContact<sup>10+<sup>
updateContact(context: Context, contact: Contact, attrs: ContactAttributes, callback: AsyncCallback
<
void
>
): void
更新联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.WRITE_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| contact |
[
Contact
](
#contact
)
| 是 | 联系人信息。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数,返回更新联系人的更新结果。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
contact
.
updateContact
(
globalThis
.
context
as
Context
,
{
id
:
1
,
name
:
{
fullName
:
'
xxx
'
},
phoneNumbers
:
[{
phoneNumber
:
'
138xxxxxxxx
'
}]
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
},
(
err
)
=>
{
if
(
err
)
{
console
.
log
(
'
updateContact callback: err->${JSON.stringify(err)}
'
);
return
;
}
console
.
log
(
'
updateContact success
'
);
});
```
## contact.updateContact(deprecated)
updateContact(contact: Contact, attrs: ContactAttributes, callback: AsyncCallback
<
void
>
): void
updateContact(contact: Contact, attrs: ContactAttributes, callback: AsyncCallback
<
void
>
): void
...
@@ -218,7 +519,64 @@ updateContact(contact: Contact, attrs: ContactAttributes, callback: AsyncCallbac
...
@@ -218,7 +519,64 @@ updateContact(contact: Contact, attrs: ContactAttributes, callback: AsyncCallbac
```
```
## contact.updateContact
## contact.updateContact<sup>10+<sup>
updateContact(context: Context, contact: Contact, attrs?: ContactAttributes): Promise
<
void
>
更新联系人,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.WRITE_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | --------------------------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| contact |
[
Contact
](
#contact
)
| 是 | 联系人信息。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 否 | 联系人的属性列表。 |
**返回值:**
| 类型 | 说明 |
| ------------------- | ------------------------------------------------- |
| Promise
<
void
>
| 以Promise形式返回结果,返回更新联系人的更新结果。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
let
promise
=
contact
.
updateContact
(
globalThis
.
context
as
Context
,
{
id
:
1
,
name
:
{
fullName
:
'
xxx
'
},
phoneNumbers
:
[{
phoneNumber
:
'
138xxxxxxxx
'
}]
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
});
promise
.
then
(()
=>
{
console
.
log
(
'
updateContact success
'
);
}).
catch
((
err
)
=>
{
console
.
error
(
`updateContact fail: err->
${
JSON
.
stringify
(
err
)}
`
);
});
```
## contact.updateContact(deprecated)
updateContact(contact: Contact, attrs?: ContactAttributes): Promise
<
void
>
updateContact(contact: Contact, attrs?: ContactAttributes): Promise
<
void
>
...
@@ -258,9 +616,9 @@ updateContact(contact: Contact, attrs?: ContactAttributes): Promise<void>
...
@@ -258,9 +616,9 @@ updateContact(contact: Contact, attrs?: ContactAttributes): Promise<void>
```
```
## contact.isLocalContact
## contact.isLocalContact
<sup>10+<sup>
isLocalContact(id: number, callback: AsyncCallback
<
boolean
>
): void
isLocalContact(
context: Context,
id: number, callback: AsyncCallback
<
boolean
>
): void
判断当前联系人id是否在电话簿中,使用callback方式作为异步方法。
判断当前联系人id是否在电话簿中,使用callback方式作为异步方法。
...
@@ -268,17 +626,34 @@ isLocalContact(id: number, callback: AsyncCallback<boolean>): void
...
@@ -268,17 +626,34 @@ isLocalContact(id: number, callback: AsyncCallback<boolean>): void
**系统能力**
:SystemCapability.Applications.ContactsData
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------- | ---- | ------------------------------------------------------------ |
| -------- | ---------------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| id | number | 是 | 联系人对象的id属性,一个联系人对应一个id。 |
| id | number | 是 | 联系人对象的id属性,一个联系人对应一个id。 |
| callback | AsyncCallback
<
boolean
>
| 是 | 回调函数,返回布尔值。true代表联系人id在本地电话簿中,false则代表联系人id不在本地电话簿中。 |
| callback | AsyncCallback
<
boolean
>
| 是 | 回调函数,返回布尔值。true代表联系人id在本地电话簿中,false则代表联系人id不在本地电话簿中。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
**示例:**
```
js
```
js
contact
.
isLocalContact
(
/*id*/
1
,
(
err
,
data
)
=>
{
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
contact
.
isLocalContact
(
globalThis
.
context
as
Context
,
/*id*/
1
,
(
err
,
data
)
=>
{
if
(
err
)
{
if
(
err
)
{
console
.
log
(
`isLocalContact callback: err->
${
JSON
.
stringify
(
err
)}
`
);
console
.
log
(
`isLocalContact callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
return
;
...
@@ -287,12 +662,11 @@ isLocalContact(id: number, callback: AsyncCallback<boolean>): void
...
@@ -287,12 +662,11 @@ isLocalContact(id: number, callback: AsyncCallback<boolean>): void
});
});
```
```
## contact.isLocalContact(deprecated)
## contact.isLocalContact
isLocalContact(id: number, callback: AsyncCallback
<
boolean
>
): void
isLocalContact(id: number): Promise
<
boolean
>
判断当前联系人id是否在电话簿中,使用
Promise
方式作为异步方法。
判断当前联系人id是否在电话簿中,使用
callback
方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**需要权限**
:ohos.permission.READ_CONTACTS
...
@@ -301,7 +675,86 @@ isLocalContact(id: number): Promise<boolean>
...
@@ -301,7 +675,86 @@ isLocalContact(id: number): Promise<boolean>
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------------------------------------------ |
| -------- | ---------------------------- | ---- | ------------------------------------------------------------ |
| id | number | 是 | 联系人对象的id属性,一个联系人对应一个id。 |
| callback | AsyncCallback
<
boolean
>
| 是 | 回调函数,返回布尔值。true代表联系人id在本地电话簿中,false则代表联系人id不在本地电话簿中。 |
**示例:**
```
js
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<sup>10+<sup>
isLocalContact(context: Context, id: number): Promise
<
boolean
>
判断当前联系人id是否在电话簿中,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| id | number | 是 | 联系人对象的id属性,一个联系人对应一个id。 |
**返回值:**
| 类型 | 说明 |
| ---------------------- | ------------------------------------------------------------ |
| Promise
<
boolean
>
| 以Promise形式返回结果,返回布尔值。true代表联系人id在本地电话簿中,false则代表联系人id不在本地电话簿中。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
let
promise
=
contact
.
isLocalContact
(
globalThis
.
context
as
Context
,
/*id*/
1
);
promise
.
then
((
data
)
=>
{
console
.
log
(
`isLocalContact success: data->
${
JSON
.
stringify
(
data
)}
`
);
}).
catch
((
err
)
=>
{
console
.
error
(
`isLocalContact fail: err->
${
JSON
.
stringify
(
err
)}
`
);
});
```
## contact.isLocalContact(deprecated)
isLocalContact(id: number): Promise
<
boolean
>
判断当前联系人id是否在电话簿中,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------------------------------------------ |
| id | number | 是 | 联系人对象的id属性,一个联系人对应一个id。 |
| id | number | 是 | 联系人对象的id属性,一个联系人对应一个id。 |
**返回值:**
**返回值:**
...
@@ -321,8 +774,53 @@ isLocalContact(id: number): Promise<boolean>
...
@@ -321,8 +774,53 @@ isLocalContact(id: number): Promise<boolean>
});
});
```
```
## contact.isMyCard<sup>10+<sup>
isMyCard(context: Context, id: number, callback: AsyncCallback
<
boolean
>
): void
判断是否为“我的名片”,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| id | number | 是 | 联系人对象的id属性。 |
| callback | AsyncCallback
<
boolean
>
| 是 | 回调函数,返回是否为“我的名片”的布尔值。true代表此联系人是“我的名片”,false则代表不是。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
contact
.
isMyCard
(
globalThis
.
context
as
Context
,
/*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
## contact.isMyCard
(deprecated)
isMyCard(id: number, callback: AsyncCallback
<
boolean
>
): void
isMyCard(id: number, callback: AsyncCallback
<
boolean
>
): void
...
@@ -352,7 +850,57 @@ isMyCard(id: number, callback: AsyncCallback<boolean>): void
...
@@ -352,7 +850,57 @@ isMyCard(id: number, callback: AsyncCallback<boolean>): void
```
```
## contact.isMyCard
## contact.isMyCard<sup>10+<sup>
isMyCard(context: Context, id: number): Promise
<
boolean
>
判断是否为“我的名片”,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| id | number | 是 | 联系人对象的id属性。 |
**返回值:**
| 类型 | 说明 |
| ---------------------- | ------------------------------------------------------------ |
| Promise
<
boolean
>
| 以Promise形式返回结果,返回是否为“我的名片”的布尔值。true代表此联系人是“我的名片”,false则代表不是。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
let
promise
=
contact
.
isMyCard
(
globalThis
.
context
as
Context
,
/*id*/
1
);
promise
.
then
((
data
)
=>
{
console
.
log
(
`isMyCard success: data->
${
JSON
.
stringify
(
data
)}
`
);
}).
catch
((
err
)
=>
{
console
.
error
(
`isMyCard fail: err->
${
JSON
.
stringify
(
err
)}
`
);
});
```
## contact.isMyCard(deprecated)
isMyCard(id: number): Promise
<
boolean
>
isMyCard(id: number): Promise
<
boolean
>
...
@@ -385,8 +933,52 @@ isMyCard(id: number): Promise<boolean>
...
@@ -385,8 +933,52 @@ isMyCard(id: number): Promise<boolean>
});
});
```
```
## contact.queryMyCard<sup>10+<sup>
queryMyCard(context: Context, callback: AsyncCallback
<
Contact
>
): void
查询“我的名片”,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| callback | AsyncCallback
<
[Contact](#contact)
>
| 是 | 回调函数,返回“我的名片”信息。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
contact
.
queryMyCard
(
globalThis
.
context
as
Context
,
(
err
,
data
)
=>
{
if
(
err
)
{
console
.
log
(
`queryMyCard callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
}
console
.
log
(
`queryMyCard callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
```
## contact.queryMyCard
## contact.queryMyCard
(deprecated)
queryMyCard(callback: AsyncCallback
<
Contact
>
): void
queryMyCard(callback: AsyncCallback
<
Contact
>
): void
...
@@ -414,8 +1006,55 @@ queryMyCard(callback: AsyncCallback<Contact>): void
...
@@ -414,8 +1006,55 @@ queryMyCard(callback: AsyncCallback<Contact>): void
});
});
```
```
## contact.queryMyCard<sup>10+<sup>
queryMyCard(context: Context, attrs: ContactAttributes, callback: AsyncCallback
<
Contact
>
): void
查询“我的名片”,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| callback | AsyncCallback
<
[Contact](#contact)
>
| 是 | 回调函数,返回“我的名片”信息。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
contact
.
queryMyCard
(
globalThis
.
context
as
Context
,
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
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
## contact.queryMyCard
(deprecated)
queryMyCard(attrs: ContactAttributes, callback: AsyncCallback
<
Contact
>
): void
queryMyCard(attrs: ContactAttributes, callback: AsyncCallback
<
Contact
>
): void
...
@@ -446,8 +1085,59 @@ queryMyCard(attrs: ContactAttributes, callback: AsyncCallback<Contact>): v
...
@@ -446,8 +1085,59 @@ queryMyCard(attrs: ContactAttributes, callback: AsyncCallback<Contact>): v
});
});
```
```
## contact.queryMyCard<sup>10+<sup>
queryMyCard(context: Context, attrs?: ContactAttributes): Promise
<
Contact
>
查询“我的名片”,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | --------------------------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 否 | 联系人的属性列表。 |
**返回值:**
| 类型 | 说明 |
| ---------------------------------- | ------------------------------------------- |
| Promise
<
[Contact](#contact)
>
| 以Promise形式返回结果,返回“我的名片”信息。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
let
promise
=
contact
.
queryMyCard
(
globalThis
.
context
as
Context
,
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
});
promise
.
then
((
data
)
=>
{
console
.
log
(
`queryMyCard success: data->
${
JSON
.
stringify
(
data
)}
`
);
}).
catch
((
err
)
=>
{
console
.
error
(
`queryMyCard fail: err->
${
JSON
.
stringify
(
err
)}
`
);
});
```
## contact.queryMyCard
## contact.queryMyCard
(deprecated)
queryMyCard(attrs?: ContactAttributes): Promise
<
Contact
>
queryMyCard(attrs?: ContactAttributes): Promise
<
Contact
>
...
@@ -535,9 +1225,9 @@ selectContact(): Promise<Array<Contact>>
...
@@ -535,9 +1225,9 @@ selectContact(): Promise<Array<Contact>>
```
```
## contact.queryContact
## contact.queryContact
<sup>10+<sup>
queryContact(key: string, callback: AsyncCallback
<
Contact
>
): void
queryContact(
context: Context,
key: string, callback: AsyncCallback
<
Contact
>
): void
根据key查询联系人,使用callback方式作为异步方法。
根据key查询联系人,使用callback方式作为异步方法。
...
@@ -545,17 +1235,34 @@ queryContact(key: string, callback: AsyncCallback<Contact>): void
...
@@ -545,17 +1235,34 @@ queryContact(key: string, callback: AsyncCallback<Contact>): void
**系统能力**
:SystemCapability.Applications.ContactsData
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | -------------------------------------- |
| -------- | ---------------------------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| key | string | 是 | 联系人的key值,一个联系人对应一个key。 |
| key | string | 是 | 联系人的key值,一个联系人对应一个key。 |
| callback | AsyncCallback
<
[Contact](#contact)
>
| 是 | 回调函数,返回查询的联系人对象。 |
| callback | AsyncCallback
<
[Contact](#contact)
>
| 是 | 回调函数,返回查询的联系人对象。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
**示例:**
```
js
```
js
contact
.
queryContact
(
'
xxx
'
,
(
err
,
data
)
=>
{
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
contact
.
queryContact
(
globalThis
.
context
as
Context
,
'
xxx
'
,
(
err
,
data
)
=>
{
if
(
err
)
{
if
(
err
)
{
console
.
log
(
`queryContact callback: err->
${
JSON
.
stringify
(
err
)}
`
);
console
.
log
(
`queryContact callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
return
;
...
@@ -564,10 +1271,9 @@ queryContact(key: string, callback: AsyncCallback<Contact>): void
...
@@ -564,10 +1271,9 @@ queryContact(key: string, callback: AsyncCallback<Contact>): void
});
});
```
```
## contact.queryContact(deprecated)
## contact.queryContact
queryContact(key: string, callback: AsyncCallback
<
Contact
>
): void
queryContact(key: string, holder: Holder, callback: AsyncCallback
<
Contact
>
): void
根据key查询联系人,使用callback方式作为异步方法。
根据key查询联系人,使用callback方式作为异步方法。
...
@@ -580,17 +1286,12 @@ queryContact(key: string, holder: Holder, callback: AsyncCallback<Contact>
...
@@ -580,17 +1286,12 @@ queryContact(key: string, holder: Holder, callback: AsyncCallback<Contact>
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | -------------------------------------- |
| -------- | ---------------------------------------- | ---- | -------------------------------------- |
| key | string | 是 | 联系人的key值,一个联系人对应一个key。 |
| key | string | 是 | 联系人的key值,一个联系人对应一个key。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| callback | AsyncCallback
<
[Contact](#contact)
>
| 是 | 回调函数,返回查询的联系人对象。 |
| callback | AsyncCallback
<
[Contact](#contact)
>
| 是 | 回调函数,返回查询的联系人对象。 |
**示例:**
**示例:**
```
js
```
js
contact
.
queryContact
(
'
xxx
'
,
{
contact
.
queryContact
(
'
xxx
'
,
(
err
,
data
)
=>
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
(
err
,
data
)
=>
{
if
(
err
)
{
if
(
err
)
{
console
.
log
(
`queryContact callback: err->
${
JSON
.
stringify
(
err
)}
`
);
console
.
log
(
`queryContact callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
return
;
...
@@ -602,7 +1303,7 @@ queryContact(key: string, holder: Holder, callback: AsyncCallback<Contact>
...
@@ -602,7 +1303,7 @@ queryContact(key: string, holder: Holder, callback: AsyncCallback<Contact>
## contact.queryContact
## contact.queryContact
queryContact(
key: string, attrs: ContactAttributes
, callback: AsyncCallback
<
Contact
>
): void
queryContact(
context: Context, key: string, holder: Holder
, callback: AsyncCallback
<
Contact
>
): void
根据key查询联系人,使用callback方式作为异步方法。
根据key查询联系人,使用callback方式作为异步方法。
...
@@ -610,19 +1311,38 @@ queryContact(key: string, attrs: ContactAttributes, callback: AsyncCallback<
...
@@ -610,19 +1311,38 @@ queryContact(key: string, attrs: ContactAttributes, callback: AsyncCallback<
**系统能力**
:SystemCapability.Applications.ContactsData
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | -------------------------------------- |
| -------- | ---------------------------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| key | string | 是 | 联系人的key值,一个联系人对应一个key。 |
| key | string | 是 | 联系人的key值,一个联系人对应一个key。 |
|
attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。
|
|
holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。
|
| callback | AsyncCallback
<
[Contact](#contact)
>
| 是 | 回调函数,返回查询的联系人对象。 |
| callback | AsyncCallback
<
[Contact](#contact)
>
| 是 | 回调函数,返回查询的联系人对象。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
**示例:**
```
js
```
js
contact
.
queryContact
(
'
xxx
'
,
{
// 获取context
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
contact
.
queryContact
(
globalThis
.
context
as
Context
,
'
xxx
'
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
(
err
,
data
)
=>
{
},
(
err
,
data
)
=>
{
if
(
err
)
{
if
(
err
)
{
console
.
log
(
`queryContact callback: err->
${
JSON
.
stringify
(
err
)}
`
);
console
.
log
(
`queryContact callback: err->
${
JSON
.
stringify
(
err
)}
`
);
...
@@ -632,10 +1352,9 @@ queryContact(key: string, attrs: ContactAttributes, callback: AsyncCallback<
...
@@ -632,10 +1352,9 @@ queryContact(key: string, attrs: ContactAttributes, callback: AsyncCallback<
});
});
```
```
## contact.queryContact(deprecated)
## contact.queryContact
queryContact(key: string, holder: Holder, callback: AsyncCallback
<
Contact
>
): void
queryContact(key: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback
<
Contact
>
): void
根据key查询联系人,使用callback方式作为异步方法。
根据key查询联系人,使用callback方式作为异步方法。
...
@@ -649,7 +1368,6 @@ queryContact(key: string, holder: Holder, attrs: ContactAttributes, callback: As
...
@@ -649,7 +1368,6 @@ queryContact(key: string, holder: Holder, attrs: ContactAttributes, callback: As
| -------- | ---------------------------------------- | ---- | -------------------------------------- |
| -------- | ---------------------------------------- | ---- | -------------------------------------- |
| key | string | 是 | 联系人的key值,一个联系人对应一个key。 |
| key | string | 是 | 联系人的key值,一个联系人对应一个key。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| callback | AsyncCallback
<
[Contact](#contact)
>
| 是 | 回调函数,返回查询的联系人对象。 |
| callback | AsyncCallback
<
[Contact](#contact)
>
| 是 | 回调函数,返回查询的联系人对象。 |
**示例:**
**示例:**
...
@@ -659,8 +1377,6 @@ queryContact(key: string, holder: Holder, attrs: ContactAttributes, callback: As
...
@@ -659,8 +1377,6 @@ queryContact(key: string, holder: Holder, attrs: ContactAttributes, callback: As
holderId
:
0
,
holderId
:
0
,
bundleName
:
""
,
bundleName
:
""
,
displayName
:
""
displayName
:
""
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
},
(
err
,
data
)
=>
{
},
(
err
,
data
)
=>
{
if
(
err
)
{
if
(
err
)
{
console
.
log
(
`queryContact callback: err->
${
JSON
.
stringify
(
err
)}
`
);
console
.
log
(
`queryContact callback: err->
${
JSON
.
stringify
(
err
)}
`
);
...
@@ -670,53 +1386,60 @@ queryContact(key: string, holder: Holder, attrs: ContactAttributes, callback: As
...
@@ -670,53 +1386,60 @@ queryContact(key: string, holder: Holder, attrs: ContactAttributes, callback: As
});
});
```
```
## contact.queryContact
## contact.queryContact
queryContact(
key: string, holder?: Holder, attrs?: ContactAttributes): Promise
<
Contact
>
queryContact(
context: Context, key: string, attrs: ContactAttributes, callback: AsyncCallback
<
Contact
>
): void
根据key查询联系人,使用
Promise
方式作为异步方法。
根据key查询联系人,使用
callback
方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | --------------------------------------- | ---- | -------------------------------------- |
| -------- | ---------------------------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| key | string | 是 | 联系人的key值,一个联系人对应一个key。 |
| key | string | 是 | 联系人的key值,一个联系人对应一个key。 |
|
holder |
[
Holder
](
#holder
)
| 否 | 创建联系人的应用信息。
|
|
attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。
|
|
attrs |
[
ContactAttributes
](
#contactattributes
)
| 否 | 联系人的属性列表。
|
|
callback | AsyncCallback
<
[Contact](#contact)
>
| 是 | 回调函数,返回查询的联系人对象。
|
**返回值:**
**错误码:**
| 类型 | 说明 |
| ---------------------------------- | ----------------------------------------------- |
| 错误码ID | 错误信息 |
| Promise
<
[Contact](#contact)
>
| 以Promise形式返回结果,返回查询到的联系人对象。 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
**示例:**
```
js
```
js
let
promise
=
contact
.
queryContact
(
'
xxx
'
,
{
// 获取context
holderId
:
0
,
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
bundleName
:
""
,
class
EntryAbility
extends
UIAbility
{
displayName
:
""
onWindowStageCreate
(
windowStage
){
},
{
globalThis
.
context
=
this
.
context
;
}
}
contact
.
queryContact
(
globalThis
.
context
as
Context
,
'
xxx
'
,
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
});
},
(
err
,
data
)
=>
{
promise
.
then
((
data
)
=>
{
if
(
err
)
{
console
.
log
(
`queryContact success: data->
${
JSON
.
stringify
(
data
)}
`
);
console
.
log
(
`queryContact callback: err->
${
JSON
.
stringify
(
err
)}
`
);
}).
catch
((
err
)
=>
{
return
;
console
.
error
(
`queryContact fail: err->
${
JSON
.
stringify
(
err
)}
`
);
}
console
.
log
(
`queryContact callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
});
```
```
## contact.queryContact(deprecated)
## contact.queryContacts
queryContact(key: string, attrs: ContactAttributes, callback: AsyncCallback
<
Contact
>
): void
queryContacts(callback: AsyncCallback
<
Array
<
Contact
>>
): void
查询所有
联系人,使用callback方式作为异步方法。
根据key查询
联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**需要权限**
:ohos.permission.READ_CONTACTS
...
@@ -725,61 +1448,84 @@ queryContacts(callback: AsyncCallback<Array<Contact>>): void
...
@@ -725,61 +1448,84 @@ queryContacts(callback: AsyncCallback<Array<Contact>>): void
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------------------------- | ---- | -------------------------------------- |
| -------- | ---------------------------------------- | ---- | -------------------------------------- |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
| key | string | 是 | 联系人的key值,一个联系人对应一个key。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| callback | AsyncCallback
<
[Contact](#contact)
>
| 是 | 回调函数,返回查询的联系人对象。 |
**示例:**
**示例:**
```
js
```
js
contact
.
queryContacts
((
err
,
data
)
=>
{
contact
.
queryContact
(
'
xxx
'
,
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
},
(
err
,
data
)
=>
{
if
(
err
)
{
if
(
err
)
{
console
.
log
(
`queryContact
s
callback: err->
${
JSON
.
stringify
(
err
)}
`
);
console
.
log
(
`queryContact callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
return
;
}
}
console
.
log
(
`queryContact
s
callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
console
.
log
(
`queryContact callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
});
```
```
## contact.queryContact
## contact.queryContacts
queryContact(context: Context, key: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback
<
Contact
>
): void
queryContacts(holder: Holder, callback: AsyncCallback
<
Array
<
Contact
>>
): void
查询所有
联系人,使用callback方式作为异步方法。
根据key查询
联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------------------------- | ---- | -------------------------------------- |
| -------- | ---------------------------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| key | string | 是 | 联系人的key值,一个联系人对应一个key。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| callback | AsyncCallback
<
[Contact](#contact)
>
| 是 | 回调函数,返回查询的联系人对象。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
**示例:**
```
js
```
js
contact
.
queryContacts
({
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
contact
.
queryContact
(
globalThis
.
context
as
Context
,
'
xxx
'
,
{
holderId
:
0
,
holderId
:
0
,
bundleName
:
""
,
bundleName
:
""
,
displayName
:
""
displayName
:
""
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
},
(
err
,
data
)
=>
{
},
(
err
,
data
)
=>
{
if
(
err
)
{
if
(
err
)
{
console
.
log
(
`queryContact
s
callback: err->
${
JSON
.
stringify
(
err
)}
`
);
console
.
log
(
`queryContact callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
return
;
}
}
console
.
log
(
`queryContact
s
callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
console
.
log
(
`queryContact callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
});
```
```
## contact.queryContact
s
## contact.queryContact
(deprecated)
queryContact
s(attrs: ContactAttributes, callback: AsyncCallback
<
Array
<
Contact
>
>
): void
queryContact
(key: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback
<
Contact
>
): void
查询所有
联系人,使用callback方式作为异步方法。
根据key查询
联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**需要权限**
:ohos.permission.READ_CONTACTS
...
@@ -788,67 +1534,93 @@ queryContacts(attrs: ContactAttributes, callback: AsyncCallback<Array<Cont
...
@@ -788,67 +1534,93 @@ queryContacts(attrs: ContactAttributes, callback: AsyncCallback<Array<Cont
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------------------------- | ---- | -------------------------------------- |
| -------- | ---------------------------------------- | ---- | -------------------------------------- |
| key | string | 是 | 联系人的key值,一个联系人对应一个key。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。
|
| callback | AsyncCallback
<
[Contact](#contact)
>
| 是 | 回调函数,返回查询的联系人对象。
|
**示例:**
**示例:**
```
js
```
js
contact
.
queryContacts
({
contact
.
queryContact
(
'
xxx
'
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
},
(
err
,
data
)
=>
{
},
(
err
,
data
)
=>
{
if
(
err
)
{
if
(
err
)
{
console
.
log
(
`queryContact
s
callback: err->
${
JSON
.
stringify
(
err
)}
`
);
console
.
log
(
`queryContact callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
return
;
}
}
console
.
log
(
`queryContact
s
callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
console
.
log
(
`queryContact callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
});
```
```
## contact.queryContact
s
## contact.queryContact
queryContact
s(holder: Holder, attrs: ContactAttributes, callback: AsyncCallback
<
Array
<
Contact
>>
): void
queryContact
(context: Context, key: string, holder?: Holder, attrs?: ContactAttributes): Promise
<
Contact
>
查询所有联系人,使用callback
方式作为异步方法。
根据key查询联系人,使用Promise
方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------------------------- | ---- | -------------------------------------- |
| ------- | --------------------------------------- | ---- | ------------------------------------------------------------ |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| key | string | 是 | 联系人的key值,一个联系人对应一个key。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
| holder |
[
Holder
](
#holder
)
| 否 | 创建联系人的应用信息。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 否 | 联系人的属性列表。 |
**返回值:**
| 类型 | 说明 |
| ---------------------------------- | ----------------------------------------------- |
| Promise
<
[Contact](#contact)
>
| 以Promise形式返回结果,返回查询到的联系人对象。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
**示例:**
```
js
```
js
contact
.
queryContacts
({
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
let
promise
=
contact
.
queryContact
(
globalThis
.
context
as
Context
,
'
xxx
'
,
{
holderId
:
0
,
holderId
:
0
,
bundleName
:
""
,
bundleName
:
""
,
displayName
:
""
displayName
:
""
},
{
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
},
(
err
,
data
)
=>
{
});
if
(
err
)
{
promise
.
then
((
data
)
=>
{
console
.
log
(
`queryContacts callback: err->
${
JSON
.
stringify
(
err
)}
`
);
console
.
log
(
`queryContact success: data->
${
JSON
.
stringify
(
data
)}
`
);
return
;
}).
catch
((
err
)
=>
{
}
console
.
error
(
`queryContact fail: err->
${
JSON
.
stringify
(
err
)}
`
);
console
.
log
(
`queryContacts callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
});
```
```
## contact.queryContact(deprecated)
## contact.queryContacts
queryContact(key: string, holder?: Holder, attrs?: ContactAttributes): Promise
<
Contact
>
queryContacts(holder?: Holder, attrs?: ContactAttributes): Promise
<
Array
<
Contact
>>
查询所有
联系人,使用Promise方式作为异步方法。
根据key查询
联系人,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**需要权限**
:ohos.permission.READ_CONTACTS
...
@@ -857,19 +1629,20 @@ queryContacts(holder?: Holder, attrs?: ContactAttributes): Promise<Array<C
...
@@ -857,19 +1629,20 @@ queryContacts(holder?: Holder, attrs?: ContactAttributes): Promise<Array<C
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | --------------------------------------- | ---- | ---------------------- |
| ------ | --------------------------------------- | ---- | -------------------------------------- |
| key | string | 是 | 联系人的key值,一个联系人对应一个key。 |
| holder |
[
Holder
](
#holder
)
| 否 | 创建联系人的应用信息。 |
| holder |
[
Holder
](
#holder
)
| 否 | 创建联系人的应用信息。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 否 | 联系人的属性列表。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 否 | 联系人的属性列表。 |
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| ----------------------------------
------------- | ----
----------------------------------------------- |
| ----------------------------------
|
----------------------------------------------- |
| Promise
<
Array
<
[Contact](#contact)
>>
| 以Promise形式返回结果,返回查询到的联系人对象数组
。 |
| Promise
<
[Contact](#contact)
>
| 以Promise形式返回结果,返回查询到的联系人对象
。 |
**示例:**
**示例:**
```
js
```
js
let
promise
=
contact
.
queryContact
s
(
{
let
promise
=
contact
.
queryContact
(
'
xxx
'
,
{
holderId
:
0
,
holderId
:
0
,
bundleName
:
""
,
bundleName
:
""
,
displayName
:
""
displayName
:
""
...
@@ -877,48 +1650,62 @@ queryContacts(holder?: Holder, attrs?: ContactAttributes): Promise<Array<C
...
@@ -877,48 +1650,62 @@ queryContacts(holder?: Holder, attrs?: ContactAttributes): Promise<Array<C
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
});
});
promise
.
then
((
data
)
=>
{
promise
.
then
((
data
)
=>
{
console
.
log
(
`queryContact
s
success: data->
${
JSON
.
stringify
(
data
)}
`
);
console
.
log
(
`queryContact success: data->
${
JSON
.
stringify
(
data
)}
`
);
}).
catch
((
err
)
=>
{
}).
catch
((
err
)
=>
{
console
.
error
(
`queryContact
s
fail: err->
${
JSON
.
stringify
(
err
)}
`
);
console
.
error
(
`queryContact fail: err->
${
JSON
.
stringify
(
err
)}
`
);
});
});
```
```
## contact.queryContacts
## contact.queryContactsByPhoneNumber
queryContacts(context: Context, callback: AsyncCallback
<
Array
<
Contact
>>
): void
queryContactsByPhoneNumber(phoneNumber: string, callback: AsyncCallback
<
Array
<
Contact
>>
): void
根据电话号码查询
联系人,使用callback方式作为异步方法。
查询所有
联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| --------
--- | ----------------------------------------------------- | ---- |
-------------------------------------- |
| --------
| ----------------------------------------------------- | ---- | ----------------------
-------------------------------------- |
|
phoneNumber | string | 是 | 联系人的电话号码。
|
|
context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。
|
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
**示例:**
```
js
```
js
contact
.
queryContactsByPhoneNumber
(
'
138xxxxxxxx
'
,
(
err
,
data
)
=>
{
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
contact
.
queryContacts
(
globalThis
.
context
as
Context
,
(
err
,
data
)
=>
{
if
(
err
)
{
if
(
err
)
{
console
.
log
(
`queryContacts
ByPhoneNumber
callback: err->
${
JSON
.
stringify
(
err
)}
`
);
console
.
log
(
`queryContacts callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
return
;
}
}
console
.
log
(
`queryContacts
ByPhoneNumber
callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
console
.
log
(
`queryContacts callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
});
```
```
## contact.queryContacts(deprecated)
## contact.queryContactsByPhoneNumber
queryContacts(callback: AsyncCallback
<
Array
<
Contact
>>
): void
queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, callback: AsyncCallback
<
Array
<
Contact
>>
): void
根据电话号码查询
联系人,使用callback方式作为异步方法。
查询所有
联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**需要权限**
:ohos.permission.READ_CONTACTS
...
@@ -927,66 +1714,76 @@ queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, callback: AsyncC
...
@@ -927,66 +1714,76 @@ queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, callback: AsyncC
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ----------------------------------------------------- | ---- | -------------------------------------- |
| -------- | ----------------------------------------------------- | ---- | -------------------------------------- |
| phoneNumber | string | 是 | 联系人的电话号码。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
**示例:**
**示例:**
```
js
```
js
contact
.
queryContactsByPhoneNumber
(
'
138xxxxxxxx
'
,
{
contact
.
queryContacts
((
err
,
data
)
=>
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
(
err
,
data
)
=>
{
if
(
err
)
{
if
(
err
)
{
console
.
log
(
`queryContacts
ByPhoneNumber
callback: err->
${
JSON
.
stringify
(
err
)}
`
);
console
.
log
(
`queryContacts callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
return
;
}
}
console
.
log
(
`queryContacts
ByPhoneNumber
callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
console
.
log
(
`queryContacts callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
});
```
```
## contact.queryContacts
## contact.queryContactsByPhoneNumber
queryContacts(context: Context, holder: Holder, callback: AsyncCallback
<
Array
<
Contact
>>
): void
queryContactsByPhoneNumber(phoneNumber: string, attrs: ContactAttributes, callback: AsyncCallback
<
Array
<
Contact
>>
): void
根据电话号码查询
联系人,使用callback方式作为异步方法。
查询所有
联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| --------
--- | ----------------------------------------------------- | ---- |
-------------------------------------- |
| --------
| ----------------------------------------------------- | ---- | ----------------------
-------------------------------------- |
|
phoneNumber | string | 是 | 联系人的电话号码。
|
|
context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。
|
|
attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。
|
|
holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。
|
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
**示例:**
```
js
```
js
contact
.
queryContactsByPhoneNumber
(
'
138xxxxxxxx
'
,
{
// 获取context
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
contact
.
queryContacts
(
globalThis
.
context
as
Context
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
(
err
,
data
)
=>
{
},
(
err
,
data
)
=>
{
if
(
err
)
{
if
(
err
)
{
console
.
log
(
`queryContacts
ByPhoneNumber
callback: err->
${
JSON
.
stringify
(
err
)}
`
);
console
.
log
(
`queryContacts callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
return
;
}
}
console
.
log
(
`queryContacts
ByPhoneNumber
callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
console
.
log
(
`queryContacts callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
});
```
```
## contact.queryContacts(deprecated)
## contact.queryContactsByPhoneNumber
queryContacts(holder: Holder, callback: AsyncCallback
<
Array
<
Contact
>>
): void
queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback
<
Array
<
Contact
>>
): void
根据电话号码查询
联系人,使用callback方式作为异步方法。
查询所有
联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**需要权限**
:ohos.permission.READ_CONTACTS
...
@@ -995,78 +1792,79 @@ queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, attrs: ContactAt
...
@@ -995,78 +1792,79 @@ queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, attrs: ContactAt
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ----------------------------------------------------- | ---- | -------------------------------------- |
| -------- | ----------------------------------------------------- | ---- | -------------------------------------- |
| phoneNumber | string | 是 | 联系人的电话号码。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
**示例:**
**示例:**
```
js
```
js
contact
.
queryContacts
ByPhoneNumber
(
'
138xxxxxxxx
'
,
{
contact
.
queryContacts
(
{
holderId
:
0
,
holderId
:
0
,
bundleName
:
""
,
bundleName
:
""
,
displayName
:
""
displayName
:
""
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
},
(
err
,
data
)
=>
{
},
(
err
,
data
)
=>
{
if
(
err
)
{
if
(
err
)
{
console
.
log
(
`queryContacts
ByPhoneNumber
callback: err->
${
JSON
.
stringify
(
err
)}
`
);
console
.
log
(
`queryContacts callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
return
;
}
}
console
.
log
(
`queryContacts
ByPhoneNumber
callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
console
.
log
(
`queryContacts callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
});
```
```
## contact.queryContacts
## contact.queryContactsByPhoneNumber
queryContacts(context: Context, attrs: ContactAttributes, callback: AsyncCallback
<
Array
<
Contact
>>
): void
queryContactsByPhoneNumber(phoneNumber: string, holder?: Holder, attrs?: ContactAttributes): Promise
<
Array
<
Contact
>>
根据电话号码查询联系人,使用Promise
方式作为异步方法。
查询所有联系人,使用callback
方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| --------
--- | --------------------------------------- | ---- |
---------------------- |
| --------
| ----------------------------------------------------- | ---- | --------------------------------------
---------------------- |
|
phoneNumber | string | 是 | 联系人的电话号码。
|
|
context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。
|
|
holder |
[
Holder
](
#holder
)
| 否 | 创建联系人的应用信息。
|
|
attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。
|
|
attrs |
[
ContactAttributes
](
#contactattributes
)
| 否 | 联系人的属性列表。
|
|
callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。
|
**
返回值
:**
**
错误码
:**
| 类型 | 说明 |
| 错误码ID | 错误信息 |
| ----------------------------------------------- | --------------------------------------------------- |
| -------- | ------------------ |
| Promise
<
Array
<
[Contact](#contact)
>>
| 以Promise形式返回结果,返回查询到的联系人对象数组。 |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
**示例:**
```
js
```
js
let
promise
=
contact
.
queryContactsByPhoneNumber
(
'
138xxxxxxxx
'
,
{
// 获取context
holderId
:
0
,
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
bundleName
:
""
,
class
EntryAbility
extends
UIAbility
{
displayName
:
""
onWindowStageCreate
(
windowStage
){
},
{
globalThis
.
context
=
this
.
context
;
}
}
contact
.
queryContacts
(
globalThis
.
context
as
Context
,
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
});
},
(
err
,
data
)
=>
{
promise
.
then
((
data
)
=>
{
if
(
err
)
{
console
.
log
(
`queryContactsByPhoneNumber success: data->
${
JSON
.
stringify
(
data
)}
`
);
console
.
log
(
`queryContacts callback: err->
${
JSON
.
stringify
(
err
)}
`
);
}).
catch
((
err
)
=>
{
return
;
console
.
error
(
`queryContactsByPhoneNumber fail: err->
${
JSON
.
stringify
(
err
)}
`
);
}
console
.
log
(
`queryContacts callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
});
```
```
## contact.queryContacts(deprecated)
## contact.queryContactsByEmail
queryContacts(attrs: ContactAttributes, callback: AsyncCallback
<
Array
<
Contact
>>
): void
queryContactsByEmail(email: string, callback: AsyncCallback
<
Array
<
Contact
>>
): void
根据email查询
联系人,使用callback方式作为异步方法。
查询所有
联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**需要权限**
:ohos.permission.READ_CONTACTS
...
@@ -1076,62 +1874,81 @@ queryContactsByEmail(email: string, callback: AsyncCallback<Array<Contact&
...
@@ -1076,62 +1874,81 @@ queryContactsByEmail(email: string, callback: AsyncCallback<Array<Contact&
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------------------------- | ---- | -------------------------------------- |
| -------- | ----------------------------------------------------- | ---- | -------------------------------------- |
|
email | string | 是 | 联系人的邮箱地址
。 |
|
attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表
。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
**示例:**
**示例:**
```
js
```
js
contact
.
queryContactsByEmail
(
'
xxx@email.com
'
,
(
err
,
data
)
=>
{
contact
.
queryContacts
({
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
},
(
err
,
data
)
=>
{
if
(
err
)
{
if
(
err
)
{
console
.
log
(
`queryContacts
ByEmail
callback: err->
${
JSON
.
stringify
(
err
)}
`
);
console
.
log
(
`queryContacts callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
return
;
}
}
console
.
log
(
`queryContacts
ByEmail
callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
console
.
log
(
`queryContacts callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
});
```
```
## contact.queryContacts
## contact.queryContactsByEmail
queryContacts(context: Context, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback
<
Array
<
Contact
>>
): void
queryContactsByEmail(email: string, holder: Holder, callback: AsyncCallback
<
Array
<
Contact
>>
): void
根据email查询
联系人,使用callback方式作为异步方法。
查询所有
联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------------------------- | ---- | -------------------------------------- |
| -------- | ----------------------------------------------------- | ---- | --------------------------------------
----------------------
|
|
email | string | 是 | 联系人的邮箱地址。
|
|
context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。
|
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
**示例:**
```
js
```
js
contact
.
queryContactsByEmail
(
'
xxx@email.com
'
,
{
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
contact
.
queryContacts
(
globalThis
.
context
as
Context
,
{
holderId
:
0
,
holderId
:
0
,
bundleName
:
""
,
bundleName
:
""
,
displayName
:
""
displayName
:
""
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
},
(
err
,
data
)
=>
{
},
(
err
,
data
)
=>
{
if
(
err
)
{
if
(
err
)
{
console
.
log
(
`queryContacts
ByEmail
callback: err->
${
JSON
.
stringify
(
err
)}
`
);
console
.
log
(
`queryContacts callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
return
;
}
}
console
.
log
(
`queryContacts
ByEmail
callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
console
.
log
(
`queryContacts callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
});
```
```
## contact.queryContacts(deprecated)
## contact.queryContactsByEmail
queryContacts(holder: Holder, attrs: ContactAttributes, callback: AsyncCallback
<
Array
<
Contact
>>
): void
queryContactsByEmail(email: string, attrs: ContactAttributes, callback: AsyncCallback
<
Array
<
Contact
>>
): void
根据email查询
联系人,使用callback方式作为异步方法。
查询所有
联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**需要权限**
:ohos.permission.READ_CONTACTS
...
@@ -1140,69 +1957,90 @@ queryContactsByEmail(email: string, attrs: ContactAttributes, callback: AsyncCal
...
@@ -1140,69 +1957,90 @@ queryContactsByEmail(email: string, attrs: ContactAttributes, callback: AsyncCal
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------------------------- | ---- | ------------------------------------ |
| -------- | ----------------------------------------------------- | ---- | ------------------------------------
--
|
|
email | string | 是 | 联系人的邮箱地址。
|
|
holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。
|
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到联系人对象数组。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到
的
联系人对象数组。 |
**示例:**
**示例:**
```
js
```
js
contact
.
queryContactsByEmail
(
'
xxx@email.com
'
,
{
contact
.
queryContacts
({
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
},
(
err
,
data
)
=>
{
},
(
err
,
data
)
=>
{
if
(
err
)
{
if
(
err
)
{
console
.
log
(
`queryContacts
ByEmail
callback: err->
${
JSON
.
stringify
(
err
)}
`
);
console
.
log
(
`queryContacts callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
return
;
}
}
console
.
log
(
`queryContacts
ByEmail
callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
console
.
log
(
`queryContacts callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
});
```
```
## contact.queryContacts
## contact.queryContactsByEmail
queryContacts(context: Context, holder?: Holder, attrs?: ContactAttributes): Promise
<
Array
<
Contact
>>
queryContactsByEmail(email: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback
<
Array
<
Contact
>>
): void
根据email查询联系人,使用callback
方式作为异步方法。
查询所有联系人,使用Promise
方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------------------------- | ---- | ------------------------------------ |
| ------- | --------------------------------------- | ---- | ------------------------------------------------------------ |
| email | string | 是 | 联系人的邮箱地址。 |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| holder |
[
Holder
](
#holder
)
| 否 | 创建联系人的应用信息。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 否 | 联系人的属性列表。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到联系人对象数组。 |
**返回值:**
| 类型 | 说明 |
| ----------------------------------------------- | --------------------------------------------------- |
| Promise
<
Array
<
[Contact](#contact)
>>
| 以Promise形式返回结果,返回查询到的联系人对象数组。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
**示例:**
```
js
```
js
contact
.
queryContactsByEmail
(
'
xxx@email.com
'
,
{
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
let
promise
=
contact
.
queryContacts
(
globalThis
.
context
as
Context
,
{
holderId
:
0
,
holderId
:
0
,
bundleName
:
""
,
bundleName
:
""
,
displayName
:
""
displayName
:
""
},
{
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
},
(
err
,
data
)
=>
{
});
if
(
err
)
{
promise
.
then
((
data
)
=>
{
console
.
log
(
`queryContactsByEmail callback: err->
${
JSON
.
stringify
(
err
)}
`
);
console
.
log
(
`queryContacts success: data->
${
JSON
.
stringify
(
data
)}
`
);
return
;
}).
catch
((
err
)
=>
{
}
console
.
error
(
`queryContacts fail: err->
${
JSON
.
stringify
(
err
)}
`
);
console
.
log
(
`queryContactsByEmail callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
});
```
```
## contact.queryContacts(deprecated)
## contact.queryContactsByEmail
queryContacts(holder?: Holder, attrs?: ContactAttributes): Promise
<
Array
<
Contact
>>
queryContactsByEmail(email: string, holder?: Holder, attrs?: ContactAttributes): Promise
<
Array
<
Contact
>>
根据email查询
联系人,使用Promise方式作为异步方法。
查询所有
联系人,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**需要权限**
:ohos.permission.READ_CONTACTS
...
@@ -1212,7 +2050,6 @@ queryContactsByEmail(email: string, holder?: Holder, attrs?: ContactAttributes):
...
@@ -1212,7 +2050,6 @@ queryContactsByEmail(email: string, holder?: Holder, attrs?: ContactAttributes):
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | --------------------------------------- | ---- | ---------------------- |
| ------ | --------------------------------------- | ---- | ---------------------- |
| email | string | 是 | 联系人的邮箱地址。 |
| holder |
[
Holder
](
#holder
)
| 否 | 创建联系人的应用信息。 |
| holder |
[
Holder
](
#holder
)
| 否 | 创建联系人的应用信息。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 否 | 联系人的属性列表。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 否 | 联系人的属性列表。 |
...
@@ -1224,8 +2061,8 @@ queryContactsByEmail(email: string, holder?: Holder, attrs?: ContactAttributes):
...
@@ -1224,8 +2061,8 @@ queryContactsByEmail(email: string, holder?: Holder, attrs?: ContactAttributes):
**示例:**
**示例:**
```
js
```
js
let
promise
=
contact
.
queryContacts
ByEmail
(
'
xxx@email.com
'
,
{
let
promise
=
contact
.
queryContacts
(
{
holderId
:
0
,
holderId
:
0
,
bundleName
:
""
,
bundleName
:
""
,
displayName
:
""
displayName
:
""
...
@@ -1233,47 +2070,63 @@ queryContactsByEmail(email: string, holder?: Holder, attrs?: ContactAttributes):
...
@@ -1233,47 +2070,63 @@ queryContactsByEmail(email: string, holder?: Holder, attrs?: ContactAttributes):
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
});
});
promise
.
then
((
data
)
=>
{
promise
.
then
((
data
)
=>
{
console
.
log
(
`queryContacts
ByEmail
success: data->
${
JSON
.
stringify
(
data
)}
`
);
console
.
log
(
`queryContacts success: data->
${
JSON
.
stringify
(
data
)}
`
);
}).
catch
((
err
)
=>
{
}).
catch
((
err
)
=>
{
console
.
error
(
`queryContacts
ByEmail
fail: err->
${
JSON
.
stringify
(
err
)}
`
);
console
.
error
(
`queryContacts fail: err->
${
JSON
.
stringify
(
err
)}
`
);
});
});
```
```
## contact.query
Groups
## contact.query
ContactsByPhoneNumber
query
Groups(callback: AsyncCallback
<
Array
<
Group
>>
): void
query
ContactsByPhoneNumber(context: Context, phoneNumber: string, callback: AsyncCallback
<
Array
<
Contact
>>
): void
查询联系人的所有群组
,使用callback方式作为异步方法。
根据电话号码查询联系人
,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------- | ---- | ------------------------------------ |
| ----------- | ----------------------------------------------------- | ---- | ------------------------------------------------------------ |
| callback | AsyncCallback
<
Array
<
[Group](#group)
>>
| 是 | 回调函数,返回查询到的群组对象数组。 |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| phoneNumber | string | 是 | 联系人的电话号码。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
**示例:**
```
js
```
js
contact
.
queryGroups
((
err
,
data
)
=>
{
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
contact
.
queryContactsByPhoneNumber
(
globalThis
.
context
as
Context
,
'
138xxxxxxxx
'
,
(
err
,
data
)
=>
{
if
(
err
)
{
if
(
err
)
{
console
.
log
(
`query
Groups
callback: err->
${
JSON
.
stringify
(
err
)}
`
);
console
.
log
(
`query
ContactsByPhoneNumber
callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
return
;
}
}
console
.
log
(
`query
Groups
callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
console
.
log
(
`query
ContactsByPhoneNumber
callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
});
```
```
## contact.queryContactsByPhoneNumber(deprecated)
## contact.queryGroups
queryContactsByPhoneNumber(phoneNumber: string, callback: AsyncCallback
<
Array
<
Contact
>>
): void
queryGroups(holder: Holder, callback: AsyncCallback
<
Array
<
Group
>>
): void
查询联系人的所有群组
,使用callback方式作为异步方法。
根据电话号码查询联系人
,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**需要权限**
:ohos.permission.READ_CONTACTS
...
@@ -1282,70 +2135,79 @@ queryGroups(holder: Holder, callback: AsyncCallback<Array<Group>>):
...
@@ -1282,70 +2135,79 @@ queryGroups(holder: Holder, callback: AsyncCallback<Array<Group>>):
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| --------
| ------------------------------------------------- | ---- |
------------------------------------ |
| --------
--- | ----------------------------------------------------- | ---- | --
------------------------------------ |
|
holder | Holder | 是 | 创建联系人的应用信息。
|
|
phoneNumber | string | 是 | 联系人的电话号码。
|
| callback
| AsyncCallback
<
Array
<
[Group](#group)
>>
| 是 | 回调函数,返回查询到的群组
对象数组。 |
| callback
| AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人
对象数组。 |
**示例:**
**示例:**
```
js
```
js
contact
.
queryGroups
({
contact
.
queryContactsByPhoneNumber
(
'
138xxxxxxxx
'
,
(
err
,
data
)
=>
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
(
err
,
data
)
=>
{
if
(
err
)
{
if
(
err
)
{
console
.
log
(
`query
Groups
callback: err->
${
JSON
.
stringify
(
err
)}
`
);
console
.
log
(
`query
ContactsByPhoneNumber
callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
return
;
}
}
console
.
log
(
`query
Groups
callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
console
.
log
(
`query
ContactsByPhoneNumber
callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
});
```
```
## contact.query
Groups
## contact.query
ContactsByPhoneNumber
query
Groups(holder?: Holder): Promise
<
Array
<
Group
>>
query
ContactsByPhoneNumber(context: Context, phoneNumber: string, holder: Holder, callback: AsyncCallback
<
Array
<
Contact
>>
): void
查询联系人的所有群组,使用Promise
方式作为异步方法。
根据电话号码查询联系人,使用callback
方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ----------------- | ---- | ---------------------- |
| ----------- | ----------------------------------------------------- | ---- | ------------------------------------------------------------ |
| holder |
[
Holder
](
#holder
)
| 否 | 创建联系人的应用信息。 |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| phoneNumber | string | 是 | 联系人的电话号码。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
**
返回值
:**
**
错误码
:**
| 类型 | 说明 |
| 错误码ID | 错误信息 |
| ------------------------------------------- | ------------------------------------------------- |
| -------- | ------------------ |
| Promise
<
Array
<
[Group](#group)
>>
| 以Promise形式返回结果,返回查询到的群组对象数组。 |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
**示例:**
```
js
```
js
let
promise
=
contact
.
queryGroups
({
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
contact
.
queryContactsByPhoneNumber
(
globalThis
.
context
as
Context
,
'
138xxxxxxxx
'
,
{
holderId
:
0
,
holderId
:
0
,
bundleName
:
""
,
bundleName
:
""
,
displayName
:
""
displayName
:
""
});
},
(
err
,
data
)
=>
{
promise
.
then
((
data
)
=>
{
if
(
err
)
{
console
.
log
(
`queryGroups success: data->
${
JSON
.
stringify
(
data
)}
`
);
console
.
log
(
`queryContactsByPhoneNumber callback: err->
${
JSON
.
stringify
(
err
)}
`
);
}).
catch
((
err
)
=>
{
return
;
console
.
error
(
`queryGroups fail: err->
${
JSON
.
stringify
(
err
)}
`
);
}
console
.
log
(
`queryContactsByPhoneNumber callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
});
```
```
## contact.queryContactsByPhoneNumber(deprecated)
## contact.queryHolders
queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, callback: AsyncCallback
<
Array
<
Contact
>>
): void
queryHolders(callback: AsyncCallback
<
Array
<
Holder
>>
): void
查询所有创建联系人的应用信息
,使用callback方式作为异步方法。
根据电话号码查询联系人
,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**需要权限**
:ohos.permission.READ_CONTACTS
...
@@ -1354,51 +2216,1172 @@ queryHolders(callback: AsyncCallback<Array<Holder>>): void
...
@@ -1354,51 +2216,1172 @@ queryHolders(callback: AsyncCallback<Array<Holder>>): void
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------------------------------- | ---- | ---------------------------------------------------- |
| ----------- | ----------------------------------------------------- | ---- | -------------------------------------- |
| callback | AsyncCallback
<
Array
<
[Holder](#holder)
>>
| 是 | 回调函数,返回查询到的创建联系人应用信息的对象数组。 |
| phoneNumber | string | 是 | 联系人的电话号码。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
**示例:**
**示例:**
```
js
```
js
contact
.
queryHolders
((
err
,
data
)
=>
{
contact
.
queryContactsByPhoneNumber
(
'
138xxxxxxxx
'
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
(
err
,
data
)
=>
{
if
(
err
)
{
if
(
err
)
{
console
.
log
(
`query
Holders
callback: err->
${
JSON
.
stringify
(
err
)}
`
);
console
.
log
(
`query
ContactsByPhoneNumber
callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
return
;
}
}
console
.
log
(
`query
Holders
callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
console
.
log
(
`query
ContactsByPhoneNumber
callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
});
```
```
## contact.queryContactsByPhoneNumber
## contact.queryHolders
queryContactsByPhoneNumber(context: Context, phoneNumber: string, attrs: ContactAttributes, callback: AsyncCallback
<
Array
<
Contact
>>
): void
queryHolders(): Promise
<
Array
<
Holder
>>
查询所有创建联系人的应用信息,使用Promise
方式作为异步方法。
根据电话号码查询联系人,使用callback
方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**系统能力**
:SystemCapability.Applications.ContactsData
**
返回值:**
**
模型约束**
:此接口仅可在Stage模型下使用。
| 类型 | 说明 |
**参数:**
| --------------------------------------------- | ------------------------------------------------------------ |
| Promise
<
Array
<
[Holder](#holder)
>>
| 以Promise形式返回结果,返回查询到的创建联系人应用信息的对象数组。 |
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ----------------------------------------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| phoneNumber | string | 是 | 联系人的电话号码。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
**示例:**
```
js
```
js
let
promise
=
contact
.
queryHolders
();
// 获取context
promise
.
then
((
data
)
=>
{
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
console
.
log
(
`queryHolders success: data->
${
JSON
.
stringify
(
data
)}
`
);
class
EntryAbility
extends
UIAbility
{
}).
catch
((
err
)
=>
{
onWindowStageCreate
(
windowStage
){
console
.
error
(
`queryHolders fail: err->
${
JSON
.
stringify
(
err
)}
`
);
globalThis
.
context
=
this
.
context
;
}
}
contact
.
queryContactsByPhoneNumber
(
globalThis
.
context
as
Context
,
'
138xxxxxxxx
'
,
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
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(deprecated)
## contact.queryKey
queryContactsByPhoneNumber(phoneNumber: string, attrs: ContactAttributes, callback: AsyncCallback
<
Array
<
Contact
>>
): void
根据电话号码查询联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ----------------------------------------------------- | ---- | -------------------------------------- |
| phoneNumber | string | 是 | 联系人的电话号码。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
**示例:**
```
js
contact
.
queryContactsByPhoneNumber
(
'
138xxxxxxxx
'
,
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
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(context: Context, phoneNumber: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback
<
Array
<
Contact
>>
): void
根据电话号码查询联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ----------------------------------------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| phoneNumber | string | 是 | 联系人的电话号码。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
contact
.
queryContactsByPhoneNumber
(
globalThis
.
context
as
Context
,
'
138xxxxxxxx
'
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
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(deprecated)
queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback
<
Array
<
Contact
>>
): void
根据电话号码查询联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ----------------------------------------------------- | ---- | -------------------------------------- |
| phoneNumber | string | 是 | 联系人的电话号码。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
**示例:**
```
js
contact
.
queryContactsByPhoneNumber
(
'
138xxxxxxxx
'
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
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(context: Context, phoneNumber: string, holder?: Holder, attrs?: ContactAttributes): Promise
<
Array
<
Contact
>>
根据电话号码查询联系人,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | --------------------------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| phoneNumber | string | 是 | 联系人的电话号码。 |
| holder |
[
Holder
](
#holder
)
| 否 | 创建联系人的应用信息。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 否 | 联系人的属性列表。 |
**返回值:**
| 类型 | 说明 |
| ----------------------------------------------- | --------------------------------------------------- |
| Promise
<
Array
<
[Contact](#contact)
>>
| 以Promise形式返回结果,返回查询到的联系人对象数组。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
let
promise
=
contact
.
queryContactsByPhoneNumber
(
globalThis
.
context
as
Context
,
'
138xxxxxxxx
'
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
});
promise
.
then
((
data
)
=>
{
console
.
log
(
`queryContactsByPhoneNumber success: data->
${
JSON
.
stringify
(
data
)}
`
);
}).
catch
((
err
)
=>
{
console
.
error
(
`queryContactsByPhoneNumber fail: err->
${
JSON
.
stringify
(
err
)}
`
);
});
```
## contact.queryContactsByPhoneNumber(deprecated)
queryContactsByPhoneNumber(phoneNumber: string, holder?: Holder, attrs?: ContactAttributes): Promise
<
Array
<
Contact
>>
根据电话号码查询联系人,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | --------------------------------------- | ---- | ---------------------- |
| phoneNumber | string | 是 | 联系人的电话号码。 |
| holder |
[
Holder
](
#holder
)
| 否 | 创建联系人的应用信息。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 否 | 联系人的属性列表。 |
**返回值:**
| 类型 | 说明 |
| ----------------------------------------------- | --------------------------------------------------- |
| Promise
<
Array
<
[Contact](#contact)
>>
| 以Promise形式返回结果,返回查询到的联系人对象数组。 |
**示例:**
```
js
let
promise
=
contact
.
queryContactsByPhoneNumber
(
'
138xxxxxxxx
'
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
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(context: Context, email: string, callback: AsyncCallback
<
Array
<
Contact
>>
): void
根据email查询联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| email | string | 是 | 联系人的邮箱地址。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
contact
.
queryContactsByEmail
(
globalThis
.
context
as
Context
,
'
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(deprecated)
queryContactsByEmail(email: string, callback: AsyncCallback
<
Array
<
Contact
>>
): void
根据email查询联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------------------------- | ---- | -------------------------------------- |
| email | string | 是 | 联系人的邮箱地址。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
**示例:**
```
js
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(context: Context, email: string, holder: Holder, callback: AsyncCallback
<
Array
<
Contact
>>
): void
根据email查询联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| email | string | 是 | 联系人的邮箱地址。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
contact
.
queryContactsByEmail
(
globalThis
.
context
as
Context
,
'
xxx@email.com
'
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
(
err
,
data
)
=>
{
if
(
err
)
{
console
.
log
(
`queryContactsByEmail callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
}
console
.
log
(
`queryContactsByEmail callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
```
## contact.queryContactsByEmail(deprecated)
queryContactsByEmail(email: string, holder: Holder, callback: AsyncCallback
<
Array
<
Contact
>>
): void
根据email查询联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------------------------- | ---- | -------------------------------------- |
| email | string | 是 | 联系人的邮箱地址。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
**示例:**
```
js
contact
.
queryContactsByEmail
(
'
xxx@email.com
'
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
(
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(context: Context, email: string, attrs: ContactAttributes, callback: AsyncCallback
<
Array
<
Contact
>>
): void
根据email查询联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| email | string | 是 | 联系人的邮箱地址。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到联系人对象数组。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
contact
.
queryContactsByEmail
(
globalThis
.
context
as
Context
,
'
xxx@email.com
'
,
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
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(deprecated)
queryContactsByEmail(email: string, attrs: ContactAttributes, callback: AsyncCallback
<
Array
<
Contact
>>
): void
根据email查询联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------------------------- | ---- | ------------------------------------ |
| email | string | 是 | 联系人的邮箱地址。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到联系人对象数组。 |
**示例:**
```
js
contact
.
queryContactsByEmail
(
'
xxx@email.com
'
,
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
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(context: Context, email: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback
<
Array
<
Contact
>>
): void
根据email查询联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| email | string | 是 | 联系人的邮箱地址。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到联系人对象数组。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
contact
.
queryContactsByEmail
(
globalThis
.
context
as
Context
,
'
xxx@email.com
'
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
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(deprecated)
queryContactsByEmail(email: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback
<
Array
<
Contact
>>
): void
根据email查询联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------------------------- | ---- | ------------------------------------ |
| email | string | 是 | 联系人的邮箱地址。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到联系人对象数组。 |
**示例:**
```
js
contact
.
queryContactsByEmail
(
'
xxx@email.com
'
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
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(context: Context, email: string, holder?: Holder, attrs?: ContactAttributes): Promise
<
Array
<
Contact
>>
根据email查询联系人,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | --------------------------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| email | string | 是 | 联系人的邮箱地址。 |
| holder |
[
Holder
](
#holder
)
| 否 | 创建联系人的应用信息。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 否 | 联系人的属性列表。 |
**返回值:**
| 类型 | 说明 |
| ----------------------------------------------- | --------------------------------------------------- |
| Promise
<
Array
<
[Contact](#contact)
>>
| 以Promise形式返回结果,返回查询到的联系人对象数组。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
let
promise
=
contact
.
queryContactsByEmail
(
globalThis
.
context
as
Context
,
'
xxx@email.com
'
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
});
promise
.
then
((
data
)
=>
{
console
.
log
(
`queryContactsByEmail success: data->
${
JSON
.
stringify
(
data
)}
`
);
}).
catch
((
err
)
=>
{
console
.
error
(
`queryContactsByEmail fail: err->
${
JSON
.
stringify
(
err
)}
`
);
});
```
## contact.queryContactsByEmail(deprecated)
queryContactsByEmail(email: string, holder?: Holder, attrs?: ContactAttributes): Promise
<
Array
<
Contact
>>
根据email查询联系人,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | --------------------------------------- | ---- | ---------------------- |
| email | string | 是 | 联系人的邮箱地址。 |
| holder |
[
Holder
](
#holder
)
| 否 | 创建联系人的应用信息。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 否 | 联系人的属性列表。 |
**返回值:**
| 类型 | 说明 |
| ----------------------------------------------- | --------------------------------------------------- |
| Promise
<
Array
<
[Contact](#contact)
>>
| 以Promise形式返回结果,返回查询到的联系人对象数组。 |
**示例:**
```
js
let
promise
=
contact
.
queryContactsByEmail
(
'
xxx@email.com
'
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
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(context: Context, callback: AsyncCallback
<
Array
<
Group
>>
): void
查询联系人的所有群组,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| callback | AsyncCallback
<
Array
<
[Group](#group)
>>
| 是 | 回调函数,返回查询到的群组对象数组。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
contact
.
queryGroups
(
globalThis
.
context
as
Context
,
(
err
,
data
)
=>
{
if
(
err
)
{
console
.
log
(
`queryGroups callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
}
console
.
log
(
`queryGroups callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
```
## contact.queryGroups(deprecated)
queryGroups(callback: AsyncCallback
<
Array
<
Group
>>
): void
查询联系人的所有群组,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------- | ---- | ------------------------------------ |
| callback | AsyncCallback
<
Array
<
[Group](#group)
>>
| 是 | 回调函数,返回查询到的群组对象数组。 |
**示例:**
```
js
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(context: Context, holder: Holder, callback: AsyncCallback
<
Array
<
Group
>>
): void
查询联系人的所有群组,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| holder | Holder | 是 | 创建联系人的应用信息。 |
| callback | AsyncCallback
<
Array
<
[Group](#group)
>>
| 是 | 回调函数,返回查询到的群组对象数组。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
contact
.
queryGroups
(
globalThis
.
context
as
Context
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
(
err
,
data
)
=>
{
if
(
err
)
{
console
.
log
(
`queryGroups callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
}
console
.
log
(
`queryGroups callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
```
## contact.queryGroups(deprecated)
queryGroups(holder: Holder, callback: AsyncCallback
<
Array
<
Group
>>
): void
查询联系人的所有群组,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------- | ---- | ------------------------------------ |
| holder | Holder | 是 | 创建联系人的应用信息。 |
| callback | AsyncCallback
<
Array
<
[Group](#group)
>>
| 是 | 回调函数,返回查询到的群组对象数组。 |
**示例:**
```
js
contact
.
queryGroups
({
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
(
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(context: Context, holder?: Holder): Promise
<
Array
<
Group
>>
查询联系人的所有群组,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ----------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| holder |
[
Holder
](
#holder
)
| 否 | 创建联系人的应用信息。 |
**返回值:**
| 类型 | 说明 |
| ------------------------------------------- | ------------------------------------------------- |
| Promise
<
Array
<
[Group](#group)
>>
| 以Promise形式返回结果,返回查询到的群组对象数组。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
let
promise
=
contact
.
queryGroups
(
globalThis
.
context
as
Context
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
});
promise
.
then
((
data
)
=>
{
console
.
log
(
`queryGroups success: data->
${
JSON
.
stringify
(
data
)}
`
);
}).
catch
((
err
)
=>
{
console
.
error
(
`queryGroups fail: err->
${
JSON
.
stringify
(
err
)}
`
);
});
```
## contact.queryGroups(deprecated)
queryGroups(holder?: Holder): Promise
<
Array
<
Group
>>
查询联系人的所有群组,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ----------------- | ---- | ---------------------- |
| holder |
[
Holder
](
#holder
)
| 否 | 创建联系人的应用信息。 |
**返回值:**
| 类型 | 说明 |
| ------------------------------------------- | ------------------------------------------------- |
| Promise
<
Array
<
[Group](#group)
>>
| 以Promise形式返回结果,返回查询到的群组对象数组。 |
**示例:**
```
js
let
promise
=
contact
.
queryGroups
({
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
});
promise
.
then
((
data
)
=>
{
console
.
log
(
`queryGroups success: data->
${
JSON
.
stringify
(
data
)}
`
);
}).
catch
((
err
)
=>
{
console
.
error
(
`queryGroups fail: err->
${
JSON
.
stringify
(
err
)}
`
);
});
```
## contact.queryHolders
queryHolders(context: Context, callback: AsyncCallback
<
Array
<
Holder
>>
): void
查询所有创建联系人的应用信息,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------------------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| callback | AsyncCallback
<
Array
<
[Holder](#holder)
>>
| 是 | 回调函数,返回查询到的创建联系人应用信息的对象数组。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
contact
.
queryHolders
(
globalThis
.
context
as
Context
,
(
err
,
data
)
=>
{
if
(
err
)
{
console
.
log
(
`queryHolders callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
}
console
.
log
(
`queryHolders callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
```
## contact.queryHolders(deprecated)
queryHolders(callback: AsyncCallback
<
Array
<
Holder
>>
): void
查询所有创建联系人的应用信息,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------------------------------- | ---- | ---------------------------------------------------- |
| callback | AsyncCallback
<
Array
<
[Holder](#holder)
>>
| 是 | 回调函数,返回查询到的创建联系人应用信息的对象数组。 |
**示例:**
```
js
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(context: Context ): Promise
<
Array
<
Holder
>>
查询所有创建联系人的应用信息,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
**返回值:**
| 类型 | 说明 |
| --------------------------------------------- | ------------------------------------------------------------ |
| Promise
<
Array
<
[Holder](#holder)
>>
| 以Promise形式返回结果,返回查询到的创建联系人应用信息的对象数组。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
let
promise
=
contact
.
queryHolders
(
globalThis
.
context
as
Context
);
promise
.
then
((
data
)
=>
{
console
.
log
(
`queryHolders success: data->
${
JSON
.
stringify
(
data
)}
`
);
}).
catch
((
err
)
=>
{
console
.
error
(
`queryHolders fail: err->
${
JSON
.
stringify
(
err
)}
`
);
});
```
## contact.queryHolders(deprecated)
queryHolders(): Promise
<
Array
<
Holder
>>
查询所有创建联系人的应用信息,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**返回值:**
| 类型 | 说明 |
| --------------------------------------------- | ------------------------------------------------------------ |
| Promise
<
Array
<
[Holder](#holder)
>>
| 以Promise形式返回结果,返回查询到的创建联系人应用信息的对象数组。 |
**示例:**
```
js
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(context: Context, id: number, callback: AsyncCallback
<
string
>
): void
根据联系人的id查询联系人的key,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| id | number | 是 | 联系人对象的id属性。 |
| callback | AsyncCallback
<
string
>
| 是 | 回调函数,返回查询到的联系人对应的key。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
contact
.
queryKey
(
globalThis
.
context
as
Context
,
/*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(deprecated)
queryKey(id: number, callback: AsyncCallback
<
string
>
): void
queryKey(id: number, callback: AsyncCallback
<
string
>
): void
...
@@ -1427,9 +3410,59 @@ queryKey(id: number, callback: AsyncCallback<string>): void
...
@@ -1427,9 +3410,59 @@ queryKey(id: number, callback: AsyncCallback<string>): void
});
});
```
```
## contact.queryKey
## contact.queryKey
queryKey(context: Context, id: number, holder: Holder, callback: AsyncCallback
<
string
>
): void
根据联系人的id查询联系人的key,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| id | number | 是 | 联系人对象的id属性。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| callback | AsyncCallback
<
string
>
| 是 | 回调函数,返回查询到的联系人对应的key。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
contact
.
queryKey
(
globalThis
.
context
as
Context
,
/*id*/
1
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
(
err
,
data
)
=>
{
if
(
err
)
{
console
.
log
(
`queryKey callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
}
console
.
log
(
`queryKey callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
```
## contact.queryKey(deprecated)
queryKey(id: number, holder: Holder, callback: AsyncCallback
<
string
>
): void
queryKey(id: number, holder: Holder, callback: AsyncCallback
<
string
>
): void
根据联系人的id查询联系人的key,使用callback方式作为异步方法。
根据联系人的id查询联系人的key,使用callback方式作为异步方法。
...
@@ -1462,9 +3495,63 @@ queryKey(id: number, holder: Holder, callback: AsyncCallback<string>): voi
...
@@ -1462,9 +3495,63 @@ queryKey(id: number, holder: Holder, callback: AsyncCallback<string>): voi
});
});
```
```
## contact.queryKey
## contact.queryKey
queryKey(context: Context, id: number, holder?: Holder): Promise
<
string
>
根据联系人的id查询联系人的key,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ----------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 | 应用上下文Context,Stage模型的应用Context定义见
[
Context
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md
)
。 |
| id | number | 是 | 联系人对象的id属性。 |
| holder |
[
Holder
](
#holder
)
| 否 | 创建联系人的应用信息。 |
**返回值:**
| 类型 | 说明 |
| --------------------- | ---------------------------------------------------- |
| Promise
<
string
>
| 以Promise形式返回结果,返回查询到的联系人对应的key。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
// 获取context
import
UIAbility
from
'
@ohos.app.ability.UIAbility
'
;
class
EntryAbility
extends
UIAbility
{
onWindowStageCreate
(
windowStage
){
globalThis
.
context
=
this
.
context
;
}
}
let
promise
=
contact
.
queryKey
(
globalThis
.
context
as
Context
,
/*id*/
1
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
});
promise
.
then
((
data
)
=>
{
console
.
log
(
`queryKey success: data->
${
JSON
.
stringify
(
data
)}
`
);
}).
catch
((
err
)
=>
{
console
.
error
(
`queryKey fail: err->
${
JSON
.
stringify
(
err
)}
`
);
});
```
## contact.queryKey(deprecated)
queryKey(id: number, holder?: Holder): Promise
<
string
>
queryKey(id: number, holder?: Holder): Promise
<
string
>
根据联系人的id查询联系人的key,使用Promise方式作为异步方法。
根据联系人的id查询联系人的key,使用Promise方式作为异步方法。
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录