Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
7406f02c
D
Docs
项目概览
OpenHarmony
/
Docs
12 个月 前同步成功
通知
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看板
体验新版 GitCode,发现更多精彩内容 >>
未验证
提交
7406f02c
编写于
7月 20, 2023
作者:
O
openharmony_ci
提交者:
Gitee
7月 20, 2023
浏览文件
操作
浏览文件
下载
差异文件
!21053 企业设备管理&传感器内容优化
Merge pull request !21053 from ningning/master
上级
cb235a00
19e2795e
变更
2
显示空白变更内容
内联
并排
Showing
2 changed file
with
140 addition
and
139 deletion
+140
-139
zh-cn/application-dev/device/sensor-guidelines.md
zh-cn/application-dev/device/sensor-guidelines.md
+45
-46
zh-cn/application-dev/reference/apis/js-apis-enterprise-adminManager.md
...ion-dev/reference/apis/js-apis-enterprise-adminManager.md
+95
-93
未找到文件。
zh-cn/application-dev/device/sensor-guidelines.md
浏览文件 @
7406f02c
...
...
@@ -15,65 +15,64 @@
| ohos.sensor | sensor.on(sensorId, callback:AsyncCallback
<
Response
>
): void | 持续监听传感器数据变化 |
| ohos.sensor | sensor.once(sensorId, callback:AsyncCallback
<
Response
>
): void | 获取一次传感器数据变化 |
| ohos.sensor | sensor.off(sensorId, callback?:AsyncCallback
<
void
>
): void | 注销传感器数据的监听 |
| ohos.sensor | sensor.getSensorList(callback: AsyncCallback
\<
Array
\<
Sensor>>): void| 获取设备上的所有传感器信息 |
## 开发步骤
1.
获取设备上传感器的数据前,需要检查是否已经配置请求相应的权限。
<br>
系统提供的传感器权限有:
-
ohos.permission.ACCELEROMETER
开发步骤以加速度传感器ACCELEROMETER为例。
-
ohos.permission.GYROSCOPE
-
ohos.permission.ACTIVITY_MOTION
-
ohos.permission.READ_HEALTH_DATA
具体配置方式请参考
[
权限申请声明
](
../security/accesstoken-guidelines.md
)
。
2.
以下场景以加速度传感器ACCELEROMETER为例。展示持续监听传感器接口的调用结果。
1.
导入模块。
```
ts
import
sensor
from
"
@ohos.sensor
"
;
```
sensor
.
on
(
sensor
.
SensorId
.
ACCELEROMETER
,
function
(
data
)
{
console
.
info
(
"
Succeeded in obtaining data. x:
"
+
data
.
x
+
"
y:
"
+
data
.
y
+
"
z:
"
+
data
.
z
);
// 获取数据成功
2.
查询设备支持的所有传感器的参数。
```ts
sensor.getSensorList(function (error, data) {
if (error) {
console.info('getSensorList failed');
} else {
console.info('getSensorList success');
for (let i = 0; i < data.length; i++) {
console.info(JSON.stringify(data[i]));
}
}
});
```
!
[
171e6f30-a8d9-414c-bafa-b430340305fb
](
figures/171e6f30-a8d9-414c-bafa-b430340305fb.png
)
![输入图片说明](figures/001.png)
可以看到该传感器支持的最小采样周期为5000000纳秒,支持的最大采样周期是200000000纳秒,传感器上报周期interval应该设置在该范围内。
3.
检查是否已经配置相应权限,具体配置方式请参考
[
权限申请声明
](
../security/accesstoken-guidelines.md
)
。
3.
注销传感器数据监听。
4.
注册监听。可以通过on()和once()两种接口监听传感器的调用结果。
-
通过on()接口,实现对传感器的持续监听,传感器上报周期interval设置为100000000纳秒。
```ts
import
sensor
from
"
@ohos.sensor
"
;
sensor
.
off
(
sensor
.
SensorId
.
ACCELEROMETER
);
sensor.on(sensor.SensorId.ACCELEROMETER, function (data) {
console.info("Succeeded in obtaining data. x: " + data.x + " y: " + data.y + " z: " + data.z);
}, {'interval': 100000000});
```
!
[
65d69983-29f6-4381-80a3-f9ef2ec19e53
](
figures/65d69983-29f6-4381-80a3-f9ef2ec19e53
.png
)
![输入图片说明](figures/002
.png)
4.
获取一次传感器数据变化
。
-
通过once()接口,实现对传感器的一次监听
。
```ts
import
sensor
from
"
@ohos.sensor
"
;
sensor.once(sensor.SensorId.ACCELEROMETER, function (data) {
console
.
info
(
"
Succeeded in obtaining data. x:
"
+
data
.
x
+
"
y:
"
+
data
.
y
+
"
z:
"
+
data
.
z
);
// 获取数据成功
console.info("Succeeded in obtaining data. x: " + data.x + " y: " + data.y + " z: " + data.z);
});
```
!
[
db5d017d-6c1c-4a71-a2dd-f74b7f23239e
](
figures/db5d017d-6c1c-4a71-a2dd-f74b7f23239e
.png
)
![输入图片说明](figures/003
.png)
若接口调用不成功,建议使用try/catch语句捕获代码中可能出现的错误信息。例如:
5.
取消持续监听。
```ts
import sensor from "@ohos.sensor";
try {
sensor.once(sensor.SensorId.ACCELEROMETER, function (data) {
console.info("Succeeded in obtaining data. x: " + data.x + "y: " + data.y + "z: " + data.z); // 获取数据成功
});
} catch (error) {
console.error(
`Failed to get sensor data. Code: ${error.code}, message: ${error.message}`
);
}
sensor.off(sensor.SensorId.ACCELEROMETER);
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-enterprise-adminManager.md
浏览文件 @
7406f02c
...
...
@@ -6,7 +6,9 @@
>
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
>
> 本模块接口仅对[设备管理员应用](enterpriseDeviceManagement-overview.md#基本概念)开放,实现相应功能。
> 本模块接口仅可在Stage模型下使用。
>
> 本模块接口仅对[设备管理应用](enterpriseDeviceManagement-overview.md#基本概念)开放,实现相应功能。
## 导入模块
...
...
@@ -18,7 +20,7 @@ import adminManager from '@ohos.enterprise.adminManager';
enableAdmin(admin: Want, enterpriseInfo: EnterpriseInfo, type: AdminType, callback: AsyncCallback
\<
void>): void
激活当前用户下
的指定设备管理员应用,使用callback形式返回是否激活成功。其中超级管理员应用只能在管理员用户下被激活
。
激活当前用户下
指定的设备管理应用,其中超级设备管理应用仅能在管理员用户下被激活。使用callback异步回调
。
**需要权限:**
ohos.permission.MANAGE_ENTERPRISE_DEVICE_ADMIN
...
...
@@ -30,14 +32,14 @@ enableAdmin(admin: Want, enterpriseInfo: EnterpriseInfo, type: AdminType, callba
| 参数名 | 类型 | 必填 | 说明 |
| -------------- | ----------------------------------- | ---- | ------------------ |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理
员
应用。 |
| enterpriseInfo |
[
EnterpriseInfo
](
#enterpriseinfo
)
| 是 | 设备管理
员
应用的企业信息。 |
| type |
[
AdminType
](
#admintype
)
| 是 | 激活的设备管理
员
类型。 |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理应用。 |
| enterpriseInfo |
[
EnterpriseInfo
](
#enterpriseinfo
)
| 是 | 设备管理应用的企业信息。 |
| type |
[
AdminType
](
#admintype
)
| 是 | 激活的设备管理
应用
类型。 |
| callback | AsyncCallback
\<
void> | 是 | 回调函数,当接口调用成功,err为null,否则为错误对象。 |
**错误码**
:
以下
的错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
以下
错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
。
| 错误码ID | 错误信息 |
| ------- | --------------------------------------------------------------- |
...
...
@@ -70,7 +72,7 @@ adminManager.enableAdmin(wantTemp, enterpriseInfo, adminManager.AdminType.ADMIN_
enableAdmin(admin: Want, enterpriseInfo: EnterpriseInfo, type: AdminType, userId: number, callback: AsyncCallback
\<
void>): void
激活指定用户(通过userId指定)下
的指定设备管理员应用,使用callback形式返回是否激活成功。其中超级管理员应用只能在管理员用户下被激活
。
激活指定用户(通过userId指定)下
指定的设备管理应用,其中超级管理应用仅能在管理员用户下被激活。使用callback异步回调
。
**需要权限:**
ohos.permission.MANAGE_ENTERPRISE_DEVICE_ADMIN
...
...
@@ -82,15 +84,15 @@ enableAdmin(admin: Want, enterpriseInfo: EnterpriseInfo, type: AdminType, userId
| 参数名 | 类型 | 必填 | 说明 |
| -------------- | ----------------------------------- | ---- | ---------------------------- |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理
员
应用。 |
| enterpriseInfo |
[
EnterpriseInfo
](
#enterpriseinfo
)
| 是 | 设备管理
员
应用的企业信息。 |
| type |
[
AdminType
](
#admintype
)
| 是 | 激活的设备管理
员类型。
|
| userId | number | 是 | 用户ID
。默认值:调用方所在用户,取值范围:大于等于0
。 |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理应用。 |
| enterpriseInfo |
[
EnterpriseInfo
](
#enterpriseinfo
)
| 是 | 设备管理应用的企业信息。 |
| type |
[
AdminType
](
#admintype
)
| 是 | 激活的设备管理
应用类型。
|
| userId | number | 是 | 用户ID
,指定具体用户,取值范围:大于等于0。
<br>
默认值:调用方所在用户
。 |
| callback | AsyncCallback
\<
void> | 是 | 回调函数,当接口调用成功,err为null,否则为错误对象。 |
**错误码**
:
以下
的错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
以下
错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
。
| 错误码ID | 错误信息 |
| ------- | --------------------------------------------------------------- |
...
...
@@ -123,7 +125,7 @@ adminManager.enableAdmin(wantTemp, enterpriseInfo, adminManager.AdminType.ADMIN_
enableAdmin(admin: Want, enterpriseInfo: EnterpriseInfo, type: AdminType, userId?: number): Promise
\<
void>
如果调用接口时传入了可选参数userId,则激活指定用户下的指定设备管理员应用,否则激活当前用户下的指定设备管理员应用,使用Promise形式返回是否激活成功。其中超级管理员应用只能在管理员用户下被激活
。
激活当前/指定用户下指定的设备管理应用,其中超级管理应用仅能在管理员用户下被激活。使用promise异步回调
。
**需要权限:**
ohos.permission.MANAGE_ENTERPRISE_DEVICE_ADMIN
...
...
@@ -135,20 +137,20 @@ enableAdmin(admin: Want, enterpriseInfo: EnterpriseInfo, type: AdminType, userId
| 参数名 | 类型 | 必填 | 说明 |
| -------------- | ----------------------------------- | ---- | ---------------------------- |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理
员
应用。 |
| enterpriseInfo |
[
EnterpriseInfo
](
#enterpriseinfo
)
| 是 | 设备管理
员
应用的企业信息。 |
| type |
[
AdminType
](
#admintype
)
| 是 | 激活的设备管理
员
类型。 |
| userId | number | 否 | 用户ID
。默认值:调用方所在用户,取值范围:大于等于0。
|
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理应用。 |
| enterpriseInfo |
[
EnterpriseInfo
](
#enterpriseinfo
)
| 是 | 设备管理应用的企业信息。 |
| type |
[
AdminType
](
#admintype
)
| 是 | 激活的设备管理
应用
类型。 |
| userId | number | 否 | 用户ID
,取值范围:大于等于0。
<br>
- 调用接口时,若传入userId,表示指定用户。
<br>
- 调用接口时,若未传入userId,表示当前用户。
|
**返回值:**
| 类型 | 说明 |
| ----------------- | ----------------- |
| Promise
\<
void> | 无返回结果的Promise对象。当激活设备管理
员应用失败时
会抛出错误对象。 |
| Promise
\<
void> | 无返回结果的Promise对象。当激活设备管理
应用失败时,
会抛出错误对象。 |
**错误码**
:
以下
的错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
以下
错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
。
| 错误码ID | 错误信息 |
| ------- | --------------------------------------------------------------- |
...
...
@@ -177,7 +179,7 @@ adminManager.enableAdmin(wantTemp, enterpriseInfo, adminManager.AdminType.ADMIN_
disableAdmin(admin: Want, callback: AsyncCallback
\<
void>): void
将当前用户下
的指定普通管理员应用去激活,使用callback形式返回是否去激活成功
。
将当前用户下
指定的普通设备管理应用去激活。使用callback异步回调
。
**需要权限:**
ohos.permission.MANAGE_ENTERPRISE_DEVICE_ADMIN
...
...
@@ -189,12 +191,12 @@ disableAdmin(admin: Want, callback: AsyncCallback\<void>): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------- | ---- | ------------------- |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 普通设备管理
员
应用。 |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 普通设备管理应用。 |
| callback | AsyncCallback
\<
void> | 是 | 回调函数,当接口调用成功,err为null,否则为错误对象。 |
**错误码**
:
以下的错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
以下的错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
。
| 错误码ID | 错误信息 |
| ------- | ----------------------------------------------------------------- |
...
...
@@ -221,7 +223,7 @@ adminManager.disableAdmin(wantTemp, (err) => {
disableAdmin(admin: Want, userId: number, callback: AsyncCallback
\<
void>): void
将指定用户(通过userId指定)下
的指定普通管理员应用去激活,使用callback形式返回是否去激活成功
。
将指定用户(通过userId指定)下
指定的普通管理应用去激活。使用callback异步回调
。
**需要权限:**
ohos.permission.MANAGE_ENTERPRISE_DEVICE_ADMIN
...
...
@@ -233,13 +235,13 @@ disableAdmin(admin: Want, userId: number, callback: AsyncCallback\<void>): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------- | ---- | ---------------------------- |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 普通设备管理
员
应用。 |
| userId | number | 是 | 用户ID
。默认值:调用方所在用户,取值范围:大于等于0
。 |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 普通设备管理应用。 |
| userId | number | 是 | 用户ID
,指定具体用户,取值范围:大于等于0。
<br>
默认值:当前用户
。 |
| callback | AsyncCallback
\<
void> | 是 | 回调函数,当接口调用成功,err为null,否则为错误对象。 |
**错误码**
:
以下
的错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
以下
错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
。
| 错误码ID | 错误信息 |
| ------- | ----------------------------------------------------------------- |
...
...
@@ -266,7 +268,7 @@ adminManager.disableAdmin(wantTemp, 100, (err) => {
disableAdmin(admin: Want, userId?: number): Promise
\<
void>
如果调用接口时传入了可选参数userId,则将指定用户下的指定普通管理员应用去激活,否则将当前用户下的指定普通管理员应用去激活,使用Promise形式返回是否去激活成功
。
将当前/指定用户下指定的普通管理应用去激活。使用promise异步回调
。
**需要权限:**
ohos.permission.MANAGE_ENTERPRISE_DEVICE_ADMIN
...
...
@@ -278,18 +280,18 @@ disableAdmin(admin: Want, userId?: number): Promise\<void>
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ----------------------------------- | ---- | ---------------------------- |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 普通设备管理
员
应用。 |
| userId | number | 否 | 用户ID
。默认值:调用方所在用户,取值范围:大于等于0。
|
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 普通设备管理应用。 |
| userId | number | 否 | 用户ID
, 取值范围:大于等于0。
<br>
- 调用接口时,若传入userId,表示指定用户。
<br>
- 调用接口时,若未传入userId,表示当前用户。
|
**返回值:**
| 类型 | 说明 |
| ----------------- | ----------------- |
| Promise
\<
void> | 无返回结果的Promise对象。当去激活普通管理
员应用失败时
会抛出错误对象。 |
| Promise
\<
void> | 无返回结果的Promise对象。当去激活普通管理
应用失败时,
会抛出错误对象。 |
**错误码**
:
以下
的错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
以下
错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
。
| 错误码ID | 错误信息 |
| ------- | ----------------------------------------------------------------- |
...
...
@@ -312,7 +314,7 @@ adminManager.disableAdmin(wantTemp, 100).catch((err) => {
disableSuperAdmin(bundleName: String, callback: AsyncCallback
\<
void>): void
根据bundleName将管理员用户下的超级
管理员应用去激活,使用callback形式返回是否去激活成功
。
根据bundleName将管理员用户下的超级
设备管理应用去激活。使用callback异步回调
。
**需要权限:**
ohos.permission.MANAGE_ENTERPRISE_DEVICE_ADMIN
...
...
@@ -324,12 +326,12 @@ disableSuperAdmin(bundleName: String, callback: AsyncCallback\<void>): void
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ----------------------- | ---- | ------------------- |
| bundleName | String | 是 | 超级设备管理
员
应用的包名。 |
| bundleName | String | 是 | 超级设备管理应用的包名。 |
| callback | AsyncCallback
\<
void> | 是 | 回调函数,当接口调用成功,err为null,否则为错误对象。 |
**错误码**
:
以下的错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
以下的错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
。
| 错误码ID | 错误信息 |
| ------- | ----------------------------------------------------------------- |
...
...
@@ -353,7 +355,7 @@ adminManager.disableSuperAdmin(bundleName, (err) => {
disableSuperAdmin(bundleName: String): Promise
\<
void>
根据bundleName将管理员用户下的超级
管理员应用去激活,使用Promise形式返回是否去激活成功
。
根据bundleName将管理员用户下的超级
设备管理应用去激活。使用promise异步回调
。
**需要权限:**
ohos.permission.MANAGE_ENTERPRISE_DEVICE_ADMIN
...
...
@@ -365,17 +367,17 @@ disableSuperAdmin(bundleName: String): Promise\<void>
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | ------------ |
| bundleName | String | 是 | 超级设备管理
员
应用的包名。 |
| bundleName | String | 是 | 超级设备管理应用的包名。 |
**返回值:**
| 类型 | 说明 |
| ----------------- | ----------------- |
| Promise
\<
void> | 无返回结果的Promise对象。当去激活超级
管理员应用失败时
会抛出错误对象。 |
| Promise
\<
void> | 无返回结果的Promise对象。当去激活超级
设备管理应用失败时,
会抛出错误对象。 |
**错误码**
:
以下
的错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
以下
错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
。
| 错误码ID | 错误信息 |
| ------- | ----------------------------------------------------------------- |
...
...
@@ -395,7 +397,7 @@ adminManager.disableSuperAdmin(bundleName).catch((err) => {
isAdminEnabled(admin: Want, callback: AsyncCallback
\<
boolean>): void
查询当前用户下
的指定设备管理员应用是否被激活,使用callback形式返回是否处于激活状态
。
查询当前用户下
指定的设备管理应用是否被激活。使用callback异步回调
。
**系统能力:**
SystemCapability.Customization.EnterpriseDeviceManager
...
...
@@ -405,8 +407,8 @@ isAdminEnabled(admin: Want, callback: AsyncCallback\<boolean>): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------- | ---- | -------------------- |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理
员
应用。 |
| callback | AsyncCallback
\<
boolean> | 是 | 回调函数,当接口调用成功,err为null,data为boolean值,true表示当前用户下
的指定设备管理员应用被激活,false表示当前用户下的指定设备管理员
应用未激活,否则err为错误对象。 |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理应用。 |
| callback | AsyncCallback
\<
boolean> | 是 | 回调函数,当接口调用成功,err为null,data为boolean值,true表示当前用户下
指定的设备管理应用被激活,false表示当前用户下指定的设备管理
应用未激活,否则err为错误对象。 |
**示例**
:
...
...
@@ -429,7 +431,7 @@ adminManager.isAdminEnabled(wantTemp, (err, result) => {
isAdminEnabled(admin: Want, userId: number, callback: AsyncCallback
\<
boolean>): void
查询指定用户(通过userId指定)下
的指定设备管理员应用是否被激活,使用callback形式返回是否处于激活状态
。
查询指定用户(通过userId指定)下
指定的设备管理应用是否被激活。使用callback异步回调
。
**系统能力:**
SystemCapability.Customization.EnterpriseDeviceManager
...
...
@@ -439,9 +441,9 @@ isAdminEnabled(admin: Want, userId: number, callback: AsyncCallback\<boolean>):
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------- | ---- | ---------------------------- |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理
员
应用。 |
| userId | number | 是 | 用户ID
。默认值:调用方所在用户,取值范围:大于等于0
。 |
| callback | AsyncCallback
\<
boolean> | 是 | 回调函数,当接口调用成功,err为null,data为boolean值,true表示当前用户下
的指定设备管理员应用被激活,false表示当前用户下的指定设备管理员
应用未激活,否则err为错误对象。 |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理应用。 |
| userId | number | 是 | 用户ID
,指定具体用户,取值范围:大于等于0。
<br>
默认值:当前用户
。 |
| callback | AsyncCallback
\<
boolean> | 是 | 回调函数,当接口调用成功,err为null,data为boolean值,true表示当前用户下
指定的设备管理应用被激活,false表示当前用户下指定的设备管理
应用未激活,否则err为错误对象。 |
**示例**
:
...
...
@@ -464,7 +466,7 @@ adminManager.isAdminEnabled(wantTemp, 100, (err, result) => {
isAdminEnabled(admin: Want, userId?: number): Promise
\<
boolean>
如果调用接口时传入参数userId,则查询指定用户下的设备管理员应用是否被激活,否则判断当前用户下的设备管理员应用是否被激活,使用Promise形式返回是否处于激活状态
。
查询当前/指定用户下指定的设备管理应用是否被激活。使用promise异步回调
。
**系统能力:**
SystemCapability.Customization.EnterpriseDeviceManager
...
...
@@ -474,14 +476,14 @@ isAdminEnabled(admin: Want, userId?: number): Promise\<boolean>
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ----------------------------------- | ---- | ---------------------------- |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理
员
应用。 |
| userId | number | 否 | 用户ID
。默认值:调用方所在用户,取值范围:大于等于0
。 |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理应用。 |
| userId | number | 否 | 用户ID
,取值范围:大于等于0。
<br>
- 调用接口时,若传入userId,表示指定用户。
<br>
- 调用接口时,若未传入userId,表示当前用户
。 |
**返回值:**
| 类型 | 说明 |
| ----------------- | ------------------- |
| Promise
\<
boolean> | Promise对象, 返回true表示指定的
管理员应用被激活,返回false表示指定的管理员
应用未激活。|
| Promise
\<
boolean> | Promise对象, 返回true表示指定的
设备管理应用被激活,返回false表示指定的设备管理
应用未激活。|
**示例**
:
...
...
@@ -502,7 +504,7 @@ adminManager.isAdminEnabled(wantTemp, 100).then((result) => {
isSuperAdmin(bundleName: String, callback: AsyncCallback
\<
boolean>): void
根据bundleName查询管理员用户下的超级
管理员应用是否被激活,使用callback形式返回是否处于激活状态
。
根据bundleName查询管理员用户下的超级
设备管理应用是否被激活。使用callback异步回调
。
**系统能力:**
SystemCapability.Customization.EnterpriseDeviceManager
...
...
@@ -512,8 +514,8 @@ isSuperAdmin(bundleName: String, callback: AsyncCallback\<boolean>): void
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ----------------------- | ---- | -------------------- |
| bundleName | String | 是 |
设备管理员
应用。 |
| callback | AsyncCallback
\<
boolean> | 是 | 回调函数,当接口调用成功,err为null,data为boolean类型值,true表示当前用户下
的指定设备管理员应用被激活,false表示当前用户下的指定设备管理员
应用未激活,否则err为错误对象。 |
| bundleName | String | 是 |
超级设备管理
应用。 |
| callback | AsyncCallback
\<
boolean> | 是 | 回调函数,当接口调用成功,err为null,data为boolean类型值,true表示当前用户下
指定的设备管理应用被激活,false表示当前用户下指定的设备管理
应用未激活,否则err为错误对象。 |
**示例**
:
...
...
@@ -533,7 +535,7 @@ adminManager.isSuperAdmin(bundleName, (err, result) => {
isSuperAdmin(bundleName: String): Promise
\<
boolean>
根据bundleName查询管理员用户下的超级
管理员应用是否被激活,使用Promise形式返回是否处于激活状态
。
根据bundleName查询管理员用户下的超级
设备管理应用是否被激活。使用promise异步回调
。
**系统能力:**
SystemCapability.Customization.EnterpriseDeviceManager
...
...
@@ -543,13 +545,13 @@ isSuperAdmin(bundleName: String): Promise\<boolean>
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | --------- |
| bundleName | String | 是 | 超级设备管理
员
应用。 |
| bundleName | String | 是 | 超级设备管理应用。 |
**返回值:**
| 错误码ID | 错误信息 |
| ----------------- | ------------------- |
| Promise
\<
boolean> | Promise对象, 返回true表示指定的超级
管理员应用被激活,返回false表示指定的超级管理员
应用未激活。 |
| Promise
\<
boolean> | Promise对象, 返回true表示指定的超级
设备管理应用被激活,返回false表示指定的超级设备管理
应用未激活。 |
**示例**
:
...
...
@@ -567,7 +569,7 @@ adminManager.isSuperAdmin(bundleName).then((result) => {
setEnterpriseInfo(admin: Want, enterpriseInfo: EnterpriseInfo, callback: AsyncCallback
\<
void>;): void
设置指定
设备管理员应用的企业信息,使用callback形式返回是否设置成功
。
设置指定
的设备管理应用的企业信息。使用callback异步回调
。
**需要权限:**
ohos.permission.SET_ENTERPRISE_INFO
...
...
@@ -579,13 +581,13 @@ setEnterpriseInfo(admin: Want, enterpriseInfo: EnterpriseInfo, callback: AsyncCa
| 参数名 | 类型 | 必填 | 说明 |
| -------------- | ----------------------------------- | ---- | ---------------------- |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理
员
应用。 |
| enterpriseInfo |
[
EnterpriseInfo
](
#enterpriseinfo
)
| 是 | 设备管理
员
应用的企业信息。 |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理应用。 |
| enterpriseInfo |
[
EnterpriseInfo
](
#enterpriseinfo
)
| 是 | 设备管理应用的企业信息。 |
| callback | AsyncCallback
\<
void>; | 是 | 回调函数,当接口调用成功,err为null,否则为错误对象。 |
**错误码**
:
以下
的错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
以下
错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
。
| 错误码ID | 错误信息 |
| ------- | ----------------------------------------------------- |
...
...
@@ -616,7 +618,7 @@ adminManager.setEnterpriseInfo(wantTemp, enterpriseInfo, (err) => {
setEnterpriseInfo(admin: Want, enterpriseInfo: EnterpriseInfo): Promise
\<
void>;
设置指定
设备管理员应用的企业信息,使用Promise形式返回是否设置成功
。
设置指定
的设备管理应用的企业信息。使用promise异步回调
。
**需要权限:**
ohos.permission.SET_ENTERPRISE_INFO
...
...
@@ -628,18 +630,18 @@ setEnterpriseInfo(admin: Want, enterpriseInfo: EnterpriseInfo): Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 |
| -------------- | ----------------------------------- | ---- | ------------ |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理
员
应用 |
| enterpriseInfo |
[
EnterpriseInfo
](
#enterpriseinfo
)
| 是 | 设备管理
员
应用的企业信息 |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理应用 |
| enterpriseInfo |
[
EnterpriseInfo
](
#enterpriseinfo
)
| 是 | 设备管理应用的企业信息 |
**返回值:**
| 类型 | 说明 |
| ----------------- | --------------------- |
| Promise
\<
void> | 无返回结果的Promise对象。当设置设备管理
员应用企业信息失败时
会抛出错误对象。 |
| Promise
\<
void> | 无返回结果的Promise对象。当设置设备管理
应用企业信息失败时,
会抛出错误对象。 |
**错误码**
:
以下
的错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
以下
错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
。
| 错误码ID | 错误信息 |
| ------- | ----------------------------------------------------- |
...
...
@@ -666,7 +668,7 @@ adminManager.setEnterpriseInfo(wantTemp, enterpriseInfo).catch((err) => {
getEnterpriseInfo(admin: Want, callback: AsyncCallback
<
EnterpriseInfo
>
): void
获取指定
设备管理员应用的企业信息,使用callback形式返回设备管理员应用的企业信息
。
获取指定
的设备管理应用的企业信息。使用callback异步回调
。
**系统能力:**
SystemCapability.Customization.EnterpriseDeviceManager
...
...
@@ -676,12 +678,12 @@ getEnterpriseInfo(admin: Want, callback: AsyncCallback<EnterpriseInfo>): v
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ------------------------ |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理
员
应用 |
| callback | AsyncCallback
<
[EnterpriseInfo](#enterpriseinfo)
>
| 是 | 回调函数,当接口调用成功,err为null,data为设备管理
员
应用的企业信息,否则err为错误对象。 |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理应用 |
| callback | AsyncCallback
<
[EnterpriseInfo](#enterpriseinfo)
>
| 是 | 回调函数,当接口调用成功,err为null,data为设备管理应用的企业信息,否则err为错误对象。 |
**错误码**
:
以下
的错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
以下
错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
。
| 错误码ID | 错误信息 |
| ------- | ----------------------------------------------------- |
...
...
@@ -708,7 +710,7 @@ adminManager.getEnterpriseInfo(wantTemp, (err, result) => {
getEnterpriseInfo(admin: Want): Promise
<
EnterpriseInfo
>
获取指定
设备管理员应用的企业信息,使用Promise形式返回设备管理员应用的企业信息
。
获取指定
的设备管理应用的企业信息,使用promise异步回调
。
**系统能力:**
SystemCapability.Customization.EnterpriseDeviceManager
...
...
@@ -718,17 +720,17 @@ getEnterpriseInfo(admin: Want): Promise<EnterpriseInfo>
| 参数名 | 类型 | 必填 | 说明 |
| ----- | ----------------------------------- | ---- | ------- |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理
员
应用 |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理应用 |
**返回值:**
| 类型 | 说明 |
| ---------------------------------------- | ------------------------- |
| Promise
<
[EnterpriseInfo](#enterpriseinfo)
>
| Promise对象,返回指定
设备管理员
应用的企业信息。 |
| Promise
<
[EnterpriseInfo](#enterpriseinfo)
>
| Promise对象,返回指定
的设备管理
应用的企业信息。 |
**错误码**
:
以下
的错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
以下
错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
。
| 错误码ID | 错误信息 |
| ------- | ----------------------------------------------------- |
...
...
@@ -753,7 +755,7 @@ adminManager.getEnterpriseInfo(wantTemp).then((result) => {
subscribeManagedEvent(admin: Want, managedEvents: Array
\<
ManagedEvent>, callback: AsyncCallback
\<
void>): void
指定
设备管理员应用订阅系统管理事件。使用callback形式返回结果
。
指定
的设备管理应用订阅系统管理事件。使用callback异步回调
。
**需要权限:**
ohos.permission.ENTERPRISE_SUBSCRIBE_MANAGED_EVENT
...
...
@@ -765,13 +767,13 @@ subscribeManagedEvent(admin: Want, managedEvents: Array\<ManagedEvent>, callback
| 参数名 | 类型 | 必填 | 说明 |
| ----- | ----------------------------------- | ---- | ------- |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理
员
应用。 |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理应用。 |
| managedEvents | Array
\<
[
ManagedEvent
](
#managedevent
)
> | 是 | 订阅事件数组。 |
| callback | AsyncCallback
\<
void> | 是 | 回调函数,当接口调用成功,err为null,否则为错误对象。 |
**错误码**
:
以下
的错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
以下
错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
。
|错误码ID | 错误信息 |
| ------- | ----------------------------------------------------- |
...
...
@@ -800,7 +802,7 @@ adminManager.subscribeManagedEvent(wantTemp, events, (err) => {
subscribeManagedEvent(admin: Want, managedEvents: Array
\<
ManagedEvent>): Promise
\<
void>
指定
设备管理员应用订阅系统管理事件。使用Promise形式返回结果
。
指定
的设备管理应用订阅系统管理事件。使用Promise异步回调
。
**需要权限:**
ohos.permission.ENTERPRISE_SUBSCRIBE_MANAGED_EVENT
...
...
@@ -812,18 +814,18 @@ subscribeManagedEvent(admin: Want, managedEvents: Array\<ManagedEvent>): Promise
| 参数名 | 类型 | 必填 | 说明 |
| ----- | ----------------------------------- | ---- | ------- |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理
员
应用。 |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理应用。 |
| managedEvents | Array
\<
[
ManagedEvent
](
#managedevent
)
> | 是 | 订阅事件数组。 |
**返回值:**
| 类型 | 说明 |
| ----- | ----------------------------------- |
| Promise
\<
void> | 无返回结果的Promise对象。当指定
设备管理员应用订阅系统事件失败时
会抛出错误对象。 |
| Promise
\<
void> | 无返回结果的Promise对象。当指定
的设备管理应用订阅系统事件失败时,
会抛出错误对象。 |
**错误码**
:
以下
的错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
以下
错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
。
| 错误码ID | 错误信息 |
| ------- | ----------------------------------------------------- |
...
...
@@ -849,7 +851,7 @@ adminManager.subscribeManagedEvent(wantTemp, events).then(() => {
unsubscribeManagedEvent(admin: Want, managedEvents: Array
\<
ManagedEvent>, callback: AsyncCallback
\<
void>): void
指定
设备管理员应用取消订阅系统管理事件。使用callback形式返回结果
。
指定
的设备管理应用取消订阅系统管理事件。使用callback异步回调
。
**需要权限:**
ohos.permission.ENTERPRISE_SUBSCRIBE_MANAGED_EVENT
...
...
@@ -861,13 +863,13 @@ unsubscribeManagedEvent(admin: Want, managedEvents: Array\<ManagedEvent>, callba
| 参数名 | 类型 | 必填 | 说明 |
| ----- | ----------------------------------- | ---- | ------- |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理
员
应用。 |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理应用。 |
| managedEvents | Array
\<
[
ManagedEvent
](
#managedevent
)
> | 是 | 取消订阅事件数组。 |
| callback | AsyncCallback
\<
void> | 是 | 回调函数,当接口调用成功,err为null,否则为错误对象。 |
**错误码**
:
以下
的错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
以下
错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
。
| 错误码ID | 错误信息 |
| ------- | ----------------------------------------------------- |
...
...
@@ -896,7 +898,7 @@ adminManager.unsubscribeManagedEvent(wantTemp, events, (err) => {
unsubscribeManagedEvent(admin: Want, managedEvents: Array
\<
ManagedEvent>): Promise
\<
void>
指定
设备管理员应用取消订阅系统管理事件。使用Promise形式返回结果
。
指定
的设备管理应用取消订阅系统管理事件。使用promise异步回调
。
**需要权限:**
ohos.permission.ENTERPRISE_SUBSCRIBE_MANAGED_EVENT
...
...
@@ -908,18 +910,18 @@ unsubscribeManagedEvent(admin: Want, managedEvents: Array\<ManagedEvent>): Promi
| 参数名 | 类型 | 必填 | 说明 |
| ----- | ----------------------------------- | ---- | ------- |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理
员
应用。 |
| admin |
[
Want
](
js-apis-app-ability-want.md
)
| 是 | 设备管理应用。 |
| managedEvents | Array
\<
[
ManagedEvent
](
#managedevent
)
> | 是 | 取消订阅事件数组。 |
**返回值:**
| 类型 | 说明 |
| ----- | ----------------------------------- |
| Promise
\<
void> | 无返回结果的Promise对象。当指定设备管理
员应用取消订阅系统管理时间失败时
会抛出错误对象。 |
| Promise
\<
void> | 无返回结果的Promise对象。当指定设备管理
应用取消订阅系统管理事件失败时,
会抛出错误对象。 |
**错误码**
:
以下
的错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
以下
错误码的详细介绍请参见
[
企业设备管理错误码
](
../errorcodes/errorcode-enterpriseDeviceManager.md
)
。
| 错误码ID | 错误信息 |
| ------- | ----------------------------------------------------- |
...
...
@@ -943,7 +945,7 @@ adminManager.unsubscribeManagedEvent(wantTemp, events).then(() => {
## EnterpriseInfo
设备管理
员应用的企业信息
设备管理
应用的企业信息。
**系统能力:**
SystemCapability.Customization.EnterpriseDeviceManager
...
...
@@ -951,12 +953,12 @@ adminManager.unsubscribeManagedEvent(wantTemp, events).then(() => {
| 名称 | 类型 | 必填 | 说明 |
| ----------- | --------| ---- | ------------------------------- |
| name | string | 是 | 表示设备管理
员
应用所属企业的名称。 |
| description | string | 是 | 表示设备管理
员
应用所属企业的描述。 |
| name | string | 是 | 表示设备管理应用所属企业的名称。 |
| description | string | 是 | 表示设备管理应用所属企业的描述。 |
## AdminType
设备管理
员应用的管理员类型。
设备管理
应用的类型。
**系统能力:**
SystemCapability.Customization.EnterpriseDeviceManager
...
...
@@ -964,12 +966,12 @@ adminManager.unsubscribeManagedEvent(wantTemp, events).then(() => {
| 名称 | 值 | 说明 |
| ----------------- | ---- | ----- |
| ADMIN_TYPE_NORMAL | 0x00 | 普通
管理员
|
| ADMIN_TYPE_SUPER | 0x01 | 超级
管理员
|
| ADMIN_TYPE_NORMAL | 0x00 | 普通
设备管理应用。
|
| ADMIN_TYPE_SUPER | 0x01 | 超级
设备管理应用。
|
## ManagedEvent
可订阅系统管理事件。
可订阅
的
系统管理事件。
**系统能力:**
SystemCapability.Customization.EnterpriseDeviceManager
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录