java.lang.Object | |
↳ | android.speech.tts.TextToSpeech.Engine |
Constants and parameter names for controlling text-to-speech. These include:
KEY_PARAM_UTTERANCE_ID
, KEY_PARAM_STREAM
.
KEY_FEATURE_NETWORK_SYNTHESIS
). These values may be passed in to
speak(String, int, HashMap)
and synthesizeToFile(String, HashMap, 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 | Activity Action: Starts the activity from the platform TextToSpeech engine to verify the proper installation and availability of the resource files on the system. | |||||||||
String | ACTION_GET_SAMPLE_TEXT | Activity intent for getting some sample text to use for demonstrating TTS. | |||||||||
String | ACTION_INSTALL_TTS_DATA | Activity Action: Triggers the platform TextToSpeech engine to start the activity that installs the resource files on the device that are required for TTS to be operational. | |||||||||
String | ACTION_TTS_DATA_INSTALLED | Broadcast Action: broadcast to signal the change in the list of available languages or/and their features. | |||||||||
int | CHECK_VOICE_DATA_BAD_DATA | This constant was deprecated in API level 18. Use CHECK_VOICE_DATA_FAIL instead. | |||||||||
int | CHECK_VOICE_DATA_FAIL | Indicates failure when checking the installation status of the resources used by the
TextToSpeech engine with the ACTION_CHECK_TTS_DATA intent. |
|||||||||
int | CHECK_VOICE_DATA_MISSING_DATA | This constant was deprecated in API level 18. Use CHECK_VOICE_DATA_FAIL instead. | |||||||||
int | CHECK_VOICE_DATA_MISSING_VOLUME | This constant was deprecated in API level 18. Use CHECK_VOICE_DATA_FAIL instead. | |||||||||
int | CHECK_VOICE_DATA_PASS | Indicates success when checking the installation status of the resources used by the
TextToSpeech engine with the ACTION_CHECK_TTS_DATA intent. |
|||||||||
int | DEFAULT_STREAM | Default audio stream used when playing synthesized speech. | |||||||||
String | EXTRA_AVAILABLE_VOICES | Extra information received with the ACTION_CHECK_TTS_DATA intent result where
the TextToSpeech engine returns an ArrayList |
|||||||||
String | EXTRA_CHECK_VOICE_DATA_FOR | This constant was deprecated in API level 18. Redundant functionality, checking for existence of specific sets of voice data can be done on client side. | |||||||||
String | EXTRA_SAMPLE_TEXT | Extra information received with the ACTION_GET_SAMPLE_TEXT intent result where
the TextToSpeech engine returns an String with sample text for requested voice
|
|||||||||
String | EXTRA_TTS_DATA_INSTALLED | This constant was deprecated in API level 18. No longer in use. If client ise interested in information about what changed, is should send ACTION_CHECK_TTS_DATA intent to discover available voices. | |||||||||
String | EXTRA_UNAVAILABLE_VOICES | Extra information received with the ACTION_CHECK_TTS_DATA intent result where
the TextToSpeech engine returns an ArrayList |
|||||||||
String | EXTRA_VOICE_DATA_FILES | This constant was deprecated in API level 18. TTS engine implementation detail, this information has no use for text-to-speech API client. | |||||||||
String | EXTRA_VOICE_DATA_FILES_INFO | This constant was deprecated in API level 18. TTS engine implementation detail, this information has no use for text-to-speech API client. | |||||||||
String | EXTRA_VOICE_DATA_ROOT_DIRECTORY | This constant was deprecated in API level 18. TTS engine implementation detail, this information has no use for text-to-speech API client. | |||||||||
String | INTENT_ACTION_TTS_SERVICE | Intent for starting a TTS service. | |||||||||
String | KEY_FEATURE_EMBEDDED_SYNTHESIS | Feature key for embedded synthesis. | |||||||||
String | KEY_FEATURE_NETWORK_SYNTHESIS | Feature key for network synthesis. | |||||||||
String | KEY_PARAM_PAN | Parameter key to specify how the speech is panned from left to right when speaking text. | |||||||||
String | KEY_PARAM_STREAM | Parameter key to specify the audio stream type to be used when speaking text or playing back a file. | |||||||||
String | KEY_PARAM_UTTERANCE_ID | Parameter key to identify an utterance in the
TextToSpeech.OnUtteranceCompletedListener after text has been
spoken, a file has been played back or a silence duration has elapsed. |
|||||||||
String | KEY_PARAM_VOLUME | Parameter key to specify the speech volume relative to the current stream type volume used when speaking text. | |||||||||
String | SERVICE_META_DATA | Name under which a text to speech engine publishes information about itself. |
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
Activity Action: Starts the activity from the platform TextToSpeech
engine to verify the proper installation and availability of the
resource files on the system. Upon completion, the activity will
return one of the following codes:
CHECK_VOICE_DATA_PASS
,
CHECK_VOICE_DATA_FAIL
,
Moreover, the data received in the activity result will contain the following fields:
EXTRA_AVAILABLE_VOICES
which contains an ArrayListEXTRA_UNAVAILABLE_VOICES
which contains an ArrayListActivity intent for getting some sample text to use for demonstrating TTS. Specific locale have to be requested by passing following extra parameters:
EXTRA_SAMPLE_TEXT
which contains an String with sample text.Activity Action: Triggers the platform TextToSpeech engine to
start the activity that installs the resource files on the device
that are required for TTS to be operational. Since the installation
of the data can be interrupted or declined by the user, the application
shouldn't expect successful installation upon return from that intent,
and if need be, should check installation status with
ACTION_CHECK_TTS_DATA
.
Broadcast Action: broadcast to signal the change in the list of available languages or/and their features.
This constant was deprecated
in API level 18.
Use CHECK_VOICE_DATA_FAIL instead.
Indicates erroneous data when checking the installation status of the resources used by
the TextToSpeech engine with the ACTION_CHECK_TTS_DATA
intent.
Indicates failure when checking the installation status of the resources used by the
TextToSpeech engine with the ACTION_CHECK_TTS_DATA
intent.
This constant was deprecated
in API level 18.
Use CHECK_VOICE_DATA_FAIL instead.
Indicates missing resources when checking the installation status of the resources used
by the TextToSpeech engine with the ACTION_CHECK_TTS_DATA
intent.
This constant was deprecated
in API level 18.
Use CHECK_VOICE_DATA_FAIL instead.
Indicates missing storage volume when checking the installation status of the resources
used by the TextToSpeech engine with the ACTION_CHECK_TTS_DATA
intent.
Indicates success when checking the installation status of the resources used by the
TextToSpeech engine with the ACTION_CHECK_TTS_DATA
intent.
Default audio stream used when playing synthesized speech.
Extra information received with the ACTION_CHECK_TTS_DATA
intent result where
the TextToSpeech engine returns an ArrayList
This constant was deprecated
in API level 18.
Redundant functionality, checking for existence of specific sets of voice
data can be done on client side.
Extra information sent with the ACTION_CHECK_TTS_DATA
intent where the
caller indicates to the TextToSpeech engine which specific sets of voice data to
check for by sending an ArrayList
Extra information received with the ACTION_GET_SAMPLE_TEXT
intent result where
the TextToSpeech engine returns an String with sample text for requested voice
This constant was deprecated
in API level 18.
No longer in use. If client ise interested in information about what
changed, is should send ACTION_CHECK_TTS_DATA intent to discover available voices.
Extra information received with the ACTION_TTS_DATA_INSTALLED
intent result.
It indicates whether the data files for the synthesis engine were successfully
installed. The installation was initiated with the ACTION_INSTALL_TTS_DATA
intent. The possible values for this extra are
SUCCESS
and ERROR
.
Extra information received with the ACTION_CHECK_TTS_DATA
intent result where
the TextToSpeech engine returns an ArrayList
This constant was deprecated
in API level 18.
TTS engine implementation detail, this information has no use for
text-to-speech API client.
Extra information received with the ACTION_CHECK_TTS_DATA
intent result where
the TextToSpeech engine specifies the file names of its resources under the
resource path.
This constant was deprecated
in API level 18.
TTS engine implementation detail, this information has no use for
text-to-speech API client.
Extra information received with the ACTION_CHECK_TTS_DATA
intent result where
the TextToSpeech engine specifies the locale associated with each resource file.
This constant was deprecated
in API level 18.
TTS engine implementation detail, this information has no use for
text-to-speech API client.
Extra information received with the ACTION_CHECK_TTS_DATA
intent result where
the TextToSpeech engine specifies the path to its resources.
It may be used by language packages to find out where to put their data.
Intent for starting a TTS service. Services that handle this intent must
extend TextToSpeechService
. Normal applications should not use this intent
directly, instead they should talk to the TTS service using the the methods in this
class.
Feature key for embedded synthesis. See getFeatures(Locale)
for a description of how feature keys work. If set and supported by the engine
as per getFeatures(Locale)
, the engine must synthesize
text on-device (without making network requests).
Feature key for network synthesis. See getFeatures(Locale)
for a description of how feature keys work. If set (and supported by the engine
as per getFeatures(Locale)
, the engine must
use network based synthesis.
Parameter key to specify how the speech is panned from left to right when speaking text. Pan is specified as a float ranging from -1 to +1 where -1 maps to a hard-left pan, 0 to center (the default behavior), and +1 to hard-right.
Parameter key to specify the audio stream type to be used when speaking text
or playing back a file. The value should be one of the STREAM_ constants
defined in AudioManager
.
Parameter key to identify an utterance in the
TextToSpeech.OnUtteranceCompletedListener
after text has been
spoken, a file has been played back or a silence duration has elapsed.
Parameter key to specify the speech volume relative to the current stream type volume used when speaking text. Volume is specified as a float ranging from 0 to 1 where 0 is silence, and 1 is the maximum volume (the default behavior).
Name under which a text to speech engine publishes information about itself.
This meta-data should reference an XML resource containing a
<
tag.
tts-engine
>