Kakao i Agent SDK::Android

페이지 이동경로

시작하기

Kakao i Agent SDK는 기본적으로 사용자의 음성 명령을 입력받고, 명령어를 분석하여 사용자 요청에 맞는 응답(음성과 UI)을 출력하는 기능을 제공합니다. 음성 인식 결과를 음성 답변 오디오로 출력하는 것과 동시에 UI 요소(View Template)의 출력을 원하는 경우에는 SDK에 내장된 기본 View Template Renderer를 사용할 수 있습니다. Kakao i Agent SDK는 기능별 모듈로 구성되어 있으며, Kakao i 음성 인식 서비스에서 제공하는 기능을 처리하기 위한 별도의 메서드를 제공합니다.

헤이카카오 비로그인 방식 지원

최종 사용자가 애플리케이션에서 Kakao i 음성 인식 서비스를 이용하기 위해서는 기본적으로 카카오 계정을 통해 헤이카카오(HeyKakao) 서비스에 가입해야 합니다. 하지만 헤이카카오 서비스에 가입하지 않고 Kakao i 음성 인식 서비스를 사용하는 사용자들을 위해, Kakao i Agent SDK for Android 1.3.5.5(2021년 12월) 버전부터는 헤이카카오 비로그인 방식을 지원하고 있습니다.

주의
현재(2021년 12월) 기준으로 Kakao i Agent SDK에서는 헤이카카오 비로그인 기능만을 단독으로 구현하여 사용하는 것은 불가능하며, 반드시 헤이카카오 로그인 기능과 병행하여 구현해야합니다.

안내
Kakao i 음성 인식 서비스를 이용하기 위해서는 사전에 헤이카카오(HeyKakao) 서비스에 가입해야 합니다.

  • Kakao i 음성 인식 서비스는 Kakao 서비스와 구분되는 별도의 헤이카카오 서비스입니다.
  • 헤이카카오 서비스는 Kakao 계정을 사용해 가입할 수 있습니다.

Kakao i Agent SDK 구성요소

Kakao i Agent SDK for Android 구성요소
구성요소 설명
Kakao i Agent 음성 인식의 주요 기능을 포함하는 모듈
- 음성 인식, 인식 상태 전달 등
Kakao i Client Kakao i 서버와 SDK의 연동을 위한 모듈
- 음성 인식 데이터와 음성 인식 상태 정보를 Kakao i 서버와 송신/수신할 때 사용
AppClient 애플리케이션의 통신 관련 설정을 할 수 있는 모듈
Auditorium 음성 입력 관련 모듈
- 사용자의 음성 명령을 녹음하고, 녹음된 결과(오디오 버퍼)를 필요한 곳에 공급
Dialoid(Wake-up) 음성 발화 모듈
- Wake-Up Word(호출명령어)를 설정하고, 인식된 발화 음성에 대한 상태와 정보를 확인
Kapi Adapter Kakao i 음성 인식 서비스 인증 관련 모듈
PhoneCall Manager 전화 걸기 관련 모듈

안내
이 문서는 Kakao i Agent SDK for Android 1.3.5.5 버전(2021년 12월)을 기반으로 작성되었습니다.

인터랙션 개발 시나리오

다음은 애플리케이션에서 헤이카카오 로그인이 완료되고, 사용자가 “오늘 날씨 알려줘"라는 음성 명령어를 발화했을 때 사용자(User), 애플리케이션(Application), Kakao i Agent SDK 간 인터랙션을 정리한 시나리오입니다.

인터랙션 시나리오 그림인터랙션 시나리오

  1. 애플리케이션에서 Kakao i Agent SDK 초기화를 수행합니다.
  2. Kakao i 계정 정보를 인증합니다.
    • Kakao i 계정 인증은 Kakao 계정을 기반으로 진행됩니다.
  3. 사용자가 Wake-up Word(호출명령어)인 “헤이 카카오!”를 발화하면, SDK는 발화 명령어를 인식하고 발화 효과음을 재생하여 사용자에게 명령어를 입력받을 수 있는 상태임을 알립니다.
  4. 사용자가 “오늘 날씨 알려줘"라는 음성 명령을 하면, SDK는 사용자 음성 명령을 인식하고 애플리케이션에 인식 상태를 실시간으로 전달합니다.
    • SDK는 명령어 인식을 완료하면 더 이상 사용자 음성을 입력받지 않고, 해당 음성 명령에 대한 응답을 출력합니다.
  5. 음성 답변과 함께, SDK의 기본 응답 UI 템플릿인 View Template을 통해 응답 UI를 출력합니다.

안내
음성 응답 결과 출력은 Kakao i Agent SDK에 기본적으로 탑재되어 있는 UI 템플릿 형식인 View Template을 사용할 수 있습니다.

  • UI 템플릿 관련한 자세한 설명은 View Template 문서를 참고하시기 바랍니다.

관련 문서

Android Kakao i Agent SDK Wallpad Kakao i Agent SDK

이 문서가 만족스러운 이유를 알려주세요.
이 문서에 아쉬운 점을 알려주세요.
평가해주셔서 감사합니다.

더 자세한 의견은 documentation@kakaoenterprise.com 으로 제보해주세요.