Kakao i Agent SDK::Wallpad::개발 프로세스::Android Studio 설정

페이지 이동경로

Android Studio 설정

Android Studio 프로젝트에서 Wallpad용 Kakao i Agent SDK를 사용하기 위해서는 Gradle 설정과 Menifest 설정이 필요합니다.

Gradle 설정

  1. Android Studio를 최신 버전으로 업데이트 합니다.

  2. Android Studio | New Project로 이동하여 신규 프로젝트를 생성합니다

  3. build.gradle로 이동하여 minSdkVersion 레벨을 21, JavaVersion을 8로 설정 후, 애플리케이션 패키지명을 applicationId로 지정합니다.

    코드예제Gradle 설정

    android {
            defaultConfig {
                ...
                minSdkVersion 21 //Android SDK API 레벨을 21로 설정
                applicationId "com.kakao.i.test.stage.wallpad"
            }
             compileOptions {
                            //Java 컴파일러 타겟을 Java8로 설정
                sourceCompatibility JavaVersion.VERSION_1_8
                targetCompatibility JavaVersion.VERSION_1_8
            }
             kotlinOptions {
                            //Jvm Target을 1.8로 지정
                jvmTarget = "1.8"
            }
            }   
    

  4. build.gradle (Project) 파일에서 allprojects-repositories 섹션의 mavenCentral() 아래에 각 레포지토리 URL을 추가합니다.

    • Maven 저장소에 접근이 안될 경우에는 로컬 AAR(Android Archive package) 형태로 배포할 수 있습니다.

    코드예제build.gradle

    allprojects {
    repositories {
            google()
            jcenter()
            mavenCentral()
            // Maven 접근이 안될 경우 아래 경로에 aar 파일을 포함(Sample App 참고)
            maven { url "${projectDir}/repositories" }
            maven { url 'https://devrepo.kakao.com/nexus/content/groups/public/' }
            //출시 시
            maven { url 'http://maven.daumcorp.com/content/repositories/daum/' }
            //테스트 시
            maven { url 'http://maven.daumcorp.com/content/repositories/daum-snapshots/' }
    }
    

    Maven Repository 경로
    의존성 구분 개발 단계 경로
    Kakao SDK 공통 https://devrepo.kakao.com/nexus/content/groups/public/
    Kakao i SDK Release(출시 시) http://maven.daumcorp.com/content/repositories/daum
    Kakao i SDK Snapshots(테스트 시) http://maven.daumcorp.com/content/repositories/daum-snapshots
    주의
    Release(출시)와 Snapshots(테스트)의 Maven Repository 경로가 상이하므로, 반드시 확인 후 추가하시기 바랍니다.
  5. build.gradle (module: app) 파일에 SDK 의존성을 추가합니다.

    Wallpad 의존성 항목
    의존성 항목 필수 여부 설명
    com.kakao.i:sdk-agent-wallpad:1.3.2.25 필수 Kakao i 음성 인식 서비스 SDK
    com.kakao.i:wakeup-dialog:1.6.7 필수 Wake-up을 위한 음성 인식 라이브러리
    - 추가 시, Wake-up Detector 모듈이 자동 생성됨
    - Wake-up Detector 모듈은 SDK에 포함된 Dialoid 라이브러리를 사용함
  6. SDK 최신 버전을 컴파일하기 위해, build.gradle (module: app) 파일의 dependencies {} 섹션에 다음의 의존성을 추가합니다.

    코드예제dependencies

    dependencies {
        implementation 'com.kakao.i:sdk-agent-wallpad:1.3.2.25'
        implementation 'com.kakao.i:wakeup-dialoid:1.6.7'
     }
    

    안내
    의존성 항목은 향후 추가 및 변경될 수 있습니다.

Manifest 설정

사용자 권한을 획득하기 위해서 Android Manifest를 업데이트합니다.

  1. Project/…/AndroidManifest.xml 파일을 오픈합니다.

  2. 다음의 표 | Manifest 권한을 참고하여, 필요한 Permission을 업데이트합니다.

    코드예제Permission

     <uses-permission android:name="android.permission.INTERNET" />
     <uses-permission android:name="android.permission.RECORD_AUDIO" />
     <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
     <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
     <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
    

    Manifest 권한
    Permission 필수 여부 설명
    android.permission.INTERNET 필수 인터넷 사용을 위한 권한
    android.permission.RECORD_AUDIO 필수 마이크 사용을 위한 권한
    android.permission.FOREGROUND_SERVICE 필수 지속적으로 음성 인식 서비스 사용을 위한 권한
    android.permission.SYSTEM_ALERT_WINDOW 필수 플로팅 마이크 버튼 사용을 위한 권한
    android.permission.RECEIVE_BOOT_COMPLETED 필수 Wallpad 부팅 시 서비스를 실행하기 위한 권한
    안내
    Manifest의 Permission 허용에 대한 자세한 설명은 Google Developers 사이트를 참고하시기 바랍니다.
이 문서가 만족스러운 이유를 알려주세요.
이 문서에 아쉬운 점을 알려주세요.
평가해주셔서 감사합니다.

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