Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
e4ae26cf
D
Docs
项目概览
OpenHarmony
/
Docs
1 年多 前同步成功
通知
159
Star
292
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 @@
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
...
...
@@ -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
>
...
...
@@ -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
...
...
@@ -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
>
...
...
@@ -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
...
...
@@ -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
...
...
@@ -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
>
...
...
@@ -258,7 +616,53 @@ updateContact(contact: Contact, attrs?: ContactAttributes): Promise<void>
```
## contact.isLocalContact
## contact.isLocalContact<sup>10+<sup>
isLocalContact(context: Context, id: number, callback: AsyncCallback
<
boolean
>
): void
判断当前联系人id是否在电话簿中,使用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属性,一个联系人对应一个id。 |
| callback | AsyncCallback
<
boolean
>
| 是 | 回调函数,返回布尔值。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
;
}
}
contact
.
isLocalContact
(
globalThis
.
context
as
Context
,
/*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(deprecated)
isLocalContact(id: number, callback: AsyncCallback
<
boolean
>
): void
...
...
@@ -287,10 +691,9 @@ isLocalContact(id: number, callback: AsyncCallback<boolean>): void
});
```
## contact.isLocalContact<sup>10+<sup>
## contact.isLocalContact
isLocalContact(id: number): Promise
<
boolean
>
isLocalContact(context: Context, id: number): Promise
<
boolean
>
判断当前联系人id是否在电话簿中,使用Promise方式作为异步方法。
...
...
@@ -298,11 +701,14 @@ isLocalContact(id: number): Promise<boolean>
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------------------------------------------ |
| id | number | 是 | 联系人对象的id属性,一个联系人对应一个id。 |
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------- | ---- | ------------------------------------------------------------ |
| 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。 |
**返回值:**
...
...
@@ -310,21 +716,113 @@ isLocalContact(id: number): Promise<boolean>
| ---------------------- | ------------------------------------------------------------ |
| Promise
<
boolean
>
| 以Promise形式返回结果,返回布尔值。true代表联系人id在本地电话簿中,false则代表联系人id不在本地电话簿中。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
let
promise
=
contact
.
isLocalContact
(
/*id*/
1
);
```
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)
## contact.isMyCard
isLocalContact(id: number): Promise
<
boolean
>
isMyCard(id: number, callback: AsyncCallback
<
boolean
>
): void
判断当前联系人id是否在电话簿中,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------------------------------------------ |
| id | number | 是 | 联系人对象的id属性,一个联系人对应一个id。 |
**返回值:**
| 类型 | 说明 |
| ---------------------- | ------------------------------------------------------------ |
| Promise
<
boolean
>
| 以Promise形式返回结果,返回布尔值。true代表联系人id在本地电话簿中,false则代表联系人id不在本地电话簿中。 |
**示例:**
```
js
let
promise
=
contact
.
isLocalContact
(
/*id*/
1
);
promise
.
then
((
data
)
=>
{
console
.
log
(
`isLocalContact success: data->
${
JSON
.
stringify
(
data
)}
`
);
}).
catch
((
err
)
=>
{
console
.
error
(
`isLocalContact fail: err->
${
JSON
.
stringify
(
err
)}
`
);
});
```
## contact.isMyCard<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(deprecated)
isMyCard(id: number, callback: AsyncCallback
<
boolean
>
): void
判断是否为“我的名片”,使用callback方式作为异步方法。
...
...
@@ -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
>
...
...
@@ -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
...
...
@@ -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)
>
| 是 | 回调函数,返回“我的名片”信息。 |
## contact.queryMyCard
**错误码:**
| 错误码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(deprecated)
queryMyCard(attrs: ContactAttributes, callback: AsyncCallback
<
Contact
>
): void
...
...
@@ -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
>
...
...
@@ -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方式作为异步方法。
...
...
@@ -545,17 +1235,34 @@ queryContact(key: string, callback: AsyncCallback<Contact>): void
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | -------------------------------------- |
| key | string | 是 | 联系人的key值,一个联系人对应一个key。 |
| callback | AsyncCallback
<
[Contact](#contact)
>
| 是 | 回调函数,返回查询的联系人对象。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ------------------------------------------------------------ |
| 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
<
[Contact](#contact)
>
| 是 | 回调函数,返回查询的联系人对象。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
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
)
{
console
.
log
(
`queryContact callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
...
...
@@ -564,10 +1271,9 @@ queryContact(key: string, callback: AsyncCallback<Contact>): void
});
```
## contact.queryContact(deprecated)
## contact.queryContact
queryContact(key: string, holder: Holder, callback: AsyncCallback
<
Contact
>
): void
queryContact(key: string, callback: AsyncCallback
<
Contact
>
): void
根据key查询联系人,使用callback方式作为异步方法。
...
...
@@ -580,17 +1286,12 @@ queryContact(key: string, holder: Holder, callback: AsyncCallback<Contact>
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | -------------------------------------- |
| key | string | 是 | 联系人的key值,一个联系人对应一个key。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| callback | AsyncCallback
<
[Contact](#contact)
>
| 是 | 回调函数,返回查询的联系人对象。 |
**示例:**
```
js
contact
.
queryContact
(
'
xxx
'
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
(
err
,
data
)
=>
{
contact
.
queryContact
(
'
xxx
'
,
(
err
,
data
)
=>
{
if
(
err
)
{
console
.
log
(
`queryContact callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
...
...
@@ -602,7 +1303,7 @@ queryContact(key: string, holder: Holder, callback: AsyncCallback<Contact>
## contact.queryContact
queryContact(
key: string, attrs: ContactAttributes
, callback: AsyncCallback
<
Contact
>
): void
queryContact(
context: Context, key: string, holder: Holder
, callback: AsyncCallback
<
Contact
>
): void
根据key查询联系人,使用callback方式作为异步方法。
...
...
@@ -610,19 +1311,38 @@ queryContact(key: string, attrs: ContactAttributes, callback: AsyncCallback<
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | -------------------------------------- |
| key | string | 是 | 联系人的key值,一个联系人对应一个key。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| callback | AsyncCallback
<
[Contact](#contact)
>
| 是 | 回调函数,返回查询的联系人对象。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ------------------------------------------------------------ |
| 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
)
| 是 | 创建联系人的应用信息。 |
| callback | AsyncCallback
<
[Contact](#contact)
>
| 是 | 回调函数,返回查询的联系人对象。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
contact
.
queryContact
(
'
xxx
'
,
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
// 获取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
,
bundleName
:
""
,
displayName
:
""
},
(
err
,
data
)
=>
{
if
(
err
)
{
console
.
log
(
`queryContact callback: err->
${
JSON
.
stringify
(
err
)}
`
);
...
...
@@ -632,10 +1352,9 @@ queryContact(key: string, attrs: ContactAttributes, callback: AsyncCallback<
});
```
## contact.queryContact(deprecated)
## contact.queryContact
queryContact(key: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback
<
Contact
>
): void
queryContact(key: string, holder: Holder, callback: AsyncCallback
<
Contact
>
): void
根据key查询联系人,使用callback方式作为异步方法。
...
...
@@ -649,7 +1368,6 @@ queryContact(key: string, holder: Holder, attrs: ContactAttributes, callback: As
| -------- | ---------------------------------------- | ---- | -------------------------------------- |
| key | string | 是 | 联系人的key值,一个联系人对应一个key。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| callback | AsyncCallback
<
[Contact](#contact)
>
| 是 | 回调函数,返回查询的联系人对象。 |
**示例:**
...
...
@@ -659,8 +1377,6 @@ queryContact(key: string, holder: Holder, attrs: ContactAttributes, callback: As
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
},
(
err
,
data
)
=>
{
if
(
err
)
{
console
.
log
(
`queryContact callback: err->
${
JSON
.
stringify
(
err
)}
`
);
...
...
@@ -670,51 +1386,324 @@ queryContact(key: string, holder: Holder, attrs: ContactAttributes, callback: As
});
```
## 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
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | --------------------------------------- | ---- | -------------------------------------- |
| key | string | 是 | 联系人的key值,一个联系人对应一个key。 |
| holder |
[
Holder
](
#holder
)
| 否 | 创建联系人的应用信息。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 否 | 联系人的属性列表。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ------------------------------------------------------------ |
| 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。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| callback | AsyncCallback
<
[Contact](#contact)
>
| 是 | 回调函数,返回查询的联系人对象。 |
**返回值:**
| 类型 | 说明 |
| ---------------------------------- | ----------------------------------------------- |
| Promise
<
[Contact](#contact)
>
| 以Promise形式返回结果,返回查询到的联系人对象。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
let
promise
=
contact
.
queryContact
(
'
xxx
'
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
{
// 获取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
'
,
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
});
promise
.
then
((
data
)
=>
{
console
.
log
(
`queryContact success: data->
${
JSON
.
stringify
(
data
)}
`
);
}).
catch
((
err
)
=>
{
console
.
error
(
`queryContact fail: err->
${
JSON
.
stringify
(
err
)}
`
);
},
(
err
,
data
)
=>
{
if
(
err
)
{
console
.
log
(
`queryContact callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
}
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
根据key查询联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | -------------------------------------- |
| key | string | 是 | 联系人的key值,一个联系人对应一个key。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| callback | AsyncCallback
<
[Contact](#contact)
>
| 是 | 回调函数,返回查询的联系人对象。 |
**示例:**
```
js
contact
.
queryContact
(
'
xxx
'
,
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
},
(
err
,
data
)
=>
{
if
(
err
)
{
console
.
log
(
`queryContact callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
}
console
.
log
(
`queryContact callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
```
## contact.queryContact
queryContact(context: Context, key: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback
<
Contact
>
): void
根据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
)
。 |
| key | string | 是 | 联系人的key值,一个联系人对应一个key。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| 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
.
queryContact
(
globalThis
.
context
as
Context
,
'
xxx
'
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
},
(
err
,
data
)
=>
{
if
(
err
)
{
console
.
log
(
`queryContact callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
}
console
.
log
(
`queryContact callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
```
## contact.queryContact(deprecated)
queryContact(key: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback
<
Contact
>
): void
根据key查询联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | -------------------------------------- |
| key | string | 是 | 联系人的key值,一个联系人对应一个key。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| callback | AsyncCallback
<
[Contact](#contact)
>
| 是 | 回调函数,返回查询的联系人对象。 |
**示例:**
```
js
contact
.
queryContact
(
'
xxx
'
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
},
(
err
,
data
)
=>
{
if
(
err
)
{
console
.
log
(
`queryContact callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
}
console
.
log
(
`queryContact callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
```
## contact.queryContact
queryContact(context: Context, key: string, holder?: Holder, attrs?: ContactAttributes): Promise
<
Contact
>
根据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
)
。 |
| key | string | 是 | 联系人的key值,一个联系人对应一个key。 |
| holder |
[
Holder
](
#holder
)
| 否 | 创建联系人的应用信息。 |
| 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
.
queryContact
(
globalThis
.
context
as
Context
,
'
xxx
'
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
});
promise
.
then
((
data
)
=>
{
console
.
log
(
`queryContact success: data->
${
JSON
.
stringify
(
data
)}
`
);
}).
catch
((
err
)
=>
{
console
.
error
(
`queryContact fail: err->
${
JSON
.
stringify
(
err
)}
`
);
});
```
## contact.queryContact(deprecated)
queryContact(key: string, holder?: Holder, attrs?: ContactAttributes): Promise
<
Contact
>
根据key查询联系人,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | --------------------------------------- | ---- | -------------------------------------- |
| key | string | 是 | 联系人的key值,一个联系人对应一个key。 |
| holder |
[
Holder
](
#holder
)
| 否 | 创建联系人的应用信息。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 否 | 联系人的属性列表。 |
**返回值:**
| 类型 | 说明 |
| ---------------------------------- | ----------------------------------------------- |
| Promise
<
[Contact](#contact)
>
| 以Promise形式返回结果,返回查询到的联系人对象。 |
**示例:**
```
js
let
promise
=
contact
.
queryContact
(
'
xxx
'
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
});
promise
.
then
((
data
)
=>
{
console
.
log
(
`queryContact success: data->
${
JSON
.
stringify
(
data
)}
`
);
}).
catch
((
err
)
=>
{
console
.
error
(
`queryContact fail: err->
${
JSON
.
stringify
(
err
)}
`
);
});
```
## contact.queryContacts
queryContacts(context: Context, 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
)
。 |
| 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
.
queryContacts
(
globalThis
.
context
as
Context
,
(
err
,
data
)
=>
{
if
(
err
)
{
console
.
log
(
`queryContacts callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
}
console
.
log
(
`queryContacts callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
```
## contact.queryContacts(deprecated)
queryContacts(callback: AsyncCallback
<
Array
<
Contact
>>
): void
查询所有联系人,使用callback方式作为异步方法。
...
...
@@ -740,9 +1729,58 @@ queryContacts(callback: AsyncCallback<Array<Contact>>): void
});
```
## contact.queryContacts
queryContacts(context: Context, holder: Holder, 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
)
。 |
| 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
.
queryContacts
(
globalThis
.
context
as
Context
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
(
err
,
data
)
=>
{
if
(
err
)
{
console
.
log
(
`queryContacts callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
}
console
.
log
(
`queryContacts callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
```
## contact.queryContacts(deprecated)
queryContacts(holder: Holder, callback: AsyncCallback
<
Array
<
Contact
>>
): void
查询所有联系人,使用callback方式作为异步方法。
...
...
@@ -774,9 +1812,56 @@ queryContacts(holder: Holder, callback: AsyncCallback<Array<Contact>>
});
```
## contact.queryContacts
queryContacts(context: Context, 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
)
。 |
| 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
.
queryContacts
(
globalThis
.
context
as
Context
,
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
},
(
err
,
data
)
=>
{
if
(
err
)
{
console
.
log
(
`queryContacts callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
}
console
.
log
(
`queryContacts callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
```
## contact.queryContacts(deprecated)
queryContacts(attrs: ContactAttributes, callback: AsyncCallback
<
Array
<
Contact
>>
): void
查询所有联系人,使用callback方式作为异步方法。
...
...
@@ -806,9 +1891,61 @@ queryContacts(attrs: ContactAttributes, callback: AsyncCallback<Array<Cont
});
```
## contact.queryContacts
queryContacts(context: Context, 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
)
。 |
| 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
.
queryContacts
(
globalThis
.
context
as
Context
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
},
(
err
,
data
)
=>
{
if
(
err
)
{
console
.
log
(
`queryContacts callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
}
console
.
log
(
`queryContacts callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
```
## contact.queryContacts(deprecated)
queryContacts(holder: Holder, attrs: ContactAttributes, callback: AsyncCallback
<
Array
<
Contact
>>
): void
查询所有联系人,使用callback方式作为异步方法。
...
...
@@ -832,61 +1969,326 @@ queryContacts(holder: Holder, attrs: ContactAttributes, callback: AsyncCallback&
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
},
(
err
,
data
)
=>
{
if
(
err
)
{
console
.
log
(
`queryContacts callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
}
console
.
log
(
`queryContacts callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
```
## contact.queryContacts
queryContacts(context: Context, 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
)
。 |
| 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
.
queryContacts
(
globalThis
.
context
as
Context
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
});
promise
.
then
((
data
)
=>
{
console
.
log
(
`queryContacts success: data->
${
JSON
.
stringify
(
data
)}
`
);
}).
catch
((
err
)
=>
{
console
.
error
(
`queryContacts fail: err->
${
JSON
.
stringify
(
err
)}
`
);
});
```
## contact.queryContacts(deprecated)
queryContacts(holder?: Holder, attrs?: ContactAttributes): Promise
<
Array
<
Contact
>>
查询所有联系人,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | --------------------------------------- | ---- | ---------------------- |
| holder |
[
Holder
](
#holder
)
| 否 | 创建联系人的应用信息。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 否 | 联系人的属性列表。 |
**返回值:**
| 类型 | 说明 |
| ----------------------------------------------- | --------------------------------------------------- |
| Promise
<
Array
<
[Contact](#contact)
>>
| 以Promise形式返回结果,返回查询到的联系人对象数组。 |
**示例:**
```
js
let
promise
=
contact
.
queryContacts
({
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
});
promise
.
then
((
data
)
=>
{
console
.
log
(
`queryContacts success: data->
${
JSON
.
stringify
(
data
)}
`
);
}).
catch
((
err
)
=>
{
console
.
error
(
`queryContacts fail: err->
${
JSON
.
stringify
(
err
)}
`
);
});
```
## contact.queryContactsByPhoneNumber
queryContactsByPhoneNumber(context: Context, phoneNumber: string, 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 | 是 | 联系人的电话号码。 |
| 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
'
,
(
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, callback: AsyncCallback
<
Array
<
Contact
>>
): void
根据电话号码查询联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ----------------------------------------------------- | ---- | -------------------------------------- |
| phoneNumber | string | 是 | 联系人的电话号码。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
**示例:**
```
js
contact
.
queryContactsByPhoneNumber
(
'
138xxxxxxxx
'
,
(
err
,
data
)
=>
{
if
(
err
)
{
console
.
log
(
`queryContactsByPhoneNumber callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
}
console
.
log
(
`queryContactsByPhoneNumber callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
```
## contact.queryContactsByPhoneNumber
queryContactsByPhoneNumber(context: Context, phoneNumber: string, holder: Holder, 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
)
| 是 | 创建联系人的应用信息。 |
| 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
:
""
},
(
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, callback: AsyncCallback
<
Array
<
Contact
>>
): void
根据电话号码查询联系人,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ----------------------------------------------------- | ---- | -------------------------------------- |
| phoneNumber | string | 是 | 联系人的电话号码。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
**示例:**
```
js
contact
.
queryContactsByPhoneNumber
(
'
138xxxxxxxx
'
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
(
err
,
data
)
=>
{
if
(
err
)
{
console
.
log
(
`queryContacts callback: err->
${
JSON
.
stringify
(
err
)}
`
);
console
.
log
(
`queryContacts
ByPhoneNumber
callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
}
console
.
log
(
`queryContacts callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
console
.
log
(
`queryContacts
ByPhoneNumber
callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
```
## contact.queryContactsByPhoneNumber
## contact.queryContacts
queryContacts(holder?: Holder, attrs?: ContactAttributes): Promise
<
Array
<
Contact
>>
queryContactsByPhoneNumber(context: Context, phoneNumber: string, attrs: ContactAttributes, callback: AsyncCallback
<
Array
<
Contact
>>
): void
查询所有联系人,使用Promise
方式作为异步方法。
根据电话号码查询联系人,使用callback
方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | --------------------------------------- | ---- | ---------------------- |
| holder |
[
Holder
](
#holder
)
| 否 | 创建联系人的应用信息。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 否 | 联系人的属性列表。 |
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ----------------------------------------------------- | ---- | ------------------------------------------------------------ |
| 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)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
**返回值:**
| 类型 | 说明 |
| ----------------------------------------------- | --------------------------------------------------- |
| Promise
<
Array
<
[Contact](#contact)
>>
| 以Promise形式返回结果,返回查询到的联系人对象数组。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 201 | Permission denied. |
| 401 | Parameter error. |
**示例:**
```
js
let
promise
=
contact
.
queryContacts
({
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
{
// 获取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
'
,
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
});
promise
.
then
((
data
)
=>
{
console
.
log
(
`queryContacts success: data->
${
JSON
.
stringify
(
data
)}
`
);
}).
catch
((
err
)
=>
{
console
.
error
(
`queryContacts fail: err->
${
JSON
.
stringify
(
err
)}
`
);
},
(
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.queryContactsByPhoneNumber
queryContactsByPhoneNumber(phoneNumber: string, callback: AsyncCallback
<
Array
<
Contact
>>
): void
queryContactsByPhoneNumber(phoneNumber: string, attrs: ContactAttributes, callback: AsyncCallback
<
Array
<
Contact
>>
): void
根据电话号码查询联系人,使用callback方式作为异步方法。
...
...
@@ -899,12 +2301,15 @@ queryContactsByPhoneNumber(phoneNumber: string, callback: AsyncCallback<Array
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ----------------------------------------------------- | ---- | -------------------------------------- |
| phoneNumber | string | 是 | 联系人的电话号码。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
**示例:**
```
js
contact
.
queryContactsByPhoneNumber
(
'
138xxxxxxxx
'
,
(
err
,
data
)
=>
{
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
;
...
...
@@ -913,10 +2318,9 @@ queryContactsByPhoneNumber(phoneNumber: string, callback: AsyncCallback<Array
});
```
## contact.queryContactsByPhoneNumber
queryContactsByPhoneNumber(
phoneNumber: string, holder: Holder
, callback: AsyncCallback
<
Array
<
Contact
>>
): void
queryContactsByPhoneNumber(
context: Context, phoneNumber: string, holder: Holder, attrs: ContactAttributes
, callback: AsyncCallback
<
Array
<
Contact
>>
): void
根据电话号码查询联系人,使用callback方式作为异步方法。
...
...
@@ -924,21 +2328,41 @@ queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, callback: AsyncC
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ----------------------------------------------------- | ---- | -------------------------------------- |
| phoneNumber | string | 是 | 联系人的电话号码。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ----------------------------------------------------- | ---- | ------------------------------------------------------------ |
| 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
contact
.
queryContactsByPhoneNumber
(
'
138xxxxxxxx
'
,
{
// 获取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
)}
`
);
...
...
@@ -948,10 +2372,9 @@ queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, callback: AsyncC
});
```
## contact.queryContactsByPhoneNumber(deprecated)
## contact.queryContactsByPhoneNumber
queryContactsByPhoneNumber(phoneNumber: string, attrs: ContactAttributes, callback: AsyncCallback
<
Array
<
Contact
>>
): void
queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback
<
Array
<
Contact
>>
): void
根据电话号码查询联系人,使用callback方式作为异步方法。
...
...
@@ -964,6 +2387,7 @@ queryContactsByPhoneNumber(phoneNumber: string, attrs: ContactAttributes, callba
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ----------------------------------------------------- | ---- | -------------------------------------- |
| phoneNumber | string | 是 | 联系人的电话号码。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
...
...
@@ -971,6 +2395,10 @@ queryContactsByPhoneNumber(phoneNumber: string, attrs: ContactAttributes, callba
```
js
contact
.
queryContactsByPhoneNumber
(
'
138xxxxxxxx
'
,
{
holderId
:
0
,
bundleName
:
""
,
displayName
:
""
},
{
attributes
:
[
contact
.
Attribute
.
ATTR_EMAIL
,
contact
.
Attribute
.
ATTR_NAME
]
},
(
err
,
data
)
=>
{
if
(
err
)
{
...
...
@@ -981,46 +2409,65 @@ queryContactsByPhoneNumber(phoneNumber: string, attrs: ContactAttributes, callba
});
```
## contact.queryContactsByPhoneNumber
queryContactsByPhoneNumber(
phoneNumber: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback
<
Array
<
Contact
>>
): void
queryContactsByPhoneNumber(
context: Context, phoneNumber: string, holder?: Holder, attrs?: ContactAttributes): Promise
<
Array
<
Contact
>>
根据电话号码查询联系人,使用
callback
方式作为异步方法。
根据电话号码查询联系人,使用
Promise
方式作为异步方法。
**需要权限**
:ohos.permission.READ_CONTACTS
**系统能力**
:SystemCapability.Applications.ContactsData
**模型约束**
:此接口仅可在Stage模型下使用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ----------------------------------------------------- | ---- | -------------------------------------- |
| phoneNumber | string | 是 | 联系人的电话号码。 |
| holder |
[
Holder
](
#holder
)
| 是 | 创建联系人的应用信息。 |
| attrs |
[
ContactAttributes
](
#contactattributes
)
| 是 | 联系人的属性列表。 |
| callback | AsyncCallback
<
Array
<
[Contact](#contact)
>>
| 是 | 回调函数,返回查询到的联系人对象数组。 |
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | --------------------------------------- | ---- | ------------------------------------------------------------ |
| 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
contact
.
queryContactsByPhoneNumber
(
'
138xxxxxxxx
'
,
{
// 获取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
]
},
(
err
,
data
)
=>
{
if
(
err
)
{
console
.
log
(
`queryContactsByPhoneNumber callback: err->
${
JSON
.
stringify
(
err
)}
`
);
return
;
}
console
.
log
(
`queryContactsByPhoneNumber callback: success data->
${
JSON
.
stringify
(
data
)}
`
);
});
promise
.
then
((
data
)
=>
{
console
.
log
(
`queryContactsByPhoneNumber success: data->
${
JSON
.
stringify
(
data
)}
`
);
}).
catch
((
err
)
=>
{
console
.
error
(
`queryContactsByPhoneNumber fail: err->
${
JSON
.
stringify
(
err
)}
`
);
});
```
## contact.queryContactsByPhoneNumber
## contact.queryContactsByPhoneNumber(deprecated)
queryContactsByPhoneNumber(phoneNumber: string, holder?: Holder, attrs?: ContactAttributes): Promise
<
Array
<
Contact
>>
...
...
@@ -1061,9 +2508,54 @@ queryContactsByPhoneNumber(phoneNumber: string, holder?: Holder, attrs?: Contact
});
```
## 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方式作为异步方法。
...
...
@@ -1091,9 +2583,59 @@ queryContactsByEmail(email: string, callback: AsyncCallback<Array<Contact&
});
```
## 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方式作为异步方法。
...
...
@@ -1126,9 +2668,57 @@ queryContactsByEmail(email: string, holder: Holder, callback: AsyncCallback<A
});
```
## 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方式作为异步方法。
...
...
@@ -1159,9 +2749,62 @@ queryContactsByEmail(email: string, attrs: ContactAttributes, callback: AsyncCal
});
```
## 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方式作为异步方法。
...
...
@@ -1197,8 +2840,65 @@ queryContactsByEmail(email: string, holder: Holder, attrs: ContactAttributes, ca
});
```
## contact.queryContactsByEmail
## 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
>>
...
...
@@ -1239,9 +2939,53 @@ queryContactsByEmail(email: string, holder?: Holder, attrs?: ContactAttributes):
});
```
## 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方式作为异步方法。
...
...
@@ -1268,9 +3012,58 @@ queryGroups(callback: AsyncCallback<Array<Group>>): void
});
```
## 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方式作为异步方法。
...
...
@@ -1302,9 +3095,62 @@ queryGroups(holder: Holder, callback: AsyncCallback<Array<Group>>):
});
```
## 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方式作为异步方法。
...
...
@@ -1340,9 +3186,53 @@ queryGroups(holder?: Holder): Promise<Array<Group>>
});
```
## 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方式作为异步方法。
...
...
@@ -1369,9 +3259,57 @@ queryHolders(callback: AsyncCallback<Array<Holder>>): void
});
```
## 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方式作为异步方法。
...
...
@@ -1397,9 +3335,54 @@ queryHolders(): Promise<Array<Holder>>
});
```
## 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
根据联系人的id查询联系人的key,使用callback方式作为异步方法。
...
...
@@ -1427,9 +3410,59 @@ queryKey(id: number, callback: AsyncCallback<string>): void
});
```
## 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
根据联系人的id查询联系人的key,使用callback方式作为异步方法。
...
...
@@ -1462,9 +3495,63 @@ queryKey(id: number, holder: Holder, callback: AsyncCallback<string>): voi
});
```
## 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
>
根据联系人的id查询联系人的key,使用Promise方式作为异步方法。
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录