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