自学内容网 自学内容网

鸿蒙语言基础类库:【@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点击或者复制转到。类型必填说明
successFunction接口调用成功的回调函数。
failFunction接口调用失败的回调函数。
completeFunction接口调用结束的回调函数。

success返回值:

参数名类型说明
valuenumber屏幕亮度,取值为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

参数:

参数名类型必填说明
valuenumber屏幕亮度,值为1-255之间的整数。 - 如果值小于等于0,系统按1处理。 - 如果值大于255,系统按255处理。 - 如果值为小数,系统将处理为整数。例如设置为8.1,系统按8处理。
successFunction接口调用成功的回调函数。
failFunction接口调用失败的回调函数。
completeFunction接口调用结束的回调函数。

示例:

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

参数:

参数名类型必填说明
successFunction接口调用成功的回调函数。
failFunction接口调用失败的回调函数。
completeFunction接口调用结束的回调函数。

success返回值:

参数名类型说明
modenumber值为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

参数:

参数名类型必填说明
modenumber值为0或1 - 0为手动调节屏幕亮度 - 1为自动调节屏幕亮度
successFunction接口调用成功的回调函数。
failFunction接口调用失败的回调函数。
completeFunction接口调用结束的回调函数。

示例:

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

参数:

参数名类型必填说明
keepScreenOnboolean是否保持屏幕常亮。
successFunction接口调用成功的回调函数。
failFunction接口调用失败的回调函数。
completeFunction接口调用结束的回调函数。

示例:

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)!