Kakao i Agent SDK::iOS

페이지 이동경로

Kakao i Agent SDK

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

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

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

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

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

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

SDK 구성요소

Kakao i Agent SDK for iOS 구성요소
구성요소 설명
KakaoIDelegate iOS 버전 Kakao i Agent SDK의 Delegate
- 카카오 i 음성 인식 서비스를 사용하는 모앱에 해당 Delegate를 반드시 구현 필요
KakaoI iOS 버전 Kakao i Agent SDK의 메인 클래스로 해당 클래스를 통해 주요 기능을 제공
KakaoAuthDelegate 카카오 i 음성 인식 서비스 사용을 위한 인증 관련 Delegate
KIPhoneCallInterfaceDelegate 전화 걸기 관련 Delegate
- 전화 걸기 기능을 사용하기 위해 해당 Delegate를 반드시 구현 필요
KITemplateInterfaceDelegate 화면에 표시할 UI 템플릿(View Template) 관련 Delegate
- UI 템플릿을 사용하기 위해서는 해당 Delegate를 반드시 구현 필요

안내
해당 문서는 iOS 버전의 Kakao i Agent SDK 2.1.3.842 버전을 기반으로 작성되었습니다.

  • 개발 시 필요한 iOS 최소 버전: iOS 10.0

인터랙션 시나리오

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

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

  1. 애플리케이션에서 Kakao i Agent SDK(이하 SDK)를 초기화합니다.

    a. Info.plist 파일에서 String 타입 키(Key)인 KAKAO_PHASE를 추가하고, Value로 $(CONFIGURATION)을 추가합니다.

    KAKAO_PHASE 그림Phase 설정

    <key>KAKAO_PHASE</key>
    <string>$(CONFIGURATION)</string>
    

    b. 애플리케이션 내에서 SDK 사용을 위해 인터페이스를 등록하고 Delegate를 초기화합니다.

    • KakaoIDelegate(Main), AuthDelegate(인증), KITemplateInterface(View Template), KIPhoneCallInterface(전화 기능)
  2. SDK를 활성화합니다.

  3. 사용자가 기본 Wake-up Word(호출명령어)인 “헤이 카카오”를 발화하면, SDK는 발화 명령어를 인식하고 발화 효과음을 재생하여 사용자에게 명령어를 입력받을 수 있는 상태임을 알립니다.

  4. 사용자가 “오늘 날씨 알려줘”라는 음성 명령을 하면, SDK는 사용자의 음성 명령을 인식하고 애플리케이션에 인식 상태를 실시간으로 전달합니다.

    • 명령어 인식이 완료되면 더 이상 사용자의 음성을 입력받지 않고, 해당 음성 명령에 대한 응답을 출력합니다.
  5. 음성 답변과 함께 SDK의 기본 응답 UI 템플릿인 View Template을 통해 응답 UI를 출력합니다.

안내
음성 응답 결과를 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

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

더 자세한 의견은 contact.dkt@kakaocorp.com 으로 제보해주세요.