跳过主要内容
@capgo/capacitor-亮度 设备API 开源

亮度 Capacitor 插件

支持程序化控制设备屏幕亮度,包括应用程序和系统级控制

安装

bun add @capgo/capacitor-brightness bunx cap sync
npm、pnpm 或 yarn
  • npm install @capgo/capacitor-brightness
  • pnpm add @capgo/capacitor-brightness
  • yarn add @capgo/capacitor-brightness

指南

如何在Capacitor中使用亮度

在设备上测试

下载Capgo应用程序,然后扫描code的二维码

亮度插件预览二维码 code

使用 @capgo/capacitor-亮度

在 iOS 和 Android 上控制屏幕亮度。

安装

bun add @capgo/capacitor-brightness
bunx cap sync

bunx cap sync 将插件的本机 code 复制到您的本机项目中。每次升级插件后都重新运行它。

导入

import { CapgoBrightness } from '@capgo/capacitor-brightness';

快速浏览 API

方法 描述
getBrightness 获取设备主屏幕当前亮度。
setBrightness 设置设备主屏幕亮度。
getSystemBrightness 获取系统屏幕亮度。
setSystemBrightness 设置系统屏幕亮度。需要在 Android 上授予 WRITE_SETTINGS 权限。此操作也会将亮度模式更改为手动模式。
getSystemBrightnessMode 获取当前系统亮度模式(自动或手动)。需要在 Android 上授予 WRITE_SETTINGS 权限。
setSystemBrightnessMode 设置系统亮度模式(自动或手动)。需要在 Android 上授予 WRITE_SETTINGS 权限。
isUsingSystemBrightness 检查当前活动是否使用系统屏幕亮度值。
restoreSystemBrightness 将当前活动的亮度设置重置为使用系统屏幕值。
isAvailable 检查设备上是否支持 Brightness API。
checkPermissions 检查用户是否有权限访问系统屏幕亮度。
requestPermissions 请求访问系统屏幕亮度的权限。在 Android 上,这会打开系统设置以授予 WRITE_SETTINGS 权限。

示例

getBrightness()

获取设备主屏幕的当前亮度。

import { CapgoBrightness } from '@capgo/capacitor-brightness';

const result = await CapgoBrightness.getBrightness();
console.log(result);

setBrightness()

设置设备主屏幕的亮度。

import { CapgoBrightness } from '@capgo/capacitor-brightness';

await CapgoBrightness.setBrightness({ brightness: 0.5 });

getSystemBrightness()

获取系统全局屏幕亮度。

import { CapgoBrightness } from '@capgo/capacitor-brightness';

const result = await CapgoBrightness.getSystemBrightness();
console.log(result);

setSystemBrightness()

设置系统全局屏幕亮度。需要在 Android 上具有 WRITE_SETTINGS 权限。这也会将亮度模式更改为手动。

import { CapgoBrightness } from '@capgo/capacitor-brightness';

await CapgoBrightness.setSystemBrightness({ brightness: 0.5 });

getSystemBrightnessMode()

获取当前系统亮度模式(自动或手动)。需要在 Android 上具有 WRITE_SETTINGS 权限。

import { CapgoBrightness } from '@capgo/capacitor-brightness';

const result = await CapgoBrightness.getSystemBrightnessMode();
console.log(result);

setSystemBrightnessMode()

设置系统亮度模式(自动或手动)。需要在 Android 上具有 WRITE_SETTINGS 权限。

import { CapgoBrightness, BrightnessMode } from '@capgo/capacitor-brightness';

await CapgoBrightness.setSystemBrightnessMode({ mode: BrightnessMode.AUTOMATIC });

上表列出了 11 个核心方法。监听器和版本辅助函数,以及每个方法的完整契约,均在 GitHub 仓库.

完整参考

从使用@capgo/capacitor-亮度继续

如果您正在使用 使用@capgo/capacitor-亮度 为了规划原生媒体和界面行为,连接它与 @capgo/capacitor-亮度 在@capgo/capacitor-亮度中实现详细信息 入门 在入门中实现详细信息 使用@capgo/capacitor-实时活动 为原生能力在使用@capgo/capacitor-实时活动中 @capgo/capacitor-实时活动 为 @capgo/capacitor-live-activities 的实现细节 使用 @capgo/capacitor-video-player 为使用 @capgo/capacitor-video-player 的原生能力

常见问题

亮度插件FAQ

如何在Capacitor应用中安装亮度插件?

Run "bun add @capgo/capacitor-brightness" (or "npm install @capgo/capacitor-brightness"), then run "bunx cap sync" so the iOS and Android projects pick up the native code. Import it from "@capgo/capacitor-brightness" in your app code.

@capgo/capacitor-brightness 与 React、Vue 和 Angular 是否兼容?

是的。亮度是一个 Capacitor 包,因此它与任何在 Capacitor 内部运行的 Web 框架兼容,包括 Ionic、React、Vue、Angular、Svelte 和普通 JavaScript。

哪个 Capacitor 版本支持 @capgo/capacitor-brightness?

Capgo 插件遵循 Capacitor 的主要版本:使用与 Capacitor 主要版本匹配的插件主要版本(例如插件 v8 与 Capacitor 8)。在 GitHub README 中的兼容性表格列出了维护的版本。

@capgo/capacitor-brightness 是否免费和开源?

是的。code 的源代码在 GitHub 上公开,地址为 https://github.com/Cap-go/capacitor-brightness/,并且该包从 npm 免费安装。欢迎 bug 报告和拉取请求。

是否可以在不经过 App Store 审核的情况下更新使用 Brightness 的 code?

安装或升级插件会更改本地 code,因此需要新建一个商店构建。之后,调用插件的 JavaScript、HTML 和 CSS 更改可以立即通过 Capgo 实时更新发布。

不必等待应用程序审查即可将亮度变化推送

一旦插件在您的商店构建中,Capgo即刻更新将将您的JavaScript、HTML和CSS更改推送给用户。

开始使用Capgo