Android tts的使用

Android tts

1.基本使用

1.1 初始化

使用默认的引擎

TextToSpeech(Context context, TextToSpeech.OnInitListener listener)

使用指定的引擎

TextToSpeech(Context context, TextToSpeech.OnInitListener listener, String engine)

查看默认的引擎

String defaultEngine = mTextToSpeech.getDefaultEngine();//讯飞语音引擎是com.iflytek.speechsuite

遍历所有的引擎

List<TextToSpeech.EngineInfo> engines = mTextToSpeech.getEngines();
for (int i = 0; i < engines.size(); i++) {
   Log.e("tag", "talk: " + i + "\t" + engines.get(i).name + "\t" + engines.get(i).label);
}

结果

0	com.iflytek.speechsuite	讯飞语音引擎
1	com.android.tback	天坦语音
2	com.iflytek.vflynote	讯飞语记

天坦语音和讯飞语记都是讯飞的语音

初始化

mTextToSpeech = new TextToSpeech(this, new TextToSpeech.OnInitListener() {
     @Override
     public void onInit(int status) {
         if (status == TextToSpeech.SUCCESS) {
         	 //设置中文
             int result = mTextToSpeech.setLanguage(Locale.CHINA);
             if (result != TextToSpeech.LANG_COUNTRY_AVAILABLE
                            && result != TextToSpeech.LANG_AVAILABLE) {
                  Toast.makeText(TtsActivity.this, "TTS暂时不支持这种语音的朗读！",
                                Toast.LENGTH_SHORT).show();
              }
         }
     }
});

1.2 设置参数

设置语速

//设置速率,速率：默认是1.0f，可选0.5f~2.0f
//一般手机中默认的都是讯飞语音引擎，语速的范围是10~600，我们可以设置[0.5,6]
mTextToSpeech.setSpeechRate(1.0f);

查询引擎语速

try {
    //讯飞语音引擎，语速的范围是10~600，我们可以设置[0.5,6]
    Log.e("zxd", "updateRate: " + i + "\t" + Settings.Secure.getInt(mContext.getContentResolver(), TTS_DEFAULT_RATE));
} catch (Settings.SettingNotFoundException e) {
    e.printStackTrace();
}

设置音调

//设置音调，默认是1.0。值越大声音越尖(女生)，值越小则变成男声,1.0是常规
mTextToSpeech.setPitch(1.0f);

设置最大播报长度

mTextToSpeech.getMaxSpeechInputLength();//最大播报文本长度

设置播报状态回调

mTextToSpeech.setOnUtteranceProgressListener(new UtteranceProgressListener() {
        @Override
        public void onStart(String utteranceId) {
          //播报开始
        }

        @Override
        public void onDone(String utteranceId) {
          //播报结束
        }

        @Override
        public void onError(String utteranceId) {
          //播报出错
        }
      });

1.3 播放与暂停

播放

/**
* text 需要转成语音的文字
* queueMode 队列方式：
* QUEUE_ADD：播放完之前的语音任务后才播报本次内容
* QUEUE_FLUSH：丢弃之前的播报任务，立即播报本次内容
* params 设置TTS参数，可以是null。
* KEY_PARAM_STREAM：音频通道，可以是：STREAM_MUSIC、STREAM_NOTIFICATION、STREAM_RING等
* KEY_PARAM_VOLUME：音量大小，0-1f
* utteranceId：当前朗读文本的id
*/
mTextToSpeech.speak(text, TextToSpeech.QUEUE_ADD, null, "test");
mTextToSpeech.speak(text, TextToSpeech.QUEUE_FLUSH, null, "test");
//也可以放很多参数，但实际上没有什么必要
long utteranceId = System.currentTimeMillis();
HashMap ttsOptions = new HashMap<String, String>();
ttsOptions.put(TextToSpeech.Engine.KEY_PARAM_UTTERANCE_ID,
String.valueOf(utteranceId));//utterance，这个参数随便写，用于监听播报完成的回调中
ttsOptions.put(TextToSpeech.Engine.KEY_PARAM_VOLUME, String.valueOf(1));//音量
ttsOptions.put(TextToSpeech.Engine.KEY_PARAM_STREAM,
String.valueOf(AudioManager.STREAM_NOTIFICATION));//播放类型
int ret = mSpeech.speak(tts, TextToSpeech.QUEUE_FLUSH, ttsOptions);
if (ret == TextToSpeech.SUCCESS) {
  //播报成功
}

暂停

//不管是否正在朗读TTS都被打断
textToSpeech.stop();//此时会触发UtteranceProgressListener的onDone回调。

关闭，销毁引擎

textToSpeech.shutdown();

1.4 保存语音文件并且播放

保存音频

//先判断目录文件是否存在，然后创建wav文件
File rootFile = new File(Environment.getExternalStorageDirectory().getAbsolutePath()
                        + "/Android/hecheng/");
if (!rootFile.exists()) {
   rootFile.mkdir();
}
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
   int ret = mTextToSpeech.synthesizeToFile("这是中文合成效果", null,
   new File("/mnt/sdcard/" + new Date().toString().replace(" ", "_").trim() + ".wav"),
   TextToSpeech.Engine.KEY_PARAM_UTTERANCE_ID);
   if (ret == TextToSpeech.SUCCESS) {
      //合成文件成功
      ToastUtils.show(TtsActivity.this, "合成成功!");
    }
}

解释

这个方法过时了
mTextToSpeech.synthesizeToFile(final String text, final HashMap<String, String> params,
            final String filename)
            
HashMap<String, String> hashMap = new HashMap<>();
hashMap.put(TextToSpeech.Engine.KEY_PARAM_UTTERANCE_ID, "com.zxd.aa");
mTextToSpeech.synthesizeToFile("这是英文合成效果", hashMap, Environment.getExternalStorageDirectory().getAbsolutePath() + "/Android/hecheng/" + new Date().toString().replace(" ", "_").trim() + ".wav");            

播放音频

private MediaPlayer player;
player = new MediaPlayer();
try {
    player.reset();
    player.setDataSource("/mnt/sdcard/" + "12321.wav");
    player.prepare();
    player.start();
} catch (IOException e) {
    e.printStackTrace();
    Log.e("zxd", "IOException:" + e.getMessage());
}

简单操作

//播放
player.start();
//暂停
player.pause();
//恢复
player.resume();其实就是start()，Calling {@link #start()} to resume playback for a paused MediaPlayer object, and the resumed playback
//重置
player.reset();

1.5 Android11适配

为兼容Android11系统手机，我们需要在应用程序AndroidManifest.xml文件中增加如下声明：

  <queries>
    <intent>
      <action android:name="android.intent.action.TTS_SERVICE"/>
    </intent>
  </queries>
复制代码

3.5.x版本Gradle需要使用3.5.4以上版本才能识别queries属性。

参考链接

Android原生TTS的基本使用以及配合中文语音包实现中文TTS √

Android TTS的暂停与恢复功能 √

Android TTS引擎使用 √