v4.24.1.0

다운로드


Unity Android/iOS
다운로드 Hive SDK v4 Unity Android+iOS 24.1.0
배포일 2024-05-14

 

개발 환경


Unity (Android)
  • Unity 2021.3.0+
  • Unity 2022.3.0+
  • Unity 2023.1.0+
targetSDK 버전에 따른 Unity 호환 버전

Hive SDK v4.23.0.0 이후 Android 빌드 targetSDK 버전에 호환되는 Unity 버전은 아래와 같습니다.

  • targetSDK 33 빌드 시
    • Unity 2021 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)
  • targetSDK 34 빌드 시
    • Unity 2022 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)
Unity (iOS)
  • Unity 2021.3.0+
  • Unity 2022.3.0+
  • Unity 2023.1.0+

Android
Gradle Android Gradle Plugin Kotlin Gradle Plugin
v7.5 v7.4.2 v1.8.0

iOS

 

외부 라이브러리

필수 항목

  • Kotlin (Android) v1.8.0
  • Kotlin Coroutine (Android) 1.4.3
  • AndroidX (Android) v1.0.0+
  • Constraint Layout (Android) v2.1.4
  • Glide (Android) v4.13.0
  • SDWebImage (iOS) v5.18.7

선택 항목

IDP
  • Facebook SDK Android v17.0.0
  • Facebook SDK iOS v16.2.1
  • GooglePlay Services-Auth (Android) v20.7.0
  • GooglePlay Services-Games v2 (Android) v20.0.0
  • Google Sign-In SDK (iOS) v7.1.0
  • QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
  • QQ (iOS) v3.5.16
  • VK (Android) v3.5.1
  • VK (iOS) v1.6.4
  • WeChat (Android) v6.8.0
  • WeChat (iOS) v2.0.4
  • LINE (Android) v5.10.0
  • LINE (iOS) v5.11.0
  • Huawei (Android) v6.12.0.300
IAP
  • Google Billing Library (Android) v6.0.1
  • OneStore (Android) v21.01.00
  • WeChat (Android) v6.8.0
  • Amazon (Android) v3.0.4
  • Huawei (Android) v6.13.0.300
PUSH
  • Amazon (Android) v1.0.1
  • FCM(FirebaseCloudMessaging) (Android) v23.2.1
MARKETING TRACKING ANALYTICS
  • Adjust(Android) v4.38.2
  • Adjust(iOS) v4.38.0
  • Singular(Android) v12.5.4
  • Singular(iOS) v12.4.1
  • AppsFlyer(Android) v6.13.0
  • AppsFlyer(iOS) v6.14.3
  • FirebaseAnalytics(Android) v21.5.0
  • FirebaseAnalytics(iOS) v10.22.0
기타
  • GooglePlay Services-Review (Android) v2.1.0
  • GooglePlay Services-AppUpdate (Android) v2.1.0
  • Google reCaptcha (Android) v18.4.0
  • Google reCaptcha (iOS) v18.3.0
  • YoutubeAndroidWebPlayerApi (Android) v1.0.1

 

새로운 기능


N/A

변경한 기능


애널리틱스
  • iOS 기기의 추적 동의 여부에 따라 동의배너 노출여부를 결정하도록 변경합니다.
    • 추적 동의를 거절한 경우에는 동의배너를 노출하지 않습니다.

개발 환경 업데이트


iOS
  • Apple Privacy Manifest 정책 대응에 따라 외부 라이브러리를 업데이트 합니다.
    • AppsFlyer(iOS) v6.13.1 → v6.14.3
    • QQ (iOS) v3.5.14 → v3.5.16
  • Facebook SDK를 다운그레이드합니다.
    • Facebook SDK v17.0.0 → v16.2.1

해결한 버그


빌링
  • iOS Hive SDK v4 24.0.0 미만 버전(예: v4 23.4.0)에서 v4 24.0.0으로 업데이트하는 경우, 상품 조회가 되지 않는 오류를 수정합니다.

개발자 가이드 변경점


N/A

 

v4.24.0.0 (2024-04-30)

새로운 기능


프로모션
  • Android 외부 페이지 노출을 위해 기기에 설정된 기본 브라우저를 이용하는 커스텀 탭을 지원합니다. PlatformHelper 클래스 showInAppBrowser 메서드로 인앱 브라우저를 노출할 수 있습니다.
  • iOS 외부 페이지 노출을 위해 브라우저를 이용하는 SafariViewController를 지원합니다. PlatformHelper 클래스 showInAppBrowser 메서드로 인앱 브라우저를 노출할 수 있습니다.
빌링
  • iOS 첫 구독 할인 정보가 있는 경우 상품 정보 조회 시 함께 전달합니다. getProductInfo 사용 시 콜백으로 받는 IAPV4Product 객체 목록에서 original_price 필드값과 price 필드값의 차이로 할인 정보를 확인할 수 있습니다.

변경한 기능


Hive SDK 공통
  • iOS 앱 버전을 구분할 때 CFBundleShortVersionString을 추가로 사용합니다.
Unity
  • All Unity Login Simulator 사용 시 Hive 콘솔 샌드박스에 있는 AppID와 Hive 인증키로 게스트 계정 playerIdplayerToken 실제 값을 불러오도록 변경했습니다. 샌드박스 서버에 있는 값들을 사용하므로 검증 API 호출(Authorizationplayer_id)이 가능합니다.
빌링
  • All 환불 유저 재결제 UI에서 노출되는 PG 결제 타입 문구를 “HiveStore”에서 “PG 결제”로 변경했습니다.
  • Android PG 결제 페이지를 인앱 브라우저가 아니라 인앱 웹뷰에서 노출하도록 변경합니다. 인앱 브라우저 환경을 지원하지 않는 기기에서도 PG 결제를 지원합니다.
애널리틱스
  • Android Firebase 이벤트 수집 기능 중 광고 식별자 수집 설정 기본값을 true로 변경합니다.

알려진 문제점


인증
  • iOS Facebook SDK iOS 17.0.0 사용 시 iOS 17.0 이상 기기에서 사용자가 “앱 추적 투명성(App Tracking Transparency)”에 동의하지 않는 경우 로그인을 할 수 없는 문제가 있습니다. 해당 조건에서 Facebook 로그인을 구현하려면 Hive SDK v4 24.1.0을 사용하세요.

개발 환경 업데이트


Android
  • GooglePlay Services-Games v2 (Android) v19.0.0 → 20.0.0
  • Facebook SDK Android v16.2.0 → 17.0.0
  • LINE (Android) v5.9.1 → 5.10.0
iOS
  • WeChat 2.0.2 → 2.0.4
  • Hercules 2024.01.23 → 2024.04.11
  • Singular 12.3.2 → 12.4.1

개발자 가이드 변경점


  • displayOriginalPrice 설명을 변경했습니다.
  • displayPrice 하단 Note 설명을 변경했습니다.
  • iOS 설정하기에서 서드 파티 프레임워크 종속성, Podfile 작성 예시를 변경했습니다. Hive SDK 기본 동작을 위한 필수 적용 프레임워크에서 HiveAppTrackingTransparencyHiveResource를 제거했습니다.

 

v4.23.5.0

다운로드


Unity Android/iOS
다운로드 Hive SDK v4 Unity Android+iOS 23.5.0
배포일 2024-05-31

 

개발 환경


Unity (Android)
  • Unity 2021.3.0+
  • Unity 2022.3.0+
  • Unity 2023.1.0+
targetSDK 버전에 따른 Unity 호환 버전

Hive SDK v4.23.0.0 이후 Android 빌드 targetSDK 버전에 호환되는 Unity 버전은 아래와 같습니다.

  • targetSDK 33 빌드 시
    • Unity 2021 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)
  • targetSDK 34 빌드 시
    • Unity 2022 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)
Unity (iOS)
  • Unity 2021.3.0+
  • Unity 2022.3.0+
  • Unity 2023.1.0+

Android
Gradle Android Gradle Plugin Kotlin Gradle Plugin
v7.5 v7.4.2 v1.8.0

iOS

 

외부 라이브러리

필수 항목

  • Kotlin (Android) v1.8.0
  • Kotlin Coroutine (Android) 1.4.3
  • AndroidX (Android) v1.0.0+
  • Constraint Layout (Android) v2.1.4
  • Glide (Android) v4.13.0
  • SDWebImage (iOS) v5.18.7

선택 항목

IDP
  • Facebook SDK Android v16.2.0
  • Facebook SDK iOS v16.2.1
  • GooglePlay Services-Auth (Android) v20.7.0
  • GooglePlay Services-Games v2 (Android) v19.0.0
  • Google Sign-In SDK (iOS) v7.1.0
  • QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
  • QQ (iOS) v3.5.16
  • VK (Android) v3.5.1
  • VK (iOS) v1.6.4
  • WeChat (Android) v6.8.0
  • WeChat (iOS) v2.0.4
  • LINE (Android) v5.9.1
  • LINE (iOS) v5.11.0
  • Huawei (Android) v6.12.0.300
IAP
  • Google Billing Library (Android) v6.0.1
  • OneStore (Android) v21.01.00
  • WeChat (Android) v6.8.0
  • Amazon (Android) v3.0.4
  • Huawei (Android) v6.13.0.300
PUSH
  • Amazon (Android) v1.0.1
  • FCM(FirebaseCloudMessaging) (Android) v23.2.1
MARKETING TRACKING ANALYTICS
  • Adjust(Android) v4.38.2
  • Adjust(iOS) v4.38.0
  • Singular(Android) v12.5.4
  • Singular(iOS) v12.4.1
  • AppsFlyer(Android) v6.13.0
  • AppsFlyer(iOS) v6.14.3
  • FirebaseAnalytics(Android) v21.5.0
  • FirebaseAnalytics(iOS) v10.22.0
기타
  • GooglePlay Services-Review (Android) v2.1.0
  • GooglePlay Services-AppUpdate (Android) v2.1.0
  • Google reCaptcha (Android) v18.4.0
  • Google reCaptcha (iOS) v18.3.0
  • YoutubeAndroidWebPlayerApi (Android) v1.0.1

 

변경한 기능


애널리틱스
  • iOS 기기의 추적 동의 설정에 따라 동의 배너 노출 여부를 결정합니다. 추적 동의를 거절한 경우에는 동의배너를 노출하지 않습니다.

개발 환경 업데이트


iOS
  • Apple Privacy Manifest 정책 대응에 따라 외부 라이브러리를 업데이트합니다.
    • AppsFlyer(iOS) v6.13.1 → v6.14.3
    • QQ (iOS) v3.5.14 → v3.5.16
    • WeChat 2.0.2 → 2.0.4
    • Hercules 2024.01.23 → 2024.04.11
    • Singular 12.3.2 → 12.4.1
  • Facebook SDK를 다운그레이드합니다. 다운그레이드로 앱 추적 투명성(App Tracking Transparency)에 동의하지 않은 경우 로그인이 되지 않는 이슈를 해결합니다.
    • Facebook SDK v17.0.0 → v16.2.1

 

v4.23.4.0 (2024-04-11)

새로운 기능


애널리틱스
  • EU 및 EEA지역의 DMA 규정에 따라 개인정보 수집 동의배너 노출 기능을 지원합니다.
    • MarketTrackingTool을 하나 이상 사용하고, EU 및 EEA 지역에 마케팅을 수행하는 경우 해당 기능을 적용해야 합니다.
    • 14개월마다 재동의 요청이 필요하며, 앱에서 설정한 개월 수를 초과하는 경우 재동의 배너를 노출합니다.
    • 사용자가 수시로 동의 철회를 할 수 있도록 필요할 때마다 동의 배너를 다시 노출할 수 있습니다.

변경한 기능


Hive SDK 공통
  • Android PG결제를 위해 제공한 CustomTab의 호환성을 개선하도록 사용하는 라이브러리 버전을 변경합니다.
    • androidx.browser 1.7.0 → 1.5.0
    • androidx.browser 1.7.0 은 Android Target 34부터 사용이 가능하며, Unity 2021 버전에서 사용이 불가능합니다.
외부 라이브러리 업데이트
  • Android GDPR DMA에 대응하는 라이브러리로 업데이트 합니다:
    • Adjust 4.38.1 → 4.38.2
    • AppsFlyer 6.12.3 → 6.13.0
    • Singular 12.3.0 → 12.5.4
  • iOS GDPR DMA에 대응하는 라이브러리로 업데이트 합니다:
    • Adjust 4.37.1 → 4.38.0
    • AppsFlyer 6.12.1 → 6.13.1
    • Singular 12.1.1 → 12.3.2
  • iOS Apple Privacy Manifest 정책 대응에 따라 외부 라이브러리를 업데이트합니다:
    • Facebook 16.2.1 → 17.0.0
    • Google SignIn 7.0.0 → 7.1.0
푸시&알림
  • Android FCM 적용에 사용하는 Google API Key 값을 인코딩하여 사용하도록 변경합니다.

알려진 문제점


인증
  • iOS Facebook SDK iOS 17.0.0 사용 시 iOS 17.0 이상 기기에서 사용자가 “앱 추적 투명성(App Tracking Transparency)”에 동의하지 않는 경우 로그인을 할 수 없는 문제가 있습니다. 해당 조건에서 Facebook 로그인을 구현하려면 Hive SDK v4 24.1.0 또는 곧 릴리즈되는 v4 23.5.0을 사용하세요.

해결한 버그


Hive SDK 공통
  • Android 네트워크 상태 모니터링 동작 수행시, 간헐적으로 크래시가 발생하는 오류를 수정합니다.
  • iOS hive_config.xml 파일 내에 더 이상 사용하지 않는 useCrashReport 키가 존재하는 경우, 크래시가 발생하는 오류를 수정합니다.
챗봇
  • Android 챗봇 메시지를 입력하는 경우 웹뷰가 리사이즈 되지 않는 오류를 수정합니다.

 

개발자 가이드 변경점


 

v4.23.3.0 (2024-03-26)

새로운 기능


빌링
  • Android 모바일 환경에서도 PG 결제를 지원합니다.

변경한 기능


Unity
  • Android Unity 2022.3.16f1 이상 버전들에서 com.unity3d.player.UnityPlayerActivity 파일 관련 호환성을 개선했습니다. 기본 시작 Activity 패키지 이름을 com.hive.UnityPlayerActivity에서 com.hive.HiveUnityPlayerActivity로 변경합니다.
  • Android GameActivity(Unity 2023 이상)를 사용한 빌드를 지원합니다. Unity 2023 이상에서 GameActivity를 사용할 경우 기본 시작 Activity 패키지 이름은 com.hive.HiveUnityPlayerGameActivity입니다.
Hive SDK 공통
  • iOS SDWebImage 라이브러리 버전을 업데이트했습니다: 5.18.3 → 5.18.7
인증
  • Android reCaptcha 라이브러리 버전을 업데이트했습니다: 18.2.1 → 18.4.0
  • iOS LineSDK 라이브러리 버전을 업데이트했습니다: 5.10.0 → 5.11.0
마케팅 어트리뷰션
  • Android Adjust 라이브러리 버전을 업데이트했습니다: 4.35.1 → 4.38.1
  • iOS Adjust 라이브러리 버전을 업데이트했습니다: 4.35.2 → 4.37.1
  • iOS FirebaseAnalytics 라이브러리 버전을 업데이트했습니다: 10.20.0 → 10.22.0

해결한 버그


Unity
  • All Unity 에디터에서 호출할 수 있는 일부 Hive SDK 메서드에서 발생하는 Null-Reference-Exception 오류를 수정했습니다.
인증
  • All 본인 인증 화면 문제를 수정했습니다.
  • iOS 중국 IP를 대상으로 하는 실명 인증 화면에 음영이 나타나는 문제를 수정했습니다.
  • iOS 오프라인 모드에서 로그인 시, 연동된 IdP 정보를 제공하는 콜백 결과인 providerInfoData값이 비어있던 문제를 해결했습니다.
커뮤니티
  • iOS 네트워크 장애 상태에서 SocialV4.showCommunity(SocialV4.ViewType.FullScreen 뷰 타입) 호출 시, 네트워크 장애 발생 시 노출되어야 하는 표준 에러 페이지가 노출되지 않는 문제를 수정했습니다.
기기 관리
  • iOS 휴대폰 번호 인증 시 일일 인증 번호 발송 횟수 한도를 초과했음에도, 재발송을 위한 타이머가 초기화되는 오류를 수정했습니다.
  • iOS 휴대폰 번호 인증 시, 인증 번호 입력 제한 시간을 초과했음에도 텍스트 입력이 활성화되는 오류를 수정했습니다.
프로모션
  • iOS 일부 기기(iPhone XS Max)에서 새 소식, 대배너 등에 있는 버튼이 간헐적으로 동작하지 않는 오류를 수정했습니다.

 

개발자 가이드 변경점


 

v4.23.2.0 (2024-03-26)

새로운 기능


프로모션

변경한 기능


마케팅 어트리뷰션
  • Android Firebase Analytics 라이브러리 버전을 업데이트했습니다: 21.3.0 → 21.5.0
  • iOS Firebase Analytics 라이브러리 버전을 업데이트했습니다: 10.16.0 → 10.20.0

해결한 버그


Unity
  • All Hive Config Inspector에서 일부 UI 폴딩이 정상적으로 동작하지 않는 오류를 수정합니다.

 

v4.23.1.0 (2024-02-01)

새로운 기능


인증
  • All 기기를 네트워크에 연결할 수 없을 때, 오프라인 모드로 자동 로그인을 지원합니다.
애널리틱스

변경한 기능


Hive SDK 공통
  • All 기기를 네트워크에 연결할 수 없을 때, 네트워크 연결이 필요한 Hive SDK 기능을 다시 실행하려고 시도하지 않습니다.
애널리틱스
  • All 기기를 네트워크에 연결할 수 없을 때, 애널리틱스 로그를 다시 전송하려고 시도하지 않습니다.

알려진 문제점


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

 

v4.23.0.0 (2024-01-30)

변경한 기능


Unity
  • All 외부 라이브러리뿐 아니라, Hive 제품 기능도 선택적으로 적용할 수 있도록 외부 라이브러리 의존성 매니저 기능을 변경합니다. 이제,외부 라이브러리 의존성 매니저를 사용해 외부 라이브러리 뿐 아니라 Hive 제품도 선택하여 적용할 수 있습니다.
    • IDP에서 기존 Google을 Google 로그인과 Google Play Games 로그인으로 분리
    • Apple 로그인, GameCenter, Weverse 인증 수단 등을 선택적으로 적용 가능
    • Android 결제 마켓을 선택적으로 적용 가능
    • 노티피케이션 서비스 제공자를 선택적으로 적용 가능
  • iOS 앱 실행 시 Hive SDK 기능을 실행하는 데 필요한 기기 권한을 얻도록, 필요한 권한을 선택하여 Xcode Signing & Capabilities에 추가할 수 있습니다.
Hive SDK 공통
  • Android Java Enum 인터페이스 ResultAPI 클래스 접근자를 변경합니다. 아래 예시를 참고하세요.
    • 기존: ResultAPI.Companion.getSUCCESS()만 지원
    • 변경: ResultAPI.Companion.getSUCCESS()ResultAPI.SUCCESS 모두 지원
  • Android Java에서 인스턴스 메서드 스타일과 클래스 메서드 스타일을 모두 지원합니다. 아래 예시를 참고하세요.
    • 기존: IAPV4.INSTANCE.getProductInfo만 지원
    • 변경: IAPV4.INSTANCE.getProductInfoIAPV4.getProductInfo 모두 지원
  • Android Z-Flip 5 전면 디스플레이에서 1:1 문의, 챗봇, 성인인증 창이 화면 범위를 넘어가지 않도록 수정합니다.
  • iOS 지원하는 개발 환경을 Xcode 15 이상으로 변경합니다. macOS Ventura13.5 이상에서 사용할 수 있습니다. 지원하는 OS는 아래와 같습니다.
    • iOS 12 이상
    • iPadOS 13 이상
인증
  • All 기기 관리, 중국 실명 인증 등에서 고객이 문자 인증 시 문자 입력 제한 시간 내에 문자를 입력하지 않으면 전송 버튼을 비활성화합니다.
  • Android 각 IDP를 라이브러리로 분리하여 선택 적용할 수 있도록 변경합니다. 다음 라이브러리들을 추가적으로 선택 적용할 수 있습니다.
    • Apple Sign-In
    • Weverse
    • Hive 멤버십
  • Android Google Play Games 로그인 시 Hive 서버에서 직접 확인한 로그인 정보만 신뢰하도록 변경하여 AuthV4ServerResponseError가 발생하는 케이스 일부를 해결했습니다.
  • iOS Hive SDK에서 사용하는 reCAPTCHA 라이브러리를 공식 버전으로 업데이트합니다.
  • iOS 각 IDP를 라이브러리로 분리하여 선택 적용할 수 있도록 변경합니다. 다음 라이브러리들을 추가적으로 선택 적용할 수 있습니다.
    • Apple Sign-In
    • GameCenter
    • Hive 멤버십
프로모션
  • All 새소식 또는 대배너 둘 중 하나만 화면에 나타나도록 변경합니다. 먼저 호출한 창만 나타나며, 나중에 호출한 창은 나타나지 않습니다.
  • All UA 캠패인 정보에 campaignId포함하여 전달합니다.
  • iOS SDWebImage 라이브러리를 업데이트했고, 이미지 캐싱 및 다운로드와 관련하여 LRU 캐시 정책을 적용합니다.
빌링
  • All IAPv2 인터페이스와 기능을 더는 지원하지 않습니다.
  • Android 지연 구매(Pending Purchase)가 있었을 때, 지연된 구매 결과가 현재 진행중인 결제에 영향을 미치지 않도록 변경합니다.
프로비저닝
허큘리스
  • All Hercules 라이브러리 버전을 업데이트 합니다.
    • Android: 20231122
    • iOS: 20231116

해결한 버그


인증
  • Android 이용 제한 팝업을 포르투갈어로 노출 시 버튼이 잘못 노출되는 문제를 수정합니다.
  • iOS 프로필 이미지 수정 시 카메라 촬영 버튼을 빠르게 연타하면 크래시가 발생하는 문제를 수정합니다.
프로모션
  • Android 게임 종료 팝업 노출 시 앱을 포그라운드 > 백그라운드 > 다시 포그라운드 상태로 변경하면 줄바꿈이 정상 동작하지 않는 오류를 수정합니다.
  • iOS 프로모션 배너로 커뮤니티 웹뷰 등을 노출하는 경우 상단 노치 영역이 잘리는 현상을 수정합니다.
프로비저닝
  • iOS 이용이 정지된 유저는 정지 해제까지 남은 시간을 노출하지 않도록 수정합니다.
데이터스토어
  • iOS set 메서드에 빈 값을 넣으면 값을 삭제하는 기능이 정상적으로 동작하도록 수정합니다.
노티피케이션
  • Android 앱을 다시 실행하면 노출할 푸시 메세지들을 불러오는 과정에서 문제가 발생해 푸시 내용이 보이지 않는 문제를 수정합니다.
애널리틱스
  • All 동시 접속자 로그 전송에서 국가 코드 전송 시 알 수 없는 국가에 대한 국가코드를 Unknown에서 공백 문자(Space) 2개로 변경합니다.

알려진 문제점


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

개발자 가이드 변경점


공통

Android

iOS

  • IdP 연동 안내에 Apple Game Center를 추가했습니다.
  • Hive SDK 기능들이 내부적으로 별도 라이브러리로 분리됨에 따라, iOS Podfile 내용이 변경되었습니다.
  • Unity에서 스크립트로 SDK 필요 권한을 자동으로 Xcode Signing & Capabilities에 추가 관련 설명을 업데이트했습니다.

 

v4.22.0.4 (2023-11-30)

변경한 기능


Hive SDK 공통
  • Android Google Play Games 로그인 시 Hive SDK 인증 로직을 개선했습니다.

알려진 문제점


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

 

v4.22.0.2 (2023-11-08)

변경한 기능


결제

해결한 버그


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

알려진 문제점


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

 

v4.22.0.0 (2023-09-15)

새로운 기능


Unity
  • iOS iOS 메인 타겟으로 빌드 시 Hive SDK가 푸시 알림 권한을 갖도록 Xcode 프로젝트에 자동으로 설정할 수 있는 기능을 제공합니다.
  • iOS Firebase 마케팅 추적 도구를 사용하는 경우 자동화된 설정을 제공합니다. GoogleService-Info.plist자동으로 참조하여 Xcode 프로젝트에 포함합니다.
인증
  • All 약관 동의 내역을 초기화할 수 있는 메서드를 추가합니다. resetAgreement() 메서드를 호출하여 약관 동의 내역을 초기화할 수 있습니다.
애널리틱스
프로비저닝

변경한 기능


Unity
  • All Unity 패키지에 포함된 EDM4U 라이브러리 버전을 v1.2.176으로 업데이트합니다. Unity 2022.2 이상에서 Android 타겟으로 빌드하려면 반드시 이 버전을 사용해야 합니다.
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 대용량 로그출력 시 순간적으로 지나치게 많은 메모리를 사용했던 오류를 수정합니다.
Unity
  • Android 데이터 스토어에서 getMyData(), getUserData() API 사용 시 데이터가 비어있는 경우 빈 데이터를 전달하지 않고 예외를 발생시켰던 오류를 수정합니다.
  • Android OneStore 배포용 빌드에 필요한 Maven 설정을 추가합니다.
  • Android PromotionBadgeInfo 데이터를 로그로 출력하는 과정에서 잘못 파싱한 정보를 출력하는 오류를 수정합니다.
인증
  • All AuthV4Helper 클래스로 묵시적 로그인 기능을 제공할 때 제재받은 계정으로 로그인하면 Invalid Session으로 잘못 전송했던 오류 코드를 Need Exit으로 수정합니다.
  • All 버튼 2개 이상을 가진 점검 팝업도 커스터마이징할 수 있도록 수정합니다.
마케팅 어트리뷰션
  • iOS AppsFlyer로 구매 이벤트 전송 시 잘못된 키로 부가 정보를 보내는 오류를 수정합니다.
    • custsom_product_id → custom_product_id
노티피케이션
  • Android 간헐적으로 내용이 없는 로컬 푸시를 노출하는 오류를 수정합니다.

알려진 문제점


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

개발자 가이드 변경점


  • 데이터 스토어 에러 코드(RESPONSE_FAIL:DataStoreGameIsBeingInspected)를 추가했습니다.
  • Hive SDK 4.22.0부터 릴리즈 정책 변경에 따라 릴리즈 노트, 다운로드 등 가이드 구성이 달라졌습니다. “크로스플레이” 용어는 OS를 지칭하는 “Windows”로 변경되었으며, 기존 개발가이드 크로스플레이 페이지 내용은 크로스플레이 런처 내용을 제외하고 Hive SDK 각 제품(인증, 프로모션, 빌링, 허큘리스 등) 가이드 페이지에 있는 Windows 섹션으로 통합되었습니다.
  • iOS 프레임워크 적용하기를 업데이트했습니다.

 

v4.21.1.4 (2023-11-30)

다운로드


Unity Android/iOS
다운로드 Hive SDK v4 Unity Android+iOS 21.1.4
배포일 2023-11-30

 

변경한 기능


Hive SDK 공통
  • Android Google Play Games 로그인 시 Hive SDK 인증 로직을 개선했습니다.

알려진 문제점


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

 

v4.21.1.3 (2023-11-08)

해결한 버그


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

알려진 문제점


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