Android Studio中TextToSpeech报错：speak failed: not bound to TTS engine求助

这个报错核心是TextToSpeech引擎还未完成初始化绑定，就提前调用了speak方法。SDK33下的TTS初始化流程没有本质变动，但必须严格等待初始化完成后再执行语音合成操作。以下是具体修复方案：

修复核心要点 #

• 必须监听OnInitListener的初始化结果，仅在初始化成功后允许触发语音合成
• 增加引擎可用性检查，避免系统无可用TTS引擎的情况
• 适配SDK33的参数规范，及时释放资源避免内存泄漏

修改后的完整代码 #

package com.example.texttospeechtest;

import android.os.Bundle;
import android.speech.tts.TextToSpeech;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import android.widget.Toast;
import androidx.appcompat.app.AppCompatActivity;
import java.util.Locale;

public class MainActivity extends AppCompatActivity {
    EditText editText;
    Button buttonConvert;
    TextToSpeech textToSpeech;
    // 标记TTS是否初始化完成
    private boolean isTtsReady = false;

    @Override
    protected void onCreate(Bundle savedInstanceState){
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        editText = findViewById(R.id.editText);
        buttonConvert = findViewById(R.id.buttonConvert);
        
        // 初始化TTS并监听结果
        textToSpeech = new TextToSpeech(MainActivity.this, status -> {
            if (status == TextToSpeech.SUCCESS) {
                // 设置系统默认语言，可根据需求修改为指定语言
                int langResult = textToSpeech.setLanguage(Locale.getDefault());
                if (langResult == TextToSpeech.LANG_MISSING_DATA || langResult == TextToSpeech.LANG_NOT_SUPPORTED) {
                    Toast.makeText(this, "当前语言不支持TTS", Toast.LENGTH_SHORT).show();
                } else {
                    isTtsReady = true;
                    buttonConvert.setEnabled(true);
                }
            } else {
                Toast.makeText(this, "TTS引擎初始化失败", Toast.LENGTH_SHORT).show();
                buttonConvert.setEnabled(false);
            }
        });

        buttonConvert.setOnClickListener(view -> {
            if (!isTtsReady) {
                Toast.makeText(MainActivity.this, "TTS引擎未就绪", Toast.LENGTH_SHORT).show();
                return;
            }
            String text = editText.getText().toString().trim();
            if (!text.isEmpty()) {
                // SDK21+推荐设置唯一请求ID，替代原null参数
                textToSpeech.speak(text, TextToSpeech.QUEUE_FLUSH, null, "tts_request_001");
            } else {
                Toast.makeText(MainActivity.this, "请输入要转换的文本", Toast.LENGTH_SHORT).show();
            }
        });
        
        // 初始状态禁用按钮，避免误触发
        buttonConvert.setEnabled(false);
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        // 释放TTS资源，防止内存泄漏
        if (textToSpeech != null) {
            textToSpeech.stop();
            textToSpeech.shutdown();
        }
    }
}

关键修复说明 #

1. 初始化状态校验：通过status == TextToSpeech.SUCCESS判断初始化是否完成，仅成功后才启用按钮并标记就绪状态
2. 语言兼容性检查：初始化成功后验证当前语言是否被TTS引擎支持，提前规避合成失败风险
3. 按钮状态控制：初始禁用按钮，防止用户在引擎未就绪时触发无效操作
4. 资源释放：在onDestroy中停止并关闭TTS引擎，避免内存泄漏
5. 参数规范适配：speak方法的第四个参数设置唯一请求ID，符合SDK21+的参数要求

额外注意事项 #

• 若测试设备未安装TTS引擎（部分原生安卓设备），系统会自动弹出引导安装提示，建议用户安装Google文字转语音等官方引擎
• SDK33无需额外申请权限，TTS合成属于系统服务调用，无需添加权限声明

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