系统函数

系统设置

4 个函数

设置屏幕亮度

System.setBrightness(value: integer): integer

把设备屏幕亮度设置为0到255，并关闭自动亮度。

参数1 项
序号名称类型参数说明
1 value 整 目标亮度，允许范围0到255。
返回值返回值可以不接收
序号名称类型返回说明
1 执行状态 整 设置成功返回0，失败返回-1。

设置自动熄屏时间

System.setScreenTimeout(durationMs: integer): integer

设置设备无操作后自动熄屏的等待时间。

参数1 项
序号名称类型参数说明
1 durationMs 整 等待毫秒数，允许范围1000到2147483647。
返回值返回值可以不接收
序号名称类型返回说明
1 执行状态 整 设置成功返回0，失败返回-1。

设置系统日期时间

System.setDateTime(year: integer, month: integer, day: integer, hour: integer, minute: integer, second: integer): integer

按年、月、日、时、分、秒修改整台设备的系统时间。必须具备Root权限；调用成功后会关闭系统自动确定时间，防止结果立即被覆盖。

参数6 项
序号名称类型参数说明
1 year 整 四位年份，范围1970到2099。
2 month 整 月份，范围1到12。
3 day 整 当月日期，必须符合指定年月。
4 hour 整 小时，使用24小时制，范围0到23。
5 minute 整 分钟，范围0到59。
6 second 整 秒，范围0到59。
返回值返回值可以不接收
序号名称类型返回说明
1 执行状态 整 成功返回0，参数或执行失败返回-1，没有Root权限返回-2。

打开系统设置

System.openSettings(page: string): integer

根据页面名称打开网络、Wi-Fi、移动网络、无障碍、悬浮窗、本应用详情、电池优化、通知或修改系统设置页面。函数只负责打开页面，不会自动更改开关。

参数1 项
序号名称类型参数说明
1 page 字 要打开的系统设置页。
返回值返回值可以不接收
序号名称类型返回说明
1 执行状态 整 成功提交打开设置页返回0，失败返回-1。