Android Studio 설정

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

Gradle 설정하기

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

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

3. build.gradle로 이동하여 다음과 같이 minSdkVersion, JavaVersion, jvmTarget을 설정하고, applicationId 값을 입력합니다.

   표Gradle 설정값

   구분	설정값
   minSdkVersion	21
   JavaVersion	8
   jvmTarget	1.8
   applicationId	서버에 등록된 애플리케이션 패키지명

   코드예제Gradle 설정

   Groovy

   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

   Groovy

   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 Agent SDK	Release(출시 시)	http://maven.daumcorp.com/content/repositories/daum
   Kakao i Agent 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	필수	카카오 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

   Groovy

   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. 다음을 참고하여, 필요한 Permission을 업데이트합니다.

   코드예제Manifest Permission

   XML

    <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 사이트를 참고하시기 바랍니다.