gigagenie.voice.getVoiceText

API 설명

• 음성 인식 API
• 사용자에게 음성 안내 후 음성 인식을 진행
• TTS 출력 중 stopTTS를 수신하면 TTS와 음성인식 모두 종료
• 음성 인식이 진행되면 해당 음성 인식을 종료할 수 없음(Timeout처리됨)
• 해당 API의 ttslanguage 와 voicelanguage 는 셋탑형 단말에서만 지원됨(LTE 단말에서는 미지원)
• * 1, 2번 모드 설정에 앞서 다이얼로그 킷에 등록된 발화가 있다면 다이얼로그 킷 발화를 우선 처리함(onActionEvent 참고)*

API 구조

• function getVoiceText(options,callback)
• options
  • mode: (Int, Optional) 음성 인식 결과의 후처리를 설정(default mode = 0)
    • 0: 음성 인식 결과를 전달
    • 1: 음성 인식 결과를 대화 서버로 전달(음성 인식 결과는 undefined 로 전달되며, 이후 onActionEvent 로 이벤트를 받거나 다른 앱이 실행됨)
    • 2: 확인에 대한 음성 인식을 수행
      • 음성 인식 결과는 undefined로 전달되며, onVoiceCommand로 확인에 대한 인식 결과인 confirm, cancel 을 전달
      • 단, 확인으로 해석되지 않는 경우 결과가 전달되지 않으며 그 경우는 다음과 같음
        • 확인: "확인", "그래", "응"으로 발화한 경우
        • 취소: "취소", "아니", "아니요"로 발화한 경우
      • 번호 선택에 대한 음성 인식 결과는 undefined로 넘겨지며, 이후 onSelectedNumber에 인식된 번호를 전달함(번호는 1-6번까지만 사용 가능하며 번호가 인식되지 않으면 결과가 전달되지 않음)
  • voicemsg: (String, Optional) voicemsg 내용을 TTS로 재생한 후 음성 인식을 시작함
  • ttslanguage: (Number, Optional) voicemsg를 재생할 언어를 설정(기본 값은 한국어이며, LTE 단말에서는 한국어만 지원)
    • 0: 한국어 설정(default)
    • 1: 영어
    • 2: 중국어
    • 3: 일본어
  • voicelanguage: (Number, Optional) 음성 인식에서 사용할 언어를 설정(기본 값은 한국어, LTE 단말에서는 한국어만 지원)
    • 0: 한국어 설정(default)
    • 1: 영어
    • 2: 중국어
    • 3: 일본어
  • timeout: (Number, Optional) 음성 인식 대기 시간(초)을 설정 (default 7초, 최대 7초 이하만 지원하며 voicemsg 재생 종료 이후부터 count)
  • text: (String, Optional) 음성 인식의 정확도를 계산하기 위해 인식되어야 하는 Text (영어만 지원)
• result_cd
  • 200: 음성인식 성공, extra.voicetext 에 인식된 결과가 전달됨
  • 500: Timeout 발생 등으로 음성 인식 실패(extra.voicetext 에는 ASR session timeout을 전달)
  • 501: KWS(KeyWord Spotting)에 의해 정지됨
  • 502: 재생 실패
  • 503: stopTTS에 의한 TTS 종료
  • 504: mute 상태로 TTS 재생 불가
  • 505: 처리 용량 초과(다국어 음성인식 중 서버 용량 초과시 발생)
• extra
  • voicetext: (String, Mandatory) 음성 인식된 Text를 전달
  • accuracy: (Number, Optional) 음성 인식 결과의 정확도(options.text 가 설정되어 있고, options.voicelanguage 가 1인 경우에만 설정되어 리턴됨)

사용 예시

// callback 방식으로, 즉시 음성 인식을 할 경우
gigagenie.voice.getVoiceText(null, function (result_cd, result_msg, extra) {
    if (result_cd === 200) {
        console.log("Received Text is " + extra.voicetext);
    };
});
// callback 방식으로, TTS 재생 후 음성 인식을 할 경우
var options = {};
options.voicemsg = "생년월일을 말해 주세요"
gigagenie.voice.getVoiceText(options, function (result_cd, result_msg, extra) {
    if (result_cd === 200) {
        console.log("Received Text is " + extra.voicetext);
    };
});

활용 예제는 (GiGA Genie 구구단)에서 확인 가능합니다