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可以為我們帶來更豐富的交互體驗，也可以為用戶提供更加人性化的功能。希望本文對初學者有所幫助。