Mobile SDK

Classic/VPC 환경에서 이용 가능합니다.

음성 인식에 사용할 언어와 MP3, AAC, AC3, OGG, FLAC, WAV 형식의 음성 데이터를 입력받아 텍스트로 변환하는 API를 Android와 iOS SDK 형태로 제공합니다.

사전 준비사항

Mobile SDK의 사전 준비사항에 대한 설명은 CLOVA Speech Recognition (CSR) 공통 설정을 참조해 주십시오.

API 사용

CSR API는 Android용과 iOS용 SDK를 통해 제공됩니다. 여기에서는 각 플랫폼별 CSR API를 사용하는 방법에 대해 설명합니다.

요청

Android API

Android API를 사용하는 방법은 다음과 같습니다.

1. 다음 구문을 app/build.gradle 파일에 추가해 주십시오.

   repositories {
       jcenter()
   }
   dependencies {
       compile 'com.naver.speech.clientapi:naverspeech-ncp-sdk-android:1.1.6'
   

2. 다음과 같이 Android Manifest 파일(AndroidManifest.xml)을 설정해 주십시오.

• 패키지 이름: manifest 요소의 package 속성 값이 네이버 클라우드 플랫폼 콘솔에서 등록한 안드로이드 앱 패키지 이름과 같아야 합니다.

• 권한 설정: 사용자의 음성 입력을 마이크를 통해 녹음해야 하고 녹음된 데이터를 서버로 전송해야 합니다. 따라서 android.permission.INTERNET과 android.permission.RECORD_AUDIO에 대한 권한을 반드시 설정해 주십시오.

  <manifest xmlns:android="http://schemas.android.com/apk/res/android"
            package="com.naver.naverspeech.client"
            android:versionCode="1" android:versionName="1.0">
  <uses-permission android:name="android.permission.INTERNET" />
  <uses-permission android:name="android.permission.RECORD_AUDIO" />
  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
  

3. (Optional) proguard-rules.pro 파일에 다음 코드를 추가해 주십시오.

• 이 코드는 앱을 보다 가볍고 안전하게 구동합니다.

  -keep class com.naver.speech.clientapi.SpeechRecognizer {
      protected private *;
  

• 클라이언트는 준비, 녹음, 중간결과 출력, 끝점 추출, 최종결과 출력과 같은 일련의 이벤트 흐름을 수행합니다.
• 애플리케이션 개발자는 SpeechRecognitioinListener 인터페이스를 상속받아 해당 이벤트가 발생할 때 처리할 동작을 구현합니다.

iOS API

iOS API를 사용하는 방법은 다음과 같습니다.

1. iOS용 예제를 복제(clone)하거나 Zip 파일로 다운로드하여 압축을 해제해 주십시오.

   git clone https://github.com/NaverCloudPlatform/naverspeech-sdk-ios.git
   또는
   wget https://github.com/NaverCloudPlatform/naverspeech-sdk-ios/archive/ncp.zip
   unzip ncp.zip
   

2. OS 예제에서 framework/NaverSpeech.framework 디렉터리를 개발하는 앱의 Embedded Binaries에 추가해 주십시오.

3. 다음과 같이 iOS Bundle Identifier를 설정해 주십시오.

   • Bundle Identifier: 네이버 클라우드 플랫폼 콘솔에서 등록한 iOS Bundle ID와 같아야 합니다.
   • 권한 설정: 사용자의 음성 입력을 마이크를 통해 녹음해야 하고 녹음된 데이터를 서버로 전송해야 합니다. 따라서, key 값을 다음과 같이 설정해 주십시오.

   <key&gt;NSMicrophoneUsageDescription<key>
   <string></string>
   

• 클라이언트는 준비, 녹음, 중간결과 출력, 끝점 추출, 최종결과 출력과 같은 일련의 이벤트 흐름을 수행합니다.
• 애플리케이션 개발자는 해당 이벤트가 발생할 때 원하는 동작을 수행하도록 NSKRecognizerDelegate 프로토콜을 구현합니다.

UX 고려사항

일반적으로 사용자는 음성 인식 버튼을 누르자마자 발화를 시작하려는 경향이 있습니다. 하지만 음성 인식을 시작하는 recognize() 메서드를 호출하면 음성 인식을 위한 메모리 할당, 마이크 자원 할당, 음성 인식 서버 접속 및 인증 등의 준비 과정을 수행해야 하기 때문에 사용자의 발화 일부가 누락될 수 있습니다. 따라서, 앱은 모든 준비가 완료된 후 사용자에게 발화해도 좋다는 정보를 전달해야 합니다. 이 방법은 다음과 같이 처리할 수 있습니다.

• 모든 준비가 완료되면 onReady callback 메서드가 호출됩니다.
• onReady callback 메서드가 호출되기 전까지 준비 중입니다.와 같은 메시지를 표시하거나 준비 중임을 나타내는 UI 표시를 해야 합니다.
• onReady callback 메서드가 호출되면 이야기해주세요.와 같은 메시지를 표시하거나 사용 가능함을 나타내는 UI를 표시해야 합니다.

응답 상태 코드

CLOVA Speech Recognition (CSR) API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 CLOVA Speech Recognition (CSR) 공통 응답 상태 코드를 참조해 주십시오.