鸿蒙语言基础类库:【@system.brightness (屏幕亮度)】
屏幕亮度
说明:
- 从API Version 7 开始,该接口不再维护,推荐使用新接口[
@ohos.brightness
]。- 本模块首批接口从API version 3开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
导入模块
import brightness from '@system.brightness';
brightness.getValue
getValue(Object): void
获得设备当前的屏幕亮度值。
系统能力: SystemCapability.PowerManager.DisplayPowerManager
参数:
参数名 开发前请熟悉鸿蒙开发指导文档:gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md 点击或者复制转到。 | 类型 | 必填 | 说明 |
---|---|---|---|
success | Function | 否 | 接口调用成功的回调函数。 |
fail | Function | 否 | 接口调用失败的回调函数。 |
complete | Function | 否 | 接口调用结束的回调函数。 |
success返回值:
参数名 | 类型 | 说明 |
---|---|---|
value | number | 屏幕亮度,取值为1-255之间的整数。 |
示例:
export default {
getValue() {
brightness.getValue({
success: function(data){
console.log('success get brightness value:' + data.value);
},
fail: function(data, code) {
console.log('get brightness fail, code: ' + code + ', data: ' + data);
},
});
},
}
brightness.setValue
setValue(Object): void
设置设备当前的屏幕亮度值。
系统能力: SystemCapability.PowerManager.DisplayPowerManager
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
value | number | 是 | 屏幕亮度,值为1-255之间的整数。 - 如果值小于等于0,系统按1处理。 - 如果值大于255,系统按255处理。 - 如果值为小数,系统将处理为整数。例如设置为8.1,系统按8处理。 |
success | Function | 否 | 接口调用成功的回调函数。 |
fail | Function | 否 | 接口调用失败的回调函数。 |
complete | Function | 否 | 接口调用结束的回调函数。 |
示例:
export default {
setValue() {
brightness.setValue({
value: 100,
success: function(){
console.log('handling set brightness success.');
},
fail: function(data, code){
console.log('handling set brightness value fail, code:' + code + ', data: ' + data);
},
});
},
}
brightness.getMode
getMode(Object): void
获得当前屏幕亮度模式。
系统能力: SystemCapability.PowerManager.DisplayPowerManager
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
success | Function | 否 | 接口调用成功的回调函数。 |
fail | Function | 否 | 接口调用失败的回调函数。 |
complete | Function | 否 | 接口调用结束的回调函数。 |
success返回值:
参数名 | 类型 | 说明 |
---|---|---|
mode | number | 值为0或1: - 0为手动调节屏幕亮度模式 - 1为自动调节屏幕亮度模式 |
示例:
export default {
getMode() {
brightness.getMode({
success: function(data){
console.log('success get mode:' + data.mode);
},
fail: function(data, code){
console.log('handling get mode fail, code:' + code + ', data: ' + data);
},
});
},
}
brightness.setMode
setMode(Object): void
设置设备当前的屏幕亮度模式。
系统能力: SystemCapability.PowerManager.DisplayPowerManager
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
mode | number | 是 | 值为0或1 - 0为手动调节屏幕亮度 - 1为自动调节屏幕亮度 |
success | Function | 否 | 接口调用成功的回调函数。 |
fail | Function | 否 | 接口调用失败的回调函数。 |
complete | Function | 否 | 接口调用结束的回调函数。 |
示例:
export default {
setMode() {
brightness.setMode({
mode: 1,
success: function(){
console.log('handling set mode success.');
},
fail: function(data, code){
console.log('handling set mode fail, code:' + code + ', data: ' + data);
},
});
},
}
`HarmonyOS与OpenHarmony鸿蒙文档籽料:mau123789是v直接拿`
brightness.setKeepScreenOn
setKeepScreenOn(Object): void
设置屏幕是否保持常亮状态,开启常亮模式推荐在onShow()阶段调用。
系统能力: SystemCapability.PowerManager.DisplayPowerManager
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
keepScreenOn | boolean | 是 | 是否保持屏幕常亮。 |
success | Function | 否 | 接口调用成功的回调函数。 |
fail | Function | 否 | 接口调用失败的回调函数。 |
complete | Function | 否 | 接口调用结束的回调函数。 |
示例:
export default {
setKeepScreenOn() {
brightness.setKeepScreenOn({
keepScreenOn: true,
success: function () {
console.log('handling set keep screen on success.')
},
fail: function (data, code) {
console.log('handling set keep screen on fail, code:' + code + ', data: ' + data);
},
});
},
}
原文地址:https://blog.csdn.net/2301_76813281/article/details/140442931
免责声明:本站文章内容转载自网络资源,如本站内容侵犯了原著者的合法权益,可联系本站删除。更多内容请关注自学内容网(zxcms.com)!