Kakao i Agent SDK
Kakao i Agent SDK는 기본적으로 사용자의 음성 명령을 입력받고, 명령어를 분석하여 사용자 요청에 맞는 응답(음성 또는 UI)을 출력하는 기능을 제공합니다. Wallpad 버전의 Kakao i Agent SDK는 Wallpad 용 애플리케이션에서 카카오 i 음성 인식 서비스를 사용할 수 있는 기능을 제공합니다.
SDK는 기능별 모듈로 구성되며, 카카오 i 음성 인식 서비스에서 제공하는 기능을 처리하기 위한 별도의 메서드를 제공합니다.
또한 애플리케이션 통합(Integration) 이전에 인터랙션을 테스트하기 위한 목적으로 SDK와 함께 Sample App을 함께 제공하고 있습니다. Sample App을 사용하여 신규 Android Studio 프로젝트를 생성하지 않고, Wallpad 샘플 코드에서 일부 항목을 수정하여 별도의 애플리케이션을 구현하는 방법은 부록 A. Sample App 수정 문서를 참고하시기 바랍니다.
안내
해당 문서는 Kakao i Android SDK Version 1.3.2.25(2021년 10월)를 기반으로 작성되었습니다.
- 개발 시 필요한 Android 최소 버전: Android 5.0(API 수준 21)
SDK 구성요소
Wallpad 버전의 Kakao i Agent SDK를 구성하는 모듈은 다음과 같습니다.
표Kakao i Agent SDK 구성 모듈| 구성 모듈 | 설명 |
|---|---|
| Kakao i Agent | 음성 인식의 주요 기능을 포함하는 모듈 - 음성 인식, 인식 상태 전달 등 |
| Kakao i Client | 카카오 i 서버와 SDK의 연동을 위한 모듈 - 음성 인식 데이터와 음성 인식 상태 정보를 카카오 i 서버와 송신/수신할 때 사용 |
| AppClient | 애플리케이션의 통신 관련 설정을 할 수 있는 모듈 |
| Auditorium | 음성 입력 관련 모듈 - 사용자의 음성 명령을 녹음하고, 녹음된 결과(오디오 버퍼)를 필요한 곳에 공급 |
| Dialoid(Wake-up) | 음성 발화 모듈 - Wake-Up Word(호출명령어)를 설정하고, 인식된 발화 음성에 대한 상태와 정보를 확인 |
| Kapi Adapter | 카카오 i 음성 인식 서비스 인증 관련 모듈 |
주의
카카오 i 음성 인식 서비스를 이용하기 위해서는 사전에 헤이카카오(HeyKakao) 서비스에 가입해야 합니다.
- 카카오 i 음성 인식 서비스는 카카오 서비스와 구분되는 별도의 헤이카카오 서비스입니다.
- 헤이카카오 서비스는 카카오 계정을 사용해 가입할 수 있습니다.
인터랙션 시나리오
다음은 사용자가 “오늘 날씨 알려줘"라는 음성 명령을 발화했을 때, 사용자, 고객사 애플리케이션, SDK 간의 인터랙션을 정리한 시나리오입니다.
그림Wallpad SDK 인터랙션 시나리오
- Wallpad 애플리케이션에서 Kakao i Agent SDK 초기화를 수행합니다.
- 카카오 i 계정 정보를 인증합니다.
- 카카오 i 계정 인증은 카카오 계정을 기반으로 진행됩니다.
- 사용자가 Wake-up Word(호출명령어)인 “헤이 카카오”를 발화하면, SDK는 발화 명령어를 인식하고 발화 효과음을 재생하여 사용자에게 명령어를 입력받을 수 있는 상태임을 알립니다.
- 사용자가 “오늘 날씨 알려줘"라는 음성 명령을 하면, SDK는 사용자 음성 명령을 인식하고 애플리케이션에 인식 상태를 실시간으로 전달합니다.
- SDK는 명령어 인식을 완료하면 더 이상 사용자 음성을 입력받지 않고, 해당 음성 명령에 대한 응답을 출력합니다.
- 음성 답변과 함께 SDK의 기본 응답 UI 템플릿인 View Template을 통해 응답 UI를 출력합니다.
- View Template에 대한 자세한 설명은 View Template 수정 문서를 참고하시기 바랍니다.
안내
필요 시 SDK에서 제공하는 기본 응답 UI 템플릿인 View Template을 수정할 수 있습니다.
자세한 설명은 View Template 수정 문서를 참고하시기 바랍니다.
관련 문서
Android Kakao i Agent SDK iOS Kakao i Agent SDK Wallpad Kakao i Agent SDK