Android中如何使用自带的TextToSpeech

在Android中，TextToSpeech（文字转语音）是一个非常重要的功能，它可以将文本转换为语音输出，这个功能对于许多应用程序来说都是非常有用的，例如阅读器、盲人辅助工具等，在Android中，我们可以使用自带的TextToSpeech类来实现这个功能，本文将详细介绍如何在Android中使用自带的TextToSpeech。

创建TextToSpeech对象

在使用TextToSpeech之前，我们需要创建一个TextToSpeech对象，可以通过以下两种方式来创建：

1、通过Context对象的createTextToSpeech方法创建：

TextToSpeech textToSpeech = new TextToSpeech(context, new TextToSpeech.OnInitListener() {
    @Override
    public void onInit(int status) {
        if (status == TextToSpeech.SUCCESS) {
            // TextToSpeech对象创建成功，可以开始使用了
        } else {
            // TextToSpeech对象创建失败，需要处理错误
        }
    }
});

2、通过TextToSpeech类的构造方法创建：

TextToSpeech textToSpeech = new TextToSpeech(context, "MyTextToSpeech");

设置TextToSpeech的属性

在使用TextToSpeech之前，我们还需要设置一些属性，以便更好地控制语音的输出，以下是一些常用的属性：

1、设置语速：通过setSpeechRate方法设置，取值范围为0.0到2.0，数值越大，语速越快。

textToSpeech.setSpeechRate(1.0f); // 设置语速为正常速度

2、设置音量：通过setVolume方法设置，取值范围为0.0到1.0，数值越大，音量越大。

textToSpeech.setVolume(0.5f); // 设置音量为50%

3、设置发音人：通过setLanguage和setCountry方法设置，分别表示语言和国家/地区代码。

textToSpeech.setLanguage("zh-CN"); // 设置语言为中文简体
textToSpeech.setCountry("CN"); // 设置国家/地区代码为中国

4、设置是否显示发音人选择对话框：通过setShowNotification方法设置，设置为true时，会显示一个发音人选择对话框。

textToSpeech.setShowNotification(false); // 不显示发音人选择对话框

开始和停止朗读

在设置了TextToSpeech的属性之后，我们就可以开始和停止朗读了，以下是一些常用的方法：

1、开始朗读：通过speak方法开始朗读指定的文本。

textToSpeech.speak("Hello, World!", TextToSpeech.QUEUE_FLUSH, null); // 开始朗读文本"Hello, World!"

2、停止朗读：通过shutdown方法停止朗读，需要注意的是，这个方法不会立即停止朗读，而是将朗读任务放入队列中等待执行，如果需要立即停止朗读，可以使用cancel方法。

textToSpeech.shutdown(); // 停止朗读任务，但不会立即停止朗读
textToSpeech.cancel(); // 立即停止朗读任务

释放资源

在使用完TextToSpeech之后，我们需要释放资源，以避免内存泄漏，可以通过以下两种方式来释放资源：

1、在Activity或Fragment的onDestroy方法中调用TextToSpeech对象的destroy方法：

@Override
protected void onDestroy() {
    super.onDestroy();
    textToSpeech.destroy(); // 释放TextToSpeech资源
}

2、使用try-with-resources语句自动释放资源：从Android API 26开始，可以使用try-with-resources语句自动释放资源，只需将TextToSpeech对象放在try语句的括号中即可，当try语句执行完毕时，会自动调用TextToSpeech对象的close方法来释放资源。

try (TextToSpeech textToSpeech = new TextToSpeech(context, "MyTextToSpeech")) {
    // 使用textToSpeech对象进行操作...
} catch (Exception e) {
    // 处理异常...
} // 无需手动调用textToSpeech.close()方法，资源会自动释放