• OllehSpeech.jar - 음성인식을 구현하는 클래스를 Export한 jar파일
• Libnetworkasr.so - 서버와 통신을 전담하여 처리하는 라이브러리 파일
• Libspeexcodec.so - 서버와 통신시 사용하는 음성 코덱 라이브러리
• Ping.so - 네트웍 핑 라이브러리

음성 검색을 사용하기 위해서는 자신의 프로젝트에 먼저 OllehSpeech.jar파일을 추가해야 하며 추가하는 방법은 아래 2가지이다

• 프로젝트에 포함 프로젝트에 폴더를 하나 생성하고 폴더에 OllehSpeech.jar 파일을 복사한다. 그리고 프로젝트의 “Build Path”에서 “Add JARs” 버 튼을 통해 jar파일을 추가한다.

• 프로젝트 외부에서 추가 OllehSpeech.jar파일을 하나 두고 여러 프로젝트에서 공통으로 사용하고자 할 경우 OllehSpeech.jar파일을 특정폴더에 복사한 후 프로젝트의 “Build Path”에서 “Add External JARs” 버튼을 통해 jar파일을 추가한다.

• 네트웍 라이브러리, 음성코덱 라이브러리는 프로젝트내에 libs\armeabi폴더를 생성하고 생성된 폴더 내에 복사한다. 복사 후 이클립스의 프로젝트에서 “Refresh”를 선택하면 추가한 파일이 프로젝트에 보인다.

라이브러리가 동작하기 위해 인터넷 접속, 음성녹음 등의 권한이 있어야 하므로 반드시 아래 내용이 추가되어야 한다.

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

SpeechRecognition : 음성인식 function을 정의한 클래스

• Initialize 설명 : 초기화 파라미터 context : Acitivity의 Context iServiceType : KT로부터 전달 받은 서비스 키 iMediaType : NetworkASR 값 Handler : 이벤트를 받을 이벤트 핸들러 trIPAddress : 음성인식 서버 주소, URL일 경우 내부적으로 자동 변환됨 iPort : 음성인식 서버 포트 리턴값 : boolean

• setAuth 설명 : 음성인식 키 Auth 세팅 파라미터 svcid : 서비스키 인증의 svcId 입니다 keyid : 서비스키 인증의 keyId 입니다 리턴값 : 없음

• startRecognition 설명 : 음성인식 시작 파라미터 : 없음 리턴값 : boolean

ex)

mSR = new SpeechRecognition();      
if (mSR.initialize(this, iServiceType, iMediaType, RecorderHandler,
                    SESSION_IP, SESSION_PORT) == true) {

                setAuth(svcid, keyed);

            if (mSR.startRecognition() == false)
                        mSR.destroy();
                    finish();
            else {
                   
            }
}
else finish();

• destroy 설명 : 내부 메모리를 해제하는 것이며Activity 종료시에 호출해야 함 파라미터 : 없음 리턴값 : 없음

• checkRetry 설명 : 음성인식 실패 후 바로 재시도 할 경우 내부를 초기화 시켜줌 파라미터 : 없음 리턴값 : 없음

ex)

mSR.checkRetry();      
m_waveView.clearWave();
m_btnRetry.setVisibility(View.GONE);
setStatus(SpeechRecognition.ST_INIT,0);
mSR.startRecognition();

• checkNormalResult 설명 : 음성인식 완료 후 일반 결과인지 외부 연동 필요한 것인지 확인해줌, true일 경우 외부 연동을 해주어야 한다 파라미터 : 없음 리턴값 : boolean

• getResultXML 설명 : 음성인식 결과 XML 문자열을 돌려줌, 앱에서 XML을 파싱하여 첫번째 결과가 “NOISE”일 경우 잡음으로 인해 음성인식 결과 실패한 경우이며 재시도하거나 종료해야 함 파라미터 : 없음 리턴값 : byte[]

• getExternalExchangeURL 설명 : 외부 연동 URL을 얻어온다 파라미터 : 없음 리턴값 : string

• stopVoiceTask 설명 : 음성 전송 중지 파라미터 : 없음 리턴값 : 없음

• stopVoiceRecord 설명 : 녹음 및 음성 전송 중지 파라미터 : 없음 리턴값 : 없음

음성인식이나 합성 중에는 진행상태 및 결과가 initialize함수 호출 시 전달한 이벤트 핸들러를 통해서 전달되며 메시지의 종류에 따라 적절한 처리를 해주어야 한다.

ex)

Handler eventHandler = new Handler()
{
        @Override
        public void handleMessage(Message msg) {
                switch(msg.what)
                {
        case NetworkASR.MESSAGE_SUCCESS_RECOGNIZE:
                //인식 성공 -> Task 중지 후 결과 파싱
                        break;
                case NetworkASR.MESSAGE_CONNECT_CANNOT:
                //서버 접속 실패 -> Task 중지
                        break; 
                case NetworkASR.MESSAGE_FAILURE:
                //실패 -> Task 중지
                break;                         
                case NetworkASR.MESSAGE_READY_OK:
                //서버접속 완료후 녹음이 시작됨
                        break;
                case NetworkASR.MESSAGE_START_RECOGNIZE:
                //인식 시작됨
                break;
                case NetworkASR.MESSAGE_FAILED_RECOGNIZE:
                //인식 실패됨
                        break;
                case NetworkASR.MESSAGE_START_RECORD:
                //녹음이 시작됨 -> Task 중지
                        break;
                case NetworkASR.MESSAGE_DISPLAY_WAVE:
                //파형을 그림
                break;         
    }

• NetworkASR.MESSAGE_CONNECT_CANNOT : 서버에 접속이 불가능하여 발생 -> 진행중인 Task를 중지시켜야 함
• NetworkASR.MESSAGE_READY_OK : 서버에 접속이 완료되어 음성 인식을 위한 녹음을 시작
• NetworkASR. MESSAGE_START_RECOGNIZE : 서버 측에서 음성 수신이 완료되고 음성 인식을 시작
• NetworkASR.MESSAGE_FAILED_RECOGNIZE : 서버 측에서 음성 수신이 완료되고 음성 인식이 실패
• NetworkASR.MESSAGE_SUCCESS_RECOGNIZE : 서버 측에서 음성 수신이 완료되고 음성 인식이 완료 -> 진행중인 Task를 중지시켜야 하고 결과를 파싱 해야함
• NetworkASR.MESSAGE_FAILURE : 동작중 발생하는 오류(네트웍 오류, 디바이스오류 등) 통보 -> 진행중인 Task를 중지시켜야 함
• NetworkASR.MESSAGE_START_RECORD : 음성녹음이 시작됨
• NetworkASR.MESSAGE_DISPLAY_WAVE : 파형을 그릴 수 있도록 음성데이터를 보내준다.
• msg.getData().getByteArray("PCM") : 음성데이터 msg.arg1 :데이터의 크기. 음성데이터는 16비트 크기이며 short타입의 배열로 캐스팅하여 사용함

• NetworkASR.UNKNOWN_STATUS : 노티 없이 종료 되었을 경우
• NetworkASR.CANT_CONNECT_STATUS : 서버 접속 실패
• NetworkASR.READY_STATUS : 서버 접속 후 녹음이 시작되었음
• NetworkASR.TIMEOUT_STATUS : 서버 접속 후 녹음이 진행되었으며 음성이 인식 안되어 타임아웃 발생
• NetworkASR.START_RECOG_STATUS : 서버 접속 후 녹음이 진행되었으며 음성이 검출되어 인식이 시작되었음
• NetworkASR.FAIL_RECOG_STATUS : 음성인식이 진행되었으며 결과가 실패임
• NetworkASR.FAILURE_STATUS : 음성인식이 진행되었으며 결과가 성공임
• NetworkASR.FAILURE_AUTH : 음성인식 인증이 실패임