Android TTS UtteranceProgressListener 工作异常问题咨询

嘿，我来帮你梳理一下UtteranceProgressListener无法正常工作的排查方向，这类问题大多是几个细节没处理到位，咱们一步步来：

1. 确认给TTS请求传入了Utterance ID #

UtteranceProgressListener的回调是靠唯一的utteranceId来关联请求的，如果调用speak()或synthesizeToFile()时没指定这个ID，系统根本不知道该触发哪个回调。

举个正确的调用示例：

// 构建参数，指定utterance ID
HashMap<String, String> ttsParams = new HashMap<>();
ttsParams.put(TextToSpeech.Engine.KEY_PARAM_UTTERANCE_ID, "page_utterance_" + currentPage);

// 带参数调用speak
tts.speak(textView.getText().toString(), TextToSpeech.QUEUE_FLUSH, ttsParams, "page_utterance_" + currentPage);

注意：API 21及以上可以用Bundle替代HashMap，但为了兼容低版本，用HashMap更稳妥。

2. 确保在TTS初始化成功后绑定Listener #

光实现UtteranceProgressListener接口还不够，必须在onInit回调确认TTS初始化成功后，手动设置Listener。很多人会漏掉这一步：

@Override
public void onInit(int status) {
    if (status == TextToSpeech.SUCCESS) {
        // 先设置TTS语言（必须步骤）
        int langResult = tts.setLanguage(Locale.getDefault());
        if (langResult == TextToSpeech.LANG_MISSING_DATA || langResult == TextToSpeech.LANG_NOT_SUPPORTED) {
            // 处理语言不支持的情况
            Log.e("TTS", "Language not supported");
        } else {
            // 关键：绑定UtteranceProgressListener
            tts.setOnUtteranceProgressListener(this);
        }
    } else {
        // TTS初始化失败，提示用户
        Log.e("TTS", "Initialization failed");
    }
}

注意：如果之前用过旧的OnUtteranceCompletedListener，要先移除再设置新的Listener，避免冲突。

3. 检查TTS对象的生命周期管理 #

如果你的TextToSpeech实例在朗读完成前就被销毁（比如Activity/Fragment销毁时没妥善处理），回调自然不会触发：

• 在页面销毁时，要调用tts.shutdown();释放资源，而不是只调用tts.stop();
• 确保Player类或TTS对象在朗读过程中处于存活状态，避免被GC回收

4. 回调中操作UI要切换到主线程 #

UtteranceProgressListener的所有回调方法都是在后台线程执行的，如果你在onDone里直接调用goNext()操作ViewPager（UI控件），会导致UI线程异常，看起来像是回调没触发：

修正示例：

@Override
public void onDone(String utteranceId) {
    // 切换到主线程执行UI操作
    runOnUiThread(new Runnable() {
        @Override
        public void run() {
            goNext(); // 这里安全切换ViewPager页面
        }
    });
    // 如果是在Fragment中，用 getActivity().runOnUiThread(...)
}

5. 排查系统TTS引擎兼容性 #

部分设备的默认TTS引擎可能不支持UtteranceProgressListener，可以尝试切换到Google Text-to-Speech引擎测试，看是否是引擎的问题。另外，如果使用在线TTS，要确保应用有android.permission.INTERNET权限。

先从前面两点开始排查，这是最容易踩坑的地方，应该能解决大部分问题！

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