Android에서 SpeechRecognizer API로 음성 인식 기능 구현하는 방법

Android SpeechRecognizer API 소개

이 튜토리얼에서는 Android 앱에서 SpeechRecognizer API를 사용하여 음성 인식 기능을 구현하는 방법을 단계별로 알아봅니다. 이 API를 활용하면 사용자의 음성을 텍스트로 변환하고, 인식된 결과를 바탕으로 다양한 동작을 수행할 수 있습니다.

예제에서는 간단한 퀴즈 형식으로 질문을 화면에 표시하고, 사용자가 음성으로 답변하면 그 답변이 정답인지 판별하는 앱을 만들어 보겠습니다.

1단계 — 새 프로젝트 생성

Android Studio에서 File → New Project로 이동한 후, 새 프로젝트 생성에 필요한 모든 정보를 입력하여 프로젝트를 만듭니다.

2단계 — 레이아웃 파일 작성

res/layout/activity_main.xml 파일에 아래 코드를 추가합니다. 화면에는 인식 결과를 표시할 TextView 하나만 배치합니다.

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:padding="16sp"
    tools:context=".MainActivity">
<TextView
    android:id="@+id/textView"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_marginTop="40dp"
    android:textSize="16sp"
    android:textStyle="bold" />
</LinearLayout>

3단계 — MainActivity 작성

src/MainActivity.java 파일에 다음 코드를 추가합니다. 핵심 로직은 다음과 같습니다.

RecognizerIntent.ACTION_RECOGNIZE_SPEECH 인텐트를 생성하여 음성 인식 화면을 호출합니다.
EXTRA_LANGUAGE_MODEL에 자유 형식(FREE_FORM) 언어 모델을 지정합니다.
EXTRA_PROMPT를 통해 사용자에게 보여줄 질문 문구를 전달합니다.
onActivityResult()에서 인식된 결과 목록을 받아 첫 번째 결과를 정답 여부와 비교합니다.

package app.com.sample;
import androidx.appcompat.app.AppCompatActivity;
import android.content.Intent;
import android.os.Bundle;
import android.speech.RecognizerIntent;
import android.widget.TextView;
import java.util.List;
public class MainActivity extends AppCompatActivity {
    private final int REQUEST_SPEECH_RECOGNIZER = 3000;
    private TextView textView;
    private final String mQuestion = "Which company is the largest online retailer on the planet?";
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        textView = findViewById(R.id.textView);
        startSpeechRecognizer();
    }
    private void startSpeechRecognizer() {
        Intent intent = new Intent(RecognizerIntent.ACTION_RECOGNIZE_SPEECH);
        intent.putExtra(RecognizerIntent.EXTRA_LANGUAGE_MODEL,
        RecognizerIntent.LANGUAGE_MODEL_FREE_FORM);
        intent.putExtra(RecognizerIntent.EXTRA_PROMPT, mQuestion);
        startActivityForResult(intent, REQUEST_SPEECH_RECOGNIZER);
    }
    @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        if (requestCode == REQUEST_SPEECH_RECOGNIZER) {
            if (resultCode == RESULT_OK) {
                List<String> results = data.getStringArrayListExtra(RecognizerIntent.EXTRA_RESULTS);
                String mAnswer = results.get(0);
                if (mAnswer.toUpperCase().contains("AMAZON"))
                    textView.setText(String.format("\n\nQuestion: %s\n\nYour answer is '%s' and it is
correct!", mQuestion, mAnswer));
                else
                    textView.setText(String.format("\n\nQuestion: %s\n\nYour answer is '%s' and it is
incorrect!", mQuestion, mAnswer));
            }
        }
    }
}

4단계 — 매니페스트에 마이크 권한 추가

음성 인식을 위해서는 마이크 접근 권한이 반드시 필요합니다. androidManifest.xml 파일에 아래와 같이 RECORD_AUDIO 권한을 추가합니다.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
    package="app.com.sample">
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
<uses-permission android:name="android.permission.RECORD_AUDIO" />
</manifest>

애플리케이션 실행 및 결과 확인

이제 애플리케이션을 실행해 보겠습니다. 실제 Android 스마트폰이 컴퓨터에 연결되어 있다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤, 상단 툴바의 Run 아이콘을 클릭하세요. 실행 옵션에서 본인의 모바일 기기를 선택하면, 기기에 아래와 같은 기본 화면이 표시됩니다.

Android에서 SpeechRecognizer API로 음성 인식 기능 구현하는 방법

앱이 실행되면 화면에 표시된 질문을 읽고 음성으로 답변하세요. 음성 인식이 완료되면 답변이 정답("AMAZON")인지 아닌지에 따라 TextView에 결과 메시지가 출력됩니다.