public class TextToSpeech.Engine
extends Object
| java.lang.Object | |
| ↳ | android.speech.tts.TextToSpeech.Engine |
用于控制文本到语音的常量和参数名称。 这些包括：
Android开发手册KEY_PARAM_UTTERANCE_ID, KEY_PARAM_STREAM. KEY_FEATURE_NETWORK_SYNTHESIS. These values may be passed in to speak(CharSequence, int, Bundle, String) and synthesizeToFile(CharSequence, Bundle, File, String) to modify engine behaviour. The engine can be queried for the set of features it supports through getFeatures(java.util.Locale). Constants |
|
|---|---|
String |
ACTION_CHECK_TTS_DATA 活动操作：从平台TextToSpeech引擎启动活动，以验证系统上资源文件的正确安装和可用性。 |
String |
ACTION_GET_SAMPLE_TEXT 活动意图获取一些示例文本用于演示TTS。 |
String |
ACTION_INSTALL_TTS_DATA 活动操作：触发平台TextToSpeech引擎启动安装设备上资源文件的活动，这些文件是TTS运行所需的。 |
String |
ACTION_TTS_DATA_INSTALLED 广播动作：广播以表示可用语言或/和其功能列表中的变化。 |
int |
CHECK_VOICE_DATA_BAD_DATA 此常量在API级别18中已弃用。请改用CHECK_VOICE_DATA_FAIL。 |
int |
CHECK_VOICE_DATA_FAIL 在检查TextToSpeech引擎使用的资源的安装状态时指示失败，意思是 |
int |
CHECK_VOICE_DATA_MISSING_DATA 此常量在API级别18中已弃用。请改用CHECK_VOICE_DATA_FAIL。 |
int |
CHECK_VOICE_DATA_MISSING_VOLUME 此常量在API级别18中已弃用。请改用CHECK_VOICE_DATA_FAIL。 |
int |
CHECK_VOICE_DATA_PASS 在检查TextToSpeech引擎使用的资源的安装状态时，指示成功与 |
int |
DEFAULT_STREAM 播放合成语音时使用的默认音频流。 |
String |
EXTRA_AVAILABLE_VOICES 在TextToSpeech引擎返回ArrayList的情况下，通过 |
String |
EXTRA_CHECK_VOICE_DATA_FOR 此常数在API级别18中已弃用。冗余功能可在客户端进行，以检查是否存在特定语音数据集。 |
String |
EXTRA_SAMPLE_TEXT 通过 |
String |
EXTRA_TTS_DATA_INSTALLED 此常数在API级别18中已弃用。不再使用。 如果客户对有关更改的信息感兴趣，应该发送ACTION_CHECK_TTS_DATA意图来发现可用的声音。 |
String |
EXTRA_UNAVAILABLE_VOICES 在TextToSpeech引擎返回ArrayList的情况下，通过 |
String |
EXTRA_VOICE_DATA_FILES 此常数在API级别18中已弃用.TTS引擎实现细节中，此信息对于文本到语音API客户端没有用处。 |
String |
EXTRA_VOICE_DATA_FILES_INFO 此常数在API级别18中已弃用.TTS引擎实现细节中，此信息对于文本到语音API客户端没有用处。 |
String |
EXTRA_VOICE_DATA_ROOT_DIRECTORY 此常数在API级别18中已弃用.TTS引擎实现细节中，此信息对于文本到语音API客户端没有用处。 |
String |
INTENT_ACTION_TTS_SERVICE 启动TTS服务的意图。 |
String |
KEY_FEATURE_EMBEDDED_SYNTHESIS 此常数在API级别21中已弃用。从API级别21开始，要选择嵌入式合成，请致电（ |
String |
KEY_FEATURE_NETWORK_RETRIES_COUNT 可以为请求设置指示网络请求重试次数的功能键。 |
String |
KEY_FEATURE_NETWORK_SYNTHESIS 此常数在API级别21中已弃用。从API级别21开始，选择网络综合，请致电 |
String |
KEY_FEATURE_NETWORK_TIMEOUT_MS 功能键，指示可以为请求设置网络超时。 |
String |
KEY_FEATURE_NOT_INSTALLED 功能键，指示语音可能需要下载其他数据才能发挥功能。 |
String |
KEY_PARAM_PAN 参数键用于指定说话时文字从左向右平移的方式。 |
String |
KEY_PARAM_SESSION_ID 用于指定将由请求音频输出使用的音频会话标识符（从 |
String |
KEY_PARAM_STREAM 参数键用于指定讲话文本或播放文件时要使用的音频流类型。 |
String |
KEY_PARAM_UTTERANCE_ID 文字已被说出，文件已被播放或已经过了静音持续时间后，用于标识 |
String |
KEY_PARAM_VOLUME 用于指定相对于说话文本时使用的当前流类型音量的语音音量的参数键。 |
String |
SERVICE_META_DATA 文本到语音引擎发布自身信息的名称。 |
Public constructors |
|
|---|---|
TextToSpeech.Engine() |
|
Inherited methods |
|
|---|---|
 From class java.lang.Object
|
|
String ACTION_CHECK_TTS_DATA
活动操作：从平台TextToSpeech引擎启动活动，以验证系统上资源文件的正确安装和可用性。 建成后，该活动将返回以下代码之一： CHECK_VOICE_DATA_PASS ， CHECK_VOICE_DATA_FAIL ，
此外，活动结果中收到的数据将包含以下字段：
EXTRA_AVAILABLE_VOICES which contains an ArrayList
EXTRA_UNAVAILABLE_VOICES which contains an ArrayList
常量值：“android.speech.tts.engine.CHECK_TTS_DATA”
String ACTION_GET_SAMPLE_TEXT
活动意图获取一些示例文本用于演示TTS。 必须通过传递以下额外参数来请求特定区域设置：
EXTRA_SAMPLE_TEXT which contains an String with sample text.常量值：“android.speech.tts.engine.GET_SAMPLE_TEXT”
String ACTION_INSTALL_TTS_DATA
活动操作：触发平台TextToSpeech引擎启动安装设备上资源文件的活动，这些文件是TTS运行所需的。 由于用户可能会中断或拒绝安装数据，因此应用程序不应期望从该意图返回时成功安装，如果需要，应该使用ACTION_CHECK_TTS_DATA检查安装状态。
常量值：“android.speech.tts.engine.INSTALL_TTS_DATA”
String ACTION_TTS_DATA_INSTALLED
广播动作：广播以表示可用语言或/和其功能列表中的变化。
常量值：“android.speech.tts.engine.TTS_DATA_INSTALLED”
int CHECK_VOICE_DATA_BAD_DATA
此常数在API级别18中已弃用。
改用CHECK_VOICE_DATA_FAIL。
当使用 ACTION_CHECK_TTS_DATA意图检查TextToSpeech引擎使用的资源的安装状态时，指示错误的数据。
常量值：-1（0xffffffff）
int CHECK_VOICE_DATA_FAIL
用 ACTION_CHECK_TTS_DATA意图检查TextToSpeech引擎使用的资源的安装状态时指示失败。
常量值：0（0x00000000）
int CHECK_VOICE_DATA_MISSING_DATA
此常数在API级别18中已弃用。
改用CHECK_VOICE_DATA_FAIL。
在检查TextToSpeech引擎使用的资源的安装状态时，指示缺少资源，意图为 ACTION_CHECK_TTS_DATA 。
常量值：-2（0xfffffffe）
int CHECK_VOICE_DATA_MISSING_VOLUME
此常数在API级别18中已弃用。
改用CHECK_VOICE_DATA_FAIL。
使用 ACTION_CHECK_TTS_DATA意图检查TextToSpeech引擎使用的资源的安装状态时指示缺少存储卷。
常量值：-3（0xfffffffd）
int CHECK_VOICE_DATA_PASS
用 ACTION_CHECK_TTS_DATA意图检查TextToSpeech引擎使用的资源的安装状态时指示成功。
常数值：1（0x00000001）
String EXTRA_AVAILABLE_VOICES
在TextToSpeech引擎返回ArrayList的情况下，通过ACTION_CHECK_TTS_DATA意图结果收到附加信息
常数值：“availableVoices”
String EXTRA_CHECK_VOICE_DATA_FOR
此常数在API级别18中已弃用。
冗余功能，可以在客户端检查是否存在特定的语音数据。
与ACTION_CHECK_TTS_DATA意图一起发送的额外信息，其中调用者向TextToSpeech引擎指示通过发送ArrayList检查哪些特定语音数据集
常量值：“checkVoiceDataFor”
String EXTRA_SAMPLE_TEXT
通过 ACTION_GET_SAMPLE_TEXT意图结果收到的额外信息，其中TextToSpeech引擎返回带有请求语音的示例文本的字符串
常量值：“sampleText”
String EXTRA_TTS_DATA_INSTALLED
此常数在API级别18中已弃用。
不再使用。 如果客户对有关更改的信息感兴趣，应该发送ACTION_CHECK_TTS_DATA意图来发现可用的声音。
通过ACTION_TTS_DATA_INSTALLED意图结果收到附加信息。 它指示合成引擎的数据文件是否已成功安装。 安装从ACTION_INSTALL_TTS_DATA意图开始。 这个额外的可能值是SUCCESS和ERROR 。
常量值：“dataInstalled”
String EXTRA_UNAVAILABLE_VOICES
在TextToSpeech引擎返回ArrayList的情况下，通过ACTION_CHECK_TTS_DATA意图结果收到附加信息
常量值：“unavailableVoices”
String EXTRA_VOICE_DATA_FILES
此常数在API级别18中已弃用。
TTS引擎实现细节，这些信息对于文本到语音API客户端没有用处。
通过 ACTION_CHECK_TTS_DATA意图结果接收到的额外信息，其中TextToSpeech引擎在资源路径下指定其资源的文件名。
常量值：“dataFiles”
String EXTRA_VOICE_DATA_FILES_INFO
此常数在API级别18中已弃用。
TTS引擎实现细节，这些信息对于文本到语音API客户端没有用处。
与接收到的额外信息 ACTION_CHECK_TTS_DATA意图的结果，其中的文字转语音引擎指定与每个资源文件关联的语言环境。
常量值：“dataFilesInfo”
String EXTRA_VOICE_DATA_ROOT_DIRECTORY
此常数在API级别18中已弃用。
TTS引擎实现细节，这些信息对于文本到语音API客户端没有用处。
在TextToSpeech引擎指定其资源路径的情况下，通过ACTION_CHECK_TTS_DATA意图得到的额外信息。 它可以被语言包用来找出将数据放在哪里。
常量值：“dataRoot”
String INTENT_ACTION_TTS_SERVICE
启动TTS服务的意图。 处理此意图的服务必须延伸TextToSpeechService 。 普通应用程序不应该直接使用这个意图，而应该使用这个类中的方法与TTS服务进行交谈。
常量值：“android.intent.action.TTS_SERVICE”
String KEY_FEATURE_EMBEDDED_SYNTHESIS
此常数在API级别21中已弃用。
从API级别21开始，选择嵌入式合成，调用（ getVoices() ，找到合适的嵌入语音（ isNetworkConnectionRequired() ）并将其传递给setVoice(Voice) ）。
嵌入式合成的功能键。 有关功能密钥如何工作的说明，请参阅getFeatures(Locale) 。 如果根据getFeatures(Locale)由引擎设置和支持，则引擎必须在设备上合成文本（无需发出网络请求）。
也可以看看：
常数值：“embeddedTts”
String KEY_FEATURE_NETWORK_RETRIES_COUNT
可以为请求设置指示网络请求重试次数的功能键。 如果按照getFeatures(Locale)或getFeatures()设置和支持，则可以将其用作请求参数，以设置发生故障时尝试执行的网络请求重试次数。 当用作请求参数的关键字时，其值应该是具有整数值的字符串。
常量值：“networkRetriesCount”
String KEY_FEATURE_NETWORK_SYNTHESIS
此常数在API级别21中已弃用。
从API级别21开始，选择网络综合，请致电getVoices() ，找到合适的网络语音（ isNetworkConnectionRequired() ）并将其传递到setVoice(Voice) 。
网络合成的功能键。 有关功能密钥如何工作的说明，请参见getFeatures(Locale) 。 如果设置（并且按照getFeatures(Locale)由引擎支持，引擎必须使用基于网络的综合。
也可以看看：
常量值：“networkTts”
String KEY_FEATURE_NETWORK_TIMEOUT_MS
功能键，指示可以为请求设置网络超时。 如果按照getFeatures(Locale)或getFeatures()设置和支持，则可以将其用作请求参数，以便在综合失败之前设置单个请求尝试的最大允许时间（以毫秒为单位）。 当用作请求参数的关键字时，其值应该是具有整数值的字符串。
常量值：“networkTimeoutMs”
String KEY_FEATURE_NOT_INSTALLED
功能键，指示语音可能需要下载其他数据才能发挥功能。 通过拨打setVoice(Voice)或setLanguage(Locale)触发下载。 在下载完成之前，每个合成请求都会报告ERROR_NOT_INSTALLED_YET错误，或者使用不同的语音来合成请求。 此功能不应该被用作请求参数的关键字。
常量值：“notInstalled”
String KEY_PARAM_PAN
参数键用于指定说话时文字从左向右平移的方式。 平移指定为范围从-1到+1的浮点，其中-1映射到硬左平移，0为中心（默认行为），+1为右移。
常数值：“pan”
String KEY_PARAM_SESSION_ID
用于指定将由请求音频输出使用的音频会话标识符（从generateAudioSessionId() ）的参数关键字。 它可用于将AudioEffect对象中的一个与合成（或earcon）输出相关联。
常量值：“sessionId”
String KEY_PARAM_STREAM
参数键用于指定讲话文本或播放文件时要使用的音频流类型。 该值应该是在所定义的STREAM_常数之一AudioManager 。
常量值：“streamType”
String KEY_PARAM_UTTERANCE_ID
文字已被使用后，参数键识别 TextToSpeech.OnUtteranceCompletedListener的话语，文件已播放或静音持续时间已过。
也可以看看：
常量值：“utteranceId”
String KEY_PARAM_VOLUME
用于指定相对于说话文本时使用的当前流类型音量的语音音量的参数键。 音量指定为从0到1的浮点数，其中0表示静音，1表示最大音量（默认行为）。
常量值：“音量”
String SERVICE_META_DATA
文本到语音引擎发布自身信息的名称。 这个元数据应该引用包含<标签的XML资源。tts-engine>
常量值：“android.speech.tts”