@capacitor-community/screen-brightness

中文文档
8.0.0发布于 2025/12/26MITTypeScriptESM + CJS零依赖近 30 天下载 13.2万

ios and android上的控制屏幕亮度

中文使用文档
文档目录9 节
  1. 屏幕亮度
  2. 版本数
  3. 安装
  4. 配置
  5. 使用量
  6. API 密码
  7. 设置亮度(...)
  8. 获取亮度( )
  9. 接口


屏幕亮度

@capacitor-community/screen-brightness

在iOS和Android设备上控制屏幕亮度的电容社区插件.


版本数

插件电容文档
8.x 电话8.x 电话读取
7.x 电话7.x 电话读取
6.x (单位:千美元)6.x (单位:千美元)读取
5.x 电话5.x 电话读取
4.x (中文(简体) )4.x (中文(简体) )读取
1.x 运算3.x 运算读取

安装

npm install @capacitor-community/screen-brightness
npx cap sync

配置

此插件不需要配置

使用量

import { ScreenBrightness } from '@capacitor-community/screen-brightness';

// Set the brightness:
const brightness = 0.5;
await ScreenBrightness.setBrightness({ brightness });

// Get the current brightness:
const {brightness: currentBrightness} = await ScreenBrightness.getBrightness();

API 密码

设置亮度(...)

setBrightness(options: SetBrightnessOptions) => Promise<void>

设置亮度级别。 在iOS上,它设置了系统级别亮度,在Android上,它设置了当前视图的亮度.

参数类型说明
optionsSetBrightnessOptions设置亮度的选项

自: 1.0.0 (单位:千美元)


获取亮度( )

getBrightness() => Promise<GetBrightnessReturnValue>

返回信息而不是包含当前亮度级别

  • @ 自 1. 0

回返情况: Promise<GetBrightnessReturnValue>


接口

设置亮度选项

Prop类型说明自兹
brightnessnumber将亮度设置为从 0.0( 非常暗)到 1.0( 完全亮度) 的级别 在Android上,将值设置为-1恢复用户配置的亮度.1.0.0 (单位:千美元)

获得光速返回值

Prop类型说明自兹
brightnessnumber当前亮度水平,从0.0(非常暗)到1.0(完全亮度) 在Android上,如果该应用没有更改值,则返回 -1 .1.0.0 (单位:千美元)

版本与发布记录

@capacitor-community/screen-brightness 共发布 9 个版本,首次发布于 2021/02/25;过去 12 个月发布了 1 个版本。

版本发布日期距今
8.0.0latest2025/12/2610 个月前
7.0.02025/01/241.8 年前
6.0.02024/04/182 年前
5.0.02023/05/053 年前
4.0.02022/10/224 年前
2.0.0-0next2022/08/054 年前

关于 @capacitor-community/screen-brightness 的常见问题

@capacitor-community/screen-brightness 是什么?

ios and android上的控制屏幕亮度

如何安装 @capacitor-community/screen-brightness?

在项目目录运行 npm install @capacitor-community/screen-brightness,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@capacitor/core(>=8.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@capacitor-community/screen-brightness 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@capacitor-community/screen-brightness 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@capacitor-community/screen-brightness 可以商用吗?

@capacitor-community/screen-brightness 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@capacitor-community/screen-brightness 的下载量有多少?

根据 npm 官方下载统计,@capacitor-community/screen-brightness 在 2026/10/09 – 2026/11/07 这 30 天内被下载 131,689 次,日均约 4,390 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@capacitor-community/screen-brightness 还在维护吗?

最新版本 8.0.0 发布于 2025/12/26(10 个月前);至今共发布 9 个版本,其中过去 12 个月发布了 1 个;首次发布于 2021/02/25。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。