summaryrefslogtreecommitdiffstats
path: root/include/tts
diff options
context:
space:
mode:
authorJean-Michel Trivi <jmtrivi@google.com>2009-06-15 15:14:49 -0700
committerJean-Michel Trivi <jmtrivi@google.com>2009-06-16 13:25:15 -0700
commitbc275c818be077e80d730657a2df706bea0bffb0 (patch)
tree3e8ede55f99ae3f581d077eae2af9bbb25854b24 /include/tts
parent379f38277e6d9d3d5dd85dfa9caf03a8100466a2 (diff)
downloadframeworks_native-bc275c818be077e80d730657a2df706bea0bffb0.zip
frameworks_native-bc275c818be077e80d730657a2df706bea0bffb0.tar.gz
frameworks_native-bc275c818be077e80d730657a2df706bea0bffb0.tar.bz2
Updating TTS engine interface for setting the language based on language, country and variant codes
coming from a java.util.Locale instance.
Diffstat (limited to 'include/tts')
-rw-r--r--include/tts/TtsEngine.h18
1 files changed, 11 insertions, 7 deletions
diff --git a/include/tts/TtsEngine.h b/include/tts/TtsEngine.h
index d2aa30e..8486532 100644
--- a/include/tts/TtsEngine.h
+++ b/include/tts/TtsEngine.h
@@ -99,14 +99,18 @@ public:
// @param size length of the language value
// @return TTS_SUCCESS, or TTS_FAILURE
virtual tts_result loadLanguage(const char *value, const size_t size);
-
- // Signal the engine to use the specified language. This will force the
- // language to be loaded if it wasn't loaded previously with loadLanguage().
- // See loadLanguage for the specification of the language.
- // @param value pointer to the language value
- // @param size length of the language value
+
+ // Load the resources associated with the specified language, country and Locale variant.
+ // The loaded language will only be used once a call to setLanguageFromLocale() with the same
+ // language value is issued. Language and country values are coded according to the ISO three
+ // letter codes for languages and countries, as can be retrieved from a java.util.Locale
+ // instance. The variant value is encoded as the variant string retrieved from a
+ // java.util.Locale instance built with that variant data.
+ // @param lang pointer to the ISO three letter code for the language
+ // @param country pointer to the ISO three letter code for the country
+ // @param variant pointer to the variant code
// @return TTS_SUCCESS, or TTS_FAILURE
- virtual tts_result setLanguage(const char *value, const size_t size);
+ virtual tts_result setLanguage(const char *lang, const char *country, const char *variant);
// Retrieve the currently set language, or an empty "value" if no language
// has been set.