独立文本转语音(TTS)类调用异常：仅播放提示音无语音内容

看起来你遇到的核心问题是TextToSpeech（TTS）在独立工具类中的初始化与线程调度没有处理到位——毕竟直接写在Activity里时，上下文和主线程环境是现成的，但抽成独立类后，很容易忽略TTS的异步初始化特性和线程要求。

下面给你一套经过验证的实现方案，既能支持任意Activity调用，又能解决线程场景下的朗读问题：

第一步：创建全局单例的TTS管理类 #

我们需要一个单例类来统一管理TTS实例，避免重复初始化，同时确保TTS在就绪状态下才执行朗读操作。这里用Application Context来避免内存泄漏，并且实现TextToSpeech.OnInitListener监听初始化状态：

import android.content.Context;
import android.speech.tts.TextToSpeech;
import android.speech.tts.UtteranceProgressListener;
import android.util.Log;
import java.util.Locale;

public class TTSManager implements TextToSpeech.OnInitListener {
    private static TTSManager instance;
    private TextToSpeech tts;
    private boolean isTTSInitialized = false;
    private Context appContext;

    // 私有构造方法，确保单例
    private TTSManager(Context context) {
        this.appContext = context.getApplicationContext();
        // 初始化TTS，必须在主线程执行
        tts = new TextToSpeech(appContext, this);
    }

    // 获取单例实例
    public static synchronized TTSManager getInstance(Context context) {
        if (instance == null) {
            instance = new TTSManager(context);
        }
        return instance;
    }

    // TTS初始化完成回调
    @Override
    public void onInit(int status) {
        if (status == TextToSpeech.SUCCESS) {
            // 设置语言，这里以中文为例，可根据需求调整
            int result = tts.setLanguage(Locale.CHINESE);
            if (result == TextToSpeech.LANG_MISSING_DATA || result == TextToSpeech.LANG_NOT_SUPPORTED) {
                Log.e("TTSManager", "当前语言不支持");
            } else {
                isTTSInitialized = true;
                // 可选：设置朗读参数，比如语速、音量
                tts.setSpeechRate(1.0f); // 1.0是默认语速
                tts.setPitch(1.0f); // 1.0是默认音调
                // 可选：添加朗读进度监听
                tts.setOnUtteranceProgressListener(new UtteranceProgressListener() {
                    @Override
                    public void onStart(String utteranceId) {}

                    @Override
                    public void onDone(String utteranceId) {}

                    @Override
                    public void onError(String utteranceId) {}
                });
            }
        } else {
            Log.e("TTSManager", "TTS初始化失败");
        }
    }

    // 核心朗读方法，支持线程调用
    public void speak(String text) {
        if (!isTTSInitialized) {
            Log.w("TTSManager", "TTS尚未初始化完成，稍后重试");
            // 可选：初始化未完成时，可以延迟重试或者提示用户
            return;
        }
        // TTS的speak方法必须在主线程执行，所以如果当前是子线程，切换到主线程
        if (appContext instanceof android.app.Application) {
            ((android.app.Application) appContext).runOnUiThread(() -> {
                // 使用QUEUE_FLUSH替换当前朗读任务，QUEUE_ADD则追加到队列
                tts.speak(text, TextToSpeech.QUEUE_FLUSH, null, "unique_utterance_id");
            });
        }
    }

    // 释放TTS资源，建议在Application的onTerminate或者Activity的onDestroy调用
    public void shutdown() {
        if (tts != null) {
            tts.stop();
            tts.shutdown();
            isTTSInitialized = false;
        }
    }
}

第二步：在任意Activity中调用 #

在需要朗读的Activity里，只需要获取TTSManager实例，然后调用speak方法即可，不管是主线程还是子线程都能正常工作：

public class TestActivity extends AppCompatActivity {
    private TTSManager ttsManager;
    private EditText inputEt;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_test);
        inputEt = findViewById(R.id.et_input);
        // 初始化TTSManager
        ttsManager = TTSManager.getInstance(this);

        // 示例：点击按钮朗读EditText内容
        findViewById(R.id.btn_speak).setOnClickListener(v -> {
            String text = inputEt.getText().toString().trim();
            if (!text.isEmpty()) {
                // 主线程直接调用
                ttsManager.speak(text);
            }
        });

        // 示例：子线程中调用
        new Thread(() -> {
            // 模拟耗时操作后朗读
            try {
                Thread.sleep(2000);
            } catch (InterruptedException e) {
                e.printStackTrace();
            }
            String text = inputEt.getText().toString().trim();
            if (!text.isEmpty()) {
                ttsManager.speak(text);
            }
        }).start();
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        // 可选：如果全局不需要TTS了，调用shutdown；如果其他Activity还需要，可以不用在单个Activity调用
        // ttsManager.shutdown();
    }
}

关键问题解析 #

你之前的代码只播放提示音，大概率是以下原因：

1. TTS未初始化完成就调用speak：TTS初始化是异步的，直接调用speak会导致操作无效，只有系统默认的错误提示音。
2. 线程错误：TTS的speak方法必须在主线程执行，子线程直接调用会失效。
3. 上下文问题：如果用了Activity上下文，可能因为Activity生命周期导致TTS实例被回收，而用Application Context则更稳定。

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