TextToSpeech类学习和简单封装

前言

业务涉及到对接TTS相关，所以简单学习下如何使用。

一、TTS是什么？

TextToSpeech简称为TTS，即从文本转语音，是人机对话的一部分，让机器能够说话。在内置芯片的支持之下，通过神经网络的设计，把文字智能地转化为自然语音流。TTS技术对文本文件进行实时转换，转换时间之短可以秒计算。在其特有智能语音控制器作用下，文本输出的语音音律流畅，使得听者在听取信息时感觉自然，毫无机器语音输出的冷漠与生涩感。
安卓的TextToSpeech是Android平台上一个重要的系统功能，它能够将文本转换成可听的语音，为用户提供更加方便的交互体验。同时，作为开发者，我们也可以基于TextToSpeech实现一些有趣的应用程序。比如市面上一些小说的听书功能，就是基于TTS播报开发的。

二、TextToSpeech简单使用

1.官方介绍

我们翻译一下：
从文本中合成语音，以便立即播放或创建声音文件。

TextToSpeech 实例只能在完成初始化后用于合成文本。实现 TextToSpeech.OnInitListener 以通知初始化完成。
当您使用完TextToSpeech实例时，请调用shutdown()方法以释放TextToSpeech引擎使用的本机资源。使用文本到语音的应用程序的目标Android 11应声明TextToSpeech。然后要在清单文件做以下申明。

 <queries&gt;
   ...
  <intent&gt;
      <action android:name="android.intent.action.TTS_SERVICE" /&gt;
  </intent&gt;
 </queries&gt;

什么意思呢，就是使用之前要用queries标签在清单文件中声明TTS_SERVICE这个action，告诉你的app你要对tts进行通信，不要拦截你的tts引擎与你的app进行通信，我自己试的时候没有申请这个action也能访问，但是为了保险咱们还是加上哈。

2.简单使用

上面官方把使用方法都告诉我们了，我们来简单试一试。
清单文件是这个样子的：

<?xml version="1.0" encoding="utf-8"?&gt;
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"&gt;

    <application
        android:allowBackup="true"
        android:dataExtractionRules="@xml/data_extraction_rules"
        android:fullBackupContent="@xml/backup_rules"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/Theme.TEST"
        tools:targetApi="31"&gt;
        <activity
            android:name=".MainActivity"
            android:exported="true"&gt;
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

    <queries>
        <intent>
            <action android:name="android.intent.action.TTS_SERVICE" />
        </intent>
    </queries>

</manifest>

布局文件是这个样子的：

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">
    <EditText
        android:id="@+id/edit"
        android:text="我是要转为语音的文字"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent"/>

    <Button
        android:id="@+id/test"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="将上面的文字转为语音"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/edit"/>



</androidx.constraintlayout.widget.ConstraintLayout>

布局预览就是这样的：

activity代码是这样的：

package com.example.test

import android.annotation.SuppressLint
import android.os.Bundle
import android.speech.tts.TextToSpeech
import android.util.Log
import android.widget.Button
import android.widget.EditText
import androidx.appcompat.app.AppCompatActivity
import java.util.Locale


class MainActivity : AppCompatActivity() {
    private  val TAG = "MainActivity"
    var button :Button ? = null
    var editText :EditText?=null
    private lateinit var tts :TextToSpeech


    @SuppressLint("MissingInflatedId")
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        button = findViewById(R.id.test)
        editText = findViewById(R.id.edit)
        tts = TextToSpeech(this@MainActivity
        ) { status ->
            if (status == TextToSpeech.SUCCESS) {
                Log.d(TAG, "onInit: ")
            }
        }
        tts.language = Locale.CHINA
        button?.setOnClickListener {
            tts.speak(editText?.text.toString(), TextToSpeech.QUEUE_ADD, null, "custom_pronunciation")
        }


    }



    override fun onDestroy() {
        super.onDestroy()
        tts.shutdown()

    }


}

这段代码是一个简单的Android应用程序，其主要功能是将用户在EditText中输入的文本转化为语音。以下是这段代码的详细解释：

首先，我们定义了一个名为 MainActivity 的类，它继承自 AppCompatActivity。在Android开发中，AppCompatActivity 是一个为兼容不同版本Android API设计的Activity类。

在 MainActivity 类中，我们定义了一些变量：

• button 和 editText 是这个应用中的两个UI组件，分别是一个按钮和一个文本输入框。
• tts 是一个 TextToSpeech 对象，它的作用是将文本转化为语音。

在 onCreate 方法中，首先调用了 super.onCreate(savedInstanceState) 来初始化Activity。然后，通过 findViewById 方法找到了 button 和 editText 这两个UI组件。之后，我们实例化了 tts，并在其初始化完成后（onInit）打印了一条日志。然后设置了 tts 的语言为中文。最后，设置了 button 的点击监听器，当用户点击按钮时，会将 editText 中的文本转化为语音。

在 onDestroy 方法中，我们调用了 tts.shutdown() 来释放 tts 对象占用的资源。这是很重要的，因为在Android中，如果一个Activity不再需要时（例如，当用户按下返回键，或者Activity已经完成了它的任务），系统会销毁这个Activity。在销毁Activity之前，我们需要手动关闭一些可能正在运行的后台任务，以释放资源并避免内存泄漏。

此外，代码中使用了 @SuppressLint("MissingInflatedId") 注解来抑制一些可能会在真实应用中出现的警告或错误。例如，可能出现的 “MissingInflatedId” 错误是因为在代码中直接使用视图ID，而在实际的XML布局文件中并没有定义这个ID。这个注解告诉Android编译器忽略这个错误或警告。

我是用的荣耀50进行调试，我在

设置

−

>

辅助功能

−

>

无障碍

−

>

文本转语音

设置->辅助功能->无障碍->文本转语音

设置−>辅助功能−>无障碍−>文本转语音

找到了tts相关设置，将其设置为了荣耀语音引擎

然后运行程序，成功播报！

三、TextToSpeech简单封装

虽然成功进行播报了，但是在实际使用的时候我们肯定不能就把代码直接贴进去，我们简单封装一下，新建一个TextToSpeechUntil的object

package com.example.test

import android.content.Context
import android.speech.tts.TextToSpeech
import android.speech.tts.UtteranceProgressListener
import android.util.Log
import java.util.Locale

object TextToSpeechUntil  {
    private const val TAG = "TextToSpeechUntil"
    private lateinit var tts : TextToSpeech
    private var utteranceId = System.currentTimeMillis()

    fun init(context: Context){
        tts = TextToSpeech(context
        ) { status ->
            if (status == TextToSpeech.SUCCESS) {
                Log.d(TAG, "onInit: ")
            }
        }
        tts.language = Locale.CHINA
        Log.d(TAG, "init: defaultEngine ${tts.defaultEngine}")
        tts.setOnUtteranceProgressListener(object : UtteranceProgressListener() {
            override fun onStart(utteranceId: String?) {
                Log.d(TAG, "onStart: $utteranceId")
            }

            override fun onDone(utteranceId: String?) {
                Log.d(TAG, "onDone: $utteranceId")
            }

            override fun onError(utteranceId: String?) {
                Log.d(TAG, "onError: $utteranceId")
            }

        })


    }

    fun speak(string: String){
        utteranceId = System.currentTimeMillis()
        tts.speak(string, TextToSpeech.QUEUE_ADD, null, utteranceId.toString())
    }

    fun destroy(){
        tts.shutdown()
    }
}

这个代码是一个简单的TextToSpeech模块，可以将输入的字符串转化为语音并播放出来。同时，它还监听了语音合成器的状态，可以在日志中看到每一次语音合成的信息，该模块可以将文本转化为语音。现在我来为你简单解释下这个代码：

代码导入了几个Android的类，包括Context（用于获取应用程序环境的类）、TextToSpeech（用于将文本转化为语音的类）、UtteranceProgressListener（用于监听语音合成器状态的类）和Log（用于记录日志的类）。

之后，代码定义了一个名为TextToSpeechUntil的Object，这个Object包含了一些变量和方法。

其中，tts是一个TextToSpeech对象，用于将文本转化为语音。utteranceId是一个变量，用于唯一标识每一次的语音合成。

在init方法中，我们首先初始化了一个TextToSpeech对象，并设置其语言为中文。然后设置了一个UtteranceProgressListener，它可以监听语音合成器的状态。在开始、完成和出错时，都会打印相应的日志。

在speak方法中，我们调用TextToSpeech对象的speak方法，将传入的字符串转化为语音。同时，我们设置了utteranceId，这样我们可以在日志中清楚地知道每一次语音合成的情况。

最后，在destroy方法中，我们调用TextToSpeech对象的shutdown方法，关闭TextToSpeech引擎并释放资源。

然后我们将activity的代码更改如下：

package com.example.test

import android.annotation.SuppressLint
import android.os.Bundle
import android.speech.tts.TextToSpeech
import android.util.Log
import android.widget.Button
import android.widget.EditText
import androidx.appcompat.app.AppCompatActivity
import java.util.Locale


class MainActivity : AppCompatActivity() {
    private  val TAG = "MainActivity"
    var button :Button ? = null
    var editText :EditText?=null
    private lateinit var tts :TextToSpeech


    @SuppressLint("MissingInflatedId")
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        button = findViewById(R.id.test)
        editText = findViewById(R.id.edit)
        testTextToSpeechUntil()
    }



    override fun onDestroy() {
        super.onDestroy()
        TextToSpeechUntil.destroy()
    }

    private fun testTextToSpeechUntil(){
    	//这里偷懒没将初始化放到applicaiton中
        TextToSpeechUntil.init(this)
        button?.setOnClickListener {
            TextToSpeechUntil.speak(editText?.text.toString())
        }
    }
}

然后再次运行，播报成功，并且defaultEngine 打印出包名为荣耀语音引擎，如果你需要使用其他引擎可以自行下载然后通过代码设置。

总结

本文主要介绍了Android平台上的文本转语音功能TextToSpeech的使用方法和简单封装。首先介绍了TTS的作用和官方介绍，然后通过一个简单的示例程序演示了如何使用TextToSpeech进行文本转语音。最后，针对实际应用场景，对TextToSpeech进行了简单封装，方便开发者调用。

代码007普通

打赏 收藏 海报 链接