Flutter集成百度语音识别(Android端)实战指南

一、技术选型与前期准备

百度语音识别SDK提供多种接入方式，Flutter项目选择Android原生集成方案具有最佳兼容性。开发者需完成以下准备工作：

注册百度AI开放平台账号并创建语音识别应用，获取AppID、API Key和Secret Key
下载最新版百度语音识别Android SDK（推荐使用3.x版本）
配置Android开发环境（Android Studio + Flutter SDK）
准备Android原生开发基础（Java/Kotlin知识）

SDK核心组件包含：

语音识别核心库（libBDSpeechRecognizer_X.X.X.jar）
语音合成扩展库（可选）
本地模型文件（需放入assets目录）

二、Android原生集成步骤

1. 项目结构配置

在Flutter项目的android/app目录下操作：

// android/app/build.gradle
android {
    sourceSets {
        main {
            jniLibs.srcDirs = ['libs'] // 配置so库路径
            assets.srcDirs = ['src/main/assets'] // 配置模型文件路径
        }
    }
}

2. 依赖库集成

将SDK的jar包放入android/app/libs目录，在android/app/build.gradle中添加依赖：

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'com.baidu.aip:speech:3.16.2' // 官方推荐版本
}

3. 权限配置

在android/app/src/main/AndroidManifest.xml中添加必要权限：

<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!-- Android 10+需添加 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

动态权限申请建议使用permission_handler插件在Flutter层处理。

4. 初始化配置

创建SpeechRecognizerManager工具类：

public class SpeechRecognizerManager {
    private static final String APP_ID = "你的AppID";
    private static final String API_KEY = "你的API_KEY";
    private static final String SECRET_KEY = "你的SECRET_KEY";
    private SpeechRecognizer recognizer;
    public void init(Context context) {
        // 初始化识别控制器
        AipSpeech.init(context, APP_ID, API_KEY, SECRET_KEY);
        // 创建识别器
        recognizer = SpeechRecognizer.getInstance();
        recognizer.setSpeechListener(new RecognizerListener() {
            @Override
            public void onVolumeChanged(int volume) {
                // 音量变化回调
            }
            @Override
            public void onResult(RecognizerResult result, boolean isLast) {
                // 识别结果回调
                String text = result.getResultString();
                // 通过MethodChannel传递到Flutter
            }
            // 其他必要回调...
        });
    }
    public void startRecognizing() {
        // 配置识别参数
        HashMap<String, Object> options = new HashMap<>();
        options.put(SpeechConstant.ACCEPT_AUDIO_DATA, false);
        options.put(SpeechConstant.LANGUAGE, "zh_CN");
        options.put(SpeechConstant.VAD_ENDPOINT_TIMEOUT, 2000);
        recognizer.startListening(options);
    }
    public void stopRecognizing() {
        recognizer.stopListening();
    }
}

三、Flutter插件封装

1. 创建MethodChannel通信

在lib目录下创建baidu_speech_recognizer.dart：

import 'package:flutter/services.dart';
class BaiduSpeechRecognizer {
  static const MethodChannel _channel =
      MethodChannel('com.example/baidu_speech_recognizer');
  Future<void> initialize() async {
    try {
      await _channel.invokeMethod('initialize');
    } on PlatformException catch (e) {
      print("初始化失败: ${e.message}");
    }
  }
  Future<void> startRecognizing() async {
    try {
      await _channel.invokeMethod('startRecognizing');
    } on PlatformException catch (e) {
      print("开始识别失败: ${e.message}");
    }
  }
  Future<void> stopRecognizing() async {
    await _channel.invokeMethod('stopRecognizing');
  }
}

2. 实现Android端MethodChannel处理

在android/app/src/main/kotlin/.../MainActivity.kt中添加通道处理：

private val speechManager = SpeechRecognizerManager()
override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
    GeneratedPluginRegistrant.registerWith(flutterEngine)
    MethodChannel(flutterEngine.dartExecutor.binaryMessenger, "com.example/baidu_speech_recognizer")
        .setMethodCallHandler { call, result ->
            when (call.method) {
                "initialize" -> {
                    speechManager.init(applicationContext)
                    result.success(null)
                }
                "startRecognizing" -> {
                    speechManager.startRecognizing()
                    result.success(null)
                }
                "stopRecognizing" -> {
                    speechManager.stopRecognizing()
                    result.success(null)
                }
                else -> result.notImplemented()
            }
        }
}

四、实际调用示例

1. 权限处理

使用permission_handler插件：

Future<bool> _checkPermission() async {
  var status = await Permission.microphone.request();
  return status.isGranted;
}

2. 完整使用流程

final recognizer = BaiduSpeechRecognizer();
void _startListening() async {
  if (await _checkPermission()) {
    await recognizer.initialize();
    recognizer.startRecognizing();
    // 10秒后自动停止（实际项目可用按钮控制）
    Future.delayed(Duration(seconds: 10), () {
      recognizer.stopRecognizing();
    });
  } else {
    print("未授权麦克风权限");
  }
}

五、常见问题解决方案

1. 识别无响应

检查网络权限是否配置
确认API Key和Secret Key正确
检查AndroidManifest.xml中的包名是否与百度平台一致

2. 模型文件缺失错误

将SDK中的speech_recognizer_v2.1.0.dat等模型文件放入android/app/src/main/assets目录

3. 64位兼容问题

在android/app/build.gradle中添加：

android {
    defaultConfig {
        ndk {
            abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
        }
    }
}

六、性能优化建议

使用线程池处理识别结果，避免阻塞UI线程
对长语音进行分段处理（建议每段不超过30秒）
在后台服务中实现持续识别功能
添加离线识别模型提升弱网环境体验
实现识别结果缓存机制

七、进阶功能实现

1. 实时显示识别进度

通过EventChannel实现流式数据传输：

// Flutter端
StreamController<String> _streamController = StreamController();
Stream<String> get recognitionStream => _streamController.stream;
// Android端通过EventChannel发送数据

2. 多语言支持

配置识别参数：

HashMap<String, Object> options = new HashMap<>();
options.put(SpeechConstant.LANGUAGE, "en_US"); // 英文
options.put(SpeechConstant.LANGUAGE, "zh_CN"); // 中文

八、完整项目结构建议

lib/
  ├── baidu_speech_recognizer.dart
  ├── speech_controller.dart
  └── ui/
      └── speech_page.dart
android/
  ├── app/
  │   ├── libs/
  │   │   └── BaiduSpeechSDK.jar
  │   └── src/main/
  │       ├── assets/
  │       │   └── speech_recognizer_v2.1.0.dat
  │       └── java/.../MainActivity.kt

通过以上步骤，开发者可以在Flutter项目中完整集成百度语音识别功能。实际开发中需注意处理各种异常情况，并根据业务需求调整识别参数。建议先在测试环境验证功能完整性，再发布到生产环境。