harmony 鸿蒙@system.brightness (屏幕亮度)

  • 2022-08-09
  • 浏览 (1210)

@system.brightness (屏幕亮度)

该模块提供屏幕亮度和模式的查询、调节接口。

说明:

  • 从API Version 7 开始不再维护。建议使用@ohos.brightness替代,替代接口能力仅对系统应用开放。
  • 本模块首批接口从API version 3开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

导入模块

import brightness, { BrightnessModeResponse, BrightnessResponse } from '@system.brightness';

brightness.getValue

getValue(options?: GetBrightnessOptions): void

获得设备当前的屏幕亮度值。

系统能力: SystemCapability.PowerManager.DisplayPowerManager.Lite

参数:

参数名 类型 必填 说明
options GetBrightnessOptions 获取屏幕亮度的参数对象。可选,默认为空。

示例:

  brightness.getValue({
      success: (data: BrightnessResponse) => {
        console.log('success get brightness value:' + data.value);
      },
      fail: (data: string, code: number) => {
        console.error('get brightness fail, code: ' + code + ', data: ' + data);
      }
  });

brightness.setValue

setValue(options?: SetBrightnessOptions): void

设置设备当前的屏幕亮度值。

系统能力: SystemCapability.PowerManager.DisplayPowerManager.Lite

参数:

参数名 类型 必填 说明
options SetBrightnessOptions 设置屏幕亮度的参数对象。可选,默认为空。

示例:

  brightness.setValue({
      value: 100,
      success: () => {
        console.log('handling set brightness success.');
      },
      fail: (data: string, code: number) => {
        console.error('handling set brightness value fail, code:' + code + ', data: ' + data);
      }
  });

brightness.getMode

getMode(options?: GetBrightnessModeOptions): void

获得当前屏幕亮度模式。

系统能力: SystemCapability.PowerManager.DisplayPowerManager.Lite

参数:

参数名 类型 必填 说明
options GetBrightnessModeOptions 获取屏幕亮度模式的参数对象。可选,默认为空。

示例:

  brightness.getMode({
      success: (data: BrightnessModeResponse) => {
        console.log('success get mode:' + data.mode);
      },
      fail: (data: string, code: number) => {
        console.error('handling get mode fail, code:' + code + ', data: ' + data);
      }
  });

brightness.setMode

setMode(options?: SetBrightnessModeOptions): void

设置设备当前的屏幕亮度模式。

系统能力: SystemCapability.PowerManager.DisplayPowerManager.Lite

参数: |参数名|类型|必填|说明| |——–|——–|——–|——–| |options|SetBrightnessModeOptions|否 |设置屏幕亮度模式的参数对象。可选,默认为空。|

示例:

  brightness.setMode({
      mode: 1,
      success: () => {
        console.log('handling set mode success.');
      },
      fail: (data: string, code: number) => {
        console.error('handling set mode fail, code:' + code + ', data: ' + data);
      }
  });

brightness.setKeepScreenOn

setKeepScreenOn(options?: SetKeepScreenOnOptions): void

从API version 7开始不再维护,建议使用window.setKeepScreenOn替代。

设置屏幕是否保持常亮状态,开启常亮模式推荐在onShow()阶段调用。

系统能力: SystemCapability.PowerManager.DisplayPowerManager.Lite

参数:

参数名 类型 必填 说明
options SetKeepScreenOnOptions 设置屏幕常亮的参数对象。可选,默认为空。

示例:

  brightness.setKeepScreenOn({
      keepScreenOn: true,
      success: () => {
        console.log('handling set keep screen on success.');
      },
      fail: (data: string, code: number) => {
        console.error('handling set keep screen on fail, code:' + code + ', data: ' + data);
      }
  });

GetBrightnessOptions

获取屏幕亮度的参数对象。

系统能力: SystemCapability.PowerManager.DisplayPowerManager.Lite

名称 类型 必填 说明
success (data: BrightnessResponse) => void 接口调用成功的回调函数。data为BrightnessResponse类型的返回值。
fail (data: string, code: number) => void 接口调用失败的回调函数。data为错误信息,code为错误码。
complete () => void 接口调用结束的回调函数。

SetBrightnessOptions

设置屏幕亮度的参数对象。

系统能力: SystemCapability.PowerManager.DisplayPowerManager.Lite

名称 类型 必填 说明
value number 屏幕亮度,值为1-255之间的整数。
- 如果值小于等于0,系统按1处理。
- 如果值大于255,系统按255处理。
- 如果值为小数,系统将处理为整数。例如设置为8.1,系统按8处理。
success () => void 接口调用成功的回调函数。
fail (data: string, code: number) => void 接口调用失败的回调函数。data为错误信息,code为错误码。
complete () => void 接口调用结束的回调函数。

BrightnessResponse

包含屏幕亮度的对象。

系统能力: SystemCapability.PowerManager.DisplayPowerManager.Lite

名称 类型 可读 可写 说明
value number 屏幕亮度,范围:1到255。

GetBrightnessModeOptions

获取屏幕亮度模式的参数对象。

系统能力: SystemCapability.PowerManager.DisplayPowerManager.Lite

名称 类型 必填 说明
success (data: BrightnessModeResponse) => void 接口调用成功的回调函数。data为BrightnessModeResponse类型的返回值。
fail (data: string, code: number) => void 接口调用失败的回调函数。data为错误信息,code为错误码。
complete () => void 接口调用结束的回调函数。

SetBrightnessModeOptions

设置屏幕亮度模式的参数对象。

系统能力: SystemCapability.PowerManager.DisplayPowerManager.Lite

名称 类型 必填 说明
mode number 0表示手动调节屏幕亮度模式,1表示自动调节屏幕亮度模式。
success () => void 接口调用成功的回调函数。
fail (data: string, code: number) => void 接口调用失败的回调函数。data为错误信息,code为错误码。
complete () => void 接口调用结束的回调函数。

BrightnessModeResponse

包含屏幕亮度模式的对象。

系统能力: SystemCapability.PowerManager.DisplayPowerManager.Lite

名称 类型 可读 可写 说明
mode number 0表示手动调节屏幕亮度模式,1表示自动调节屏幕亮度模式。

SetKeepScreenOnOptions

设置屏幕常亮的参数对象。

系统能力: SystemCapability.PowerManager.DisplayPowerManager.Lite

名称 类型 必填 说明
keepScreenOn boolean true表示保持屏幕常亮,false表示取消屏幕常亮。
success () => void 接口调用成功的回调函数。
fail (data: string, code: number) => void 接口调用失败的回调函数。data为错误信息,code为错误码。
complete () => void 接口调用结束的回调函数。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙接口

harmony 鸿蒙系统公共事件定义(待停用)

harmony 鸿蒙系统公共事件定义

harmony 鸿蒙开发说明

harmony 鸿蒙企业设备管理概述(仅对系统应用开放)

harmony 鸿蒙BundleStatusCallback

harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager模块)

harmony 鸿蒙@ohos.distributedBundle (分布式包管理)

harmony 鸿蒙@ohos.bundle (Bundle模块)

harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (企业设备管理扩展能力)

0  赞