Screen

基础信息说明

功能概述：提供设置与获取屏幕亮度、保持屏幕常亮的能力，支持回调结果与状态管理。

方法说明

参数说明

qg.setScreenBrightness(object)

qg.getScreenBrightness(object)

qg.setKeepScreenOn(object)

返回值说明

• 所有方法均通过参数中的回调或事件回调获取结果

回调结果说明

getScreenBrightness 回调参数

示例代码

// 设置屏幕亮度为 0.8
qg.setScreenBrightness({
  value: 0.8,
  success() {
    console.log('setScreenBrightness success')
  },
  fail(err) {
    console.log('setScreenBrightness fail', err)
  }
})

// 获取当前屏幕亮度
qg.getScreenBrightness({
  success(res) {
    console.log('current brightness:', res.value) // 0–1
  }
})

// 保持屏幕常亮
qg.setKeepScreenOn({
  keepScreenOn: true,
  success() {
    console.log('setKeepScreenOn success')
  }
})

注意事项

• 屏幕亮度用 0–1 的范围表示，但不同设备的亮度并不是连续可调的，可能只能按固定档位调整，因此实际生效的亮度可能和设置值略有差异。
• 保持常亮会增加能耗，请谨慎使用。