Android TextToSpeech详解

一、TextToSpeech的介绍

TextToSpeech，简称为TTS，是Android平台上一个重要的系统功能。它能够将文本转换成可听的语音，为用户提供更加方便的交互体验。同时，作为开发者，我们也可以基于TextToSpeech实现一些有趣的应用程序。

相信大家都有过使用语音播报的经历，比如导航路线播报等。这些功能都是由TextToSpeech实现的。TextToSpeech可以接受一个字符串作为输入，然后将其转换成语音输出。通过调整语音的语调、语速等参数，我们可以实现多样化的语音效果。在本文中，我们将详细介绍TextToSpeech的使用方法及其相关技巧。

二、TextToSpeech的使用方法

1. 初始化TextToSpeech

在使用TextToSpeech前，我们需要进行初始化。初始化的代码通常写在Activity的onCreate方法中。

    private TextToSpeech mTTS;
    
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        
        mTTS = new TextToSpeech(this, new TextToSpeech.OnInitListener() {
            @Override
            public void onInit(int status) {
                if (status == TextToSpeech.SUCCESS) {
                    // TextToSpeech初始化成功
                } else {
                    Toast.makeText(MainActivity.this, "初始化失败", Toast.LENGTH_SHORT).show();
                }
            }
        });
    }

在初始化TextToSpeech时，我们传入了一个OnInitListener对象。它会在TextToSpeech初始化结束后被调用，其中参数status表明了初始化的状态。如果状态为TextToSpeech.SUCCESS，说明初始化成功。

2. 播放语音

TextToSpeech的核心功能是播放语音。我们可以通过调用speak方法来实现。下面是一个简单的例子：

mTTS.speak("欢迎使用TextToSpeech", TextToSpeech.QUEUE_FLUSH, null);

上述代码将会播放一段语音，内容为“欢迎使用TextToSpeech”。其中，QUEUE_FLUSH表示直接清空播放队列，开始播放新的语音。如果需要将多个语音添加到播放队列中依次播放，可以使用QUEUE_ADD。

3. 设置语音参数

TextToSpeech提供了一些参数，可以调整语音的效果。下面是一段设置语调和语速的代码：

mTTS.setPitch(1.2f);    // 语调范围从0.5到2.0
mTTS.setSpeechRate(0.8f);    // 语速范围从0.1到2.0
mTTS.speak("欢迎使用TextToSpeech", TextToSpeech.QUEUE_FLUSH, null);

在上述代码中，setPitch方法用于设置语调，范围从0.5到2.0。setSpeechRate方法则用于设置语速，范围从0.1到2.0。

4. 停止播放

如果需要停止正在播放的语音，可以调用TextToSpeech的stop方法：

mTTS.stop();

5. 释放TextToSpeech

在使用完TextToSpeech后，应当及时将其释放，以防止造成资源浪费。代码如下：

@Override
protected void onDestroy() {
    super.onDestroy();

    if (mTTS != null) {
        mTTS.stop();
        mTTS.shutdown();
    }
}

在Activity被销毁时，我们调用mTTS.shutdown()方法，来释放TextToSpeech。在释放后再次使用TextToSpeech，需要重新初始化。

三、TextToSpeech的技巧

1. 判断TextToSpeech是否安装

在某些设备上，可能并没有安装TextToSpeech引擎。在这种情况下，我们应当提示用户并引导其进行安装。代码如下：

private TextToSpeech mTTS;

// ...

private void checkTTSEngine() {
    Intent checkIntent = new Intent();
    checkIntent.setAction(TextToSpeech.Engine.ACTION_CHECK_TTS_DATA);
    startActivityForResult(checkIntent, MY_TTS_CHECK_CODE);
}

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == MY_TTS_CHECK_CODE) {
        if (resultCode == TextToSpeech.Engine.CHECK_VOICE_DATA_PASS) {
            mTTS = new TextToSpeech(this, this);
        } else {
            Intent installIntent = new Intent();
            installIntent.setAction(TextToSpeech.Engine.ACTION_INSTALL_TTS_DATA);
            startActivity(installIntent);
        }
    }
}

在checkTTSEngine方法中，我们启动了一个检查TextToSpeech引擎的Intent。它会返回一个检查结果，通过onActivityResult方法来处理。如果返回的结果表明TextToSpeech引擎已经安装，我们可以进行初始化；否则，我们通过引导用户安装TextToSpeech来解决问题。

2. 设置默认语音引擎

在一些设备上，可能安装了多个语音引擎。如果需要使用默认引擎，可以通过以下代码实现：

Intent intent = new Intent();
intent.setAction(TextToSpeech.Engine.ACTION_CHECK_TTS_DATA);
startActivityForResult(intent, MY_TTS_CHECK_CODE);

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == MY_TTS_CHECK_CODE) {
        if (resultCode == TextToSpeech.Engine.CHECK_VOICE_DATA_PASS) {
            mTTS = new TextToSpeech(this, this);
        } else {
            Intent installIntent = new Intent();
            installIntent.setAction(TextToSpeech.Engine.ACTION_INSTALL_TTS_DATA);
            startActivity(installIntent);
        }
    }
}

private void setDefaultTTSEngine() {
    Intent intent = new Intent();
    intent.setAction(TextToSpeech.Engine.ACTION_INSTALL_TTS_DATA);
    intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
    startActivity(intent);
}

在setDefaultTTSEngine方法中，我们启动了一个安装TextToSpeech引擎的Intent，并通过添加FLAG_ACTIVITY_NEW_TASK标记，来让其在新的任务中运行。这样，用户就能够选择默认的语音引擎了。

3. 自定义语音

TextToSpeech不仅支持默认的语音，还支持自定义的语音。我们可以通过在SD卡上添加一些语音文件，来实现自定义语音的播放。下面是一段简单的代码：

// 将语音文件拷贝到SD卡中
// ...

String filepath = Environment.getExternalStorageDirectory().getAbsolutePath() + "/xxx.wav";
mTTS.addSpeech("自定义语音", filepath);
mTTS.speak("自定义语音", TextToSpeech.QUEUE_FLUSH, null);

在上述代码中，我们使用了addSpeech方法来添加自定义语音。该方法需要传入两个参数，第一个参数是用于标记该语音的字符串，第二个参数是语音文件的绝对路径。

四、总结

本文详细介绍了TextToSpeech的使用方法及其相关技巧。在实际开发中，TextToSpeech可以为我们带来更丰富的交互体验，也可以为用户提供更加人性化的功能。希望本文对初学者有所帮助。