com.google.appinventor.components.runtime.util

Interface ITextToSpeech

All Known Implementing Classes:

ExternalTextToSpeech, InternalTextToSpeech

public interface ITextToSpeech

This abstracts out what a text to speech implementation needs to have. In particular we use this to enable having an implementation that uses the internal Android TextToSpeech library for post-Donut devices and uses an externally installed library for the earlier devices.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	ITextToSpeech.TextToSpeechCallback Callback specifying methods for successful and failed attempts to generate speech.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	isInitialized()
int	isLanguageAvailable(java.util.Locale loc)
void	onDestroy() This will be called when the Activity is destroyed, to give us a chance to cleanup resources, if necessary.
void	onResume() This will be called when the Activity is resumed, to give us a chance to re-initialize resources, if necessary.
void	onStop() This will be called when the Activity is stopped, to give us a chance to cleanup resources, if necessary.
void	setPitch(float pitch) Sets the speech pitch for the TextToSpeech
void	setSpeechRate(float speechRate) Sets the speech rate
void	speak(java.lang.String message, java.util.Locale loc) Speaks the given message corresponding to the language and country of the given locale.

Method Detail

speak

void speak(java.lang.String message,
         java.util.Locale loc)

Speaks the given message corresponding to the language and country of the given locale.

Parameters:

message - the message to speak

loc - the locale to use

onStop

void onStop()

This will be called when the Activity is stopped, to give us a chance to cleanup resources, if necessary.

onResume

void onResume()

This will be called when the Activity is resumed, to give us a chance to re-initialize resources, if necessary.

onDestroy

void onDestroy()

This will be called when the Activity is destroyed, to give us a chance to cleanup resources, if necessary.

setPitch

void setPitch(float pitch)

Sets the speech pitch for the TextToSpeech

Parameters:

pitch - 1.0 is the normal pitch, lower values lower the tone of the synthesized voice, greater values increase it.

setSpeechRate

void setSpeechRate(float speechRate)

Sets the speech rate

Parameters:

speechRate - Speech rate. 1.0 is the normal speech rate, lower values slow down the speech (0.5 is half the normal speech rate), greater values accelerate it (2.0 is twice the normal speech rate).

isLanguageAvailable

int isLanguageAvailable(java.util.Locale loc)

isInitialized

boolean isInitialized()