Android TTS

Android原生TTS使用Pico引擎，听说对中文支持的不是太友好，TTS即TextToSpeech，废话不多说。

一、构造函数

我们一般都是使用默认的引擎，所以构造函数使用

public TextToSpeech(Context context, OnInitListener listener)

这里其实做了很多的工作，只要是启动默认引擎

 二、主要的播放方法 speak

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

text 需要转成语音的文字
queueMode 队列方式：
QUEUE_ADD：播放完之前的语音任务后才播报本次内容
QUEUE_FLUSH：丢弃之前的播报任务，立即播报本次内容
params 设置TTS参数，可以是null。
KEY_PARAM_STREAM：音频通道，可以是：STREAM_MUSIC、STREAM_NOTIFICATION、STREAM_RING等
KEY_PARAM_VOLUME：音量大小，0-1f
返回值：int SUCCESS = 0，int ERROR = -1。

private HashMap<String, String> params = new HashMap<String, String>(); 
params.put(TextToSpeech.Engine.KEY_PARAM_STREAM, String.valueOf(AudioManager.STREAM_ALARM)); 
mTts.speak(textContent, TextToSpeech.QUEUE_FLUSH, params);

三、TTS播放状态

介绍一下setOnUtteranceProgressListener()的用法，这个方法就是监听语音播报完成状态的回调，很多人用了也设置了这个监听，但是没有回调，这是为什么呢？因为我们在设置播放语音的时候，习惯性的把最后一个参数设置为null,事实上要使用setOnUtteranceProgressListener()方法是要用到最后一个参数的。

mTts.put(TextToSpeech.Engine.KEY_PARAM_UTTERANCE_ID, "utterance");//utterance，也可以是1,2,3...之类的String。这个参数随便写，用于监听播报完成的回调中
mTts.setOnUtteranceProgressListener(new UtteranceProgressListener() {
                        @Override
                        public void onStart(String s) {//开始播放， s就是上面的“utterance”
 
                        }
 
                        @Override
                        public void onDone(String s) {//完成之后
                        }
 
                        @Override
                        public void onError(String s) {//播放错误的处理
 
                        }
                    });

Demo如下：

package com.interjoy.demoqrcode;

import android.os.Bundle;
import android.speech.tts.TextToSpeech;
import android.support.v7.app.AppCompatActivity;
import android.text.TextUtils;
import android.util.Log;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import android.widget.TextView;
import android.widget.Toast;

import java.util.Locale;

public class MainActivity extends AppCompatActivity {
    private Button btn_to_speak;
    private TextToSpeech mSpeech;
    private EditText et_input;
    private static final String TAG_TTS = "MainActivity";

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        init();
    }

    private <T> T f(int resId) {
        return (T) findViewById(resId);
    }

    private void init() {
        btn_to_speak = f(R.id.btn_to_speak);
        et_input = f(R.id.et_input);
        speechInit();
        btn_to_speak.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                String text = et_input.getText().toString();
                if (TextUtils.isEmpty(text)) text = "请输入要测试的内容";
                playTTS(text);
            }
        });
    }

    /**
     * 初始化TextToSpeech，在onCreate中调用
     */
    private void speechInit() {
        if (mSpeech != null) {
            mSpeech.stop();
            mSpeech.shutdown();
            mSpeech = null;
        }
        // 创建TTS对象
        mSpeech = new TextToSpeech(MainActivity.this, new TTSListener());
    }

    /**
     * 将文本用TTS播放
     *
     * @param str 播放的文本内容
     */
    private void playTTS(String str) {
        if (mSpeech == null) mSpeech = new TextToSpeech(this, new TTSListener());
        mSpeech.speak(str, TextToSpeech.QUEUE_FLUSH, null);
        Log.i(TAG_TTS, "播放语音为：" + str);
    }

    private final class TTSListener implements TextToSpeech.OnInitListener {
        @Override
        public void onInit(int status) {
            Log.e(TAG_TTS, "初始化结果：" + (status == TextToSpeech.SUCCESS));
            int result = mSpeech.setLanguage(Locale.CHINESE);
            //如果返回值为-1或-2，说明不支持该语言
　　　　　　　if(result == TextToSpeech.LANG_MISSING_DATA || result == TextToSpeech.LANG_NOT_SUPPORTED){

               Log.e(TAG_TTS, "不支持该语言");
  　　　　　　}      

        }
    }

    @Override
    protected void onDestroy() {
        if (mSpeech != null) {
            mSpeech.stop();
            mSpeech.shutdown();
            mSpeech = null;
        }
        super.onDestroy();
    }
}

分析TTS FWK源码可知text<=4000字符，否则返回ERROR，即丢弃此次，不播放。若是电子书之类大文本播放，网上的一些做法是根据文本的标点分割成n端，循环去播或者根据setOnUtteranceProgressListener()监听去做。

另外，在项目中替换引擎的方法

Android原生引擎也即包名com.svox.pico

原生的做法也是启动一个app，其带有service，路径：/workspace/external/svox/pico/AndroidManifest.xml 中package="com.svox.pico"

启动的流程可以入下图类似（原CompatTtsService.java，自定义替换为JpccCompatTtsService.java）