React Native Voice库技术文档

React Native Voice是一个强大的语音转文本库，专为React Native应用设计。它允许开发者在Android和iOS平台上轻松集成语音识别功能。本文档将指导您完成从安装到深入使用的全过程。

安装指南

要开始使用React Native Voice，首先确保您的环境配置完毕，支持React Native开发。然后，通过以下命令添加此库：

yarn add @react-native-voice/voice
# 或者，如果您更倾向于使用npm
npm install @react-native-voice/voice --save

对于iOS项目，安装后还需要执行额外步骤：

npx pod-install

项目链接

React Native Voice需要与原生代码进行链接。对于最新版本的React Native和Expo（非 Expo Go），这通常通过自动链接完成，但手动链接步骤仍然适用特定情况。

自动链接

执行：

react-native link @react-native-voice/voice

若需手动操作：

手动链接Android

1. 在android/settings.gradle中加入引用。
2. 更新android/app/build.gradle中的依赖。
3. 在MainApplication.java内添加相应的VoicePackage。

手动链接iOS

拖拽Voice.xcodeproj到Xcode的Libraries，并调整项目设置以包含此库。

预构建插件（适用于非Expo Go）

对于使用自定义原生代码的项目，更新app.json，添加预构建插件配置：

{
  "expo": {
    "plugins": ["@react-native-voice/voice"]
  }
}

遵循“Adding custom native code”指南来重建应用程序。

使用说明

• 查看位于仓库中的完整示例，涵盖了Android与iOS的基本用法。
• 创建组件并注册事件处理程序，例如启动监听、处理语音开始、结束、结果等。

import Voice from '@react-native-voice/voice';
import React, { Component } from 'react';

class VoiceTest extends Component {
  constructor(props) {
    super(props);
    Voice.onSpeechStart = this.onSpeechStart.bind(this);
    // 注册其他事件处理函数...
  }

  onStartButtonPress = async () => {
    try {
      await Voice.start('en-US');
    } catch (error) {
      console.log(error);
    }
  };

  // 实现其他方法如onSpeechStart, onSpeechEnd等...

}

export default VoiceTest;

API文档

React Native Voice提供了静态访问API的方式，方便异步操作：

• Voice.isAvailable(): 检查系统是否支持语音识别服务。
• Voice.start(locale): 开始指定语言的语音识别。
• Voice.stop(), Voice.cancel(), Voice.destroy(), 等等，用于控制语音识别流程。

每个方法现在返回Promise，便于使用async/await。

权限管理

• Android: 需要在运行时请求录音权限。可以利用expo-permissions或原生代码实现。
• iOS: 在Info.plist中配置描述性消息，该库会自动处理权限请求。

总结

React Native Voice简化了跨平台应用中的语音识别集成，提供了全面的API和事件处理机制。通过上述步骤，您可以顺利集成语音识别功能，提升用户体验。记得在实际应用中考虑权限管理，确保符合各平台的规范。