@ capgo/ 电容- 轻快
从您的 Capacitor app 读取并设置屏幕亮度, 例如在显示 QR 代码或 票 时显示屏幕亮度 。 在Android上,也可以控制系统亮度及其自动模式.
🤖 建筑与AI编码代理? 安装 Capgo 技能 所以克劳德代码,代码,光标,副驾驶,或双子座CLI知道如何安装和使用
@capgo/capacitor-brightness在您的电容应用程序中:npx skills add Cap-go/capgo-skills。然后问你的经纪人: 添加@capgo/capor-braightness到我的Capacitor应用上,并把它接上" 代理设置指南 • 妇女 主机磁共振
主要特点
- 应用亮度数字 :
getBrightness()财务报告和审定财务报表setBrightness()用于iOS和Android上的当前屏幕. - 系统亮度数字 :
getSystemBrightness()财务报告和审定财务报表setSystemBrightness()安卓号. - 亮度模式数字 :
getSystemBrightnessMode()财务报告和审定财务报表setSystemBrightnessMode()在Android上自动和手动之间切换. - 恢复数字 :
restoreSystemBrightness()手控制回系统,isUsingSystemBrightness()请检查当前状态 . - 权限数字 :
checkPermissions()财务报告和审定财务报表requestPermissions()安卓系统设置访问. - 平台: iOS和Android. 互联网档案馆的存檔,存档日期2013-12-22. 系统亮度和模式仅为Android. 在网上不可用.
为什么Capacitor亮?
唯一提供电容的插件 完全亮度控制 用于iOS和Android:
- App 级别亮度 - 在不影响系统设置的情况下控制活动亮度
- 系统级亮度 - 修改全球设备亮度(Android)
- 自动/ 手动模式 - 在自动和手动亮度模式之间切换(Android)
- 权限处理 - 支持WRITE SETTINGS权限流
- 跨平台 - 一致的API跨iOS和Android
用于阅读应用程序,视频播放器,相机应用程序,以及需要屏幕亮度控制的任何应用程序.
文档
可在下列地点查阅完整文件: https://capgo.app/docs/plugins/brightness/ 页面存档备份,存于互联网档案馆
兼容性
| 插件版本 | 电容兼容性 | 维护 |
|---|---|---|
| 联合国 | 联合国 | ✅ |
| 页:1 | 页:1 | 应要求 |
| 页:1 | 页:1 | ❌ |
| 页:1 | 页:1 | ❌ |
说明: 此插件的主要版本沿用了Capacitor的主要版本. 使用匹配您的 Capacitor 安装的版本( 如 Capacitor 8 的插件 v8) 。 只有最新的主要版本得到积极维护.
安装
您可以使用我们的 AI 辅助设置安装插件 。 使用以下命令将 Capgo 技能添加到您的 AI 工具 :
npx skills add https://github.com/cap-go/capacitor-skills --skill capacitor-plugins
然后使用下列提示:
Use the `capacitor-plugins` skill from `cap-go/capacitor-skills` to install the `@capgo/capacitor-brightness` plugin in my project.
如果您更喜欢手动设置,请通过运行以下命令来安装插件,并遵循下面的平台特定指令:
npm install @capgo/capacitor-brightness
npx cap sync
Android 配置
对于Android来说,如果想要修改系统亮度(不仅仅是应用亮度),就需要添加 WRITE_SETTINGS 允许您使用 AndroidManifest.xml数字 :
<uses-permission android:name="android.permission.WRITE_SETTINGS" />
注:此权限需要用户通过Android 6.0+上的系统设置确认.
所需资源
- iOS:iOS 15+ (使用UIScreen.braightness) (英语)
- Android: API 24+(用于应用程序亮度,设置的窗口管理器). 系统亮度系统)
API 密码
getBrightness()setBrightness(...)getSystemBrightness()setSystemBrightness(...)getSystemBrightnessMode()setSystemBrightnessMode(...)isUsingSystemBrightness()restoreSystemBrightness()isAvailable()checkPermissions()requestPermissions()getPluginVersion()- 接口
- 类型异名
- 数字
获取亮度( )
getBrightness() => Promise<GetBrightnessResult>
获取设备主屏幕当前亮度水平.
回返情况: Promise<GetBrightnessResult>
自: 8.0.0 (单位:千美元)
设置亮度(...)
setBrightness(options: SetBrightnessOptions) => Promise<void>
设置设备主屏幕的亮度级别 .
在iOS上,亮度会持续到设备被锁定. 在Android上,亮度仅适用于当前活性.
| 参数 | 类型 | 说明 |
|---|---|---|
options | SetBrightnessOptions | - 明亮的选择. |
自: 8.0.0 (单位:千美元)
获取系统亮度( C)
getSystemBrightness() => Promise<GetBrightnessResult>
获得全系统屏幕亮度.
回返情况: Promise<GetBrightnessResult>
自: 8.0.0 (单位:千美元)
系统亮度(...)
setSystemBrightness(options: SetBrightnessOptions) => Promise<void>
设置全系统屏幕亮度. 在Android上需要WRITE SETTINGS许可. 这也改变了亮度模式为MANAUAL.
| 参数 | 类型 | 说明 |
|---|---|---|
options | SetBrightnessOptions | - 明亮的选择. |
自: 8.0.0 (单位:千美元)
获取SystemBrightnessMode ()
getSystemBrightnessMode() => Promise<GetBrightnessModeResult>
获取当前系统亮度模式(自动或手动). 在Android上需要WRITE SETTINGS许可.
回返情况: Promise<GetBrightnessModeResult>
自: 8.0.0 (单位:千美元)
systemBrightness Mode(...) 系统亮度
setSystemBrightnessMode(options: SetBrightnessModeOptions) => Promise<void>
设置系统亮度模式(自动或手动). 在Android上需要WRITE SETTINGS许可.
| 参数 | 类型 | 说明 |
|---|---|---|
options | SetBrightnessModeOptions | - 亮度模式选项. |
自: 8.0.0 (单位:千美元)
是 Using 系统亮度( )
isUsingSystemBrightness() => Promise<IsUsingSystemBrightnessResult>
检查当前活动是否使用全系统亮度值 .
回返情况: Promise<IsUsingSystemBrightnessResult>
自: 8.0.0 (单位:千美元)
恢复系统亮度( C)
restoreSystemBrightness() => Promise<void>
重置当前活动的亮度设置以使用全系统值.
自: 8.0.0 (单位:千美元)
易读 ()
isAvailable() => Promise<IsAvailableResult>
检查当前设备是否有亮度 API .
回返情况: Promise<IsAvailableResult>
自: 8.0.0 (单位:千美元)
检查( )
checkPermissions() => Promise<PermissionStatus>
检查用户访问系统亮度的权限 .
回返情况: Promise<PermissionStatus>
自: 8.0.0 (单位:千美元)
请求( )
requestPermissions() => Promise<PermissionStatus>
请求访问系统亮度的权限 . 在Android上,这打开了系统设置,以授予WRITE SETTINGS权限.
回返情况: Promise<PermissionStatus>
自: 8.0.0 (单位:千美元)
获取 PluginVersion ()
getPluginVersion() => Promise<GetPluginVersionResult>
获取本地插件版本 .
回返情况: Promise<GetPluginVersionResult>
自: 8.0.0 (单位:千美元)
接口
获取亮度
获得Braightness或获得SystemBraightness的结果.
| Prop | 类型 | 说明 | 自兹 |
|---|---|---|---|
brightness | number | 亮度值从0到1. 0是最小亮度, 1是最大亮度. | 8.0.0 (单位:千美元) |
设置亮度选项
SetBraightness 或 setSystemBraightness 的选项 .
| Prop | 类型 | 说明 | 自兹 |
|---|---|---|---|
brightness | number | 亮度值从0到1. 0是最小亮度, 1是最大亮度. | 8.0.0 (单位:千美元) |
获取亮度模式
(原始内容存档于2017-10-21). Results of getSystemBrightness Mode.
| Prop | 类型 | 说明 | 自兹 |
|---|---|---|---|
mode | BrightnessMode | 当前亮度模式 . | 8.0.0 (单位:千美元) |
设置亮度模式选项
设置SystemBrightnessMode 的选项.
| Prop | 类型 | 说明 | 自兹 |
|---|---|---|---|
mode | BrightnessMode | 要设置的亮度模式 。 无法设置为 UNKNOWN . | 8.0.0 (单位:千美元) |
是Using系统亮度反应
结果是Using System Braightness(英语:Using System Braightness). 星洲网.
| Prop | 类型 | 说明 | 自兹 |
|---|---|---|---|
isUsing | boolean | 当前的活动是否使用全系统亮度值. | 8.0.0 (单位:千美元) |
易伤性结果
由此而来.
| Prop | 类型 | 说明 | 自兹 |
|---|---|---|---|
available | boolean | 当前设备中是否有亮度 API . | 8.0.0 (单位:千美元) |
权限状态
许可状态结果 .
| Prop | 类型 | 说明 | 自兹 |
|---|---|---|---|
brightness | PermissionState | 是否允许修改系统亮度 . | 8.0.0 (单位:千美元) |
获取 PluginVersion 结果
获取PluginVersion的结果.
| Prop | 类型 | 说明 | 自兹 |
|---|---|---|---|
version | string | 本地插件版本 . | 8.0.0 (单位:千美元) |
类型异名
权限状态
'prompt' | 'prompt-with-rationale' | 'granted' | 'denied'
数字
亮度模式
| 成员 | 数值 | 说明 | 自兹 |
|---|---|---|---|
UNKNOWN | 0 | 亮度模式不详. | 8.0.0 (单位:千美元) |
AUTOMATIC | 1 | 亮度由系统自动调整. | 8.0.0 (单位:千美元) |
MANUAL | 2 | 亮度由用户手动设置. | 8.0.0 (单位:千美元) |