이 페이지는 Hive SDK 4.15 ~ 4.21 릴리즈 노트와 다운로드(게임 엔진별)를 안내합니다.

4.21

 

릴리즈 노트

Hive SDK v4.21.0 ~ Hive SDK v4.21.1

V4.21.1 (July 20, 2023)

New Features
  • All
    • [인증] 중국 국가신문출판서에서 발표한 [미성년자의 온라인게임 중독에 대한 더욱 엄격한 관리에 관한 통지] 등 관련 규정에 근거해 중국 판호를 받은 게임에 한하여 중국에서 접속한 유저는 실명 인증을 진행하도록 하는 기능을 제공합니다.
    • [허큘리스] Hive SDK v4.21.1부터 언리얼 엔진 개발자를 위해 허큘리스를 정식 플러그인으로 제공합니다.
Changed Features
  • All
    • Unreal 개발 환경이 다음과 같이 변경되었습니다.
      • Android, iOS 공통
        • Unreal Engine 4.27 Plus (commit hash: 6d964b43aa6892200b8058b30d60cdf51ca8f209)
      • iOS
        • Xcode 14.3
        • macOS Ventura 13.3+
Bug Fixes
  • iOS
    • [인증] 웹뷰로 프로필 페이지가 노출된 상황에서 URL 리다이랙션을 반복적으로 빠르게 수행하면 이를 에러로 인식하여 프로필 페이지를 종료하는 오류를 수정합니다. 에러로 인식한 리다이렉션 요청은 무시합니다.
개발자 가이드 기타 변경사항
  • Unreal Engine 4를 Xcode에서 빌드하기 전에, Apple Silicon 칩셋 호환을 설정하는 가이드를 추가했습니다. Apple Silicon을 탑재한 macOS 개발 환경에서 Unreal Engine 4로 개발할 경우 이 가이드를 따라야합니다.
  • Unreal 환경에서 Google Play Games 인증 사용을 위한 가이드를 추가했습니다.

V4.21.0.1 (June 13, 2023)

Bug Fixes
  • Android
    • [분석] Hive SDK를 초기화하기 전에 기기 화면 방향(가로 또는 세로)이 바뀌면 크래시가 발생하는 오류를 수정합니다.

V4.21.0.0 (June 9, 2023)

New Features
  • All
    • [분석] 기기 하드웨어 정보(해상도, 화면밀도, 메모리, 디스크 크기, 그래픽 드라이버 정보 등)를 자동으로 수집하여 Hive 애널리틱스 서버로 전송합니다.
    • [알림] 알림 그룹 기능을 지원합니다. 알림 그룹이란 같은 앱에서 보낸 알림들은 같은 그룹으로 묶어서 기기 화면에 표시하는 기능입니다.
    • [인증] 게임사가 로그인한 사용자 프로필 정보에 있는 이메일 정보를 수집하는 기능을 제공합니다. 이메일 정보를 수집하려면, 먼저 Hive 콘솔에서 해당 기능을 활성화해야 합니다. IdP에 따라 먼저 이메일 수집 권한 승인을 받아야 할 수 있습니다.
      • 이메일 수집 가능 IdP: Google, Facebook, Huawei (Android), Hive 멤버십, Apple (iOS)
      • 이메일 수집 불가 IdP: Google Play Games, Apple Game Center, QQ, VK, WeChat, Line, Weverse
Changed Features
  • All
    • [프로모션] Hive SDK는 노출한 전면 배너 클릭 수와 오늘 하루 보지 않기 상태 값을 수집합니다.
    • [커뮤니티] 하이브 규약을 따르는 커뮤니티에서 withhive.com, com2us.com이 아닌 커스텀 도메인 주소를 사용할 수 있도록 변경합니다. 자세한 내용은 다음을 확인하세요.
    • [빌링] 환불 유저 재결제 대상인 유저에게 노출하는 팝업 문구를 변경합니다.
      • CS CODE → CS Code
  • Android
    • [인증] 기존에는 한 가지 인증 타입으로 제공했던 Google과 Google Play Games 인증을 각기 다른 인증 타입으로 분리해 제공합니다. 이제, 유저가 Google Play Games 계정으로 로그인하면 Google 인증 정보가 아닌 Google Play Games 인증 정보를 사용하기 때문에, Android OS 플랫폼에서만 로그인할 수 있습니다.
    • [알림] 알림 센터에 있는 알림 목록에서 클릭한 알림만 삭제됩니다.
    • [공통] 지원하는 Kotlin Gradle 플러그인 버전이 변경되었고, Hive SDK가 일부 androidx.lifecycle 라이브러리를 포함합니다. 자세한 내용은 업그레이드 가이드를 확인하세요.
    • [프로모션] showNativeReview 메서드 사용을 위한 Review 관련 GooglePlay Core 라이브러리 호환성을 개선했습니다. PlayAssetDeilvery 사용 시 버전 충돌이 발생하지 않도록 개선합니다. 다음 GooglePlay Core 라이브러리 버전들과 정상 호환됩니다.
      • 1.8.0
      • 1.8.1
      • 1.10.3
      • 2.0.0
    • [빌링] iapPayload 기능을 지원하는 마켓을 추가합니다. 다음 마켓들을 순차적으로 지원합니다.
      • OneStore v7
      • Samsung GalaxyStore
      • Amazon AppStore
      • Facebook Cloud Games
      • Huawei AppConnect
Known Issues
  • iOS
    • [프로모션] Apple 서비스 장애로 iOS 11.x ~ 12.x 환경에서 showNativeReview 메서드를 호출했음에도 앱 스토어에서 리뷰 요청 팝업이 노출되지 않습니다. 이 문제는 모든 Hive SDK 버전에서 동일하게 발생합니다.
    • [IAPV4] iOS 11.x에서 애플 샌드박스 계정 로그인을 지원하지 않는 문제로 인해 iOS 11.x 환경에서 marketConnect 메서드를 호출할 수 없습니다. 이 문제는 모든 Hive SDK 버전에서 동일하게 발생합니다.
Bug Fixes
  • All
    • [인증] 기기 관리 서비스 이용 시 약관에 표기되는 회사 이름을 회사 코드에서 영문 회사명으로 표기하도록 수정합니다.
  • Android
    • [공통] 폴딩 기능이 있는 기기에서 공통 팝업(서버 점검 팝업, 블랙리스트 팝업, 공지 팝업 등)이 UI 크기에 맞춰 자동으로 재배치 되지 않는 오류를 수정합니다.
    • [인증] 사진첩이나 카메라 사용을 할 수 없는 기기에서 유저가 Google Play Games를 이용하는 경우, 인게임에서 사진첩이나 카메라에 접근하는 아이콘을 노출하지 않도록 수정합니다.
  • iOS
    • [인증] Connect 메서드 사용시 스레드 세이프 하지 않은 QQ IDP 동작 오류를 수정합니다.
    • [인증] reCAPTCHA 라이브러리가 없음에도 해당 기능을 사용하는 경우, 적절한 에러 처리 콜백을 지원합니다.
    • [인증] AuthV4Helper 클래스 showConflict 메서드 사용 시 사용자 정의 필드인 game_data 필드값이 없을 때 크래시가 발생하던 문제를 수정합니다.
    • [인증] Apple GameCenter 로그인 과정에서 사용자가 로그인을 취소하거나 에러가 발생해 로그인에 실패했을 때, 이후 GameCenter 로그인을 재시도하다가 다시 실패할 때 로그인 취소로 취급하여 에러 콜백을 전달하도록 수정합니다. 로그인 취소로 취급할 경우, “기기 설정에서 게임센터 로그인 진행” 팝업을 노출할 수 있습니다.
개발자 가이드 기타 변경사항

Appendix

공통 적용 항목

  • 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

 

업그레이드 가이드

Hive SDK v4.21.0 이상 Hive SDK v4.21.0 미만 ⇨ Hive SDK v4.21.1

Unreal Android 환경에서 Google Play Games 인증 사용하기

Google Play Games 인증을 적용하기 위해 Hive SDK v4.21.1은 com.google.android.gms:play-services-games-v2 라이브러리를 포함합니다. 이 라이브러리 사용 시 Unreal 엔진에 포함된 com.google.android.gms:play-services-games 라이브러리와 충돌합니다. 따라서, Google Play Games 인증을 적용하려면 아래와 같이 언리얼 엔진 코드를 수정해야 합니다.

  1. ./Engine/Build/Android/Java/src/com/epicgames/ue4/GameActivity.java.template를 엽니다.
  2. 아래 라인을 제거합니다.
  3. 아래 Unreal 환경에서 일반 Google 인증과 Google Play Games 인증 사용하기 가이드를 따라 진행합니다.

Unreal 환경에서 일반 Google 인증과 Google Play Games 인증 사용하기

Unreal 엔진으로 개발 시 일반 구글 인증(iOS, Android)과 Google Play Games 인증(Android)을 모두 지원합니다. 사용하려면 “GOOGLE” 또는 “GOOGLE_PLAY_GAMES” ProviderType를 선택해 AuthV4.SignIn()을 호출합니다.

Hive SDK v4.21.1 이전 버전에서 일반 구글 로그인을 지원하려면 /Plugins/HIVESDK/Source/HIVESDK/HIVESDK_APL.xml 파일에서 AS-IS 라인을 TO-BE로 수정한 다음 AuthV4.SignIn()을 호출해야 합니다.

Hive SDK v4.16.4 이상 Hive SDK v4.21.0 미만 ⇨ Hive SDK v4.21.0

Kotlin Gradle 플러그인 버전 변경

  • Kotlin Gradle 플러그인 최소 필요 버전을 1.5.10에서 1.6.20으로 변경했습니다.
  • Hive SDK가 androidx.lifecycle 라이브러리를 포함합니다.

Android Native 환경에서 외부 라이브러리 설정 변경

모듈 수준의 build.gradle 파일에서 Google 인증 외부 라이브러리와 Google Play Games 인증 외부 라이브러리를 분리

Google 인증과 Google Play Games 인증을 모두 지원하던 googlegooglev2를 더는 사용하지 않습니다.

외부 라이브러리 < 4.21.0 >= 4.21.0 GooglePlayGames 로그인 일반 Google 로그인
com.com2us.android.hive:hive-service-extension-google O X O O
com.com2us.android.hive:hive-service-extension-googlev2 O X O O
com.com2us.android.hive:hive-service-extension-google-signin X O X O
com.com2us.android.hive:hive-service-extension-google-playgames X O O X

 
4.21.0 이전: googlegooglev2에 포함된 외부 라이브러리 목록

  • com.com2us.android.hive:hive-service-extension-google
    • com.google.firebase:firebase-iid
    • com.google.firebase:firebase-messaging
    • com.google.android.gms:play-services-auth
    • com.google.android.gms:play-services-games
    • com.google.android.gms:play-services-ads-identifier
    • com.google.android.gms:play-services-analytics
    • com.google.android.gms:play-services-recaptcha
    • com.google.android.play:review
  • com.com2us.android.hive:hive-service-extension-googlev2
    • com.google.firebase:firebase-iid
    • com.google.firebase:firebase-messaging
    • com.google.android.gms:play-services-auth
    • com.google.android.gms:play-services-games-v2
    • com.google.android.gms:play-services-ads-identifier
    • com.google.android.gms:play-services-analytics
    • com.google.android.gms:play-services-recaptcha
    • com.google.android.play:review

4.21.0: google-signingoogle-playgames에 포함된 외부 라이브러리 목록

  • com.com2us.android.hive:hive-service-extension-google-signin
    • com.google.firebase:firebase-iid
    • com.google.firebase:firebase-messaging
    • com.google.android.gms:play-services-auth
    • com.google.android.gms:play-services-ads-identifier
    • com.google.android.gms:play-services-analytics
    • com.google.android.gms:play-services-recaptcha
    • com.google.android.play:review
  • com.com2us.android.hive:hive-service-extension-google-playgames
    • com.google.firebase:firebase-iid
    • com.google.firebase:firebase-messaging
    • com.google.android.gms:play-services-games-v2
    • com.google.android.gms:play-services-ads-identifier
    • com.google.android.gms:play-services-analytics
    • com.google.android.gms:play-services-recaptcha
    • com.google.android.play:review
외부 라이브러리명 변경

자세한 내용은 Gradle에 Hive SDK와 외부 라이브러리 추가하기를 확인하세요.

Android Native 환경에서 Google Play Games on PC 빌드 설정 변경

외부 라이브러리 의존성 설정 시 4.16.2 미만과 이상으로 나누었던 적용 방법을 통합합니다. hive-service-extension-googlev2를 hive-service-extension-google-playgames로 변경합니다. hive-service-extension-google-playgames는 play-service-games-v2 라이브러리를 포함합니다.

자세한 내용은 Google Play Games on PC 빌드 설정하기를 확인하세요.

Android Native 환경에서 Facebook Cloud Game 빌드 설정 변경

Facebook Cloud Game 빌드 설정을 하려면 hive-service-extension-google이 아니라 hive-service-extension-google-signin과 hive-service-extension-google-playgames를 제거해야 합니다.

자세한 내용은 Facebook Cloud Game 빌드 설정을 확인하세요.

Android Unity 환경에서 Google V2를 Google Play Games로 변경

자세한 내용은 Android Unity 프로젝트 Google Play Games on PC 빌드 설정하기를 확인하세요.

Android Unity 환경에서 Google 인증 외부 라이브러리와 Google Play Games 인증 외부 라이브러리를 분리

google-playgames는 Google Play Games 인증만을, google-signin은 Google 인증만을 지원합니다. com.com2us.android.hive:hive-service-extension-google은 더는 사용하지 않습니다.

외부 라이브러리 < 4.21.0 >= 4.21.0 GooglePlayGames 로그인 일반 Google 로그인
com.com2us.android.hive:hive-service-extension-google-signin X O X O
com.com2us.android.hive:hive-service-extension-google-playgames X O O X

자세한 내용은 일반 구글 로그인 지원을 확인하세요.

 

4.16

Hive SDK v4.16.2.1 (Jan 11, 2023)

Unity® Hive_SDK_Unity_v4.16.2.1_withCore.zip
Cocos2D-X Hive_SDK_Cocos_v4.16.2.1_withCore.zip
Android Hive_SDK_Android_v4.16.2.1_withCore.zip
iOS Hive_SDK_iOS_v4.16.2.1_withCore.zip
Unreal Hive_SDK_Unreal_v4.16.2_withCore.zip                             (Jan 04, 2023 배포)

Cocos2D-X용 SDK는 C++ 인터페이스를 포함합니다.

Hive SDK v4.16.1.8 (Jan 11, 2023)

Hive SDK v4.16.0.6 (Nov 15, 2022)

 

릴리즈 노트

Hive SDK v4.16.4

V4.16.4.0 (Apr. 21, 2023)

New Features
  • Android
    • [결제] One Store v7 라이브러리를 적용한 결제 수단을 지원합니다. Hive SDK에 One Store 라이브러리를 추가하는 방법은 다음을 확인하세요.
    • [공통] 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 로그인을 지원합니다.
    • [커뮤니티] 커뮤니티 페이지에서 뒤로 가기 버튼 입력에 따라 뒤로 가기 또는 커뮤니티 페이지 닫기 동작을 수행합니다.
    • [분석] 응답 시간 측정 지표에 응답 시간과 반응 시간을 구분하여 전송합니다.
  • 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

Hive SDK v4.16.3.0 ~ Hive SDK v4.16.3.1

V4.16.3.1 (Feb 27, 2023)

Bug Fixes
  • Android

    • [결제] 앱을 다시 시작한 후 구독형 상품 정보를 불러오지 못하는 현상을 수정합니다.

V4.16.3.0 (Feb 20, 2023)

New Features
  • Android
    • [Unity/Plugin] 게임에서 사용할 언어에 따라 빌드를 최적화할 수 있는 UI를 제공합니다. 일부 언어만을 사용하면 앱 크기를 축소할 수 있습니다.
  • iOS
    • [공통] Hive SDK 사용을 위한 iOS 빌드 최소 요구 사항을 Xcode 14.1, iOS SDK 16.1로 변경합니다.
      • Apple 고지에 따라 2023년 3월부터 Xcode 14.1, iOS SDK 16.1로 최소 요구사항을 변경합니다.
      • 최소 요구 사항인 Xcode 14.1 이상은 Armv7 아키텍쳐를 지원하지 않습니다.
      • Xcode 14.1 이상 환경에서 릴리즈 후보 앱을 빌드한 다음, 앱 검수 통과를 위해 앱을 테스트한 후 앱 스토어에 제출해야 합니다. 2023년 4월부터 App Store에 제출된 모든 iOS 및 iPadOS 앱은 Xcode 14.1 및 iOS 16.1 SDK 이상으로 빌드한 앱이어야 합니다.
    • [결제] iOS 15 이상의 기기에서 StoreKit 2를 지원합니다.
Changed Features
  • All
    • [Hive 설정] Hive SDK가 아닌 서드파티 결제 시스템에서 결제 진행 시, 설정할 수 있는 Channel값을 제공합니다.
      • getChannel 메서드로 설정된 Channel 값을 확인할 수 있습니다.
      • setChannel 메서드로 Channel 값을 변경할 수 있습니다.
    • [소셜 인증/로그인] Hive Community 자동 로그인 시 Hive Community에 로그인 세션 토큰 정보를 전달하도록 변경합니다.
    • [프로모션] 새소식 UI를 노출하는 API인 Promotion.showNews() 사용 시, 선물 상자 노출 정보(giftPidList)를 인자로 받아 선물 상자 이미지를 유저가 이벤트를 완료한 배너에 표시하도록 인터페이스를 수정합니다.
      • 선물 상자를 노출하기 위한 정보 설정을 setAddtionalInfo() 메서드로 하지 않도록 변경합니다.
    • [결제] IAPv4.marketConnect() 메서드 응답 속도를 개선합니다.
    • [프로모션] getBannerInfo 메서드 응답값에 campaignType값을 추가했습니다.
  • Android
    • [공통] 지원하는 외부 라이브러리 버전을 업데이트합니다.
      • QQ IdP: v3.5.13.83 (rc564928) → v3.5.14 (3.5.14.3_rc26220c)
    • [인증] 약관 동의 노출 화면 노출 시, 기기에서 뒤로가기를 누른 경우 나타나는 문구를 변경합니다.
    • [Unreal/Plugin] Unreal Engine 4.27.2, Unreal Engine 5 이상에서 빌드 가능하도록 호환성을 업데이트합니다.

    • [프로모션] UserEngagement 콜백 응답 정보에서 불 필요한 내용을 제거합니다.

    • [공통] Android System WebView 버전이 53, 54인 경우 SSL 오류로 동작하지 않는 기기를 지원하지 않도록 변경합니다.

      • Google Play Console에서는 예외 처리를 하지 않도록 권장합니다.
    • [프로모션][HiveWebView] WebView 컨텐츠 중 메인 페이지 에러가 아닌 컨텐츠 오류 발생 시 오류 페이지를 노출하지 않도록 변경합니다.

    • [결제] Google의 GooglePlay Billing으로 결제 진행 시 결제 시스템을 악용하는 사용자 감지를 위해 결제 사용자 정보를 전달합니다. GooglePlay Billing의 obfuscatedAccountId 값을 이용해 PlayerId값을 난독화해 전달합니다.

  • iOS
    • [공통] 지원하는 외부 라이브러리 버전을 업데이트합니다.
      • Adjust: v4.32.1 → v4.33.3
      • Singular: v11.0.10 → v12.0.1
      • AppsFlyer: 6.8.1 → 6.9.1
      • Firebase: 9.6.0 → 10.4.0
    • [Unreal/Plugin] Unreal Engine 4.27.2, Unreal Engine 5 이상에서 빌드 가능하도록 호환성을 업데이트합니다.

    • [Hive 설정] 외부 크래시 리포트 기능은 Hive Analytics 로그 수집 또는 저장 기능과 충돌할 수 있습니다. 이 때, Hive Analytics 동작을 제어하는 옵션 이름을 이해하기 쉽도록 useCrashReport에서 saveAnalyticsLogBeforeCrash변경합니다.

    • [결제] Apple의 AppStore로 결제 진행 시 결제 시스템을 악용하는 사용자 감지를 위해 결제 사용자 정보를 전달합니다. StoreKit의 appAccountToken 값을 이용하여 PlayerId값을 난독화해 전달합니다.

Bug Fixes
  • All
    • [Plugin/Unity] 일부 인터페이스에서 예외 발생시 응답 콜백을 전달하지 못하는 이슈를 수정합니다.

  • Android
    • [Hive 설정] AuthV4 클래스 setup()메서드를 사용한 초기화 이전에 getHiveTimeZone()을 호출하면 더미 응답 값을 전달하는 오류를 수정합니다. 오류 수정 후에는 더는 응답 값을 전달하지 않습니다.

    • [프로모션] 유저가 배너 오늘 하루 안보기에 동의했지만, 그럼에도 배너를 강제 노출하려고 할 때 노출되지 않는 오류를 수정합니다.

  • iOS
    • [마케팅 추적 도구] Adjust 사용 시 AppSecret값이 설정되지 않았다면 Adjust 초기화가 진행되지 않았던 오류를 수정합니다.

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

선택적용 항목

인증, 로그인(IDP)
  • Facebook SDK Android v13.0.0
  • Facebook SDK iOS v12.3.1 (Legacy Support, iOS 10+ 이상 지원)
  • Facebook SDK iOS v13.2.0 (iOS 11+ 이상 지원)
  • Facebook SDK iOS v15.0.0 (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
결제(IAP)
  • Google Billing Library (Android) v5.0.0
  • OneStore (Android) v19.00.02
  • 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

Hive SDK v4.16.2.0 ~ Hive SDK v4.16.2.1

V4.16.2.1 (Jan 11, 2023)

Bug Fixes
  • iOS
    • [Auth][Auth v4] Xcode 14에서 빌드한 경우 iOS 16 이상에서 사진첩 기능을 이용해 사진 첨부 시 정상 동작하지 않는 오류 수정
      • 프로필 변경, 1:1 문의하기, 챗봇 등
    • [Unreal][Promotion] showNativeReview 사용 시 크래시 발생 오류 수정

V4.16.2 (Dec 15, 2022)

New Features
  • All
    • [Common] Hercules 제품을 공통 기능으로 제공
    • [Auth v4] 커스텀 로그인을 사용하는 경우, 연동과 연동해제 기능을 제공
  • Android
    • [Auth v4] Huawei마켓 플랫폼에서 사용이 가능한 Huawei 인증이 IDP로 추가
    • [Auth v4] Google Play Games on PC 플랫폼을 지원
  • iOS
    • [Common] iOS SDK가 CocoaPod을 통해 배포
Changed Features
  • All
    • [Promotion] 새소식뷰의 컨텐츠에 대한 배지 노출을 개선
    • [Plugin/Unity] Unity패키지에서 사용중인 JSONObject 라이브러리 최신으로 업데이트
    • [Auth v4] 약관다시보기 노출 UI 변경
    • [Plugin/Unity] Unity내의 HiveConfig Inspector의 SDK 타임아웃 설정 기본값이 15초에서 8초로 변경
  • Android
    • [Common] SDK에서 제공하는 리소스의 종속성 분리
    • [Promotion] 전면 배너 닫기 동작시 깜빡이는 것처럼 보이는 현상 수정
    • [Promotion][Gradle] Youtube 재생 라이브러리 업데이트 수행
    • [Common] 권한고지를 더이상 노출하지 않도록 수정
      • [Common] 권한고지 내용을 커스텀하게 사용할 수 있도록 지원하는 기능은 유지
    • [Push] Android 13이상의 기기에서 알림권한을 요청하는 기능 추가
    • [Common] 지원하는 외부라이브러리 버전 업데이트
      • Adjust : 4.29.1 → 4.32.0
      • Singular : 12.0.5 → 12.0.8
      • AppsFlyers : 6.5.2 → 6.9.2
      • VK : 1.6.9 → 3.5.1
      • Alipay : 15.6.8 → 15.8.11 (aar → maven)
      • YoutubeAndroidWebPlayerApi : 1.0 → 1.0.1 (jar → maven)
      • Huawei : 6.4.0.300 → 6.7.0.300
    • [Community] HiveCommuity 로그인시 정보 전달 조건의 도메인 검사를 엄격하게 강화
  • iOS
    • [Common] Facebook SDK 와 Google Sign-In 라이브러리의 종속성 분리
    • [Promotion] 전면 배너 노출 시 동작을 개선
    • [Common] 권한고지를 더이상 노출하지 않도록 수정
      • [Common] 권한고지 내용을 커스텀하게 사용할 수 있도록 지원하는 기능은 유지
    • [Common] 지원하는 외부라이브러리 버전 업데이트
      • Adjust : 4.29.1 → 4.32.1
      • Singular : 11.0.4 → 11.0.10
      • AppsFlyers : 6.5.2 → 6.8.1
      • Firebase : 9.3.0 → 9.6.0
      • Google-SignIn : 6.1.0 → 6.2.4
      • QQ : 3.3.9 → 3.5.12
      • VK : 1.6.1 → 1.6.3
      • WeChat : 1.8.6.2 → 1.9.6
      • Line : 5.7.0 → 5.8.2
      • SDWebImage : 5.12.5 → 5.13.4
    • [Community] HiveCommuity 로그인시 정보 전달 조건의 도메인 검사를 엄격하게 강화
Bug Fixes
  • All
    • [Plugin/Unity] Unity빌드시 개발 편의를 위해 제공된 HiveConfig Inspector에 Line IDP를 위한 설정기능이 누락된 오류 수정
  • Android
    • [Plugin/CPP][UserEngagement] UserEngagement를 통해 HiveCommuity가 노출되는 경우 해당 이벤트 콜백을 전달하지 못하는 오류 수정
    • [Auth/Auth v4/SocialFacebook] Facebook Cloud 환경에서만 사용해야하는 Facebook Gaming Service 라이브러리가 포함되어진 빌드가 일반 기기에서도 Facebook Cloud 환경의 동작처럼 동작하는 오류 수정
      • Facebook Cloud 환경에서는 Facebook Gaming Service 라이브러리가 포함되어야 정상 동작
  • iOS
    • [Auth][Auth v4] 점검팝업 노출중 남은 시간이 음수로 표기되는 상황에서 0으로 표기되도록 수정
    • [Promotion] 새소식 최초 노출시 ‘오늘하루 더 이상 보지않기’ 문구가 깜빡여 보이는 현상 수정
    • [Promotion] 노치영역이 존재하는 기기에서 FullScreen 스타일 모드로 커스텀뷰 노출시 일부 배경색이 설정한 색상과 동일하지 않게 노출되는 현상 수정
    • [SDK v1][Auth][AU] 화이트리스트 설정 상태값에 따라 약관 노출이 되지않는 오류 수정
    • [Plugin/CPP] UserEngagement를 통해 HiveCommuity가 노출되는 경우 해당 이벤트 콜백을 전달하지 못하는 오류 수정
      • EngagementEventType.COMMUNITY_VIEW 타입 추가
연동된 서드파티 라이브러리 버전 (Hive SDK V4.16.2 기준)
공통적용 항목
      • Kotlin 1.5.20
      • Kotlin Coroutine 1.4.0
      • AndroidX (Android) v1.0.0+
      • constraintlayout (Android) v2.1.1
      • glide (Android) v4.13.0
      • SDWebImage (iOS) v5.13.5

IDP

    • Google Sign-In SDK (iOS) v6.1.0
선택적용 항목

IDP

      • Facebook SDK Android v13.0.0
      • Facebook SDK iOS v12.3.1
      • Facebook SDK iOS v13.2.0
      • Facebook SDK iOS v15.0.0 (선택가능 항목에서 추가됨 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.13.83 (rc564928)
      • 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) v5.0.0
      • OneStore (Android) v19.00.02
      • WeChat (Android) v6.8.0
      • Amazon (Android) v3.0.2
      • Huawei (Android) v6.3.0.300

PUSH

      • Amazon (Android) v1.0.1
      • FCM (Android) v20.2.4

MARKETING TRACKING ANALYTICS

    • Adjust(Android) v4.32.0
    • Adjust(iOS) v4.32.1
    • Singular(Android) v12.0.8
    • Singular(iOS) v11.0.10
    • AppsFlyer(Android) v6.9.2
    • AppsFlyer(iOS) v6.8.1
    • Firebase(Android) v20.1.2
    • Firebase(iOS) v9.6

기타 

    • GooglePlay Services-Review (Android) v2.0.0
    • Google Recaptcha (Android) v17.0.1
    • Google Recaptcha (iOS) v16.0.0
    • YoutubeAndroidWebPlayerApi (Android) v1.0.1

Hive SDK v4.16.1.0 ~ Hive SDK v4.16.1.8

V4.16.1.8 (Jan 11, 2023)

New Features
    • 없음
Changed Features
    • 없음
Bug Fixes
  • iOS
    • [Auth][Auth v4] Xcode 14에서 빌드한 경우 iOS 16 이상에서 사진첩 기능을 이용해 사진 첨부 시 정상 동작하지 않는 오류 수정
      • 프로필 변경, 1:1 문의하기, 챗봇 등

V4.16.1.7 (Nov 23, 2022)

New Features
    • 없음
Changed Features
    • 없음
Bug Fixes
  • iOS
    • [Analytics] 로그 전송 중 앱이 백그라운드로 이동하거나 크래시 발생 시 동작하는 미전송 로그 저장 로직에서 간헐적으로 크래시가 발생하는 이슈 수정

V4.16.1.6 (Nov 15, 2022)

New Features
    • 없음
Changed Features
  • Android
    • [Promotion] 새소식 노출 중인 버튼 터치에 대한 적절한 효과를 추가
Bug Fixes
    • 없음

V4.16.1.4 (Nov 03, 2022)

New Features
    • 없음
Changed Features
    • 없음
Bug Fixes
  • Android
    • [Auth v4][ProviderGoogle v1/v2] GooglePlayService앱의 업데이트가 필요한 상황에서 적절한 업데이트가 진행되지 않는 경우를 회피하도록 강제 업데이트 기능을 추가

V4.16.1.3 (Oct 31, 2022)

New Features
  • All
    • [IAPv4] getMarketProductInfo 메소드를 추가하여, 단일 상품을 조회하는 기능 추가
Changed Features
  • All
    • [IAPv4] marketConnect, getProductInfo 메소드 수행시 케싱기능을 추가하여 네트워크 대역폭 사용 축소
  • iOS
    • [IAPv4] marketConnect 수행시 통화코드에 따라 구분된 상품목록을 사용하는 기능 추가
Bug Fixes
  • All
    • [Unity/Plugin] 4.16.1 미만의 버전에서 업데이트 하는 경우 ExternalDependacyEditor가 이전버전의 설정을 로드하지 못하는 오류 수정

V4.16.1.2 (Sep 26, 2022)

New Features
    • 없음
Changed Features
    • 없음
Bug Fixes
  • All
    • [Unity/Plugin][DataStore] get메소드 사용하여 전달받은 응답값의 디코딩이 잘못된 오류 수정
  • Android
    • [Common] 통신시간 계측 기능의 오류로 인해 간헐적으로 크래시가 발생하는 오류 수정

V4.16.1.1 (Sep 8, 2022)

New Features
    • 없음
Changed Features
    • Android
      • [Common] Android 하위 OS 지원 라이브러리 버전 롤백
        • 적용버전 : AppCompat 1.4.0
        • 롤백된버전 : AppCompat 1.4.0-alpha01
      • [Common] Emoji 라이브러리의 종속성을 선택에서 필수로 변경
Bug Fixes
    • 없음

V4.16.1 (Sep 8, 2022)

New Features
  • All
    • [Auth v4] PlayerId를 통해 로그인한 계정을 삭제하는 기능 제공
    • [MarketTrackingTool] 마켓 성과 측정 도구중 하나로 Firebase Analytics를 선택적으로 적용할 수 있도록 제공
  • Android
    • [Common] SDK를 MavenCentral를 통해 배포하도록 변경
    • [FacebookCloud] 페이스북 클라우드 게임 플랫폼 적용 지원
    • [FacebookCloud][Push] 페이스북 클라우드의 리모트 푸시를 지원
Changed Features
  • All
    • [Analytics] 동접 데이터 전송시 주기시간당 플레이 타임값과 Hive국가코드값을 전송하도록 변경
    • [Promotion] 전면 배너와 스팟 배너에서 상세보기 팝업을 프레임 뷰로 노출할 수 있는 기능 제공
    • [Promotion] 사용하지 않는 동영상 재생 스킴 로직 제거
    • [Configuration] SDK내의 API 통신시 타임아웃의 기본값이 15초에서 8초로 변경
      • 기본값이 변경되더라도 hive_config.xml 의 설정값이 존재하는 경우 해당 값을 사용
  • Android
    • [Common] SDK 라이브러리의 종속성을 필수에서 선택으로 변경
      • 종속성 분리 대상 : recaptcha, Emoji, FCM, Youtube
    • [Common] Emoji 호환성 지원을 위해 포함되었던 폰트파일인 Emoji-bundle을 제거
    • [Promotion] GooglePlay Market에서 사용하는 Play Asset Delivery 지원을 위해 PlayCore 라이브러리 버전 업데이트
      • 변경 전 : PlayCore 1.8.3
      • 변경 후 :  PlayCore 2.0.0, Play-Review 2.0.0
  • iOS
    • [Common] M1 기기 시뮬레이터 타겟을 지원하도록 SDK라이브러리를 Framework에서 Xcframework로 변경
Bug Fixes
  • Android
    • [Auth v4] Weverse 로그인 화면이 노출되지 않는 현상 수정
  • iOS
    • [Auth v4] 기기관리 서비스의 관리 정보에서  기기의 등록된 시간이 정상적으로 표기되지 않는 현상 수정
연동된 서드파티 라이브러리 버전 (Hive SDK V4.16.0 기준)
공통적용 항목
      • Kotlin 1.5.10
      • Kotlin Coroutine 1.4.0
      • AndroidX (Android) v1.0.0+
      • constraintlayout (Android) v2.1.1
      • glide (Android) v4.13.0
      • SDWebImage (iOS) v5.12.5

IDP

    • Google Sign-In SDK (iOS) v6.1.0
선택적용 항목

IDP

      • Facebook SDK Android v13.0.0
      • Facebook SDK iOS v12.3.1
      • Facebook SDK iOS v13.2.0
      • GooglePlay Services-Auth (Android) v17.0.0
      • GooglePlay Services-Games (Android) v17.0.0
      • QQ (Android) v3.5.4.11 (r3f56456)
      • QQ (iOS) v3.3.9
      • VK (Android) v1.6.9
      • VK (iOS) v1.6.1
      • WeChat (Android) v6.8.0
      • WeChat (iOS) v1.8.6.2
      • LINE (Android) v5.7.0
      • LINE (iOS) v5.7.0
      • Huawei (Android) v6.4.0.300

IAP

      • Google Billing Library (Android) v5.0.0
      • OneStore (Android) v19.00.02
      • WeChat (Android) v6.8.0
      • Amazon (Android) v3.0.2
      • Huawei (Android) v6.3.0.300

PUSH

      • Amazon (Android) v1.0.1
      • FCM (Android) v20.2.4

MARKETING TRACKING ANALYTICS

    • Adjust(Android) v4.29.1
    • Adjust(iOS) v4.29.7
    • Singular(Android) vv12.0.5
    • Singular(iOS) v11.0.4
    • AppsFlyer(Android) v6.5.2
    • AppsFlyer(iOS) v6.5.2
    • Firebase(Android) v20.1.2
    • Firebase(iOS) v9.3

기타 

    • GooglePlay Services-Review (Android) v2.0.0
    • Google Recaptcha (Android) v17.0.1
    • Google Recaptcha (iOS) v16.0.0
    • YoutubeAndroidWebPlayerApi (Android) v1.0

Hive SDK v4.16.0.0 ~ Hive SDK v4.16.0.6

V4.16.0.6 (Nov 15, 2022)

New Features
    • 없음
Changed Features
  • Android
    • [Promotion] 새소식 노출 중인 버튼 터치에 대한 적절한 효과를 추가
Bug Fixes
    • 없음

V4.16.0.5 (Sep 1, 2022)

New Features
    • 없음
Changed Features
    • 없음
Bug Fixes
  • Android
    • [Promotion] 유저가 모든 배너의 노출을 거절한 경우 일부 단말기에서 프리징 발생하는 오류 수정

V4.16.0.4 (Aug 19, 2022)

New Features
    • 없음
Changed Features
  • All
    • [Auth v1] Hive 정식 유저의 계정 삭제 기능 지원
      • 유저 탈퇴를 인지할 수 있도록 계정 삭제 시 에러코드 전달
Bug Fixes
  • Android
    • [Auth v4][Provider] Apple로 로그인 사용 시 로그인 UI가 투명한 배경으로 게임 화면에 겹치는 현상 수정
    • [Promotion] 노출할 전면 배너가 없는 앱을 실행하면 일부 단말기에서 프리징 발생하는 현상 수정
    • [AuthV4] AuthV4.showSignIn()를 호출하여 LINE 로그인 진행 시 특정 단말에서 간헐적으로 앱이 정지하는 현상 수정

V4.16.0.3 (Aug 1, 2022)

Unreal Hive_SDK_Unreal_v4.16.0.3_withCore.zip
New Features
    • 없음
Changed Features
  • Android
    • [MarketTrackingTool] Singular SDK 업데이트
      • 업데이트 전: v11.0.0
      • 업데이트 후: v12.0.5
  • iOS
    • [IAPv4] StoreKit2 지원 비활성화
    • [Plugin/Unity] Line IdP가 포함된 Unity 빌드에 필요한 옵션이 자동 설정되도록 Podfile 설정 변경
Bug Fixes
    • 없음

V4.16.0.2 (Jul 8, 2022)

New Features
    • 없음
Changed Features
    • 없음
Bug Fixes
  • Android
    • [MarketTrackingTool] Hive SDK 빌드 시 마케팅 어트리뷰션 툴(Adjust, AppsFlyer, Singular)의 라이브러리가 제외된 경우 종속성 문제로 인해 크래시 발생하는 오류 수정

V4.16.0.1 (Jul 4, 2022)

New Features
    • 없음
Changed Features
    • 없음
Bug Fixes
  • Android
    • [Auth v4] 점검 팝업의 내용이 없는 경우 적절한 응답값을 전달하도록 수정

V4.16.0 (Jun 30, 2022)

New Features
  • All
    • [Auth v4] 봇을 통한 게스트 자동 생성을 방지하기 위해 게스트 생성 시 Google reCAPTCHA 적용
      • ShowSignin() 메서드를 호출하여 표시되는 옵션 중 게스트 선택 시 확인 가능
      • SignIn() 메서드 호출 시 Guest 타입을 선택하면 확인 가능
  • Android
    • [Promotion] 다이렉트 배너를 현재 Activity에 노출하는 기능 제공
Changed Features
  • All
    • [Configuration] 서비스 로직이 아닌 로그를 제외하는 API 제공
    • [Auth v4] 초기화 실패에 대한 케이스 추가
    • [Tracking] Adjust 구매 이벤트 전송 시 아래의 정보들을 추가로 전송하도록 변경
      • 상품가격
      • 통화코드
      • 주문번호
      • 상품코드
      • 상품타이틀
      • 서버값
    • [Provisioning] HiveCountry과 TimeZone의 최초 설정값을 유지하도록 개선
    • [Plugin/Unity] Unity 배포 버전에 포함된 EDM4U 라이브러리 업데이트
      • 변경 전: v1.2.167
      • 변경 후: v1.2.171
    • [Auth v1] SocialDialog 노출 중에 유저가 계정 탈퇴 진행 시 해당 콜백을 전달하도록 변경
    • [Push] Configuration 클래스의 updateServerId()updateGameLanguage() 메서드 사용 시 푸시 토큰의 정보를 갱신하도록 변경
  • Android
    • [Auth v4][IAP v4] Wechat 라이브러리 업데이트
      • 변경 전: v1.4.0
      • 변경 후: v6.8.0
    • [IAPv4] GoogleBillingLibrary 5.0 적용
    • [Analytics] Install Referrer 정보 획득 로직을 Hive IAP v4 초기화 로직과 분리
    • [IAPv4] marketConnect() 메서드 호출 시 상품 정보가 비어있는 경우 에러를 전달하도록 수정
    • [Common] 가로 320dp 미만인 기기에서 320dp를 보장하는 웹뷰를 사용할 수 있도록 웹뷰 초기화 설정 추가
  • iOS
    • [IAPv4] iOS 15 이상에서 사용 가능한 StoreKit2 지원
    • [Promotion] 리소스 관리 개선을 위해 SDWebImage 이미지 라이브러리 적용
    • [Common] Facebook SDK 버전 업데이트
      • 변경 전: v13.1
      • 변경 후: v13.2
Bug Fixes
  • All
    • [Auth v4] 계정 충돌 시 계정 전환을 시도했다가 취소하는 경우 세션 정보가 삭제되는 오류 수정
  • Android
    • [Plugin][Cocos] 디퍼드 딥링크에서 MainActivity 실행 시 그 종류에 따라 재실행되는 오류 수정
    • [Auth v4] checkMaintenance() 메서드를 호출하여 점검 팝업 노출 시 사용자의 터치 이벤트 발생 전에 점검 팝업 내용을 전달하는 오류 수정
    • [Auth v4] Apple 계정 충돌 후 showConflict() 메서드 호출 시 노출되는 계정 충돌 팝업의 문구 수정
  • iOS
    • [Auth v4] 저사양 기기에서 UI 변경 진행 중에 변경 과정이 딤처리되어 노출되는 현상 수정
    • [Promotion] 새소식 배너 클릭 시 페이지 정보 전달에 누락된 값을 전달하도록 수정
    • [Promotion] 다이렉트 배너를 프레임 타입으로 노출 시 비정상 종료되는 오류 수정
연동된 서드파티 라이브러리 버전 (Hive SDK V4.16.0 기준)
공통적용 항목
    • Kotlin 1.5.10
    • Kotlin Coroutine 1.4.0
    • AndroidX (Android) v1.0.0+
    • Firebase Library (Android) v20.2.4
    • constraintlayout (Android) v2.1.1

    IDP

    • Google Sign-In SDK (iOS) v6.1.0
선택적용 항목
    IDP

    • Facebook SDK Android v13.0.0
    • Facebook SDK iOS v12.3.1
    • Facebook SDK iOS v13.2.0
    • GooglePlay Services-Auth (Android) v17.0.0
    • GooglePlay Services-Games (Android) v17.0.0
    • QQ (Android) v3.5.4.11 (r3f56456)
    • QQ (iOS) v3.3.9
    • VK (Android) v1.6.9
    • VK (iOS) v1.6.1
    • WeChat (Android) v6.8.0
    • WeChat (iOS) v1.8.6.2
    • LINE (Android) v5.7.0
    • LINE (iOS) v5.7.0
    • Huawei (Android) v6.4.0.300

    IAP

    • Google Billing Library (Android) v5.0.0
    • OneStore (Android) v19.00.02
    • WeChat (Android) v6.8.0
    • Amazon (Android) v3.0.2
    • Huawei (Android) v6.3.0.300

    PUSH

    • Amazon (Android) v1.0.1

    MARKETING TRACKING ANALYTICS

    • Adjust(Android) v4.29.1
    • Adjust(iOS) v4.29.7
    • Singular(Android) v11.0.0
    • Singular(iOS) v11.0.4
    • AppsFlyer(Android) v6.5.2
    • AppsFlyer(iOS) v6.5.2

 

업그레이드 가이드

Hive SDK v4.13.0 이상 Hive SDK v4.16.4 미만 ⇨ Hive SDK v4.16.4

Android Native 개발 환경에서 Hive SDK 설치 시 외부 라이브러리 버전을 직접 입력할 필요가 없습니다.

모듈 수준의 build.gradle 파일에 Hive SDK와 외부 라이브러리를 추가할 때, 외부 라이브러리 버전을 더는 직접 입력할 필요가 없습니다. 사용할 외부 라이브러리 항목만 입력하면, Hive SDK 버전에 맞는 외부 라이브러리 버전을 Hive SDK에서 자동으로 설정합니다. 자세한 내용은 안드로이드 설정하기를 확인하세요.

필요하다면 Hive SDK 4.16.4 이전 버전과 같이 외부 라이브러리 버전을 직접 입력해 설치할 수 있습니다. 아래 내용을 참고하세요.

  1. 프로젝트 수준의 build.gradle 파일에 외부 라이브러리를 가져올 수 있도록 레파지토리를 추가합니다.
  2. 모듈 수준의 build.gradle 파일에 Hive SDK 및 외부라이브러리 의존성을 설정합니다. $HIVE_SDK_VERSION은 사용하려는 Hive SDK 버전(예: 4.16.3)입니다. VK 라이브러리를 적용하기 위해서는 targetSdkVersion 32 이상 버전이 필요합니다.

    Hive SDK 버전별로 사용해야 하는 외부 라이브러리 버전을 확인하려면, 각 Hive SDK 버전을 다운로드 후 Sample/library.gradle을 확인하세요.

    게임 앱을 종료해야할 때, 게임 스튜디오에서 앱 종료를 직접 구현해야 합니다.

    Hive SDK는 게임 앱을 더는 강제 종료하지 않습니다. Hive 인증과 Hive 초기화 과정에서 게임 앱을 종료해야할 상황이 발생할 수 있습니다. 예를 들어 게임 서버 점검중일 때에는 유저가 게임 앱을 실행해도 게임을 종료해야 합니다. 또, 유저가 약관에 동의하지 않을 때에도 게임 앱을 종료해야할 수 있습니다. Hive SDK 4.16.4부터는 이렇게 게임을 종료해야할 특정 상황에서 Hive SDK가 게임 앱을 강제 종료하지 않으며, 게임사는 게임 앱을 종료하는 코드를 콜백 함수에 직접 구현해야 합니다.

    더 구체적으로 말하면, Hive SDK 4.16.4 부터는 Hive_config.xml에 있는 exitEventEnabled을 설정할 수 없는 대신, 이 값이 항상 True인 상태가 적용됩니다. 따라서, 게임사는 Hive 인증과 초기화 과정에서 Result API 클래스 인스턴스의 needExit() 메서드 호출 결과가 True이면 게임을 종료하는 코드를 직접 구현해야 합니다. 자세한 내용은 Hive 초기화인증 문서에 있는 API 예제 코드들을 참고하세요.

    아래는 Hive SDK 인증에서 제공하는 로그인 기능 구현 시 앱 종료 이벤트 처리를 하는 예시 코드입니다.

    Unity®

    API Reference: hive.AuthV4.signIn

    C++

    API Reference: Auth4::signIn

    Kotlin

    API Reference: com.hive.Auth4.signIn

    Java

    API Reference: com.hive.Auth4.signIn

    Swift

    API Reference: HIVEAuth4:signIn

    Obj-C

    API Reference: HIVEAuth4:signIn

 

4.15

Hive SDK v4.15.8.5 (Aug 22, 2022)

Hive SDK v4.15.7 (Feb 25, 2022)

Unity® Hive_SDK_Unity_v4.15.7_withCore.zip
Cocos2D-X Hive_SDK_Cocos_v4.15.7_withCore.zip                                (Mar 24, 2022 배포)
Android Hive_SDK_Android_v4.15.7_withCore.zip                             (Mar 24, 2022 배포)
iOS Hive_SDK_iOS_v4.15.7_withCore.zip                                     (Mar 24, 2022 배포)

Cocos2D-X용 SDK는 C++ 인터페이스를 포함합니다.

Hive SDK v4.15.6.1 (Aug 2, 2022)

Hive SDK v4.15.5.1 (Dec 6, 2021)

Hive SDK v4.15.4.1 (May 13, 2022)

 

릴리즈 노트

Hive SDK v4.15.8.0 ~ Hive SDK v4.15.8.5

V4.15.8.5 (Aug 22, 2022)

New Features
    • 없음
Changed Features
    • 없음
Bug Fixes
  • Android
    • [Promotion] 노출할 전면 배너가 없는 앱을 실행하면 일부 단말기에서 프리징 발생하는 현상 수정
    • [Common] 권한요청 팝업에서 추가 권한 요청 시 크래시 발생하는 오류 수정

V4.15.8.4 (Aug 1, 2022)

New Features
    • 없음
Changed Features
  • Android
    • [MarketTrackingTool] Singular SDK 업데이트
      • 업데이트 전: v11.0.0
      • 업데이트 후: v12.0.5
Bug Fixes
    • 없음

V4.15.8.3 (May 16, 2022)

New Features
    • 없음
Changed Features
  • All
    • 봇을 통한 게스트 계정 자동 생성을 방지하기 위해 Google reCAPCHA 키 사용
      • showSignin() 메서드를 호출하여 선택 옵션 중 게스트 선택 시 로봇이 아닙니다. 체크박스 UI 노출
  • Android
    • [Tracking] AppsFlyer에 Google Play 설치 리퍼러(Install Referrer)를 수동으로 전송하는 기능 제거
Bug Fixes
    • 없음

V4.15.8.1 (Apr 15, 2022)

Unreal Hive_SDK_Unreal_v4.15.8.1_withCore.zip                           (Jun 02, 2022 배포)
New Features
  • All
    • [Common] Facebook SDK 업데이트
      • 변경 전: v12.3 / 변경 후: v13.0+
      • iOS 최소 지원 버전: iOS 11로 변경 (Android는 변경사항 없음) 관련 노트
Changed Features
    • 없음
Bug Fixes
  • iOS
    • [Auth v4] showInquiry API를 통해 문의하기 진행 시 PlayerId 값이 자동으로 설정되지 않는 오류 수정
연동된 서드파티 라이브러리 버전 (Hive SDK V4.15.8.1 기준)
공통적용 항목
    • Kotlin 1.5.10
    • Kotlin Coroutine 1.4.0
    • AndroidX (Android) v1.0.0+
    • Firebase Library (Android) v20.2.4
    • constraintlayout (Android) v2.1.1

    IDP

    • Facebook SDK iOS v13.1.0
    • Google Sign-In SDK (iOS) v6.1.0
선택적용 항목
    IDP

    • Facebook (Android) v13.0.0
    • GooglePlay Services-Auth (Android) v17.0.0
    • GooglePlay Services-Games (Android) v17.0.0
    • QQ (Android) v3.5.4.11 (r3f56456)
    • QQ (iOS) v3.3.9
    • VK (Android) v1.6.9
    • VK (iOS) v1.6.1
    • WeChat (Android) v1.4.0
    • WeChat (iOS) v1.8.6.2
    • LINE (Android) v5.7.0
    • LINE (iOS) v5.7.0

    IAP

    • Google Billing Library (Android) v3.0.3
    • OneStore (Android) v19.00.02
    • WeChat (Android) v1.4.0
    • Amazon (Android) v3.0.2

    PUSH

    • Amazon (Android) v1.0.1

    MARKETING TRACKING ANALYTICS

    • Adjust(Android) v4.29.1
    • Adjust(iOS) v4.29.7
    • Singular(Android) v11.0.0
    • Singular(iOS) v11.0.4
    • AppsFlyer(Android) v6.5.2
    • AppsFlyer(iOS) v6.5.2

V4.15.8 (Apr 6, 2022)

New Features
  • All
    • [Promotion] 이미지 포함된 리뷰 팝업 추가 자세히
    • [Promotion] 프레임 타입 이벤트 페이지 추가 자세히
    • [DataStore] Hive 데이터 스토어 추가 자세히
    • [Promotion] 디퍼드 딥링크로 UA매칭 정보를 전달할 수 있도록 개선
  • Android
    • [Auth v4] 챗봇에서 외부 브라우저로 이동할 수 있는 openbrowser 스킴 처리 추가
Changed Features
  • All
    • [Auth][SocialFacebook] 페이스북 로그인 시 기본으로 요청하는 권한에서 user_friends 권한 제거
    • [Auth][SocialHive] Hive 웹뷰 내 Hive 로고 제거
    • [Cpp/Plugin] Picojson 라이브러리가 제거되고, HiveJson을 적용
    • 외부 라이브러리 버전 업데이트 자세히
      • Adjust
      • Singular
      • AppsFlyer
      • Facebook
      • Google-SignIn
  • Android
    • [IAP v4][Repayment] 환불 유저 재결제 기능 마켓에 화웨이 추가
Bug Fixes
  • Android
    • [Protocol][Promotion] CPI 통신 시 광고 식별자의 제한 여부를 함께 보내도록 수정
    • [Auth v1][Social] SocialDialog 닫힘 동작 시 발생하는 에러 콜백 값 수정
    • [IAP v4] ONE store 샌드박스 환경에서 결제 시 발생하는 오류 수정
  • iOS
    • [Common] 동기 API에 네트워크 통신이 동반된 네트워크 환경에서 앱의 동작이 멈추거나 느려지는 오류 수정

Hive SDK v4.15.7

V4.15.7 (Feb 25, 2022)

New Features
  • All
    • [Auth v4] Hive SDK에서 지원하지 않는 외부 인증 수단을 통한 로그인을 구현하는 커스텀 로그인 기능 지원 (가이드)
  • Android
    • [Auth v4] 챗봇에서 외부 브라우저로 이동할 수 있는 openbrowser 스킴 처리 추가
Changed Features
    • 없음
Bug Fixes
  • Android
    • [Auth v4] 챗봇 페이지에서 키보드 노출 시 표시되는 챗봇 UI의 크기가 변경될 수 있도록 수정
연동된 서드파티 라이브러리 버전 (Hive SDK V4.15.7 기준)
공통적용 항목
    • Kotlin 1.5.10
    • Kotlin Coroutine 1.4.0
    • AndroidX (Android) v1.0.0+
    • Firebase Library (Android) v20.2.4
    • constraintlayout (Android) v2.1.1

    IDP

    • Facebook SDK iOS v9.1.0
    • Google Sign-In SDK (iOS) v5.0.2+
선택적용 항목
    IDP

    • Facebook (Android) v12.1.0
    • GooglePlay Services-Auth (Android) v17.0.0
    • GooglePlay Services-Games (Android) v17.0.0
    • QQ (Android) v3.5.4.11 (r3f56456)
    • QQ (iOS) v3.3.9
    • VK (Android) v1.6.9
    • VK (iOS) v1.6.1
    • WeChat (Android) v1.4.0
    • WeChat (iOS) v1.8.6.2
    • LINE (Android) v5.7.0
    • LINE (iOS) v5.7.0

    IAP

    • Google Billing Library (Android) v3.0.3
    • OneStore (Android) v19.00.02
    • WeChat (Android) v1.4.0
    • Amazon (Android) v3.0.2

    PUSH

    • Amazon (Android) v1.0.1

    MARKETING TRACKING ANALYTICS

    • Adjust(Android) v4.28.0
    • Adjust(iOS) v4.29.6
    • Singular(Android) v9.6.0
    • Singular(iOS) v10.4.0
    • AppsFlyer(Android) v6.3.0
    • AppsFlyer(iOS) v6.2.6

Hive SDK v4.15.6.0 ~ Hive SDK v4.15.6.1

V4.15.6.1 (Aug 2, 2022)

New Features
    • 없음
Changed Features
  • Android
    • [MarketTrackingTool] Singular SDK 업데이트
      • 업데이트 전: v9.6.0
      • 업데이트 후: v12.0.5
Bug Fixes
  • Android
    • [AuthV4] showSignIn API 호출하여 LINE 로그인 진행 시 일부 단말에서 간헐적으로 시스템 정지되는 현상 수정

V4.15.6 (Jan 20, 2022)

New Features
  • All
    • [HivePromotion] UA 링크를 통해 초대받은 유저의 인게임 UI에 해당 초대자 정보(vid)를 전달하여 노출하는 기능 추가 (가이드)
  • Android
    • [Auth V4] Sign in with Apple 지원
    • [Common] EmojiCompat 라이브러리 적용
      • 지원하지 않는 그림 이모티콘 사용 시 ☐ 형식으로 표기되는 호환성 이슈 해결
Changed Features
  • All
    • [Auth v4] 기기 관리 서비스의 기기 식별 보안 강화
    • [Auth v4] 초기화 단계 일부를 순차 진행에서 병렬 진행으로 변경하여 초기화 속도 개선
    • [Provisioning] 분산 서버 동작 개선
      • 최초 실행 시에는 분산 서버에서 진행 불가
    • [Provisioning] 분산 서버 적용 대상에 추가
    • [Common] 권한 고지 및 권한 요청 화면에 노출되는 문구 업데이트
    • [Auth v1][SocialFacebook] Facebook 인증 시 사용하는 user_friends 권한을 기본 권한에서 제외
  • Android
    • [Promotion] 종료 팝업의 텍스트를 적절하게 줄바꿈하도록 변경
    • [Promotion] Google Play 스토어 외의 Android 마켓에서는 Hive 리뷰 팝업이 노출되도록 showReview 메서드 동작 변경 (가이드)
    • [IAP v4] 샌드박스 환경에서 Galaxy 스토어 결제 테스트 가능하도록 수정
    • [IAP v4] Google Play 서비스와의 비정상적 연동 상태에서 전달하는 오류 처리 개선
    • [IAP v4] Amazon AppStore SDK 3.0.2 적용
    • [IAP v4] ONE store API v4 사용 시 developerPayload에 AddtionalInfo 값을 전달할 수 있도록 변경
    • [Auth v4][Auth v1][SocialFacebook] Facebook SDK 업데이트
      • 변경 전: v9.1.1
      • 변경 후: v12.1.0
    • [Auth v4] LINE SDK 업데이트
      • 변경 전: v5.3.1
      • 변경 후: v5.7.0
    • [IAP v4] OneStore SDK 업데이트
      • 변경 전: v19.0.0.1
      • 변경 후: v19.0.0.2
    • [Unity/Plugin] Unity 패포 패키지에 포함된 EDM4U 업데이트
      • 업데이트 버전: 1.2.167
    • [Unity/Plugin] Untiy 2021.2 버전부터 지원되는 최소 버전을 22로 설정함에 따른 호환성 처리 개선
    • [Unity/Plugin] Unity 2021.1 버전부터 Android 라이브러리 내 res 폴더 위치가 변경되어 hive_config.xml 파일 생성 위치 변경
      • 기존 경로(Unity 2021.1 미만 사용): Assets/Plugins/Android/res
      • 변경 경로(Unity 2021.1 이상 사용): Assets/HiveSDK/hive.androidlib/src/main/res
  • iOS
    • [Common][Unity][Cpp] Swift 외의 환경에서도 플러그인 코드 빌드 가능하도록 인터페이스 개선
Bug Fixes
  • iOS
    • [IAPv4] Restore 필요한 상품이 환불 재결제 대상에 해당하지 않을 때, 영수증 검증 및 transactionFinish 수행하지 않도록 수정
연동된 서드파티 라이브러리 버전 (Hive SDK V4.15.6 기준)
공통적용 항목
    • Kotlin 1.5.10
    • Kotlin Coroutine 1.4.0
    • AndroidX (Android) v1.0.0+
    • Firebase Library (Android) v20.2.4
    • constraintlayout (Android) v2.1.1

    IDP

    • Facebook SDK iOS v9.1.0
    • Google Sign-In SDK (iOS) v5.0.2+
선택적용 항목
    IDP

    • Facebook (Android) v12.1.0
    • GooglePlay Services-Auth (Android) v17.0.0
    • GooglePlay Services-Games (Android) v17.0.0
    • QQ (Android) v3.5.4.11 (r3f56456)
    • QQ (iOS) v3.3.9
    • VK (Android) v1.6.9
    • VK (iOS) v1.6.1
    • WeChat (Android) v1.4.0
    • WeChat (iOS) v1.8.6.2
    • LINE (Android) v5.7.0
    • LINE (iOS) v5.7.0

    IAP

    • Google Billing Library (Android) v3.0.3
    • OneStore (Android) v19.00.02
    • WeChat (Android) v1.4.0
    • Amazon (Android) v3.0.2

    PUSH

    • Amazon (Android) v1.0.1

    MARKETING TRACKING ANALYTICS

    • Adjust(Android) v4.28.0
    • Adjust(iOS) v4.29.6
    • Singular(Android) v9.6.0
    • Singular(iOS) v10.4.0
    • AppsFlyer(Android) v6.3.0
    • AppsFlyer(iOS) v6.2.6

Hive SDK v4.15.5.0 ~ Hive SDK v4.15.5.1

V4.15.5.1 (Dec 6, 2021)

New Features
  • All
    • 사명 변경과 관련된 컨텐츠 수정
Changed Features
    • 없음
Bug Fixes
    • 없음

V4.15.5 (Nov 8, 2021)

New Features
  • All
    • 게임 보안 강화를 위해 기기 관리 서비스 지원 (가이드)
Changed Features
    • 없음
Bug Fixes
    • 없음
연동된 서드파티 라이브러리 버전 (Hive SDK V4.15.5 기준)
공통적용 항목
    • Kotlin 1.4.32
    • Kotlin Coroutine 1.4.0
    • AndroidX (Android) v1.0.0+
    • Firebase Library (Android) v20.2.4
    • constraintlayout (Android) v2.1.1

    IDP

    • Facebook SDK iOS v9.1.0
    • Google Sign-In SDK (iOS) v5.0.2+
선택적용 항목
    IDP

    • Facebook (Android) v9.1.1
    • GooglePlay Services-Auth (Android) v17.0.0
    • GooglePlay Services-Games (Android) v17.0.0
    • QQ (Android) v3.5.4.11 (r3f56456)
    • QQ (iOS) v3.3.9
    • VK (Android) v1.6.9
    • VK (iOS) v1.6.1
    • WeChat (Android) v1.4.0
    • WeChat (iOS) v1.8.6.2
    • LINE (Android) v5.3.1
    • LINE (iOS) v5.7.0

    IAP

    • Google Billing Library (Android) v3.0.3
    • OneStore (Android) v19.00.01
    • WeChat (Android) v1.4.0
    • Amazon (Android) v2.0.76

    PUSH

    • Amazon (Android) v1.0.1

    MARKETING TRACKING ANALYTICS

    • Adjust(Android) v4.28.0
    • Adjust(iOS) v4.29.6
    • Singular(Android) v9.6.0
    • Singular(iOS) v10.4.0
    • AppsFlyer(Android) v6.3.0
    • AppsFlyer(iOS) v6.2.6

Hive SDK v4.15.4.0 ~ Hive SDK v4.15.4.1

V4.15.4.1 (May 13, 2022)

New Features
    • 없음
Changed Features
  • All
    • 봇을 통한 게스트 계정 자동 생성을 방지하기 위해 Google reCAPCHA 키 사용
      • showSignin() 메서드를 호출하여 선택 옵션 중 게스트 선택 시 로봇이 아닙니다. 체크박스 UI 노출
Bug Fixes
    • 없음

V4.15.4 (Oct 26, 2021)

AndroidHive_SDK_Android_V4.15.4.1_withCore.zipiOSHive_SDK_iOS_V4.15.4.1_withCore.zip

Cocos2D-X Hive_SDK_Cocos_V4.15.4.1_withCore.zip

Cocos2D-X용 SDK는 C++ 인터페이스를 포함합니다.

New Features
  • All
    • [Auth v4][Social] Social v4 추가 및 Facebook에 사진 공유·게시하는 기능 제공 (가이드)
    • [Remote Configuration] SDK 초기화 시점에 메타데이터 전달
      • 앱 버전별 서버 URL을 게임에 전달 (가이드)
Changed Features
  • All
    • [Promotion] 새소식의 메뉴 탭에 새로운 컨텐츠 알림 표시 추가 (예시 이미지)
    • [Auth v4] 게임 UI와 통일된 디자인의 Hive 멤버십 대화 상자 적용
    • [Promotion] Hive 쿠폰 API의 쿠폰 사용 URL 변경
    • [Promotion] UA 캠페인의 노출 순서를 정할 수 있도록 캠페인 순서 값 추가 (가이드)
      • getAppInvitationData() 메서드를 통해 전달받는 AppInvitationData 객체의 eachCampaignsstageCampaignsorder 값 추가
  • iOS
    • [IAP v4] 결제 성공 시 iOS 7 스타일 영수증 발급되도록 로직 변경
    • [Auth v4] iOS 13 이상의 기기에서 GameCenter 식별자 값 변경
    • [Push] iOS 15 이상 기기에서 사용자가 앱 알림 설정의 긴급한 알림 (Time Sensitive Notifications)을 사용할 수 있도록 업데이트 (가이드)
      • 긴급한 알림을 활성화하면 사용자가 집중 모드 (Focus)를 사용하더라도 해당 앱의 긴급한 이벤트에 대한 알림 수신 가능
Bug Fixes
  • Android
    • [Analytics][CCU] 앱 실행 중에 단말기의 시간 설정 변경 시 퍼널 로그가 전송되지 않는 오류 수정
  • iOS
    • [Auth][Social] Safe Area를 사용하는 기기에서 로딩 스피너가 중앙에 오지 않는 오류 수정
    • [Auth][Provision] SDK 초기화 시 사용자 동의 로그가 중복 전송되는 오류 수정
    • [Unity] ExternalDependency 도구 사용 시 Singular SDK 버전이 다운그레이드되는 오류 수정
연동된 서드파티 라이브러리 버전 (Hive SDK V4.15.4 기준)
공통적용 항목
      • Kotlin 1.4.32
      • Kotlin Coroutine 1.4.0
      • AndroidX (Android) v1.0.0+
      • Firebase Library (Android) v20.2.4

IDP

    • Facebook SDK iOS v9.1.0
    • Google Sign-In SDK (iOS) v5.0.2+
선택적용 항목

IDP

      • Facebook (Android) v9.1.1
      • GooglePlay Services-Auth (Android) v17.0.0
      • GooglePlay Services-Games (Android) v17.0.0
      • QQ (Android) v3.5.4.11 (r3f56456)
      • QQ (iOS) v3.3.9
      • VK (Android) v1.6.9
      • VK (iOS) v1.6.1
      • WeChat (Android) v1.4.0
      • WeChat (iOS) v1.8.6.2
      • LINE (Android) v5.3.1
      • LINE (iOS) v5.7.0

IAP

      • Google Billing Library (Android) v3.0.3
      • OneStore (Android) v19.00.01
      • WeChat (Android) v1.4.0
      • Amazon (Android) v2.0.76

PUSH

      • Amazon (Android) v1.0.1

MARKETING TRACKING ANALYTICS

    • Adjust(Android) v4.28.0
    • Adjust(iOS) v4.29.6
    • Singular(Android) v9.6.0
    • Singular(iOS) v10.4.0
    • AppsFlyer(Android) v6.3.0
    • AppsFlyer(iOS) v6.2.6

Hive SDK v4.15.3

V4.15.3 (Sep 16, 2021)

New Features
  • All
    • [Auth v1/Auth v4][IAP v4] Google, Apple, Amazon 플랫폼에서 환불 이력이 있는 사용자에게 환불 상품에 대한 재결제 시스템 제공
      • 환불 상품에 대해 재결제 완료한 유저만 해당 플랫폼에 로그인 가능
  • Android
    • [Common] 인텐트 필터를 사용하는 앱 구성요소에 내보내기(exported) 속성 선언
      • AndroidManifest에 intent-filter를 가지는 항목에 대해 명시적 exported 선언을 추가
    • [Common] Android 12 이상 기기에서 광고 식별자를 사용할 수 있도록 com.google.android.gms.permission.AD_ID 권한 추가
Changed Features
  • Android
    • [Common] Android 12 이상 기기에서 광고 식별자를 획득할 수 없는 경우에 null 반환
    • [Auth v1][Auth v4] 마케팅을 위한 전화번호 수집 및 SMS 전송 권한 제거
      • READ_PHONE_STATE, READ_PHONE_NUMBER 권한 제거
    • [Push] Android 12 이상 기기에서 푸시 알림 동작 방식 변경
Bug Fixes
    • 없음
연동된 서드파티 라이브러리 버전 (Hive SDK v4.15.3 기준)
공통적용 항목
    • Kotlin 1.4.32
    • Kotlin Coroutine 1.4.0
    • AndroidX (Android) v1.0.0+
    • Firebase Library (Android) v20.2.4

    IDP

    • Facebook SDK Android v9.1.1
    • Facebook SDK iOS v9.1.0
    • GooglePlay Services-Games, Auth (Android) v17.0.0
    • Google Sign-In SDK (iOS) v5.0.2+

    IAP

    • Google Billing Library (Android) v3.0.3
선택적용 항목
    IDP

    • QQ (Android) v3.5.4.11 (r3f56456)
    • QQ (iOS) v3.3.9
    • VK (Android) v1.6.9
    • VK (iOS) v1.6.1
    • WeChat (Android) v1.4.0
    • WeChat (iOS) v1.8.6.2
    • LINE (Android) v5.3.1
    • LINE (iOS) v5.7.0

    IAP

    • OneStore (Android) v19.00.01
    • WeChat (Android) v1.4.0
    • Amazon (Android) v2.0.76

    PUSH

    • Amazon (Android) v1.0.1

    MARKETING TRACKING ANALYTICS

    • Adjust(Android) v4.28.0
    • Adjust(iOS) v4.29.1
    • Singular(Android) v9.6.0
    • Singular(iOS) v10.4.0
    • AppsFlyer(Android) v6.3.0
    • AppsFlyer(iOS) v6.2.6

 

업그레이드 가이드

Hive SDK v4.15 미만에서 Hive SDK v4.15 버전들로 업그레이드하기 위해 특별히 유의할 내용은 없습니다.

 

4.21 Windows (크로스플레이 4.21)

크로스플레이 v4.21.0 (June 9, 2023)

배포일 다운로드 게임 엔진
2023-06-09 Hive_Crossplay_Unity_4.21.0.zip Unity

 

릴리즈 노트

크로스플레이 v4.21.0

V4.21.0 (June 9, 2023)

New Features
Changed Features
  • Windows
    • [공통] Windows 빌드용 Unity 버전 기준을 업데이트했습니다.
      • 4.16.4: Unity 2018.4.32f 기준
      • 4.21.0: Unity 2021.3.22f 기준
    • [공통] 빌드 전 설정 > 플레이어 설정이 변경되었습니다. 스크립팅 런타임 버전 요구사항이 삭제되었고 API 호환성이 업데이트되었습니다.
    • [인증] 크로스플레이에서 이제 자동 로그인 기능을 사용할 수 있습니다.
    • [인증] 로그인한 유저 프로필 정보에 있는 이메일 정보를 수집할 수 있습니다. 이메일 정보 수집에 관한 자세한 내용은 Hive SDK 4.21.0 릴리즈 노트를 참고하세요.
    • [인증] 계정 충돌 팝업 노출 시, 게스트 계정이 소실되는 경우 이를 인지할 수 있도록 팝업 문구를 변경합니다.

 

지원하지 않는 기능

크로스플레이 4.21.0 미지원 기능

인증

Auth 클래스의 기능들은 지원되지 않으며, 인증 v4의 일부 기능만 지원합니다.

  • 지원 IdP

    크로스플레이는 다음의 IdP 로그인만 지원합니다.

    • Hive Membership
    • Google
    • Facebook
    • SignIn-with-apple
  • 게스트 로그인

    크로스플레이는 게스트 로그인을 지원하지 않습니다.

  • 성인인증

    크로스플레이는 AuthV4 클래스의 showAdultConfirm() 메서드를 통한 성인인증 기능을 지원하지 않습니다.

멤버십 & 소셜

크로스플레이는 문의하기 외의 멤버십 & 소셜 기능을 지원하지 않습니다.

프로모션

  • 리뷰·종료 팝업

    크로스플레이는 현재 마켓이 존재하지 않기 때문에 리뷰·종료 팝업을 지원하지 않습니다.

  • 오퍼월

    크로스플레이는 getOfferwallState()showOfferwall()을 통한 오퍼월 기능을 지원하지 않습니다.

  • 유저 에퀴지션 showUAShare()

    크로스플레이는 showUAShare()를 통한 유저 에퀴지션을 지원하지 않습니다. 단, getAppInvitationData()를 통해 초대화면을 구성할 수 있습니다.

  • 새소식 페이지 띄우기 (4.16.4 이상) showNews (...)
    크로스플레이는 showNews 메서드와 이벤트 번호( pid ) 를 이용한 달성한 이벤트 배너를 강조하여 새소식 페이지 띄우기를 지원 하지 않습니다. 새소식 페이지 띄우기 로 동작합니다.

빌링

크로스플레이 빌링은 PG사를 통한 결제 (이하 PG 결제)를 지원합니다. PG 결제는 영수증을 발행하지 않으며, 유저가 결제 시 Hive 서버에서 게임 서버를 통해 바로 아이템을 지급합니다.

  • 구매

    PG 결제의 구매는 purchase() 메서드 호출 직후 ErrorCode : IAPSUCCESS = 90, Code : IAPV4HiveStoreSuccess = -6110000가 Result API를 통해 반환합니다. 해당 에러는 유저가 구입 후 서버로 바로 아이템이 지급되므로 별도로 처리할 사항이 없음을 의미합니다. 자세한 내용은 Hive PG 결제 소개에서 확인하세요.

  • 영수증 확인

    PG 결제는 클라이언트 기반의 영수증을 발급하지 않습니다. 자세한 내용은 Hive PG 결제 소개에서 확인하세요.

  • Promotional IAP

    크로스플레이는 Promotional IAP 기능을 지원하지 않습니다.

  • 구독형 결제 시스템

    크로스플레이는 구독형 결제 시스템을 제공하지 않습니다.

  • Hive 러비

    크로스플레이는 Hive 러비를 지원하지 않습니다.

노티피케이션

크로스플레이는 노티피케이션 기능을 지원하지 않습니다.

마케팅 어트리뷰션

크로스플레이는 마케팅 어트리뷰션 기능을 지원하지 않습니다.

데이터 스토어

크로스플레이는 데이터 스토어 기능을 지원하지 않습니다.

기타

  • 권한고지팝업
  • 권한고지 화면 커스터마이징
  • Configuration 클래스의 getPermissionViewData() 메서드
  • Configuration 클래스의 getChannel() 메서드
  • Configuration 클래스의 setChannel (...) 메서드
  • IAPV4 클래스의 getAccountUuid()메서드
  • 리모트 로깅

 

업그레이드 가이드

크로스플레이 v4.21 미만에서 크로스플레이 4.21 버전들로 업그레이드하기 위해 특별히 유의할 내용은 없습니다.

 

4.16 Windows (크로스플레이 4.16)

크로스플레이 v4.16.4.1 (May 26, 2023)

배포일 다운로드 게임 엔진
2023-05-26 Hive_Crossplay_Unreal_4.16.4.1.zip Unreal

크로스플레이 v4.16.2 (Dec 15, 2022)

배포일 다운로드 게임 엔진
2023-01-04 Hive_Crossplay_Unreal_4.16.2.zip Unreal
2022-12-15 Hive_Crossplay_Unity_4.16.2.zip Unity®

 

릴리즈 노트

크로스플레이 v4.16.4.0 ~ 크로스플레이 v4.16.4.1

V4.16.4.1 (May 26, 2023)

Changed Features
  • [인증] 크로스플레이에서도 AuthV4.ShowProfile을 지원합니다. 호출 시 인증 모듈의 프로필 웹뷰를 불러옵니다.
개발자 가이드 변경사항

V4.16.4 (May 15, 2023)

Bug Fixes
  • [공통] 특정 자판 배열(프랑스어 등 일부 유럽어 키보드 등) 사용 시 WebView에서 Alt + Gr + 2를 눌러 ‘@’를 입력할 수 없는 문제를 수정하였습니다.

크로스플레이 v4.16.2

V4.16.2 (Dec 15, 2022)

Update Features
  • Windows
    • [Common] Hercules 제품을 공통 기능으로 제공
      • 사용하지 않을 경우 선택적으로 제거 가능
    • [AuthV4]커스텀 로그인에 연동과 연동 해제 기능 제공
    • [Community] Community 제품 설정 값을 앱센터에 등록된 정보 사용
    • [Promotion] 스팟 배너와 다이렉트 뷰 타입 추가
    • [Promotion] 전면 배너와 스팟 배너의 상세보기 팝업 UI에 프레임뷰 타입 추가
Changed Features
  • Windows
    • [Promotion] 새소식뷰의 컨텐츠에 대한 뱃지 노출 개선
    • [Auth v4] 약관 다시 보기 UI 변경
    • [Plugin/Unity] Unity패키지에서 사용중인 JSONObject 라이브러리를 최신으로 업데이트
    • [Plugin/Unity] Unity내의 HiveConfig Inspector의 SDK 타임아웃 설정 기본값을 15초에서 8초로 변경
    • [Analytics] 동접 데이터 전송시 주기시간당 플레이 타임값과 Hive국가코드값을 전송하도록 변경
    • [Common] SDK 내부의 네트워크 기본 타임아웃 시간을 8초로 변경
Bug Fixes
  • Windows
    • [Auth v4] 중국에서 로그인할 시 이메일 로그인이 노출되는 버그 수정
    • [Promotion] 게임에서 지원하는 일부 창모드 해상도에서 전면 배너의 오늘 하루 안보기를 클릭할 수 없는 이슈 수정
    • [Promotion] 전면 배너에서 웹배너가 노출되지 않는 이슈 수정
    • [Common] boolean 값이 일부 통신에서 정상적으로 설정되지 않는 이슈 수정

 

업그레이드 가이드

크로스플레이 v4.16 미만에서 크로스플레이 v4.16 버전들로 업그레이드하기 위해 특별히 유의할 내용은 없습니다.

 

4.15 Windows (크로스플레이 4.15)

크로스플레이 4.15.8.3 (Feb 24, 2023)

배포일 다운로드 게임 엔진
2023-02-24 Hive_Crossplay_Unity_4.15.8.3.zip Unity®
2022-11-21 Hive_Crossplay_Unity_4.15.8.2.zip Unity®
2022-10-14 Hive_Crossplay_Unity_4.15.8.1.zip Unity®
2022-09-22 Hive_Crossplay_Unreal_4.15.8.zip Unreal
2022-09-07 Hive_Crossplay_Unity_4.15.8.zip Unity®

크로스플레이 v4.15.7 (May 26, 2022)

배포일 다운로드 게임 엔진
2022-06-30 Hive_Crossplay_Unreal_4.15.7.zip Unreal
2022-05-26 Hive_Crossplay_Unity_4.15.7.zip Unity®

 

릴리즈 노트

크로스플레이 v4.15.8.0 ~ Hive SDK v4.15.8.3

V4.15.8.3 (Feb 24, 2023)

Bug Fixes
  • Windows
    • [공통] 특정 자판 배열(프랑스어 등 일부 유럽어 키보드 등) 사용 시 WebView에서 Alt + Gr + 2를 눌러 ‘@’를 입력할 수 없는 문제를 수정하였습니다.

V4.15.8.2 (Nov 21, 2022)

Bug Fixes
  • Windows
    • [Common] 메모리 비정상 점유 이슈 수정
      • cef.subprocess.exe 프로세스의 메모리가 시간이 지남에 따라 선형적으로 증가하는 버그 수정
    • [AuthV4] checkMaintenance 가 네트워크 에러 발생 시 모바일 Hive SDK와 동일한 ResultAPI를 반환하도록 수정

V4.15.8.1 (Oct 14, 2022)

Update Features
  • Windows
    • [Promotion] 전면 배너의 사이즈를 확대하여 PC환경에서 가시성 개선

V4.15.8 (Sep 07, 2022)

Update Features
  • Windows
    • [Analytics] 클라이언트 로그 전송 추가
      • 크로스플레이에서도 Analytics 클래스를 사용하여 클라이언트 로그 전송
    • [AuthV4]커스텀 로그인 추가
      • 커스텀 로그인을 구현하여 SignIn을 수행 가능
      • Connect, Disconnect등의 부가 기능은 지원하지 않음
    • [AuthV4] 이용약관 다시보기 추가
      • AuthV4.showTerms()
    • [Remote Configuration] SDK 초기화 시점에 메타데이터 전달
      • 앱 버전별 서버 URL을 게임에 전달
    • [Common / UI] 고해상도에서 노출하는 UI 가시성 향상
    • [Common] Hive 지원 언어에 아랍어 추가
    • [Common] 웹뷰 노출 중 게임 컨트롤러가 동작하지 않도록 변경
Bug Fixes
  • Windows
    • [AuthV4] checkBlacklist 함수가 정상적으로 작동하지 않는 버그 수정
    • [Promotion] 일부유저에게 전면 배너가 정상적으로 노출되지 못하는 이슈 수정

크로스플레이 v4.15.7

V4.15.7 (May 26, 2022)

  • 공식 배포

 

업그레이드 가이드

크로스플레이 v4.15 미만에서 크로스플레이 v4.15 버전들로 업그레이드하기 위해 특별히 유의할 내용은 없습니다.