# 屏幕亮度 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}`)
}
})