V4.16.4

최신 다운로드

V4.16.4.0 (May 12, 2023)

 

Unity®	Hive_SDK_Unity_v4.16.4.0_withCore.zip
Unreal	Hive_SDK_Unreal_v4.16.4.0_withCore.zip
Cocos2D-X	Hive_SDK_Cocos_v4.16.4.0_withCore.zip
Android	Hive_SDK_Android_v4.16.4.0_withCore.zip
iOS	Hive_SDK_iOS_v4.16.4.0_withCore.zip

 

릴리즈 노트

 

V4.16.4.0 (Apr. 21, 2023)

New Features

• Android
  • [결제] One Store v7 라이브러리를 적용한 결제 수단을 지원합니다. Hive SDK에 One Store 라이브러리를 추가하는 방법은 다음을 확인하세요.
    • Android Native 가이드
    • Unreal 가이드
  • [공통] Hive SDK 배포 시 Maven 라이브러리 버전 관리 제어 기능인 BOM(Bill of Materials)을 지원합니다. 이에 따라, Android Native 환경에서 Hive SDK 설치 시 외부 라이브러리 버전을 직접 설정하지 않아도 됩니다. 자세한 내용은 업그레이드 가이드를 확인하세요.

Changed Features

• All
  • [인증] 서버 점검 팝업을 노출하거나 유저가 약관에 동의하지 않는 등 게임 앱을 종료해야 하는 상황일 때, Hive SDK는 더는 앱을 즉시 종료하지 않고 종료 이벤트를 게임 클라이언트에 전달합니다. 게임에서는 종료 이벤트를 수신하여 게임 앱을 종료하는 코드를 직접 구현해야 합니다. 자세한 내용은 업그레이드 가이드를 확인하세요.
    • 파일 I/O 또는 네트워크 송-수신이 수행중이라면 해당 동작을 종료 후 앱 프로세스를 종료해야 합니다.
    • 메인 프로세스에서 데몬 스레드 형태로 파생되지 않은 모든 스레드를 안전하게 종료한 뒤 앱 프로세스를 종료해야 합니다.
  • [프로모션] 새소식 이벤트 배너에 선물 수령이 임박했음을 알리는 배지를 추가합니다.
  • [빌링] 구매 또는 구독 요청 시 iapPayload를 인자로 사용하면 게임 스튜디오에서 사전에 정의한 부가 정보를 결제 트랜잭션에 전달할 수 있습니다. 게임 스튜디오에서는 이를 유저 구매 활동을 추적 및 분석하고, 미지급 아이템을 정확하게 지급하는 데 활용할 수 있습니다. 자세한 내용은 iapPayload 활용을 참고하세요.
    • purchase 메서드로 구매 진행 시 iapPayload 인자에 사전에 정의한 부가 정보를 입력합니다. additionalInfo는 더는 사용하지 않습니다.
    • purchaseSubscription 메서드로 구독 상품 변경 요청 시 IAPV4PurchaseParam 개체를 인자로 받는 빌더 패턴 메서드를 추가했습니다.
    • purchaseSubscriptionUpdate 메서드로 구독 진행 시 iapPayload 인자에 사전에 정의한 부가 정보를 입력합니다. additionalInfo는 더는 사용하지 않습니다.
  • [인증] 유저가 현재 로그인한 계정과 Idp에 이미 연동된 계정이 충돌했을 때, Idp 연동 계정에 게임 플레이 기록이 없다면 현재 로그인한 계정을 사용하도록 안내하는 UI를 개선합니다. 자세한 내용은 IdP 연동 시 계정 충돌 상황 처리를 참고하세요.
  • [분석] Funnel 분석 지표에 고정된 시작 기준값(401: Hive SDK 초기화 시작점)을 추가합니다. Hive SDK 초기화 시점부터 출발하여 유저가 게임 앱을 사용하는 도중 어떤 구간에서 이탈했는지 찾을 수 있습니다. 자세한 내용은 게임 진입 구간 퍼널 로그 전송하기를 확인하세요.

• Android
  • [공통] 지원하는 외부 라이브러리 버전을 업데이트합니다. 자세한 내용은 하단 Appendix를 확인하세요.
    • OneStore v7: v21.00.01
    • Hive SDK 4.16.4부터는 Android Native 환경에서 Hive SDK 사용 시 외부 라이브러리 버전을 모듈 수준 build.gradle에 직접 입력하지 않아도됩니다. 자세한 내용은 업그레이드 가이드를 확인하세요.
  • [공통] 지원하는 Android OS 최소 버전이 5.0(API Level 21)으로 변경됩니다.
  • [빌링] Google Play Billing 사용 시 소모성 아이템에 한하여 다중 수량 구매를 지원합니다.
  • [빌링] Google Play Billing 사용 시 Google 구독 V2를 지원합니다.
  • [빌링] Google Play Billing 사용 시 OOAP(Out of App Purchase)를 지원합니다.
  • [인증] 일반 Google 로그인을 지원합니다.
    • Android Native
    • Unity
    • Unreal
  • [커뮤니티] 커뮤니티 페이지에서 뒤로 가기 버튼 입력에 따라 뒤로 가기 또는 커뮤니티 페이지 닫기 동작을 수행합니다.
  • [분석] 응답 시간 측정 지표에 응답 시간과 반응 시간을 구분하여 전송합니다.

• iOS
  • [공통] 지원하는 외부 라이브러리 버전을 업데이트합니다. 자세한 내용은 하단 Appendix를 확인하세요.
    • Facebook SDK 버전을 14.1으로 업데이트합니다(iOS 11 호환).
    • Facebook SDK 버전을 16.0으로 업데이트합니다(iOS 12 호환).
  • [공통] iOS 프로젝트 빌드 시, “HiveResource”(Hive SDK에서 사용하는 UI 리소스 번들)가 빌드 메인 타겟에 존재하지 않더라도 “HiveSDK”와 동일한 빌드 타겟에 존재한다면 정상 동작하도록 변경합니다(HiveResource가 메인 타겟에 존재해도 정상 동작).
  • [공통] Unreal 환경에서 Facebook SDK 16.0.0 버전을 사용해야 합니다. 자세한 내용은 하단 Appendix를 참고하세요.
  • [공통] Unreal 환경에서 C++ 표준 템플릿 라이브러리와 정상적으로 호환되도록 FMallocAnsi 설정을 지원합니다.
  • [분석] 응답 시간 측정 지표에 응답 시간과 반응 시간을 구분하여 전송합니다.

Bug Fixes

• All
  • [프로모션] getBannerInfo 메서드 응답 시 키 값 스펠링을 정확하게 수정합니다.
    • 기존: start_unixtimstamp , end_unixtimstamp
    • 수정: start_unixtimestamp, end_unixtimestamp

• Android
  • [인증] 다운로드 로그에 SDK 빌드 타임을 포함하도록 수정합니다.

• iOS
  • [인증] 성인 인증 결과 응답값에 불필요한 정보가 포함된 오류를 수정합니다.
  • [인증] 계정 충돌 상황에서 네트워크 단절이 일어난 경우 응답 없음 상태로 유지되는 오류를 수정합니다.
  • [공통] 플러그인 혹은 외부에 노출된 스레드 세이프 로직을 Hive SDK 내부에서 이행하도록 수정합니다.

• Windows
  • [인증] COPPA 대상 유저인 경우 광고 식별자(Advertising Id)를 전송하지 않도록 수정합니다.

 

Appendix

공통 적용 항목

• Kotlin (Android) v1.5.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 (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

---