IBM Watson语音转文字Android示例代码参数异常问题求助

我之前也踩过类似的SDK版本兼容坑，这大概率是IBM Speech to Text SDK新旧版本间的API签名变化导致的，咱们一步步捋清楚解决：

问题根源 #

旧版本SDK（比如6.x系列）里，recognizeUsingWebSocket要求显式把MicrophoneInputStream作为第一个参数传入；但升级到新版本（比如9.x及以上）后，这个方法的签名被调整了——不再需要直接传capture参数，而是要求把音频输入流通过RecognizeOptions来配置。如果直接移除capture却没在RecognizeOptions里指定音频源，自然会触发“音频不能为空”的错误。

具体解决步骤 #

1. 确认SDK版本并匹配调用方式 #

先检查你的app模块build.gradle里的SDK依赖版本：

// 旧版本示例
implementation 'com.ibm.watson.developer_cloud:speech-to-text:6.0.0'
// 新版本示例
implementation 'com.ibm.watson:speech-to-text:9.3.1'

如果你用的是旧版本SDK

直接保留capture参数即可，IDE的提示大概率是缓存问题，同步gradle或者重启Android Studio就能解决：

private void recordMessage() {
    // mic.setEnabled(false);
    speechService = new SpeechToText();
    // 务必先设置API密钥和服务URL
    speechService.setApiKey("你的API密钥");
    speechService.setServiceUrl("你的服务URL");

    MicrophoneInputStream capture = new MicrophoneInputStream(true);
    speechService.recognizeUsingWebSocket(capture, getRecognizeOptions(), new MicrophoneRecognizeDelegate());
}

如果你用的是新版本SDK

需要把MicrophoneInputStream通过RecognizeOptions.Builder的audio()方法注入，再调用无capture参数的重载方法：

private void recordMessage() {
    // mic.setEnabled(false);
    speechService = new SpeechToText();
    speechService.setApiKey("你的API密钥");
    speechService.setServiceUrl("你的服务URL");

    // 创建麦克风输入流
    MicrophoneInputStream capture = new MicrophoneInputStream(true);
    // 可以重构getRecognizeOptions()，或者直接在这里构建选项
    RecognizeOptions options = new RecognizeOptions.Builder()
        .audio(capture) // 关键：把音频流加入配置选项
        .model("zh-CN_BroadbandModel") // 根据需求选择语言模型
        .interimResults(true) // 是否返回中间识别结果
        .build();

    // 调用新版本方法，无需传capture参数
    speechService.recognizeUsingWebSocket(options, new MicrophoneRecognizeDelegate());
}

2. 确保权限配置齐全 #

别漏了必要的权限，在AndroidManifest.xml中添加：

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

另外，Android 6.0及以上系统需要动态申请录音权限，可以在调用录音前加入检查逻辑：

if (ContextCompat.checkSelfPermission(this, Manifest.permission.RECORD_AUDIO)
        != PackageManager.PERMISSION_GRANTED) {
    ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.RECORD_AUDIO}, 1001);
} else {
    // 权限已获取，执行录音逻辑
    recordMessage();
}

3. 检查自定义的getRecognizeOptions()方法 #

如果这个方法是你自己封装的，确保新版本下它返回的RecognizeOptions已经包含了音频流配置，或者直接在调用时重构这部分逻辑，避免遗漏关键参数。

总结 #

本质就是SDK版本迭代带来的API变更，只要对应版本调整音频输入的传递方式，同时确保权限齐全，就能解决这个“IDE参数提示冲突+运行时音频为空”的矛盾问题。

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