Android TextToSpeech无法工作：未绑定TTS引擎及初始化错误求助

核心问题分析 #

你遇到的speak failed: not bound to TTS engine和onInit status=-1错误，根源在这三点：

1. 忽略TTS异步初始化特性：点击事件里刚创建TextToSpeech实例就立刻调用speak，此时引擎还没完成绑定，必然触发失败。
2. 变量名拼写错误：onInit方法里误用了未定义的mTextToSpeech，实际成员变量是myTextToSpeech，导致初始化逻辑执行异常。
3. Locale格式不标准：用非规范的"eng"作为语言代码，可能导致引擎无法识别语言配置。

代码修复步骤 #

1. 修正MainActivityListeners.java的逻辑与变量错误 #

public class MainActivityListeners implements TextToSpeech.OnInitListener {
    
    private MainActivity activity;
    private TextToSpeech myTextToSpeech;
    private boolean mIsInit;
    // 保存待朗读文本，用于初始化完成后触发朗读
    private String pendingSpeakText;

    public MainActivityListeners(MainActivity activity) {
        this.activity = activity;
        // 提前初始化TTS，避免点击时才创建导致的异步问题
        this.myTextToSpeech = new TextToSpeech(this.activity, this);
    }

    @Override
    public void onInit(int status) {
        if (status == TextToSpeech.SUCCESS) {
            // 使用标准Locale代码
            Locale locale = Locale.ENGLISH;
            int result = myTextToSpeech.setLanguage(locale);
            if (result == TextToSpeech.LANG_MISSING_DATA || result == TextToSpeech.LANG_NOT_SUPPORTED) {
                mIsInit = false;
                Toast.makeText(activity, "TTS语言包缺失或不支持当前语言", Toast.LENGTH_SHORT).show();
            } else {
                mIsInit = true;
                // 初始化完成后，朗读之前保存的待读文本
                if (pendingSpeakText != null) {
                    myTextToSpeech.speak(pendingSpeakText, TextToSpeech.QUEUE_FLUSH, null, "someId");
                    pendingSpeakText = null;
                }
            }
        } else {
            mIsInit = false;
            Toast.makeText(activity, "TTS引擎初始化失败，请安装Google文字转语音引擎", Toast.LENGTH_LONG).show();
            // 跳转至应用商店下载TTS引擎（可选）
            try {
                Intent intent = new Intent(TextToSpeech.Engine.ACTION_INSTALL_TTS_DATA);
                activity.startActivity(intent);
            } catch (ActivityNotFoundException e) {
                e.printStackTrace();
            }
        }
    }

    View.OnClickListener getTranslateClickListener(TextView myTextView) {
        return x -> {
            if (mIsInit && myTextToSpeech != null) {
                // 初始化完成后直接朗读
                myTextToSpeech.speak("Hello", TextToSpeech.QUEUE_FLUSH, null, "someId");
            } else {
                // 未初始化完成，保存文本等待初始化
                pendingSpeakText = "Hello";
                // 如果之前初始化失败，重新创建TTS实例
                if (myTextToSpeech == null) {
                    myTextToSpeech = new TextToSpeech(activity, this);
                }
            }
        };
    }

    // 在Activity销毁时释放TTS资源，避免内存泄漏
    public void releaseTTS() {
        if (myTextToSpeech != null) {
            myTextToSpeech.stop();
            myTextToSpeech.shutdown();
        }
    }
}

2. 修正MainActivity.java，添加资源释放逻辑 #

public class MainActivity extends Activity {
  
  private TextView myTextView;
  private MainActivityListeners listeners;

  @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        this.myTextView = findViewById(R.id.tv_myView);
        this.listeners = new MainActivityListeners(this);
        this.myTextView.setOnClickListener(this.listeners.getTranslateClickListener(this.myTextView));
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        // 释放TTS资源
        if (listeners != null) {
            listeners.releaseTTS();
        }
    }
}

其他语音实现方案建议 #

如果系统TTS引擎问题难以解决，可以考虑这些替代方案：

• Google Cloud Text-to-Speech API：通过网络请求将文本转为音频文件，再播放音频，语音效果稳定，但需要联网和API密钥。
• 第三方离线TTS库：比如Pico TTS、eSpeak，集成到应用中无需依赖系统引擎，但需要处理库的集成和语音质量问题。

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