屏幕亮度

說明：

• 從API Version 7 開始，該接口不再維護，推薦使用新接口[@ohos.brightness]。
• 本模塊首批接口從API version 3開始支持。后續版本的新增接口，采用上角標單獨標記接口的起始版本。

導入模塊

import brightness from '@system.brightness';

brightness.getValue

getValue(Object): void

獲得設備當前的屏幕亮度值。

系統能力： SystemCapability.PowerManager.DisplayPowerManager

參數：

success返回值：

示例：

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

參數：

示例：

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返回值：

示例：

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

參數：

示例：

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

參數：

示例：

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);            
      },        
    });    
  },
}

審核編輯 黃宇