未验证 提交 7406f02c 编写于 作者: O openharmony_ci 提交者: Gitee

!21053 企业设备管理&传感器内容优化

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