使用@react-native-community/voice实现语音转文本时遇TypeError错误

可能的原因及对应解决方法 #

1. Expo环境兼容性问题 #

@react-native-community/voice不支持Expo托管工作流，因为它需要原生代码链接。如果你当前是Expo托管项目，直接替换为Expo官方的语音识别模块：

• 安装Expo语音识别包：

  npx expo install expo-speech-recognition
  

• 替换权限请求与核心逻辑示例：

  import * as SpeechRecognition from 'expo-speech-recognition';
  
  const checkMicrophonePermission = async () => {
    const { status } = await SpeechRecognition.requestPermissionsAsync();
    if (status === 'granted') {
      console.log('麦克风权限已获取');
    }
  };
  
  const startRecording = async () => {
    setRecording(true);
    try {
      await SpeechRecognition.startRecognitionAsync('en-GB');
    } catch (error) {
      console.log('录音启动失败:', error);
    }
  };
  

2. 裸React Native项目的安装链接问题 #

如果是裸工作流，确保包已正确安装并完成原生配置：

• 重新安装并完成原生链接：

  npm install @react-native-community/voice --save
  # iOS执行pod安装
  cd ios && pod install && cd ..
  

• 配置原生权限：
  • iOS：在Info.plist中添加权限描述：

    <key>NSSpeechRecognitionUsageDescription</key>
    <string>需要使用语音识别功能将语音转为文本</string>
    <key>NSMicrophoneUsageDescription</key>
    <string>需要访问麦克风录制语音</string>
    

  • Android：在AndroidManifest.xml中添加权限：

    <uses-permission android:name="android.permission.RECORD_AUDIO" />
    <uses-permission android:name="android.permission.INTERNET" /> <!-- 语音识别需联网 -->
    

3. Voice实例初始化时机问题 #

错误提示startSpeech为null，说明Voice模块未正确初始化。调整事件监听逻辑：

• 将Voice事件监听放在权限获取成功之后，避免模块未准备好时调用方法：

  useEffect(() => {
    let isMounted = true;
    const initVoice = async () => {
      const { status } = await Permissions.askAsync(Permissions.AUDIO_RECORDING);
      if (status === 'granted' && isMounted) {
        Voice.onSpeechStart = speechStartHandler;
        Voice.onSpeechEnd = speechEndHandler;
        Voice.onSpeechResults = speechResultHandler;
        Voice.onSpeechError = speechErrorHandler;
      }
    };
    initVoice();
    return () => {
      isMounted = false;
      Voice.destroy().then(Voice.removeAllListeners);
    };
  }, []);
  

4. 版本兼容性问题 #

检查@react-native-community/voice与React Native版本是否匹配：

• 安装适配当前RN版本的最新包：

  npm install @react-native-community/voice@latest --save
  

额外排查点 #

• 使用真实设备测试，模拟器可能存在语音识别功能限制。
• 确保设备已连接网络（多数语音识别服务依赖联网）。

内容的提问来源于stack exchange，提问作者Muskan Verma