概览
“概览”章节通过代码控制设备屏幕亮度，支持应用级及系统级控制
从这里开始 getBrightness() 以及下方列出的其他核心方法。
平台支持
标题为“平台支持”的部分| 平台 | 支持 | 备注 |
|---|---|---|
| iOS | 是 | 原生 |
| Android | 是 | 原生 |
| Web 端 | 否 | 使用 Capacitor.getPlatform() 做保护 |
核心功能
标题为“核心功能”的章节getBrightness- 获取设备主屏幕当前的亮度值。setBrightness- 设置设备主屏幕的亮度值。getSystemBrightness- 获取系统级屏幕亮度。setSystemBrightness- 设置系统级屏幕亮度。在 Android 上需要 WRITE_SETTINGS 权限。此操作还会将亮度模式更改为 MANUAL。
公开 API
标题为“公开 API”的章节| 方法 | 描述 |
|---|---|
getBrightness | 获取设备主屏幕当前的亮度值。 |
setBrightness | 设置设备主屏幕的亮度值。 |
getSystemBrightness | 获取系统级屏幕亮度。 |
setSystemBrightness | 设置系统级屏幕亮度。Android 端需要 WRITE_SETTINGS 权限。此操作会将亮度模式切换为 MANUAL。 |
getSystemBrightnessMode | 获取当前系统亮度模式（automatic 或 manual）。Android 端需要 WRITE_SETTINGS 权限。 |
setSystemBrightnessMode | 设置系统亮度模式（automatic 或 manual）。Android 端需要 WRITE_SETTINGS 权限。 |
isUsingSystemBrightness | 检查当前 Activity 是否正在使用系统级亮度值。 |
restoreSystemBrightness | 将当前 Activity 的亮度设置重置为使用系统级亮度值。 |
isAvailable | 检查当前设备是否支持 Brightness API。 |
checkPermissions | 检查用户是否拥有访问系统亮度的权限。 |
requestPermissions | 请求访问系统亮度的权限。在 Android 上，这会打开系统设置以授予 WRITE_SETTINGS 权限。 |
getPluginVersion | 获取原生插件版本。 |
单一事实来源
标题为“单一事实来源”的部分此参考文档同步自 src/definitions.ts 中的 capacitor-brightness.
继续探索 @capgo/capacitor-brightness
标题为“继续探索 @capgo/capacitor-brightness”的部分如果你正在使用 @capgo/capacitor-brightness 来规划原生媒体和界面行为，并将其与 使用 @capgo/capacitor-brightness 在使用 @capgo/capacitor-brightness 时，调用原生能力： 使用 @capgo/capacitor-live-activities 用于使用 @capgo/capacitor-live-activities 时的原生能力， @capgo/capacitor-live-activities 在 @capgo/capacitor-live-activities 中的实现细节， 使用 @capgo/capacitor-video-player 有关使用 @capgo/capacitor-video-player 时的原生能力，以及 @capgo/capacitor-video-player 关于 @capgo/capacitor-video-player. 中的实现细节
