Most visited

Recently visited

Added in API level 4

TextToSpeech.Engine

public class TextToSpeech.Engine
extends Object

java.lang.Object
   ↳ android.speech.tts.TextToSpeech.Engine


用于控制文本到语音的常量和参数名称。 这些包括:

Summary

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引擎使用的资源的安装状态时指示失败,意思是 ACTION_CHECK_TTS_DATA

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引擎使用的资源的安装状态时,指示成功与 ACTION_CHECK_TTS_DATA意图。

int DEFAULT_STREAM

播放合成语音时使用的默认音频流。

String EXTRA_AVAILABLE_VOICES

在TextToSpeech引擎返回ArrayList的情况下,通过ACTION_CHECK_TTS_DATA意图结果收到附加信息 所有可用的声音。

String EXTRA_CHECK_VOICE_DATA_FOR

此常数在API级别18中已弃用。冗余功能可在客户端进行,以检查是否存在特定语音数据集。

String EXTRA_SAMPLE_TEXT

通过 ACTION_GET_SAMPLE_TEXT意向结果接收到的额外信息,其中TextToSpeech引擎返回带有请求语音的示例文本的字符串

String EXTRA_TTS_DATA_INSTALLED

此常数在API级别18中已弃用。不再使用。 如果客户对有关更改的信息感兴趣,应该发送ACTION_CHECK_TTS_DATA意图来发现可用的声音。

String EXTRA_UNAVAILABLE_VOICES

在TextToSpeech引擎返回ArrayList的情况下,通过ACTION_CHECK_TTS_DATA意图结果收到附加信息 所有不可用的声音。

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开始,要选择嵌入式合成,请致电( getVoices() ,找到合适的嵌入式语音( isNetworkConnectionRequired() )并将其传递给setVoice(Voice) )。

String KEY_FEATURE_NETWORK_RETRIES_COUNT

可以为请求设置指示网络请求重试次数的功能键。

String KEY_FEATURE_NETWORK_SYNTHESIS

此常数在API级别21中已弃用。从API级别21开始,选择网络综合,请致电getVoices() ,找到合适的网络语音( isNetworkConnectionRequired() )并将其传递给setVoice(Voice)

String KEY_FEATURE_NETWORK_TIMEOUT_MS

功能键,指示可以为请求设置网络超时。

String KEY_FEATURE_NOT_INSTALLED

功能键,指示语音可能需要下载其他数据才能发挥功能。

String KEY_PARAM_PAN

参数键用于指定说话时文字从左向右平移的方式。

String KEY_PARAM_SESSION_ID

用于指定将由请求音频输出使用的音频会话标识符(从 generateAudioSessionId() )的参数关键字。

String KEY_PARAM_STREAM

参数键用于指定讲话文本或播放文件时要使用的音频流类型。

String KEY_PARAM_UTTERANCE_ID

文字已被说出,文件已被播放或已经过了静音持续时间后,用于标识 TextToSpeech.OnUtteranceCompletedListener发音的参数键。

String KEY_PARAM_VOLUME

用于指定相对于说话文本时使用的当前流类型音量的语音音量的参数键。

String SERVICE_META_DATA

文本到语音引擎发布自身信息的名称。

Public constructors

TextToSpeech.Engine()

Inherited methods

From class java.lang.Object

Constants

ACTION_CHECK_TTS_DATA

Added in API level 4
String ACTION_CHECK_TTS_DATA

活动操作:从平台TextToSpeech引擎启动活动,以验证系统上资源文件的正确安装和可用性。 建成后,该活动将返回以下代码之一: CHECK_VOICE_DATA_PASSCHECK_VOICE_DATA_FAIL

此外,活动结果中收到的数据将包含以下字段:

  • EXTRA_AVAILABLE_VOICES which contains an ArrayList of all the available voices. The format of each voice is: lang-COUNTRY-variant where COUNTRY and variant are optional (ie, "eng" or "eng-USA" or "eng-USA-FEMALE").
  • EXTRA_UNAVAILABLE_VOICES which contains an ArrayList of all the unavailable voices (ones that user can install). The format of each voice is: lang-COUNTRY-variant where COUNTRY and variant are optional (ie, "eng" or "eng-USA" or "eng-USA-FEMALE").

常量值:“android.speech.tts.engine.CHECK_TTS_DATA”

ACTION_GET_SAMPLE_TEXT

Added in API level 18
String ACTION_GET_SAMPLE_TEXT

活动意图获取一些示例文本用于演示TTS。 必须通过传递以下额外参数来请求特定区域设置:

  • language
  • country
  • variant
Upon completion, the activity result may contain the following fields:

常量值:“android.speech.tts.engine.GET_SAMPLE_TEXT”

ACTION_INSTALL_TTS_DATA

Added in API level 4
String ACTION_INSTALL_TTS_DATA

活动操作:触发平台TextToSpeech引擎启动安装设备上资源文件的活动,这些文件是TTS运行所需的。 由于用户可能会中断或拒绝安装数据,因此应用程序不应期望从该意图返回时成功安装,如果需要,应该使用ACTION_CHECK_TTS_DATA检查安装状态。

常量值:“android.speech.tts.engine.INSTALL_TTS_DATA”

ACTION_TTS_DATA_INSTALLED

Added in API level 4
String ACTION_TTS_DATA_INSTALLED

广播动作:广播以表示可用语言或/和其功能列表中的变化。

常量值:“android.speech.tts.engine.TTS_DATA_INSTALLED”

CHECK_VOICE_DATA_BAD_DATA

Added in API level 4
int CHECK_VOICE_DATA_BAD_DATA

此常数在API级别18中已弃用。
改用CHECK_VOICE_DATA_FAIL。

当使用 ACTION_CHECK_TTS_DATA意图检查TextToSpeech引擎使用的资源的安装状态时,指示错误的数据。

常量值:-1(0xffffffff)

CHECK_VOICE_DATA_FAIL

Added in API level 4
int CHECK_VOICE_DATA_FAIL

ACTION_CHECK_TTS_DATA意图检查TextToSpeech引擎使用的资源的安装状态时指示失败。

常量值:0(0x00000000)

CHECK_VOICE_DATA_MISSING_DATA

Added in API level 4
int CHECK_VOICE_DATA_MISSING_DATA

此常数在API级别18中已弃用。
改用CHECK_VOICE_DATA_FAIL。

在检查TextToSpeech引擎使用的资源的安装状态时,指示缺少资源,意图为 ACTION_CHECK_TTS_DATA

常量值:-2(0xfffffffe)

CHECK_VOICE_DATA_MISSING_VOLUME

Added in API level 4
int CHECK_VOICE_DATA_MISSING_VOLUME

此常数在API级别18中已弃用。
改用CHECK_VOICE_DATA_FAIL。

使用 ACTION_CHECK_TTS_DATA意图检查TextToSpeech引擎使用的资源的安装状态时指示缺少存储卷。

常量值:-3(0xfffffffd)

CHECK_VOICE_DATA_PASS

Added in API level 4
int CHECK_VOICE_DATA_PASS

ACTION_CHECK_TTS_DATA意图检查TextToSpeech引擎使用的资源的安装状态时指示成功。

常数值:1(0x00000001)

DEFAULT_STREAM

Added in API level 4
int DEFAULT_STREAM

播放合成语音时使用的默认音频流。

常量值:3(0x00000003)

EXTRA_AVAILABLE_VOICES

Added in API level 8
String EXTRA_AVAILABLE_VOICES

在TextToSpeech引擎返回ArrayList的情况下,通过ACTION_CHECK_TTS_DATA意图结果收到附加信息 所有可用的声音。 每种语音的格式是:lang-COUNTRY-variant,其中COUNTRY和变体是可选的(即“eng”或“eng-USA”或“eng-USA-FEMALE”)。

常数值:“availableVoices”

EXTRA_CHECK_VOICE_DATA_FOR

Added in API level 8
String EXTRA_CHECK_VOICE_DATA_FOR

此常数在API级别18中已弃用。
冗余功能,可以在客户端检查是否存在特定的语音数据。

ACTION_CHECK_TTS_DATA意图一起发送的额外信息,其中调用者向TextToSpeech引擎指示通过发送ArrayList检查哪些特定语音数据集 感兴趣的声音。 每种语音的格式是:lang-COUNTRY-variant,其中COUNTRY和变体是可选的(即“eng”或“eng-USA”或“eng-USA-FEMALE”)。

常量值:“checkVoiceDataFor”

EXTRA_SAMPLE_TEXT

Added in API level 18
String EXTRA_SAMPLE_TEXT

通过 ACTION_GET_SAMPLE_TEXT意图结果收到的额外信息,其中TextToSpeech引擎返回带有请求语音的示例文本的字符串

常量值:“sampleText”

EXTRA_TTS_DATA_INSTALLED

Added in API level 4
String EXTRA_TTS_DATA_INSTALLED

此常数在API级别18中已弃用。
不再使用。 如果客户对有关更改的信息感兴趣,应该发送ACTION_CHECK_TTS_DATA意图来发现可用的声音。

通过ACTION_TTS_DATA_INSTALLED意图结果收到附加信息。 它指示合成引擎的数据文件是否已成功安装。 安装从ACTION_INSTALL_TTS_DATA意图开始。 这个额外的可能值是SUCCESSERROR

常量值:“dataInstalled”

EXTRA_UNAVAILABLE_VOICES

Added in API level 8
String EXTRA_UNAVAILABLE_VOICES

在TextToSpeech引擎返回ArrayList的情况下,通过ACTION_CHECK_TTS_DATA意图结果收到附加信息 所有不可用的声音。 每种语音的格式是:lang-COUNTRY-variant,其中COUNTRY和变体是可选的(即“eng”或“eng-USA”或“eng-USA-FEMALE”)。

常量值:“unavailableVoices”

EXTRA_VOICE_DATA_FILES

Added in API level 4
String EXTRA_VOICE_DATA_FILES

此常数在API级别18中已弃用。
TTS引擎实现细节,这些信息对于文本到语音API客户端没有用处。

通过 ACTION_CHECK_TTS_DATA意图结果接收到的额外信息,其中TextToSpeech引擎在资源路径下指定其资源的文件名。

常量值:“dataFiles”

EXTRA_VOICE_DATA_FILES_INFO

Added in API level 4
String EXTRA_VOICE_DATA_FILES_INFO

此常数在API级别18中已弃用。
TTS引擎实现细节,这些信息对于文本到语音API客户端没有用处。

与接收到的额外信息 ACTION_CHECK_TTS_DATA意图的结果,其中的文字转语音引擎指定与每个资源文件关联的语言环境。

常量值:“dataFilesInfo”

EXTRA_VOICE_DATA_ROOT_DIRECTORY

Added in API level 4
String EXTRA_VOICE_DATA_ROOT_DIRECTORY

此常数在API级别18中已弃用。
TTS引擎实现细节,这些信息对于文本到语音API客户端没有用处。

在TextToSpeech引擎指定其资源路径的情况下,通过ACTION_CHECK_TTS_DATA意图得到的额外信息。 它可以被语言包用来找出将数据放在哪里。

常量值:“dataRoot”

INTENT_ACTION_TTS_SERVICE

Added in API level 14
String INTENT_ACTION_TTS_SERVICE

启动TTS服务的意图。 处理此意图的服务必须延伸TextToSpeechService 普通应用程序不应该直接使用这个意图,而应该使用这个类中的方法与TTS服务进行交谈。

常量值:“android.intent.action.TTS_SERVICE”

KEY_FEATURE_EMBEDDED_SYNTHESIS

Added in API level 15
String KEY_FEATURE_EMBEDDED_SYNTHESIS

此常数在API级别21中已弃用。
从API级别21开始,选择嵌入式合成,调用( getVoices() ,找到合适的嵌入语音( isNetworkConnectionRequired() )并将其传递给setVoice(Voice) )。

嵌入式合成的功能键。 有关功能密钥如何工作的说明,请参阅getFeatures(Locale) 如果根据getFeatures(Locale)由引擎设置和支持,则引擎必须在设备上合成文本(无需发出网络请求)。

也可以看看:

常数值:“embeddedTts”

KEY_FEATURE_NETWORK_RETRIES_COUNT

Added in API level 21
String KEY_FEATURE_NETWORK_RETRIES_COUNT

可以为请求设置指示网络请求重试次数的功能键。 如果按照getFeatures(Locale)getFeatures()设置和支持,则可以将其用作请求参数,以设置发生故障时尝试执行的网络请求重试次数。 当用作请求参数的关键字时,其值应该是具有整数值的字符串。

也可以看看:

常量值:“networkRetriesCount”

KEY_FEATURE_NETWORK_SYNTHESIS

Added in API level 15
String KEY_FEATURE_NETWORK_SYNTHESIS

此常数在API级别21中已弃用。
从API级别21开始,选择网络综合,请致电getVoices() ,找到合适的网络语音( isNetworkConnectionRequired() )并将其传递到setVoice(Voice)

网络合成的功能键。 有关功能密钥如何工作的说明,请参见getFeatures(Locale) 如果设置(并且按照getFeatures(Locale)由引擎支持,引擎必须使用基于网络的综合。

也可以看看:

常量值:“networkTts”

KEY_FEATURE_NETWORK_TIMEOUT_MS

Added in API level 21
String KEY_FEATURE_NETWORK_TIMEOUT_MS

功能键,指示可以为请求设置网络超时。 如果按照getFeatures(Locale)getFeatures()设置和支持,则可以将其用作请求参数,以便在综合失败之前设置单个请求尝试的最大允许时间(以毫秒为单位)。 当用作请求参数的关键字时,其值应该是具有整数值的字符串。

也可以看看:

常量值:“networkTimeoutMs”

KEY_FEATURE_NOT_INSTALLED

Added in API level 21
String KEY_FEATURE_NOT_INSTALLED

功能键,指示语音可能需要下载其他数据才能发挥功能。 通过拨打setVoice(Voice)setLanguage(Locale)触发下载。 在下载完成之前,每个合成请求都会报告ERROR_NOT_INSTALLED_YET错误,或者使用不同的语音来合成请求。 此功能不应该被用作请求参数的关键字。

也可以看看:

常量值:“notInstalled”

KEY_PARAM_PAN

Added in API level 11
String KEY_PARAM_PAN

参数键用于指定说话时文字从左向右平移的方式。 平移指定为范围从-1到+1的浮点,其中-1映射到硬左平移,0为中心(默认行为),+1为右移。

也可以看看:

常数值:“pan”

KEY_PARAM_SESSION_ID

Added in API level 21
String KEY_PARAM_SESSION_ID

用于指定将由请求音频输出使用的音频会话标识符(从generateAudioSessionId() )的参数关键字。 它可用于将AudioEffect对象中的一个与合成(或earcon)输出相关联。

也可以看看:

常量值:“sessionId”

KEY_PARAM_STREAM

Added in API level 4
String KEY_PARAM_STREAM

参数键用于指定讲话文本或播放文件时要使用的音频流类型。 该值应该是在所定义的STREAM_常数之一AudioManager

也可以看看:

常量值:“streamType”

KEY_PARAM_UTTERANCE_ID

Added in API level 4
String KEY_PARAM_UTTERANCE_ID

文字已被使用后,参数键识别 TextToSpeech.OnUtteranceCompletedListener的话语,文件已播放或静音持续时间已过。

也可以看看:

常量值:“utteranceId”

KEY_PARAM_VOLUME

Added in API level 11
String KEY_PARAM_VOLUME

用于指定相对于说话文本时使用的当前流类型音量的语音音量的参数键。 音量指定为从0到1的浮点数,其中0表示静音,1表示最大音量(默认行为)。

也可以看看:

常量值:“音量”

SERVICE_META_DATA

Added in API level 14
String SERVICE_META_DATA

文本到语音引擎发布自身信息的名称。 这个元数据应该引用包含<tts-engine>标签的XML资源。

常量值:“android.speech.tts”

Public constructors

TextToSpeech.Engine

Added in API level 4
TextToSpeech.Engine ()

Hooray!