React Native Voice识别库安装与配置完全指南

项目基础介绍与编程语言

React Native Voice 是一个强大的跨平台语音识别库，专为React Native设计，支持iOS和Android两大操作系统。该库提供了在线和离线的支持，使开发者能够轻松集成语音输入功能到他们的应用中。项目采用JavaScript为主要编程语言，并依赖于React Native环境。此外，在原生层，它利用了各自平台的语音识别API，保证了良好的兼容性和性能。

关键技术和框架

• React Native: 跨平台移动应用开发框架。
• Voice Recognition APIs: 利用了iOS的Siri和Android的语音识别服务，提供基础的语音转文本能力。
• Promise-based API: 异步处理方法，使用Promise简化了错误处理和事件监听。
• ** Expo插件系统兼容性**: 虽然不能直接在 Expo Go 中使用，但可通过预构建插件方式添加至自定义Expo项目或非Expo的React Native项目中。

安装与配置步骤

步骤一：基本准备

确保已安装Node.js，React Native CLI（命令行工具），以及Xcode（对于iOS）和Android Studio（对于Android）。

步骤二：安装React Native Voice库

在项目的根目录下，通过npm或yarn进行安装：

# 使用npm
npm install @react-native-voice/voice --save

# 或者使用yarn
yarn add @react-native-voice/voice

步骤三：链接Native Modules

对于iOS：

1. 在终端运行npx pod-install来自动链接库到iOS项目。
2. 打开.xcodeproj文件，检查库是否被正确添加。

对于Android：

1. 自动链接通常由React Native CLI处理。 若需手动链接，在android/settings.gradle加入：

   include ':@react-native-voice_voice'
   project(':@react-native-voice_voice').projectDir = new File(rootProject.projectDir, '../node_modules/@react-native-voice/voice/android')
   

2. 更新android/app/build.gradle中的dependencies：

   implementation project(':@react-native-voice_voice')
   

3. 在MainApplication.java导入并添加到ReactPackages：

   import com.wenkesj.voice.VoicePackage;
   ...
   protected List<ReactPackage> getPackages() {
       return Arrays.asList(
               new MainReactPackage(),
               new VoicePackage()  // 添加这行
       );
   }
   

步骤四：配置权限

Android

• 在android/app/src/main/AndroidManifest.xml添加录音权限：

  <uses-permission android:name="android.permission.RECORD_AUDIO"/>
  

iOS

• 在Info.plist添加语音识别和麦克风使用描述（若未自动添加）：

  <key>NSSpeechRecognitionUsageDescription</key>
  <string>此应用程序需要您的语音来执行语音识别。</string>
  <key>NSMicrophoneUsageDescription</key>
  <string>此应用程序需要访问您的麦克风以录制声音。</string>
  

步骤五：测试与预构建插件配置（如适用）

对于使用Expo且需要原生代码的场景，遵循 Expo 的“Adding Custom Native Code”指导重新构建项目，并确保将React Native Voice作为插件添加到app.json或app.config.js中：

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

完成上述步骤后，您就可以在React Native应用中开始实现语音识别的功能。记住，在实际开发中详细阅读官方文档，以获取最新信息和高级用法。