屏幕亮度 brightness 1000+
接口声明
{ "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) 1060+
设置是否保持常亮状态
参数:
参数名 | 类型 | 必填 | 说明 |
---|
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}`)
}
})
后台运行限制
禁止使用。
后台运行详细用法参见后台运行 脚本。