在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. 注意事项
- 真机测试:需要在真实设备上测试,模拟器可能无法使用麦克风
- 权限处理:首次使用需要用户授权麦克风权限
- 网络依赖:某些语音识别服务需要网络连接
这样就完成了基本的语音转文字功能,可以根据需要添加更多功能如连续识别、语音反馈等。