프로젝트 셋업하기
AI Human SDK를 이용해 인증에 필요한 UserKey, AppId 등을 생성하고 등록하는 방법에 대해 알아봅니다.
1. 사이트 진입하기
**AI Human 웹사이트**에서 계정을 생성하고 로그인 합니다.
- 우측 상단 > Login(Sign In) > Create account
- 로그인 이후에 SDK 카테고리에서 프로젝트를 생성할 수 있습니다.
- SDK 카테고리 접근이 불가하다면 고객센터로 문의해 주세요.
2. My Workspace에 Project 추가하기
My workspace 에서 Project를 만들고, 플랫폼(Android, iOS, Windows)의 App Id를 입 력하고 확인을 클릭합니다. (이때 App ID는 자동으로 중복체크를 수행합니다.) 해당 App ID에서 사용할 수 있는 User Key가 발급됩니다.
appId, userKey, platform 정보는 인증 기능인 Authenticate() 함수의 전달인자로 사용됩니다.
정보
- App ID는 프로젝트의 고유한 Id로 일반적으로 "com.example.project.appname" 과 같이 생성합니다.
- User key는 AI Human 웹사이트에서 프로젝트를 생성하고 App ID를 입력하면 발급받을 수 있습니다.
- platform 값은 App Platform에 맞는 것을 설정합니다. (Android, iOS, Windows)
3. Unity Hub에서 새 프로젝트 생성하기
Support information
| Unity Version | 2020.3.x or later |
| Support Platform | Android, iOS, Windows |
Render pipeline compatibility
| Built-in | URP | HDRP | |
| 2D Model | Compatible | Compatible | Compatible |
| 3D Model | Compatible | Compatible | Not compatible |
4. Unity 프로젝트 셋업
AI Human SDK의 Import Package 과정을 수행합니다.
4.1. AI Human SDK 웹사이트에서 Unity AI Human SDK를 다운로드 받습니다.
4.2. Unity Editor 메뉴의 Assets > Package Manager을 통해 다음의 패키지들을 인스톨합니다.
- Burst : 3D 캐릭터의 립싱크에서 사용
- Mathematics : 3D 캐릭터의 립싱크에서 사용
- TextMeshPro : Metaverse demo의 UI에서 사용
4.3. Unity Editor 메뉴에서 Window > Import Package > Custom Package을 통해 다운로드 받은 Unity AI Human SDK(.unitypackage)를 가져옵니다.
4.4. AI Human SDK의 Sample UI는 9:16 종횡비 이상의 해상도로 제작 되었으므로 Game 뷰의 Free Aspect 항목을 선택하여 해상도를 9:16 종횡비 이상으로 설정합니다. 예외로 AIHuman & Metaverse Smaple은 16:9 종횡비를 기준으로 제작 되었으므로 해상도를 16:9 종횡비 또는 Free Aspect로 설정합니다.
4.5. Sample 실행을 위해서는 Unity Editor 메뉴에서 File > Build Settings을 선택 후 Build Settings 창의 Scenes In Build 영역으로 Project창의 Assets/DeepBrainAI/Demo/Scenes/ 경로의 모든 scene을 드래그앤드롭을 통해 추가해야 합니다.
4.5.1. (optional) DeepbrainAI 3D Model을 사용할 경우 Unity Editor 메뉴에서 Edit > Project Settings > Player > Other Settings > Color Space 항목을 Linear로 변경하는 것을 권장합니다.
4.5.2. (안드로이드) 안드로이드 타겟의 프로젝트라면 Unity Editor 메뉴에서 Edit > Project Settings > Player > Other Settings > Scripting Backend 항목을 IL2CPP로 설정합니다.
4.6. 예외 사항
Unity Editor 2021.2.x 버전 사용자는 SDK에 포함 된 Newtonsoft.Json.dll의 참조 에러가 발생 할 수 있습니다. 에러 발생 시 다음과 같은 일련의 과정을 통해 참조 에러를 해결 할 수 있습니다.
4.6.1. Unity Editor 메뉴에서 Window > Package Manager 선택
4.6.2. Package Manager창의 Packages - Unity 항목에서 Version Control 선택
4.6.3. Package Manager창 오른쪽 하단의 Update 실행
5. 샘플 프로젝트 빌드 가이드
샘플 프로젝트를 빌드하기 위해 해당 플랫폼에서 다음 과정을 수행해야 합니다.