跳转至正文

Flash Capacitor 插件

通过简单的开关功能控制设备的闪光灯和手电筒

安装

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

指南

如何在 Capacitor 中使用 Flash

在设备上测试

下载 Capgo App,然后扫描二维码 code。

Flash 插件预览二维码 code

正在使用 @capgo/capacitor-flash

Capacitor Flash 插件,用于控制设备的闪光灯/手电筒。

安装

bun add @capgo/capacitor-flash
bunx cap sync

bunx cap sync 将插件的原生 code 复制到你的原生项目中。每次升级插件后都要重新运行。

导入

import { CapacitorFlash } from '@capgo/capacitor-flash';

API 概览

方法 描述
isAvailable 检查设备是否支持手电筒。
switchOn 开启手电筒。
switchOff 关闭手电筒。
isSwitchedOn 检查手电筒当前是开启还是关闭状态。
toggle 切换手电筒的开启或关闭状态。

示例

isAvailable()

检查设备是否支持手电筒。

import { CapacitorFlash } from '@capgo/capacitor-flash';

const { value } = await CapacitorFlash.isAvailable();
if (value) {
  console.log('Flashlight is available');
}

switchOn()

开启手电筒。

import { CapacitorFlash } from '@capgo/capacitor-flash';

// Turn on at full brightness
await CapacitorFlash.switchOn({ intensity: 1.0 });

// Turn on at half brightness
await CapacitorFlash.switchOn({ intensity: 0.5 });

switchOff()

关闭手电筒。

import { CapacitorFlash } from '@capgo/capacitor-flash';

await CapacitorFlash.switchOff();

isSwitchedOn()

检查手电筒当前是开启还是关闭状态。

import { CapacitorFlash } from '@capgo/capacitor-flash';

const { value } = await CapacitorFlash.isSwitchedOn();
console.log('Flashlight is on:', value);

toggle()

切换手电筒的开启或关闭状态。

import { CapacitorFlash } from '@capgo/capacitor-flash';

const { value } = await CapacitorFlash.toggle();
console.log('Flashlight toggled, now on:', value);

完整参考文档

继续了解使用 @capgo/capacitor-flash

如果你正在使用 使用 @capgo/capacitor-flash 要规划 dashboard 和 API 操作,请将其连接到 @capgo/capacitor-flash 了解 @capgo/capacitor-flash 中的实现细节, 快速入门 有关“入门指南”中的实现细节, API 概览 关于 API Overview 中的实现细节, 简介 关于简介中的实现细节,以及 API 密钥 关于 API Keys 中的实现细节。

常见问题

Flash 插件常见问题

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

运行 "bun add @capgo/capacitor-flash"(或 "npm install @capgo/capacitor-flash"),然后运行 "bunx cap sync",使 iOS 和 Android 项目同步原生 code。最后在你的应用 code 中从 "@capgo/capacitor-flash" 导入即可。

@capgo/capacitor-flash 是否支持 React、Vue 和 Angular?

支持。Flash 是一个 Capacitor 包,因此它支持任何在 Capacitor 中运行的 Web 框架,包括 Ionic、React、Vue、Angular、Svelte 以及原生 JavaScript。

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

Capgo 插件遵循 Capacitor 的主版本号:请使用与 Capacitor 主版本号一致的插件主版本(例如插件 v8 对应 Capacitor 8)。GitHub README 中的兼容性表列出了仍在维护的版本。

@capgo/capacitor-flash 是免费开源的吗?

是的。code 的源码已在 GitHub 公开,地址为 https://github.com/Cap-go/capacitor-flash/,并且你可以直接从 npm 免费安装该 package。欢迎提交 Bug 报告或 Pull Request。

我能否在无需经过 App Store 审核的情况下,更新使用了 Flash 的 code?

安装或升级插件会改动原生 code,因此需要重新做一次商店构建。之后,调用该插件的 JavaScript、HTML 和 CSS 改动就能通过 Capgo live updates 立即发布。

无需等待应用审核即可发布 Flash 更改

只要插件已包含在你的商店版本中,Capgo live updates 就能在几分钟内把 JavaScript、HTML 和 CSS 的改动推送给用户。

开始使用 Capgo