接口声明

{"name": "system.brightness"}

导入模块

import brightness from '@system.brightness' 
或 
const brightness = require('@system.brightness')

接口定义

brightness.getValue(OBJECT)

获得当前屏幕亮度值

参数：

参数名	类型	必填	说明
success	Function	否	成功回调
fail	Function	否	失败回调
complete	Function	否	执行结束后的回调

success返回值：

参数值	类型	说明
value	Integer	屏幕亮度，取值范围0-255

示例：

brightness.getValue({
  success:function(data){
    console.log(`handling success, value = ${data.value}`)
  },
  fail: function(data, code){
    console.log(`handling fail, code = ${code}`)
  }
})

brightness.setValue(OBJECT)

设置当前屏幕亮度值

参数：

参数名	类型	必填	说明
value	Integer	是	屏幕亮度，取值范围0-255
success	Function	否	成功回调
fail	Function	否	失败回调
complete	Function	否	执行结束后的回调

示例：

brightness.setValue({
  value: 100,
  success: function () {
    console.log('handling success')
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

brightness.getMode(OBJECT)

获得当前屏幕亮度模式

参数：

参数名	类型	必填	说明
success	Function	否	成功回调
fail	Function	否	失败回调
complete	Function	否	执行结束后的回调

success返回值：

参数值	类型	说明
mode	Integer	0为手动调节屏幕亮度,1为自动调节屏幕亮度

示例：

brightness.getMode({
  success: function (data) {
    console.log(`handling success, mode = ${data.mode}`)
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

brightness.setMode(OBJECT)

设置当前屏幕亮度模式

参数：

参数名	类型	必填	说明
mode	Integer	是	0为手动调节屏幕亮度,1为自动调节屏幕亮度
success	Function	否	成功回调
fail	Function	否	失败回调
complete	Function	否	执行结束后的回调

示例：

brightness.setMode({
  mode: 1,
  success: function () {
    console.log('handling success')
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

brightness.setKeepScreenOn(OBJECT)

设置是否保持常亮状态

参数：

参数名	类型	必填	说明
keepScreenOn	Boolean	是	是否保持屏幕常亮
success	Function	否	成功回调
fail	Function	否	失败回调
complete	Function	否	执行结束后的回调

示例：

brightness.setKeepScreenOn({
  keepScreenOn: true,
  success: function() {
    console.log('handling success')
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

后台运行限制

禁止使用。

后台运行详细用法参见 后台运行脚本。