구글에서 제공하는 기본 TTS 애플리케이션은 아직까지 한국어를 지원하지 않는다. 대신에 한국어 음성이 지원되는 애플리케이션(예를 들어 갤럭시S는 삼성 TTS 또는 SvoxClassic)을 설치해야 한다
안드로이드에서 TTS 애플리케이션을 개발하려면 android.speech.tts 패키지에서 제공하는 TextToSpeech 클래스를 사용해야 한다
TextToSpeech 클래스는 생성자를 사용하여 TextToSpeech 클래스의 인스턴스를 생성하지만, 초기화 작업은 TextToSpeech.OnInitListener 인터페이스가 제공하는 onInit() 콜백 메서드를 통해 이루어진다
다음은 TextToSpeech 클래스에서 제공하는 메서드들이다
- int addEarcon(String earcon, Srting filename) : '이모티브'나 '톡'과 같이 특수 문자처럼 서버에서 제공하는 음성이 아닌 사용자가 직접 제작한 음성을 사용한다. 예를 들어 윈도우 시작과 종료 신호음처럼 특정 작업이나 사물을 나타내기 위해 사용되는 소리를 '이어콘(earcon)'이라 부른다. 첫 번째 매개 변수는 해당 문자를 나타내고, 두 번째 매개 변수는 첫 번째 매개 변수 해당되는 음성 파일을 가리킨다. 참고로 안드로이드는 음성이나 미디어가 '/sdcard/Android/Sound/a.wav'와 같이 SDCard에 저장되어 있어야 한다
- int addEarcon(String earcon, Srting packagename, int resourceId) : 위에서 설명한 addEarcon() 메서드와 동일한 기능을 수행한다. 다만 앞에서 설명한 메서드는 파일 이름을 문자열로 사용하였는데 반해 이 메서드는 패키지 명과 함께 리소스의 아이디를 사용한다 (addEarcon("[took", "com.ideal.itemid", R.raw.tock_snd);)
- int playEarcon(String earcon, int queueMode, HashMap<String, String> params) : playEarcon 메서드는 일반적으로 문자를 음성으로 변환한 다음 후렴으로 음성이나 음악을 추가하는 기능을 한다. 두 번째 매개변수는 '큐모드'라 하여 QUEUE_ADD(기존에 출력할 음성이 남아 있다면 기존 음성 출력이 끝난 다음 출력) 또는 QUEUE_FLUSH(기존에 출력할 음성이 남아 있다면 큐에 존재하는 음성들을 삭제하고 음성 출력)상수를 사용한다
- int speak(String text, int queueMode, HashMap<String, String> params) : 문자를 음성으로 출력한다
- int setLanguage(Locale loc) : TextToSpeech 엔진의 언어를 설정한다. 로케일을 설정하였을 때 반환되는 정수가 TextToSpeech.LANG_MISSING_DADA, LANG_NOT_SUPPORTED 라면 해당 언어가 지원되지 않음을 뜻한다
- int setPitch(float pitch) : 음성 톤의 높낮이를 조정한다
- int setSpeechRate(float speechRate) : 말의 빠르기를 설정한다
- int stop() : 음성 출력을 중단한다. 음성들이 큐에 쌓여 있다면 삭제한다
- void shutdown() : TextToSpeech 엔진에서 사용한 리소스를 해제시킨다
TextToSpeech.OnInitListener 인터페이스
- void onInit(int status) : TTS 엔진이 정상적으로 실행되었는지 여부는 status 매개 변수(SUCCESS / ERROR)를 통해 알 수 있다
다음은 텍스트뷰에 입력받은 문자와 'Hello'라는 영어를 함께 합성하여 발음하는 예제이다