gigagenie.voice.sendTTS

API 설명

• TTS API
• 입력된 Text 를 사용자에게 음성으로 전달
• stopTTS API에 의해서 중지됨

API 구조

• function sendTTS(options,callback)
• options
  • ttstext: (String, Mandatory) 입력된 Text로 TTS를 실행하며, 다음의 TAG를 붙일 수 있음
    • [DS] ~ [/DS]: TAG 사이의 숫자를 끊어 읽는다.(기본 값은 붙여서 읽음)
      • 예: [DS]1234[/DS] 는 "일이삼사"로, 1234는 "천이백삼십사"로 재생
    • [IS] ~ [/IS]: TAG 사이의 알파벳, 숫자 등을 끊어 읽는다.
      • 예: [IS]name[/IS] 는 "엔에이엠이"로 name은 "네임"으로 재생한다.
    • [P1]: 100ms의 묵음 삽입
    • [P2]: 200ms의 묵음 삽입
    • [P3]: 300ms의 묵음 삽입
    • [P4]: 500ms의 묵음 삽입
    • [P5]: 1000ms(1초) 묵음 삽입
    • [P6]: 2000ms(2초) 묵음 삽입
    • [LANG-EN]English[/LANG-EN]: 영어 발음으로 TTS 재생
      • 예: "사과는 영어로 [LANG-EN]apple[/LANG-EN] 입니다."
    • [LANG-CN]中文[/LANG-CN]: 중국어 발음으로 TTS 재생
    • [LANG-JP]日本語[/LANG-JP]: 일본어 발음으로 TTS 재생
  • ttslanguage: (Number, Optional) voicemsg를 재생할 언어를 설정(기본 값은 한국어)
    • 0: 한국어 설정(default)
    • 1: 영어
    • 2: 중국어
    • 3: 일본어
• result_cd
  • 200: TTS 재생 성공
  • 409: sendTTS로 TTS 재생 중임
  • 501: KWS(KeyWord Spotting)에 의해 정지됨
  • 502: 재생 실패
  • 503: 다른 App에서 TTS 중지 메시지를 보냄(stopTTS에 의한 종료)
  • 504: mute 상태로 TTS 재생 불가
• extra
  • null

사용 예시

// callback
var options = {};
options.ttstext = "안녕기가지니[P2]일반숫자[P2]1234[P2]끊어읽기[DS]1234[/DS]";
gigagenie.voice.sendTTS(options, function (result_cd, result_msg, extra) {
    if (result_cd === 200) {
        //do next action
    } else {
        //extra.reason 에 voice 오류 전달.
    };
});