使用 @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 的原生能力