跳转至正文

语音识别 Capacitor 插件

自然、低延迟的语音识别,支持流式返回部分结果,跨平台表现一致

安装

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

指南

如何在 Capacitor 中使用 Speech Recognition

在设备上测试

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

Speech Recognition 插件预览二维码 code

使用 @capgo/capacitor-speech-recognition

Capacitor 插件可实现完整的设备端语音识别,并实时返回部分识别结果。

安装

bun add @capgo/capacitor-speech-recognition
bunx cap sync

插件暴露的内容

  • available - 检测当前设备的原生语音识别服务是否可用。
  • isOnDeviceRecognitionAvailable - 检测所选语言区域是否支持平台较新的设备端识别路径。
  • start - 开始采集音频并进行语音转写。
  • stop - 停止监听并释放原生资源。

用法示例

available

检查原生语音识别服务在当前设备上是否可用。

import { SpeechRecognition } from '@capgo/capacitor-speech-recognition';

const result = await SpeechRecognition.available();
console.log(result);

isOnDeviceRecognitionAvailable

检查所选语言区域是否支持平台较新的设备端识别路径。

import { SpeechRecognition } from '@capgo/capacitor-speech-recognition';

const result = await SpeechRecognition.isOnDeviceRecognitionAvailable();
console.log(result);

start

开始采集音频并进行语音转写。

import { SpeechRecognition } from '@capgo/capacitor-speech-recognition';

const result = await SpeechRecognition.start();
console.log(result);

stop

停止监听并释放原生资源。

import { SpeechRecognition } from '@capgo/capacitor-speech-recognition';

await SpeechRecognition.stop();

完整参考

继续阅读:使用 @capgo/capacitor-speech-recognition

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

常见问题

Speech Recognition 插件常见问题

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

运行 "bun add @capgo/capacitor-speech-recognition"(或 "npm install @capgo/capacitor-speech-recognition"),然后运行 "bunx cap sync",让 iOS 和 Android 项目加载原生 code。再在应用 code 中从 "@capgo/capacitor-speech-recognition" 导入。

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

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

@capgo/capacitor-speech-recognition 支持哪个版本的 Capacitor?

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

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

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

我可以在不经过 App Store 审核的情况下,更新使用了 Speech Recognition 的 code 吗?

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

无需等待应用审核,即可快速发布语音识别功能的更新

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

开始使用 Capgo