# @capgo/capacitor-flash 中文文档 规范地址：https://npmcn.com/package/%40capgo/capacitor-flash/ 版本：8\.0\.51 npm 元数据更新时间：2026-11-02T13:00:40.735Z 中文译文更新时间：2026-11-09T03:23:01.539Z 软件包许可：MPL-2\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40capgo/capacitor-flash 原文对照：https://npmcn.com/package/%40capgo/capacitor-flash/?lang=original 项目主页：https://capgo.app/docs/plugins/flash/ 源码仓库：https://github.com/Cap-go/capacitor-flash ## 关键信息（来自 npm 元数据） - 包体积（解压后）：74.7 kB，26 个文件 - 模块格式：ESM + CJS - TypeScript 类型：包内自带 - 运行依赖：0 个 - peer 依赖：@capacitor/core \>=8\.0\.0 - 首次发布：2022-07-24T12:41:43.664Z - 最新版本发布：2026-11-02T13:00:40.385Z - 近 30 天下载量：52185（2026-10-09 至 2026-11-07，npm 官方下载统计） - 已发布版本数：135（近 12 个月 60 个） ## 中文简介 切换设备的闪光灯/火炬 . ## 安装 ```sh npm install @capgo/capacitor-flash ``` 也可以使用：`pnpm add @capgo/capacitor-flash`、`yarn add @capgo/capacitor-flash`、`bun add @capgo/capacitor-flash` ## README # 电容器起伏 打开和关闭您的 Capacitor app 设备的手电筒, 在硬件允许的地方有亮度控制. [![Capgo - Build Capacitor apps with AI, ship updates instantly](https://capgo.app/readme-banner.svg?repo=Cap-go/capacitor-flash)](https://capgo.app/?ref=plugin_flash) **队长**:在几分钟内将修正推给您的 Capacitor 用户,在没有Mac的情况下构建已签名的iOS和Android apps,并在一击中回滚. ## [\*免费开始\*](https://capgo.app/register/?ref=plugin_flash) 14天无限自由审判. 不需要信用卡 > 🤖 **建筑与AI编码代理?** 安装 [Capgo 技能](https://capgo.app/skills/?ref=plugin_flash) 所以克劳德代码,代码,光标,副驾驶,或双子座CLI知道如何安装和使用 `@capgo/capacitor-flash` 在您的电容应用程序中: `npx skills add Cap-go/capgo-skills`。然后问你的经纪人: _加入@capgo/capor-flash到我的 Capacitor app上并把它接上。"_ [代理设置指南](https://capgo.app/agents/?ref=plugin_flash) • 妇女 [主机磁共振](https://capgo.app/docs/ai/mcp/?ref=plugin_flash) ![@capgo/capacitor-flash for Capacitor apps](https://raw.githubusercontent.com/Cap-go/capacitor-flash/main/assets/github-social-preview.png) ## 主要特点 - **打开和关闭**数字 : `switchOn({})`, (中文(简体) ), `switchOff()` 财务报告和审定财务报表 `toggle()`。 。 。 . - **强度**: 通过 `intensity` 改为 `switchOn()` 在辅助设备上. - **状态**数字 : `isSwitchedOn()` 报告火炬是否打开. - **可用性**数字 : `isAvailable()` 先检查一下手电筒. - **平台**:iOS,Android和Web. iOS使用AVFoundation,Android使用相机2. Web在浏览器允许的地方使用相机火炬. ## 为什么是闪电控制器? 很简单, **免费**,以及 **轻型** 手电筒控制插件 : - **强度控制** - 调整亮度水平(iOS和Android 13+) - **状态检查** - 查询手电筒的可用性和当前状态 - **切换支持** - 使用切换方法进行简单的打开/关闭切换 - **通用兼容性** - 跨越iOS、Android和网络(移动设备上的Chrome)的工作 - **现代软件包管理** - 支持Swift软件包管理器(SPM)和CocoaPods(SPM-为Capacitor 8准备) - **零依赖关系** - 最小的脚印,没有出血 适合QR扫描仪应用,紧急火炬特性,相机应用,以及实用工具. ## 文档 这里有最完整的医生: [https://capgo.app/docs/plugins/flash/ 页面存档备份,存于互联网档案馆](https://capgo.app/docs/plugins/flash/) ## 兼容性 | 插件版本 | 电容兼容性 | 维护 | | --- | --- | --- | | 联合国 | 联合国 | ✅ | | 页:1 | 页:1 | 应要求 | | 页:1 | 页:1 | ❌ | | 页:1 | 页:1 | ❌ | > **说明:** 此插件的主要版本沿用了Capacitor的主要版本. 使用匹配您的 Capacitor 安装的版本( 如 Capacitor 8 的插件 v8) 。 只有最新的主要版本得到积极维护. ## 安装 您可以使用我们的 AI 辅助设置安装插件 。 使用以下命令将 Capgo 技能添加到您的 AI 工具 : ```bash npx skills add https://github.com/cap-go/capacitor-skills --skill capacitor-plugins ``` 然后使用下列提示: ```text Use the `capacitor-plugins` skill from `cap-go/capacitor-skills` to install the `@capgo/capacitor-flash` plugin in my project. ``` 如果您更喜欢手动设置,请通过运行以下命令来安装插件,并遵循下面的平台特定指令: ```bash npm install @capgo/capacitor-flash npx cap sync ``` ## iOS系统 出局了 出局了 ## 机器人 工作在盒子内。 不需要任何许可,因为 `CameraManager.setTorchMode()` API(引入于Android 6.0)不需要相机许可. 可以选择, 您可以在您的 QQ 中声明闪存硬件特性 `AndroidManifest.xml`数字 : ```xml ``` ## 网页 在移动设备上的Chrome和以Chrome为主的浏览器中工作. 使用带有火炬约束的MediaDevices API. 打电话 `isAvailable()` 首先检查当前浏览器/设备是否支持火炬控制. ## API 密码 - [`isAvailable()`](https://npmcn.com/package/%40capgo/capacitor-flash/#readme-isavailable) - [`switchOn(...)`](https://npmcn.com/package/%40capgo/capacitor-flash/#readme-switchon) - [`switchOff()`](https://npmcn.com/package/%40capgo/capacitor-flash/#readme-switchoff) - [`isSwitchedOn()`](https://npmcn.com/package/%40capgo/capacitor-flash/#readme-isswitchedon) - [`toggle()`](https://npmcn.com/package/%40capgo/capacitor-flash/#readme-toggle) - [`getPluginVersion()`](https://npmcn.com/package/%40capgo/capacitor-flash/#readme-getpluginversion) 用于控制设备手电筒/托克的电容闪光插件. ### 易读 () ```typescript isAvailable() => Promise<{ value: boolean; }> ``` 检查设备是否有手电筒可用 . **回返情况:** `Promise<{ value: boolean; }>` **自:** 1.0.0 (单位:千美元) * * * ### 开关(...) ```typescript switchOn(options: { intensity?: number; }) => Promise ``` 打开手电筒. | 参数 | 类型 | 说明 | | --- | --- | --- | | **`options`** | `{ intensity?: number; }` | \- 包括轻强度在内的可选配置 | **自:** 1.0.0 (单位:千美元) * * * ### 切换Off () ```typescript switchOff() => Promise ``` 关了手电筒. **自:** 1.0.0 (单位:千美元) * * * ### 正在切换 On () ```typescript isSwitchedOn() => Promise<{ value: boolean; }> ``` 检查手电筒当前是否打开或关闭 . **回返情况:** `Promise<{ value: boolean; }>` **自:** 1.0.0 (单位:千美元) * * * ### 切换( c) ```typescript toggle() => Promise<{ value: boolean; }> ``` 切换手电筒打开或关闭. **回返情况:** `Promise<{ value: boolean; }>` **自:** 1.0.0 (单位:千美元) * * * ### 获取 PluginVersion () ```typescript getPluginVersion() => Promise<{ version: string; }> ``` 获取本地 Capacitor 插件版本 . **回返情况:** `Promise<{ version: string; }>` **自:** 1.0.0 (单位:千美元) * * * ## 常见问题 ### @capgo/capacitor-flash 是什么？ 切换设备的闪光灯/火炬 \. ### 如何安装 @capgo/capacitor-flash？ 在项目目录运行 npm install @capgo/capacitor-flash，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@capacitor/core（\>=8\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @capgo/capacitor-flash 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @capgo/capacitor-flash 支持 ESM 还是 CommonJS？ 同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。 ### @capgo/capacitor-flash 可以商用吗？ @capgo/capacitor-flash 使用 MPL-2\.0 许可。弱 Copyleft：可以商用，也可以和闭源代码一起使用；但如果分发时修改了 MPL 授权的文件，这些文件的修改需以 MPL 开源。以上为概括，不构成法律意见，请以许可原文为准。 ### @capgo/capacitor-flash 的下载量有多少？ 根据 npm 官方下载统计，@capgo/capacitor-flash 在 2026/10/09 – 2026/11/07 这 30 天内被下载 52,185 次，日均约 1,740 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @capgo/capacitor-flash 还在维护吗？ 最新版本 8\.0\.51 发布于 2026/11/02（6 天前）；至今共发布 135 个版本，其中过去 12 个月发布了 60 个；首次发布于 2022/07/24。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。