v4.22.0.2

다운로드

Unreal Engine 4 Android/iOS Unreal Engine 5 Android/iOS
다운로드 Hive SDK v4 UE4 Android+iOS 22.0.2 Hive SDK v4 UE5 Android+iOS 22.0.2
배포일 2023-11-08 2023-11-08

 

개발 환경

Unreal Engine 4: Android
Gradle Android Gradle Plugin Kotlin Gradle Plugin
v6.1.1 v4.0.0 v1.6.20

  • Unreal Engine 4.27 Plus
    • commit hash: 6d964b43aa6892200b8058b30d60cdf51ca8f209
  • JAVA 8
  • Android Studio 4.1
  • Android NDK r21
  • Android SDK min version 21
  • Android SDK target version 33

Unreal Engine 4: iOS
  • Unreal Engine 4.27 Plus
    • commit hash: 6d964b43aa6892200b8058b30d60cdf51ca8f209
  • Xcode 14.3
  • iOS 12.0+
  • macOS Ventura 13+

Unreal Engine 5: Android
  • Unreal Engine 5.2.1
  • minSdkVersion 26
  • NDK r25b
  • targetSdkVersion 33
Gradle Android Gradle Plugin Kotlin Gradle Plugin
v6.1.1 v4.0.0 v1.6.20

Unreal Engine 5: iOS
  • Unreal Engine 5.2.1
  • xcode 14
  • iOS 15
  • macOS Ventura 13+

외부 라이브러리

필수 항목

  • Kotlin (Android) v1.6.20
  • Kotlin Coroutine (Android) 1.4.0
  • AndroidX (Android) v1.0.0+
  • Constraint Layout (Android) v2.1.4
  • Glide (Android) v4.13.0
  • SDWebImage (iOS) v5.13.4

선택 항목

IDP
  • Facebook SDK Android v13.0.0
  • Facebook SDK iOS v14.1.0 (iOS 11+ 이상 지원)
  • Facebook SDK iOS v16.0.0 (iOS 12+ 이상 지원)
  • GooglePlay Services-Auth (Android) v17.0.0
  • GooglePlay Services-Games v2 (Android) v17.0.0
  • Google Sign-In SDK (iOS) v6.2.4
  • QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
  • QQ (iOS) v3.5.12
  • VK (Android) v3.5.1
  • VK (iOS) v1.6.3
  • WeChat (Android) v6.8.0
  • WeChat (iOS) v1.9.6
  • LINE (Android) v5.7.0
  • LINE (iOS) v5.8.2
  • Huawei (Android) v6.7.0.300
IAP
  • Google Billing Library (Android) v6.0.1
  • OneStore (Android) v21.00.02
  • WeChat (Android) v6.8.0
  • Amazon (Android) v3.0.4
  • Huawei (Android) v6.3.0.300
PUSH
  • Amazon (Android) v1.0.1
  • FCM(FirebaseCloudMessaging) (Android) v23.1.2
MARKETING TRACKING ANALYTICS
  • Adjust(Android) v4.32.0
  • Adjust(iOS) v4.33.3
  • Singular(Android) v12.0.8
  • Singular(iOS) v12.0.1
  • AppsFlyer(Android) v6.12.2
  • AppsFlyer(iOS) v6.12.1
  • FirebaseAnalytics(Android) v21.3.0
  • FirebaseAnalytics(iOS) v10.4.0
기타
  • GooglePlay Services-Review (Android) v2.0.0
  • Google Recaptcha (Android) v17.0.1
  • Google Recaptcha (iOS) v16.0.0
  • YoutubeAndroidWebPlayerApi (Android) v1.0.1

 

변경한 기능

결제

해결한 버그

애널리틱스
  • All Singular 마케팅 분석 도구 이용 시 매출 이벤트를 정상적으로 분석하지 못했던 오류를 수정합니다.
결제
  • iOS 구독 상품을 restoreSubscription으로 복구하려고 할 때, 구독한 상품이 없는 경우 NOT_OWNEND 응답 콜백을 수신하지 못하는 오류를 수정합니다.

알려진 문제점

이 Hive SDK 버전 배포 시 알려진 문제점은 없습니다.

 

v4.22.0.0

새로운 기능

인증
  • All 약관 동의 내역을 초기화할 수 있는 메서드를 추가합니다. resetAgreement() 메서드를 호출하여 약관 동의 내역을 초기화할 수 있습니다.
애널리틱스
프로비저닝

 

변경한 기능

Hive SDK 공통
  • All 팝업 UI, 리뷰 UI 등에서 닫기 버튼(X 버튼)을 다이얼로그 내부로 이동합니다.
  • All 게임 서비스 종료 후 Hive SDK 초기화를 시도하면 에러 코드를 반환합니다.
  • Android Android OS 10 이상 기기에서 PlatformHelper 클래스 share 메서드 사용 시, 서식이 있는 텍스트 미리보기를 지원합니다.
  • Android Android OS 14 이상 기기에서 PlatformHelper 클래스 share 메서드 사용 시, 미디어(이미지 등) 미리보기를 지원합니다.
  • iOS 앱 설정에 따라 회전을 지원하였던 UI를 hive_config.xml에 설정한 HiveOrientation값에 따라 회전하도록 변경합니다. Hive SDK가 제공하는 모든 UI에서 화면 회전을 지원합니다.
인증
  • All 기기 관리 기능 사용 시 노출하는 문구를 변경합니다.
    • 기기 관리 서비스 사용을 권장하는 문구가 추가됩니다.
    • 기기 관리 기능 사용중 문자 인증 과정에서 이전 단계로 이동하는 ‘닫기’버튼을 추가합니다.
  • All 중국에서 접속하는 유저가 실명 인증을 진행할 때 노출하는 고객센터 링크 URL을 제거합니다.
  • All 게임 서비스를 종료하면 더는 로그인과 PlayerID 생성이 불가능하며, 로그인 시도 시 게임 서비스 종료에 따른 에러 코드를 반환합니다.
  • Android 점검, 성인 인증, 약관 등 모든 인증 팝업에서 실시간 화면 회전을 지원합니다.
빌링
  • All Amazon 마켓과 Apple App Store에서 결제 시 지연 구매(Pending Purchase) 기능을 지원합니다.
    • UserEngagement 전역 콜백 핸들러 선언 예제 코드가 변경되었습니다. IAP_UPDATED 이벤트 EventEnd 콜백 코드가 변경되었으며, Amazon 마켓과 Apple App Store에서 결제 시 지연 결제 기능을 제공하려면 이 코드 변경을 먼저 적용해야 합니다.
  • Android Android OS 14 타겟 빌드를 지원하는 Google Billing Library 6.0.1을 적용합니다. 아래와 같이 사용 버전을 변경해야 합니다.
    • v5.0.0 → v6.0.1
노티피케이션
  • Android 지원하는 FCM(Firebase Cloud Messaging) 버전이 변경되었습니다. 아래와 같이 사용 버전을 변경해야 합니다.
    • v20.2.4 → v23.1.2
마케팅 어트리뷰션
  • All Adjust 사용 시 이미 설치된 앱을 실행할 수 있는 딥링크를 제공합니다. 또 유저가 딥링크를 클릭해 이미 설치된 앱을 실행할 때 Adjust 어트리뷰션과 리어트리뷰션 추적 기능을 제공합니다.
  • Android AppsFlyer 라이브러리를 최신 버전으로 변경합니다.
    • 이전 버전: v6.9.2
    • 변경 버전: v6.12.2
  • iOS AppsFlyer 라이브러리를 최신 버전으로 변경합니다.
    • 이전 버전: v6.9.2
    • 변경 버전: v6.12.1
커뮤니티
  • All 커뮤니티 시작 URL에 포함된 도메인을 도메인 화이트리스트에 포함합니다. 예를 들어, 제노니아 커뮤니티의 시작 URL이 “https://www.zenonia.co.kr/ko/board/6″이라면, “https://www.zenonia.co.kr”은 화이트리스트에 포함합니다. 화이트리스트에 포함된 도메인은 JavaScript 코드 실행을 허용하고 POST 방식 REST API 요청을 수신할 수 있습니다.

 

해결한 버그

Hive SDK 공통
  • All 외부 라이브러리가 없을 때 Unknown 또는 응답 없음 에러 코드가 아닌 별도 에러코드를 제공합니다.
  • Android 대용량 로그출력 시 순간적으로 지나치게 많은 메모리를 사용했던 오류를 수정합니다.
인증
  • All AuthV4Helper 클래스로 묵시적 로그인 기능을 제공할 때 제재받은 계정으로 로그인하면 Invalid Session으로 잘못 전송했던 오류 코드를 Need Exit으로 수정합니다.
  • All 버튼 2개 이상을 가진 점검 팝업도 커스터마이징할 수 있도록 수정합니다.
마케팅 어트리뷰션
  • iOS AppsFlyer로 구매 이벤트 전송 시 잘못된 키로 부가 정보를 보내는 오류를 수정합니다.
    • custsom_product_id → custom_product_id
노티피케이션
  • Android 간헐적으로 내용이 없는 로컬 푸시를 노출하는 오류를 수정합니다.

 

알려진 문제점

이 Hive SDK 버전 배포 시 알려진 문제점은 없습니다.

 

개발자 가이드 변경점

 

v4.21.1.3

다운로드

Unreal Engine 4 Android/iOS Unreal Engine 5 Android/iOS
다운로드 Hive SDK v4 UE4 Android+iOS 21.1.3 Hive SDK v4 UE5 Android+iOS 21.1.3
배포일 2023-11-08 2023-11-08

 

개발 환경

Unreal Engine 4: Android
  • Unreal Engine 4.27 Plus
  • minSdkVersion 21
  • NDK r21b
  • targetSdkVersion 33
Gradle Android Gradle Plugin Kotlin Gradle Plugin
v6.1.1 v4.0.0 v1.6.20

Unreal Engine 4: iOS
  • Unreal Engine 4.27 Plus
    • commit hash: 6d964b43aa6892200b8058b30d60cdf51ca8f209
  • xcode 14
  • iOS 12
  • macOS Ventura 13+

Unreal Engine 5: Android
  • Unreal Engine 5.1.1
  • minSdkVersion 26
  • NDK r25b
  • targetSdkVersion 33
Gradle Android Gradle Plugin Kotlin Gradle Plugin
v6.1.1 v4.0.0 v1.6.20

Unreal Engine 5: iOS
  • Unreal Engine 5.1.1
  • xcode 14
  • iOS 15
  • macOS Ventura 13+
외부 라이브러리

필수 항목

  • Kotlin (Android) v1.6.20
  • Kotlin Coroutine (Android) 1.4.0
  • AndroidX (Android) v1.0.0+
  • Constraint Layout (Android) v2.1.1
  • Glide (Android) v4.13.0
  • SDWebImage (iOS) v5.13.4

선택 항목

인증
  • Facebook SDK Android v13.0.0
  • Facebook SDK iOS v14.1.0 (iOS Native 또는 Unity, iOS 11 이상)
  • Facebook SDK iOS v15.0.0 (iOS Native 또는 Unity, iOS 12 이상)
  • Facebook SDK iOS v16.0.0 (Unreal, iOS 12 이상)
  • GooglePlay Services-Auth (Android) v17.0.0
  • GooglePlay Services-Games v2 (Android) v17.0.0
  • Google Sign-In SDK (iOS) v6.2.4
  • QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
  • QQ (iOS) v3.5.12
  • VK (Android) v3.5.1
  • VK (iOS) v1.6.3
  • WeChat (Android) v6.8.0
  • WeChat (iOS) v1.9.6
  • LINE (Android) v5.7.0
  • LINE (iOS) v5.8.2
  • Huawei (Android) v6.7.0.300
결제
  • Google Billing Library (Android) v5.0.0
  • OneStore (Android) v21.00.01
  • WeChat (Android) v6.8.0
  • Amazon (Android) v3.0.2
  • Huawei (Android) v6.3.0.300
푸시
  • Amazon (Android) v1.0.1
  • FCM(FirebaseCloudMessaging) (Android) v20.2.4
마케팅 추적 도구
  • Adjust(Android) v4.32.0
  • Adjust(iOS) v4.33.3
  • Singular(Android) v12.0.8
  • Singular(iOS) v12.0.1
  • AppsFlyer(Android) v6.9.2
  • AppsFlyer(iOS) v6.9.1
  • FirebaseAnalytics(Android) v20.1.2
  • FirebaseAnalytics(iOS) v10.4.0
기타
  • GooglePlay Services-Review (Android) v2.0.0
  • Google Recaptcha (Android) v17.0.1
  • Google Recaptcha (iOS) v16.0.0
  • YoutubeAndroidWebPlayerApi (Android) v1.0.1

 

해결한 버그

애널리틱스
  • All Singular 마케팅 분석 도구 이용 시 매출 이벤트를 정상적으로 분석하지 못했던 오류를 수정합니다.
결제
  • iOS 구독 상품을 restoreSubscription으로 복구하려고 할 때, 구독한 상품이 없는 경우 NOT_OWNEND 응답 콜백을 수신하지 못하는 오류를 수정합니다.

알려진 문제점

이 Hive SDK 버전 배포 시 알려진 문제점은 없습니다.

 

v4.21.1.0

새로운 기능

인증
  • All 중국 국가신문출판서에서 발표한 [미성년자의 온라인게임 중독에 대한 더욱 엄격한 관리에 관한 통지] 등 관련 규정에 근거해 중국 판호를 받은 게임에 한하여 중국에서 접속한 유저는 실명 인증을 진행하도록 하는 기능을 제공합니다.
허큘리스
  • All Hive SDK v4.21.1부터 언리얼 엔진 개발자를 위해 허큘리스를 정식 플러그인으로 제공합니다.

 

해결한 버그

인증
  • All 웹뷰로 프로필 페이지가 노출된 상황에서 URL 리다이랙션을 반복적으로 빠르게 수행하면 이를 에러로 인식하여 프로필 페이지를 종료하는 오류를 수정합니다. 에러로 인식한 리다이렉션 요청은 무시합니다.

 

알려진 문제점

이 Hive SDK 버전 배포 시 알려진 문제점은 없습니다.

 

개발자 가이드 변경점

  • Unreal Engine 4를 Xcode에서 빌드하기 전에, Apple Silicon 칩셋 호환을 설정하는 가이드를 추가했습니다. Apple Silicon을 탑재한 macOS 개발 환경에서 Unreal Engine 4로 개발할 경우 이 가이드를 따라야합니다.
  • Unreal 환경에서 Google Play Games 인증 사용을 위한 가이드를 추가했습니다.
  • Hive SDK에서 Unreal Engine 5를 사용하기 위한 설정 가이드를 추가했습니다.