# 屏幕亮度 brightness

# 导入模块

import brightness from '@system.brightness';

# brightness.getValue(OBJECT)

获得设备当前的屏幕亮度值。

  • 参数
参数名 类型 必填 说明
success Function 成功回调。
fail Function 失败回调。
complete Function 执行结束后的回调。
  • success返回值
参数名 类型 说明
value number 屏幕亮度,取值为1-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 number 屏幕亮度,值为1-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.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}`)
  }
})