在Flutter中使用speech_to_text库实现语音转文字,需要完成以下步骤:
1. 添加依赖
在 pubspec.yaml 中添加:
dependencies:
  speech_to_text: ^6.6.0
运行 flutter pub get 安装。
2. 配置权限
Android:在 android/app/src/main/AndroidManifest.xml 中添加:
<uses-permission android:name="android.permission.RECORD_AUDIO" />
iOS:在 ios/Runner/Info.plist 中添加:
<key>NSMicrophoneUsageDescription</key>
<string>需要麦克风权限进行语音识别</string>
<key>NSSpeechRecognitionUsageDescription</key>
<string>需要语音识别权限将语音转换为文字</string>
3. 基本实现代码
import 'package:flutter/material.dart';
import 'package:speech_to_text/speech_to_text.dart' as stt;
class SpeechScreen extends StatefulWidget {
  @override
  _SpeechScreenState createState() => _SpeechScreenState();
}
class _SpeechScreenState extends State<SpeechScreen> {
  stt.SpeechToText _speech = stt.SpeechToText();
  bool _isListening = false;
  String _text = '点击按钮开始说话';
  @override
  void initState() {
    super.initState();
    _initSpeech();
  }
  void _initSpeech() async {
    bool available = await _speech.initialize(
      onStatus: (status) => print('Status: $status'),
      onError: (error) => print('Error: $error'),
    );
    if (!available) {
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text('语音识别不可用')),
      );
    }
  }
  void _listen() async {
    if (!_isListening) {
      bool available = await _speech.listen(
        onResult: (result) => setState(() {
          _text = result.recognizedWords;
        }),
        localeId: 'zh-CN', // 中文识别
      );
      if (available) {
        setState(() => _isListening = true);
      }
    } else {
      _speech.stop();
      setState(() => _isListening = false);
    }
  }
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('语音转文字')),
      body: Padding(
        padding: EdgeInsets.all(16),
        child: Column(
          children: [
            Expanded(
              child: Container(
                padding: EdgeInsets.all(16),
                decoration: BoxDecoration(
                  border: Border.all(color: Colors.grey),
                  borderRadius: BorderRadius.circular(8),
                ),
                child: Text(_text),
              ),
            ),
            SizedBox(height: 20),
            FloatingActionButton(
              onPressed: _listen,
              child: Icon(_isListening ? Icons.mic : Icons.mic_none),
              backgroundColor: _isListening ? Colors.red : Colors.blue,
            ),
          ],
        ),
      ),
    );
  }
}
4. 关键说明
- 初始化:调用 initialize()检查设备支持情况
- 开始监听:listen()启动语音识别,通过onResult回调获取识别结果
- 停止监听:stop()结束识别
- 语言设置:通过 localeId参数设置识别语言(如中文使用zh-CN)
- 错误处理:通过 onError回调处理识别错误
5. 注意事项
- 真机测试:需要在真实设备上测试,模拟器可能无法使用麦克风
- 权限处理:首次使用需要用户授权麦克风权限
- 网络依赖:某些语音识别服务需要网络连接
这样就完成了基本的语音转文字功能,可以根据需要添加更多功能如连续识别、语音反馈等。