MDM设备控制管理：如何设置息屏时间
==================

#### 问题现象

MDM应用需要自定义息屏时间，通过[deviceSettings.setValue](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-enterprise-devicesettings#devicesettingssetvalue)设置3秒延迟息屏不生效。

#### 背景知识

*   [MDM Kit（企业设备管理服务）](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/mdm-kit)提供企业设备管理服务接入和开发指南。
*   [@ohos.enterprise.deviceSettings （设备设置管理）](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-enterprise-devicesettings)本模块提供企业设备设置能力，包括设置、获取设备息屏时间等。

#### 解决方案

[deviceSettings](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-enterprise-devicesettings)模块提供企业设备设置能力，包括设置、获取设备息屏时间等。使用[deviceSettings.setValue](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-enterprise-devicesettings#devicesettingssetvalue)接口，item参数设置为screenOff，设置设备息屏策略。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c0/v3/bzAuYgyeQSqdxZW-8FjA_g/notice_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T134228Z&HW-CC-Expire=86400&HW-CC-Sign=1CE65F8705F667BBBBE9EFA3D121C0E795E8EC4B7F7C55D1FE0D48EEE5BE8235)

*   MDM应用开发需要[申请资质](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/mdm-kit-guide#申请资质)，并使用对应的证书和Profile才可以使用接口。
*   该接口使用需要ohos.permission.ENTERPRISE\_MANAGE\_SETTINGS权限。
*   目前手机/平板可设置息屏时间范围与系统设置中的可选时间一致。可通过“设置”->“显示和亮度”->“休眠”，查看系统支持的休眠时间，当前手机系统最短休眠时间为15s。
*   当前永不息屏只在2in1设备上接通电源时才能生效。

#### 常见FAQ

Q：MDM应用是否有与华为时间服务器同步时间的接口？

A：可以使用[getNTPServer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-enterprise-systemmanager#systemmanagergetntpserver)方法来获取时间，同步时间。

Q：MDM应用如何实现无限期授权？

A：只要激活，正常进行授权后，后续永久授权。

Q：如何快速确认接口使用失败原因？

A：通过try-catch的形式捕获错误信息，并根据[企业设备管理错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-enterprisedevicemanager)或[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)排查。

Q：deviceSettings.setValue接口，item为'screenOff'，设置值"0"，为何报错误码401？

A：item为'screenOff'时，息屏时间需是正整数（单位毫秒），设置值"0"会报错误码401，当前手机系统最短休眠时间为15s。