Skip to main content

시작하기 전에

Unity 프로젝트에 DARO Unity SDK를 설치하기 전에 다음 항목을 준비하세요.
  • DARO 대시보드에서 발급한 iOS 또는 Android 앱 키
  • 플랫폼별 DARO key file
  • 사용할 광고 포맷별 광고 단위 ID
  • Android 또는 iOS 빌드 환경

SDK 설치하기

권장 설치 방법은 DaroPackageInstaller.unitypackage를 사용하는 것입니다.
1

Installer 패키지 가져오기

GitHub Release에서 DaroPackageInstaller.unitypackage 파일을 다운로드합니다.
2

Unity 프로젝트에 import하기

Unity Editor에서 Assets > Import Package > Custom Package를 선택한 뒤 DaroPackageInstaller.unitypackage를 import합니다.
3

패키지 설치 확인하기

Installer가 Packages/manifest.json에 OpenUPM scoped registry, EDM4U, so.daro.unity 의존성을 추가합니다.so.daro.unity 최신 패키지 버전은 0.4.0이며, EDM4U [email protected]을 사용합니다.
4

Integration Manager 실행하기

Unity Editor에서 Assets > Daro > Integration Manager를 열고 프로젝트 설정을 검증합니다.
Installer는 Unity 프로젝트의 Packages/manifest.json에 OpenUPM registry를 추가하고 [email protected] 설치를 시작합니다.

프로젝트 설정하기

Unity Editor에서 Daro > Integration Manager를 열고 플랫폼별 설정을 입력합니다.
1

Settings Asset 생성

Integration Manager에서 Create Settings Asset을 선택합니다.
2

iOS 설정 입력

iOS 빌드를 사용하는 경우 iOS Daro App Key, iOS Key File, AdMob App ID, ATT 문구를 입력합니다.
3

Android 설정 입력

Android 빌드를 사용하는 경우 Android Daro App Key, Android Key File을 입력합니다.
4

Android 빌드 템플릿 활성화

Android 빌드를 사용하는 경우 Unity Editor에서 Edit > Project Settings > Player > Android > Publishing Settings > Build로 이동한 뒤 다음 항목을 활성화합니다.
  • Custom Main Gradle Template
  • Custom Gradle Properties Template
  • Custom Gradle Settings Template
활성화하면 다음 파일이 생성됩니다.
  • Assets/Plugins/Android/mainTemplate.gradle
  • Assets/Plugins/Android/gradleTemplate.properties
  • Assets/Plugins/Android/settingsTemplate.gradle
Android 빌드 시 DARO Unity SDK가 필요한 Gradle 플러그인, 최소 SDK 설정, ProGuard 규칙을 내보낸 프로젝트에 적용합니다.
5

설정 검증

Integration Manager에서 현재 빌드 타겟의 설정 검증 결과를 확인합니다.
Unity 6000.3.17f1 이상에서 Android 빌드를 하는 경우 Assets/Plugins/Android/gradleTemplate.properties에 다음 설정을 추가하세요.
Unity 6000.3.17f1부터 AGP 9.0이 적용되어 Android 라이브러리 namespace 중복 검사가 기본으로 활성화됩니다. Pangle 7.7의 pag-sdkpag-sdk-ad AAR은 동일한 com.bytedance namespace를 사용하므로 processDebugMainManifest 단계에서 매니페스트 병합이 실패할 수 있습니다. 이 문제는 EDM4U 의존성 해석 오류와 별개입니다.
앱 키와 key file은 InitializeAsync()의 인자로 전달하지 않습니다. Unity 빌드 시점에 iOS Info.plist와 Android AndroidManifest.xml 또는 gradle.properties로 주입됩니다.

SDK 초기화하기

앱 시작 시점에 DaroSdk.InitializeAsync()를 호출합니다.
개인정보 보호 설정과 사용자 ID는 SDK 초기화 전에도 설정할 수 있습니다.

광고 인스턴스 사용 흐름

전체 화면 광고 인스턴스는 다음 순서로 사용합니다.
  1. await DaroSdk.InitializeAsync()를 완료합니다.
  2. 광고 인스턴스를 생성합니다.
  3. 이벤트 핸들러를 등록합니다.
  4. Load()를 호출합니다.
  5. 로드 완료 후 IsReady()를 확인하고 Show()를 호출합니다.
  6. 화면이 사라질 때 Dispose()를 호출합니다.
배너 광고는 Load()가 성공하면 자동으로 표시됩니다. Show()Hide() 후 배너를 다시 표시할 때만 사용하세요.
SDK 콜백은 Unity 메인 스레드에서 전달됩니다. 생성자와 Load(), Show(), Hide(), Dispose() 같은 공개 SDK 메서드도 Unity 메인 스레드에서 호출하세요.
광고 인스턴스가 더 이상 필요하지 않을 때 Dispose()를 명시적으로 호출하세요. SDK 0.4.0은 finalizer 기반 정리를 보조 수단으로 제공하지만, 정리 시점은 보장되지 않습니다.