Stories by 신지웅 on Medium

STT(Speech to Text)로 음성인식 어플을 만들기
오늘은 구글의 API인 STT(Speech to Text)로 음성인식 어플을 만들어 
보겠습니다.
STT란 한국어로 음성인식이라고 생각하시면 편하실 거 같습니다.
어플 설명으로는 버튼을 누르고 말을 하면 TextView에 말했던 음성이 적히게 되는 보기엔 간단한 어플입니다.
자료는 아래 두 링크에서 주로 참고하였습니다.
안드로이드 구글 음성API[SpeechRecognizer tutorial]
Android Developers
프로젝트 생성
minSDK는 사용자들이 주로 사용하는 버전인 API 21(Android 5.0 Lollipop)로 설정 하였고 음성인식과 결과만 보여주면 되기 때문에 Empty Activity를 선택 하였습니다.
AndroidManifest.xml
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.RECORD_AUDIO"/>
Google STT를 사용하기 위해서 인터넷 사용 권한과 오디오 사용 권한이 필요하므로 AndroidManifest.xml에 사용할 퍼미션을 추가해줍시다.
activity_main.xml
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:gravity="center"
    android:orientation="vertical"
    tools:context=".MainActivity">
    <TextView
        android:id="@+id/sttResult"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="음성인식 결과가 여기에 표시됩니다." />
    <Button
        android:id="@+id/sttStart"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="음성인식 시작" />
</LinearLayout>
MainActivity.java
퍼미션 설정
if ( Build.VERSION.SDK_INT >= 23 ){
            // 퍼미션 체크
            ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.INTERNET,
                    Manifest.permission.RECORD_AUDIO},PERMISSION);
        }
안드로이드 6.0버전 부터는 퍼미션을 따로 체크해줘야 합니다. 
따라서 if 문으로 안드로이드 버전이 23 이상이면 퍼미션을 체크하는 알림 창을 띄어줍니다.
음성인식 시 사용 될 intent 설정
//사용자에게 음성을 요구하고 음성 인식기를 통해 전송하는 활동을 시작합니다.
intent = new Intent(RecognizerIntent.ACTION_RECOGNIZE_SPEECH);
//음성 인식을위한 음성 인식기의 의도에 사용되는 여분의 키입니다.
intent.putExtra(RecognizerIntent.EXTRA_CALLING_PACKAGE,getPackageName());
//음성을 번역할 언어를 설정합니다. 
intent.putExtra(RecognizerIntent.EXTRA_LANGUAGE,"ko-KR");
음성을 인식하게 하는 부분
처음에는 이렇게 코드를 짤려고 했지만 별표 친 부분에서 오류가 납니다.
sttBtn.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
      ★ mRecognizer=SpeechRecognizer.createSpeechRecognizer(this);
        mRecognizer.setRecognitionListener(listener);
        mRecognizer.startListening(intent);
    }
});
그래서 람다식을 사용해서 클릭 리스너를 사용하니 오류가 수정되었습니다.
람다식 : 식별자 없이 실행 가능한 함수 표현식
sttBtn.setOnClickListener(v -> {
    mRecognizer=SpeechRecognizer.createSpeechRecognizer(this);
    mRecognizer.setRecognitionListener(listener);
    mRecognizer.startListening(intent);
});
클릭 리스너 안에 있는 코드의 설명입니다.
mRecognizer=SpeechRecognizer.createSpeechRecognizer(this);
// 새 SpeechRecognizer를 만드는 팩토리 메서드입니다.
mRecognizer.setRecognitionListener(listener);
// 모든 콜백을 수신하는 리스너를 설정합니다.listener은 아래에서 정의하였습니다.
mRecognizer.startListening(intent);
// 듣기를 시작합니다.
음성인식 시 가장 핵심적인 부분인 RecognitionListener
팁 : 메소드가 많지만,
private RecognitionListener listener = new RecognitionListener()
를 치시고 자동완성을 해주시면 아래의 코드는 자동으로 완성됩니다.
private RecognitionListener listener = new RecognitionListener() {
    @Override
    public void onReadyForSpeech(Bundle params) {
        // 사용자가 말하기 시작할 준비가되면 호출됩니다.
    }
    @Override
    public void onBeginningOfSpeech() {
        // 사용자가 말하기 시작했을 때 호출됩니다.
    }
    @Override
    public void onRmsChanged(float rmsdB) {
        // 입력받는 소리의 크기를 알려줍니다.
    }
    @Override
    public void onBufferReceived(byte[] buffer) {
        // 사용자가 말을 시작하고 인식이 된 단어를 buffer에 담습니다.
    }
    @Override
    public void onEndOfSpeech() {
        // 사용자가 말하기를 중지하면 호출됩니다.
    }
    @Override
    public void onError(int error) {
        // 네트워크 또는 인식 오류가 발생했을 때 호출됩니다.
    }
    @Override
    public void onResults(Bundle results) {
        // 인식 결과가 준비되면 호출됩니다.
    }
    @Override
    public void onPartialResults(Bundle partialResults) {
        // 부분 인식 결과를 사용할 수 있을 때 호출됩니다.
    }
    @Override
    public void onEvent(int eventType, Bundle params) {
        // 향후 이벤트를 추가하기 위해 예약됩니다.
    }
}
음성인식 준비
저는 여기서 onReadyForSpeech() 메소드에 Toast 메시지를 띄워 음성인식을 시작하는 알림을 알려 줄 수 있도록 하였습니다.
@Override
public void onReadyForSpeech(Bundle params) {
    Toast.makeText(getApplicationContext(),"음성인식을 시작합니다.",Toast.LENGTH_SHORT).show();
}
음성인식 에러 처리
에러를 그냥 보내게 된다면 개발자가 테스트로 사용을 하다가 발생한 오류를 제대로 처리할 수 없게 되고, 추후 배포를 할 때 사용자가 극심하게 불편을 호소하게 됩니다. 그래서 작성자는 에러메시지를 처리하였습니다.
        @Override
        public void onError(int error) {
            String message;
            switch (error) {
                case SpeechRecognizer.ERROR_AUDIO:
                    message = "오디오 에러";
                    break;
                case SpeechRecognizer.ERROR_CLIENT:
                    message = "클라이언트 에러";
                    break;
                case SpeechRecognizer.ERROR_INSUFFICIENT_PERMISSIONS:
                    message = "퍼미션 없음";
                    break;
                case SpeechRecognizer.ERROR_NETWORK:
                    message = "네트워크 에러";
                    break;
                case SpeechRecognizer.ERROR_NETWORK_TIMEOUT:
                    message = "네트웍 타임아웃";
                    break;
                case SpeechRecognizer.ERROR_NO_MATCH:
                    message = "찾을 수 없음";
                    break;
                case SpeechRecognizer.ERROR_RECOGNIZER_BUSY:
                    message = "RECOGNIZER가 바쁨";
                    break;
                case SpeechRecognizer.ERROR_SERVER:
                    message = "서버가 이상함";
                    break;
                case SpeechRecognizer.ERROR_SPEECH_TIMEOUT:
                    message = "말하는 시간초과";
                    break;
                default:
                    message = "알 수 없는 오류임";
                    break;
            }
            Toast.makeText(getApplicationContext(), "에러가 발생하였습니다. : " + message,Toast.LENGTH_SHORT).show();
        }
먼저 String을 지역변수로 선언하여 오류를 잡았을 때 띄워줄 메시지를 넣어줍니다.
다음 switch-case문으로 에러가 생길 때 발생되는 메시지를 처리해줍니다. 발생된 에러에 따라 switch-case문으로 처리한 message를 Toast로 화면에 출력해 주었습니다.
에러에 대한 설명은 message를 보시면 어떨 때 어떠한 오류가 발생되는 지 알 수 있습니다. 에러 메시지를 원문으로 보고 싶은 분께서는 링크를 클릭 해주세요.
음성인식 결과 출력
@Override
public void onResults(Bundle results) {
// 아래 코드는 음성인식된 결과를 ArrayList로 모아옵니다.
ArrayList<String> matches = results.getStringArrayList(SpeechRecognizer.RESULTS_RECOGNITION);
// 이후 for문으로 textView에 setText로 음성인식된 결과를 수정해줍니다.
for(int i = 0; i < matches.size() ; i++){
        textView.setText(matches.get(i));
    }
}
Full Source
package org.androidtptown.googlestt;
import android.Manifest;
import android.content.Intent;
import android.os.Build;
import android.speech.RecognitionListener;
import android.speech.RecognizerIntent;
import android.speech.SpeechRecognizer;
import android.support.v4.app.ActivityCompat;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.Button;
import android.widget.TextView;
import android.widget.Toast;
import java.util.ArrayList;
public class MainActivity extends AppCompatActivity {
    Intent intent;
    SpeechRecognizer mRecognizer;
    Button sttBtn;
    TextView textView;
    final int PERMISSION = 1;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        if ( Build.VERSION.SDK_INT >= 23 ){
            // 퍼미션 체크
            ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.INTERNET,
                    Manifest.permission.RECORD_AUDIO},PERMISSION);
        }
        
        textView = (TextView)findViewById(R.id.sttResult);
        sttBtn = (Button) findViewById(R.id.sttStart);
        
        intent=new Intent(RecognizerIntent.ACTION_RECOGNIZE_SPEECH);
 intent.putExtra(RecognizerIntent.EXTRA_CALLING_PACKAGE,getPackageName());
        intent.putExtra(RecognizerIntent.EXTRA_LANGUAGE,"ko-KR");
sttBtn.setOnClickListener(v ->{
          mRecognizer=SpeechRecognizer.createSpeechRecognizer(this);
            mRecognizer.setRecognitionListener(listener);
            mRecognizer.startListening(intent);
        });
    }
    private RecognitionListener listener = new RecognitionListener() {
        @Override
        public void onReadyForSpeech(Bundle params) {
            Toast.makeText(getApplicationContext(),"음성인식을 시작합니다.",Toast.LENGTH_SHORT).show();
        }
        @Override
        public void onBeginningOfSpeech() {}
        @Override
        public void onRmsChanged(float rmsdB) {}
        @Override
        public void onBufferReceived(byte[] buffer) {}
        @Override
        public void onEndOfSpeech() {}
        @Override
        public void onError(int error) {
            String message;
            switch (error) {
                case SpeechRecognizer.ERROR_AUDIO:
                    message = "오디오 에러";
                    break;
                case SpeechRecognizer.ERROR_CLIENT:
                    message = "클라이언트 에러";
                    break;
                case SpeechRecognizer.ERROR_INSUFFICIENT_PERMISSIONS:
                    message = "퍼미션 없음";
                    break;
                case SpeechRecognizer.ERROR_NETWORK:
                    message = "네트워크 에러";
                    break;
                case SpeechRecognizer.ERROR_NETWORK_TIMEOUT:
                    message = "네트웍 타임아웃";
                    break;
                case SpeechRecognizer.ERROR_NO_MATCH:
                    message = "찾을 수 없음";
                    break;
                case SpeechRecognizer.ERROR_RECOGNIZER_BUSY:
                    message = "RECOGNIZER가 바쁨";
                    break;
                case SpeechRecognizer.ERROR_SERVER:
                    message = "서버가 이상함";
                    break;
                case SpeechRecognizer.ERROR_SPEECH_TIMEOUT:
                    message = "말하는 시간초과";
                    break;
                default:
                    message = "알 수 없는 오류임";
                    break;
            }
            Toast.makeText(getApplicationContext(), "에러가 발생하였습니다. : " + message,Toast.LENGTH_SHORT).show();
        }
        @Override
        public void onResults(Bundle results) {
        // 말을 하면 ArrayList에 단어를 넣고 textView에 단어를 이어줍니다.
            ArrayList<String> matches =
results.getStringArrayList(SpeechRecognizer.RESULTS_RECOGNITION);
            for(int i = 0; i < matches.size() ; i++){
                textView.setText(matches.get(i));
            }
        }
        @Override
        public void onPartialResults(Bundle partialResults) {}
        @Override
        public void onEvent(int eventType, Bundle params) {}
    };
}
실행결과
Creating an Android Google STT application was originally published in Berkbach on Medium, where people are continuing the conversation by highlighting and responding to this story.

Creating an Android Google STT application

댓글