Android TTS學習——繼續愛的表白

一． 簡單介紹

在上一篇裏

http://blog.csdn.net/ichliebephone/archive/2010/08/10/5802739.aspx

我們講到了TTS 最主要的一個API ：

public int speak ( String   text, int queueMode,   HashMap < String ,   String > params)

其中我們介紹了前兩個參數，第三個參數設置了null ，並沒有具體介紹。

而且我們在介紹Android TTS 提供的功能時，說到TTS 提供了兩個接口，第一個初始化接口OnInitListener 我們已經使用過了，而第二個接口OnUtteranceCompletedListener 我們還沒有使用到。

首先我們就來簡單介紹一下這個接口的使用方式。TTS 引擎進行語音合成的每個語音片段叫做"utterance ", 而且在送給speak 函數進行語音合成時，可以爲這次的語音片段"utterance " 設置一個ID 。OnUtteranceCompletedListener 這個接口裏定義了一個回調函數，當設置了ID 的語音片段"utterance " 語音合成結束後就會調用這個回調函數。然後我們就可以在這回調函數裏進行我們需要的操作，比如在某個特定ID 的語音片段結束後播放音樂，或者跟蹤記錄哪些文本內容已經被朗讀等。

       下面利用這個接口的功能完成一個Demo 例子，朗讀一段愛的表白，並且在程序退出後可以記住這次表白到哪了，下次在她再次打開程序時，就可以繼續這愛的表白。

二． 實例分析

我們希望做的效果如下：

圖1 實現效果圖

在界面上體現不出這個Demo 的特點，除了一長串英文的愛的表白外，還有一個Speak 按鈕。但當點擊了Speak 按鈕開始朗讀上面的表白後，在沒有讀完就退出程序後，下次再啓動後還會接着上次的繼續朗讀。

創建一個Android 工程，工程名爲AndroidTTSDemoThird, 其中SDK 必須選擇1.6 版本及以上。

其中Main.xml 文件很簡單，如下所示：

<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:orientation="vertical" android:layout_width="fill_parent" android:layout_height="fill_parent" > <EditText android:id="@+id/inputText" android:hint="Input the text here!" android:layout_width="fill_parent" android:layout_height="wrap_content"> </EditText> <Button android:text="Speak" android:id="@+id/speakBtn" android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_gravity="center_horizontal" android:enabled="false" ></Button> </LinearLayout>

Java 文件的編寫：

這次要實現 OnInitListener 和 OnUtteranceCompletedListener 兩個接口

public class AndroidTTSDemoThird extends Activity implements OnInitListener, OnUtteranceCompletedListener{ /** Called when the activity is first created. */ @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); } @Override public void onInit(int status) { // TODO Auto-generated method stub //TTS Engine初始化完成 } @Override public void onUtteranceCompleted(String utteranceId) { // TODO Auto-generated method stub //一個語音片段結束後的回調函數 } }

接着定義好下面要用到的幾個變量：

//定義變量 private EditText inputText = null; private Button speakBtn = null; private TextToSpeech mTts; private static final String TAG = "TTS Demo"; private static final String STORE_NAME = "preferenceFile"; private static final String loveConfession = "You complete me. You had me at hello, you had me at hello. To the world you maybe one person, but to one person you maybe the world. Please believe me, I was prepared for everything,except you. I love that you are the last person I want to talk to before I go to sleep at night. Love means never having to say you're sorry. So choose me. Marry me. Let me make you happy. "; private String[] loveArray; private int lastUtterance = -1; private HashMap<String, String> params = new HashMap<String, String>();

因爲通過前面的兩個 Demo ，我們知道已經安裝了 TTS 需要的數據，因此這裏我們可以在 onCreate 函數中直接創建一個 TextToSpeech 實例，

//創建TextToSpeech實例，初始化完成後會調用OnInitListener（第二個參數）的回調函數 mTts = new TextToSpeech(this, this // TextToSpeech.OnInitListener );

成功創建一個 TextToSpeech 後，就會調用接口 OnInitListener 中定義的回調函數

@Override public void onInit(int status) { // TODO Auto-generated method stub //TTS Engine初始化完成 if(status == TextToSpeech.SUCCESS) { int result = mTts.setLanguage(Locale.US); //設置發音語言 if(result == TextToSpeech.LANG_MISSING_DATA || result == TextToSpeech.LANG_NOT_SUPPORTED) //判斷語言是否可用 { Log.v(TAG, "Language is not available"); speakBtn.setEnabled(false); } else { speakBtn.setEnabled(true); //設置一個語音片段結束後的回調函數 mTts.setOnUtteranceCompletedListener(this); } } }

和前面的 Demo 相比，這裏多了一句 mTts .setOnUtteranceCompletedListener( this );

就是設置語音片段結束後的回調函數。

 

接着在 onCreate 函數中設置 EditText 和 Button 的使用：

//設置控件 inputText = (EditText)findViewById(R.id.inputText); speakBtn = (Button)findViewById(R.id.speakBtn); inputText.setText(loveConfession); speakBtn.setOnClickListener(new OnClickListener() { public void onClick(View v) { // TODO Auto-generated method stub //處理輸入框裏的內容 StringTokenizer loveTokens = new StringTokenizer(inputText.getText().toString(),",."); int i = 0; loveArray = new String[loveTokens.countTokens()]; while(loveTokens.hasMoreTokens()) { loveArray[i++] = loveTokens.nextToken(); } //朗讀輸入框裏的內容 speakText(); } });

在 SpeakBtn 的 onClick 事件中，先把輸入框中的內容按 ',' 和 '.' 分割成一個個短的部分並保存在字符串數組中，然後調用我們寫的 speakText() 函數來進行朗讀。

speakText() 函數的定義如下：

private void speakText() { lastUtterance++; if(lastUtterance >= loveArray.length) { lastUtterance = 0; } Log.v(TAG, "the begin utterance is " + lastUtterance); for(int i = lastUtterance; i < loveArray.length; i++) { //爲每個語音片段都設置一個標記 params.put(TextToSpeech.Engine.KEY_PARAM_UTTERANCE_ID, String.valueOf(i)); mTts.speak(loveArray[i], TextToSpeech.QUEUE_ADD, params); } }

lastUtterance 變量保存上一個語音片段的 ID ， params 是 HashMap<String, String> 類型，鍵值對形式的變量，在這裏我們的鍵 name 爲 TextToSpeech.Engine.KEY_PARAM_UTTERANCE_ID ，是一個 UTTERANCE_ID ，值 value 爲 String.valueOf(i) ，其實只要是任何字符串變量都行，爲了方便我們設置的爲有順序的數字。然後把這個鍵值對變量添加給 speak 函數， TTS 引擎就會在這個語音片段朗讀結束後通知我們，調用設置好的回調函數 onUtteranceCompleted(String utteranceId) ，這個回調函數的內容如下：

@Override public void onUtteranceCompleted(String utteranceId) { // TODO Auto-generated method stub //一個語音片段結束後的回調函數 Log.v(TAG, "Get completed message for the utteranceId " + utteranceId); //用lastUtterance記錄當前結束的語音片段 lastUtterance = Integer.parseInt(utteranceId); }

很簡單，主要就是把當前剛結束的這個語音片段 ID--utteranceId 保存到 lastUtterance 變量中，這樣在程序退出時，我們就可以保存這個變量，

@Override protected void onDestroy() { // TODO Auto-generated method stub //釋放TTS的資源 if(mTts != null) { mTts.stop(); mTts.shutdown(); } //保存lastUtterance值 SharedPreferences settings = getSharedPreferences(STORE_NAME, 0); SharedPreferences.Editor editor = settings.edit(); editor.putInt("lastUtterance", lastUtterance); editor.commit(); Log.v(TAG, "the stored lastUtterance is " + lastUtterance); super.onDestroy(); }

首先是釋放 TTS 資源，然後把 lastUtterance 變量的值以鍵值對的方式保存在系統中，這樣下次啓動程序時 lastUtterance 就可以從系統中讀取上次退出時保存的值。在 onCreate 函數中添加獲取保存的 lastUtterance 代碼：

//獲得保存的lastUtterance值 SharedPreferences settings = getSharedPreferences(STORE_NAME, 0); lastUtterance = settings.getInt("lastUtterance", -1); Log.v(TAG, "the restored lastUtterance is " + lastUtterance);

至此，這個 Demo 完成了，運行後點擊 Speak 按鈕會朗讀文本框中的經典的愛的表白，一小段一小段朗讀，每朗讀完一小段程序都會調用回調函數 onUtteranceCompleted 記錄剛朗讀完的那個小段的 ID ，當所有的表白沒朗讀完就按返回退出程序時，程序在 onDestroy() 裏把記錄着的片段 ID 保存在系統中，這樣下次再次打開程序時就可以接着上次繼續這愛的表白。

 

注：文章參加“ 首屆Google暑期大學生博客分享大賽——2010 Andriod篇”