본문으로 건너뛰기
버전: 1.3.x

프로젝트 셋업하기

이 장에서는 android project의 appId를 이용하여, 프로젝트를 생성하고 userkey를 발급받는 과정을 알아봅니다. userkey는 AIHuman SDK의 인증에 사용됩니다.

1. 원하는 프로젝트를 Android Studio 기반으로 생성하고 아래와 같이 셋업합니다.​

프로젝트 설정을 아래와 같이 할수 있습니다.(샘플이며 필수 아님.)

SDK 웹사이트에서 Android sample 및 SDK를 다운로드 받아 참조하세요. 아래는 샘플의 환경 설정입니다.

  • 프로젝트 레벨 build.gradle을 설정(탑메뉴 File > Project structure)합니다.
    • Android Gradle plugin version : 7.1.2, Gradle Version : 7.2

[프로젝트 레벨 build.gradle 설정]


[app 레벨 build.gradle 설정]

  • compileSdkVersion 32, buildToolVersion "30.0.3", minSdkVersion 22, targetSdkVersion 32

2. 사용할 프로젝트에 SDK (aar 파일) 추가하기​

AI Human SDK aar 파일들(2개 AIHumanSDK, AIHuman3DSDK)을 프로젝트 libs에 추가합니다. libs 폴더는 app 디렉토리 아래에 생성합니다. 앱레벨 build.gradle 파일에 aar 관련 내용(implementation fileTree(dir: "libs", include: [".jar", ".aar"]))을 추가합니다. 아래에 build.gradle 파일 섹션 참조하세요.

3. app 레벨의 build.gradle 파일 : (샘플 프로젝트의 build.gradle 파일 참조)​

아래의 내용들을 설정해야합니다. 더 자세한 사항은 샘플을 참조하여주세요.

  1. 자바 8 사용 설정 : compileOptions 확인
  2. packagingOptions : exclude 메타 정보 파일 설정 추가
  3. viewBinding 설정(옵션) : 꼭 추가할 필요 없음. 하지만 샘플 코드는 사용 설정 되어 있음.
  4. 디펜던시 추가 : SDK의 디펜던시를 추가 후 sync 클릭 
android{
  //...
  compileOptions {
      sourceCompatibility JavaVersion.VERSION_1_8
      targetCompatibility JavaVersion.VERSION_1_8
  }

  buildFeatures {
      viewBinding true
  }

  packagingOptions {
      exclude 'META-INF/DEPENDENCIES'
      exclude 'META-INF/LICENSE'
      exclude 'META-INF/LICENSE.txt'
      exclude 'META-INF/license.txt'
      exclude 'META-INF/NOTICE'
      exclude 'META-INF/NOTICE.txt'
      exclude 'META-INF/notice.txt'
      exclude 'META-INF/INDEX.LIST'
      exclude 'META-INF/ASL2.0'
      exclude("META-INF/*.kotlin_module")
  }
}

dependencies {
    //...

    //dependencies for AIHumanSDK AI aar ====================================
    implementation fileTree(dir: "libs", include: ["*.jar", "*.aar"])

    implementation 'androidx.appcompat:appcompat:1.4.1'
    implementation('io.socket:socket.io-client:1.0.1') {
        exclude group: 'org.json', module: 'json'
    }

    implementation 'com.squareup.retrofit2:retrofit:2.6.0'
    implementation 'com.squareup.retrofit2:converter-scalars:2.6.0'

    //dialogflow (option but needs for the sample)
    implementation 'com.google.cloud:google-cloud-dialogflow:2.1.0'

    //jwt authentication
    api group: 'io.jsonwebtoken', name: 'jjwt', version: '0.9.0'
    //==================================== dependencies for AIHumanSDK AI aar

    // MS Speech SDK ====
    implementation 'com.microsoft.cognitiveservices.speech:client-sdk:1.19.0'
    // Diff lib for pronunciation assessment
    implementation "io.github.java-diff-utils:java-diff-utils:4.10"
    // ==== MS Speech SDK
}

4. AndroidManifest.xml 파일 설정​

권한 추가 : INTERNET은 필수 

<uses-permission android:name="android.permission.INTERNET" />

application 속성 추가 ​ "Namespace 'tools' is not bound" 에러가 발생하면 Create Namespace declaration을 눌러줍니다.

<application
    android:usesCleartextTraffic="true"
    tools:replace="android:icon,android:theme">

3D 캐릭터를 사용할 액티비티 설정 (사용하는 경우)

<activity android:name=".activity.UnityActivity"
    android:screenOrientation="fullSensor"
    android:configChanges="mcc|mnc|locale|touchscreen|keyboard|keyboardHidden|navigation|orientation|screenLayout|uiMode|screenSize|smallestScreenSize|fontScale|layoutDirection|density"
    android:hardwareAccelerated="false"
    android:theme="@style/UnityThemeSelector.Translucent"
    android:process=":Unity"/>

5. Gradle JDK 설정 (11)​

android studio articfox이상 버전을 사용중이면 "Android Gradle plugin requires Java 11 to run. You are currently using Java 1.8." 에러가 발생합니다. 맥OS 기준 탑메뉴 > preference > build, Execution, Deployment > Build Tool > Gradle > Gradle JDK > 11 버전을 선택합니다. Java 11 버전이 설치되어있지 않으면 오라클 웹사이트 에서 jdk 11 버전을 다운로드 받아 설치합니다. 링크