Android & iOS

v4.25.5.2¶

다운로드¶

주의 사항¶

• Hive SDK v4 Unity 25.4.0 이상 사용 시, Hive SDK Manager를 통해 업데이트를 진행하는 경우 Hive SDK Manager 2.0 버전으로 업데이트가 필요합니다.

• 인증 보안 프로토콜 변경으로 인해, Hive SDK v4 Unity 25.0.0 이상 사용 시, 반드시 Hive 콘솔 > 보안 키 설정에서 보안 키를 발급 받아야 합니다. 보안 키를 발급받지 않으면, 앱에서 로그인할 수 없습니다.

• PG 결제 프로세스의 변경으로 인해, Hive SDK v4 Unity 25.1.3 이상에서 PG 결제를 사용하려면 PG 결제 동작 과정을 참고하여 코드 구현을 수정해야 합니다.

개발 환경¶

Unity (Android)¶

• Unity 2021.3.43f+
• Unity 2022.3.0+
• Unity 2023.1.0+
• Unity 6000.0.0+

targetSDK 버전에 따른 Unity 호환 버전¶

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

Unity (iOS)¶

• Unity 2021.3.0+
• Unity 2022.3.0+
• Unity 2023.1.0+
• Unity 6000.0.0+

Android¶

iOS¶

• Xcode 16.1 이상
• Xcode 버전은 Apple App Store 정책에 따라 업데이트해야합니다.

필수 항목¶

• Kotlin (Android) v1.9.22
• Kotlin Coroutine (Android) 1.4.3
• AndroidX (Android) v1.2.0+
• Constraint Layout (Android) v2.1.4
• Glide (Android) v4.13.0
• SDWebImage (iOS) v5.20.0

선택 항목¶

IDP¶

• Facebook SDK (Android) v17.0.0
• Facebook SDK (iOS) v17.4.0
• GooglePlay Services-Auth (Android) v20.7.0
• GooglePlay Services-Games v2 (Android) v20.1.2
• Google Sign-In SDK (iOS) v8.0.0
• QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
• QQ (iOS) v3.5.17.4
• WeChat (Android) v6.8.0
• WeChat (iOS) v2.0.4
• LINE (Android) v5.10.0
• LINE (iOS) v5.11.2
• Huawei (Android) v6.12.0.300

IAP¶

• Google Billing Library (Android) v7.0.0
• Samsung GalaxyStore IAP (Android) v6.1.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.2.0
• FCM(FirebaseCloudMessaging) (Android) v24.0.2

MARKETING TRACKING ANALYTICS¶

• Airbridge(Android) v4.3.0
• Airbridge(iOS) v4.3.0
• Adjust(Android) v5.2.0
• Adjust(iOS) v5.2.0
• Singular(Android) v12.7.0
• Singular(iOS) v12.7.1
• AppsFlyer(Android) v6.16.2
• AppsFlyer(iOS) v6.16.1
• FirebaseAnalytics(Android) v22.1.2
• FirebaseAnalytics(iOS) v11.6.0

CHAT¶

• OkHttp(Android) v4.12.0

기타¶

• GooglePlay Services-Review (Android) v2.0.1
• GooglePlay Services-AppUpdate (Android) v2.1.0
• Google reCaptcha (Android) v18.6.1
• Google reCaptcha (iOS) v18.6.0
• YoutubeAndroidWebPlayerApi (Android) v1.0.1

해결한 버그¶

인증¶

• iOS 가로모드에서 챗봇을 노출하는 경우 크래시가 발생하는 오류를 수정합니다.

v4.25.5.1¶

다운로드¶

주의 사항¶

• Hive SDK v4 Unity 25.4.0 이상 사용 시, Hive SDK Manager를 통해 업데이트를 진행하는 경우 Hive SDK Manager 2.0 버전으로 업데이트가 필요합니다.

• 인증 보안 프로토콜 변경으로 인해, Hive SDK v4 Unity 25.0.0 이상 사용 시, 반드시 Hive 콘솔 > 보안 키 설정에서 보안 키를 발급 받아야 합니다. 보안 키를 발급받지 않으면, 앱에서 로그인할 수 없습니다.

• PG 결제 프로세스의 변경으로 인해, Hive SDK v4 Unity 25.1.3 이상에서 PG 결제를 사용하려면 PG 결제 동작 과정을 참고하여 코드 구현을 수정해야 합니다.

개발 환경¶

Unity (Android)¶

• Unity 2021.3.43f+
• Unity 2022.3.0+
• Unity 2023.1.0+
• Unity 6000.0.0+

targetSDK 버전에 따른 Unity 호환 버전¶

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

Unity (iOS)¶

• Unity 2021.3.0+
• Unity 2022.3.0+
• Unity 2023.1.0+
• Unity 6000.0.0+

Android¶

iOS¶

• Xcode 16.1 이상
• Xcode 버전은 Apple App Store 정책에 따라 업데이트해야 합니다.

필수 항목¶

• Kotlin (Android) v1.9.22
• Kotlin Coroutine (Android) 1.4.3
• AndroidX (Android) v1.2.0+
• Constraint Layout (Android) v2.1.4
• Glide (Android) v4.13.0
• SDWebImage (iOS) v5.20.0

선택 항목¶

IDP¶

• Facebook SDK (Android) v17.0.0
• Facebook SDK (iOS) v17.4.0
• GooglePlay Services-Auth (Android) v20.7.0
• GooglePlay Services-Games v2 (Android) v20.1.2
• Google Sign-In SDK (iOS) v8.0.0
• QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
• QQ (iOS) v3.5.17.4
• WeChat (Android) v6.8.0
• WeChat (iOS) v2.0.4
• LINE (Android) v5.10.0
• LINE (iOS) v5.11.2
• Huawei (Android) v6.12.0.300

IAP¶

• Google Billing Library (Android) v7.0.0
• Samsung GalaxyStore IAP (Android) v6.1.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.2.0
• FCM(FirebaseCloudMessaging) (Android) v24.0.2

MARKETING TRACKING ANALYTICS¶

• Airbridge(Android) v4.3.0
• Airbridge(iOS) v4.3.0
• Adjust(Android) v5.2.0
• Adjust(iOS) v5.2.0
• Singular(Android) v12.7.0
• Singular(iOS) v12.7.1
• AppsFlyer(Android) v6.16.2
• AppsFlyer(iOS) v6.16.1
• FirebaseAnalytics(Android) v22.1.2
• FirebaseAnalytics(iOS) v11.6.0

CHAT¶

• OkHttp(Android) v4.12.0

기타¶

• GooglePlay Services-Review (Android) v2.0.1
• GooglePlay Services-AppUpdate (Android) v2.1.0
• Google reCaptcha (Android) v18.6.1
• Google reCaptcha (iOS) v18.6.0
• YoutubeAndroidWebPlayerApi (Android) v1.0.1

새로운 기능¶

인증¶

• All 다계정 로그인 기능을 신규로 제공합니다. 관련 세부 기능은 아래와 같습니다.
  • 현재 로그인된 계정을 기기에 저장
  • 저장된 계정을 조회
  • 저장된 계정을 로그아웃하고 삭제
  • 저장된 다른 계정으로 빠른 로그인

프로모션¶

• All 다이렉트 링크 기능를 신규로 추가합니다.

노티피케이션¶

• All 푸시 액션 버튼을 신규로 제공합니다.
  • 푸시 알람 수신 시, 푸시 선택 액션 버튼을 통해 사전에 정의된 액션을 수행할 수 있습니다.

채팅¶

• All 메시지 전송
  • 채팅 메시지가 사용자의 언어로 자동 번역되어 수신하는 기능과 특정 메시지를 번역하는 기능을 추가합니다.
  • 특정 언어 사용자만 수신힐 수 있는 공지 메시지 기능을 추가합니다.
  • 웹소켓 메시지에 메시지 id값을 추가하여 콜백의 순서 보장을 제공합니다.
• All 채널
  • 채팅 채널 입장 시 이전 대화 이력을 조회할 수 있는 기능을 추가합니다.
  • 현재 채널에 참여한 인원수를 제공합니다.
  • 채널 목록 조회시 정렬 기준 기능을 제공합니다.
• All 이벤트 관리
  • 채팅 커스텀 데이터 이벤트를 바이너리로 전송할 수 있는 기능을 추가합니다.
• All 연결 관리
  • 재연결 기능을 추가합니다.

변경한 기능¶

공통¶

• Android 빌드에 필요한 난독화 규칙을 업데이트합니다.
• iOS 분리되어 제공되었던 HiveAppTrackingTransparents.framework 라이브러리가 Service.framework에 통합됩니다.

인증¶

• All Hive 멤버십 계정을 사용하지 않는 경우 동작하지 않았던 showMyInquiry 메소드를 사용 시 문의하기 페이지가 노출되도록 변경합니다.
• Android VK 인증 팝업을 웹뷰에서 인앱브라우저로 변경합니다.

마케팅 어트리뷰션¶

• iOS 자동으로 수집하는 Firebase 구매 이벤트를 활성화한 경우 지원하도록 변경합니다.

허큘리스¶

• All 허큘리스 라이브러리를 업데이트합니다.
  • Unity 20241120 -> 20250217
  • Android 20241125-2 -> 20250527
  • iOS 20241120 -> 20250218

해결한 버그¶

프로비저닝¶

• iOS 약관 노출시 웹뷰 스크롤이 되지 않도록 수정합니다.

프로모션¶

• iOS iPad 기기에서 새소식 UI의 모서리 곡률을 수정합니다.

분석¶

• iOS 약관 동의가 끝난 직후 Analytics 로그를 전송 가능하도록 로직을 수정합니다.

알려진 이슈¶

• iOS 가로모드에서 챗봇을 사용하는 경우 크래시가 발생하는 오류가 발생합니다.
  • Hive SDK Unity iOS 25.5.2 이상으로 업데이트 하세요.

개발자 가이드 변경 사항¶

• 마케팅 어트리뷰션 > 이벤트 자동 추적 가이드를 변경합니다.
• 인증 > 다계정 로그인 관리 가이드를 신규 추가합니다.
• 인증 > 사전 준비 > Android > VK IdP 설정 가이드를 추가합니다.
• 프로모션 > 사전 준비 > Android > 다이렉트 링크 사용하기 가이드를 추가합니다.
• 프로모션 > 사전 준비 > iOS > 다이렉트 링크 사용하기 가이드를 추가합니다.
• 노티피케이션 > 부가 기능에서 iOS 미디어 노티피케이션 구현 내용을 변경하며, 푸시 액션 버튼 구현 가이드를 추가합니다.
• 채팅의 새로운 기능 추가에 해당하는 가이드를 업데이트를 합니다.

개발 환경 업데이트¶

Android¶

iOS¶

v4.25.2.2¶

다운로드¶

주의 사항¶

• 인증 보안 프로토콜 변경으로 인해, Hive SDK v4 Unity 25.0.0 이상 사용 시, 반드시 Hive 콘솔 > 보안 키 설정에서 보안 키를 발급 받아야 합니다. 보안 키를 발급받지 않으면, 앱에서 로그인할 수 없습니다.

• PG 결제 프로세스의 변경으로 인해, Hive SDK v4 Unity 25.1.3 이상에서 PG 결제를 사용하려면 PG 결제 동작 과정을 참고하여 코드 구현을 수정해야 합니다.

개발 환경¶

Unity (Android)¶

• Unity 2021.3.43f+
• Unity 2022.3.0+
• Unity 2023.1.0+
• Unity 6000.0.0+

targetSDK 버전에 따른 Unity 호환 버전¶

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

• targetSDK 34 빌드 시
  • Unity 2022 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)
  • Unity 2021.3.43f 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)
• targetSDK 35 빌드 시
  • Unity 6000 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)

Unity (iOS)¶

• Unity 2021.3.0+
• Unity 2022.3.0+
• Unity 2023.1.0+
• Unity 6000.0.0+

Android¶

iOS¶

• Xcode 16.1 이상
• Xcode 버전은 Apple App Store 정책에 따라 업데이트해야 합니다.

필수 항목¶

• Kotlin (Android) v1.9.22
• Kotlin Coroutine (Android) 1.4.3
• AndroidX (Android) v1.2.0+
• Constraint Layout (Android) v2.1.4
• Glide (Android) v4.13.0
• SDWebImage (iOS) v5.20.0

선택 항목¶

IDP¶

• Facebook SDK (Android) v17.0.0
• Facebook SDK (iOS) v17.4.0
• GooglePlay Services-Auth (Android) v20.7.0
• Google Credential Play Services Auth(Android) v1.3.0
• GooglePlay Services-Games v2 (Android) v20.1.2
• Google Sign-In SDK (iOS) v8.0.0
• QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
• QQ (iOS) v3.5.17.4
• WeChat (Android) v6.8.0
• WeChat (iOS) v2.0.4
• LINE (Android) v5.10.0
• LINE (iOS) v5.11.2
• Huawei (Android) v6.12.0.300

IAP¶

• Google Billing Library (Android) v7.0.0
• Samsung GalaxyStore IAP (Android) v6.1.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.2.0
• FCM(FirebaseCloudMessaging) (Android) v24.0.2

MARKETING TRACKING ANALYTICS¶

• Airbridge(Android) v4.3.0
• Airbridge(iOS) v4.3.0
• Adjust(Android) v5.2.0
• Adjust(iOS) v5.2.0
• Singular(Android) v12.7.0
• Singular(iOS) v12.7.1
• AppsFlyer(Android) v6.16.2
• AppsFlyer(iOS) v6.16.1
• FirebaseAnalytics(Android) v22.1.2
• FirebaseAnalytics(iOS) v11.6.0

CHAT¶

• OkHttp(Android) v4.12.0

기타¶

• GooglePlay Services-Review (Android) v2.0.1
• GooglePlay Services-AppUpdate (Android) v2.1.0
• Google reCaptcha (Android) v18.6.1
• Google reCaptcha (iOS) v18.6.0
• YoutubeAndroidWebPlayerApi (Android) v1.0.1

변경한 기능¶

인증¶

• Android Google Credential Manager의 호환성이 낮아 일부 유저가 접속할 수 없는 이슈로 인해, 인증 방법을 기존의 Google Sign-In 으로 롤백하여 변경합니다.

기타¶

• 외부 라이브러리를 업데이트합니다.
  • GooglePlay Services-Auth(Android) v20.7.0 (Google Sign-In 롤백 재지원)
  • Google Credential Play Services Auth(Android) v1.3.0 (Google Sign-In 롤백 제거)

개발 환경 업데이트¶

Android¶

• GooglePlay Services-Auth(Android) v20.7.0 (Google Sign-In 롤백 재지원)
• Google Credential Play Services Auth(Android) v1.3.0 (Google Sign-In 롤백 제거)

v4.25.2.1¶

다운로드¶

주의 사항¶

• 인증 보안 프로토콜 변경으로 인해, Hive SDK v4 Unity 25.0.0 이상 사용 시, 반드시 Hive 콘솔 > 보안 키 설정에서 보안 키를 발급 받아야 합니다. 보안 키를 발급받지 않으면, 앱에서 로그인할 수 없습니다.

• PG 결제 프로세스의 변경으로 인해, Hive SDK v4 Unity 25.1.3 이상에서 PG 결제를 사용하려면 PG 결제 동작 과정을 참고하여 코드 구현을 수정해야 합니다.

개발 환경¶

Unity (Android)¶

• Unity 2021.3.43f+
• Unity 2022.3.0+
• Unity 2023.1.0+
• Unity 6000.0.0+

targetSDK 버전에 따른 Unity 호환 버전¶

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

• targetSDK 34 빌드 시
  • Unity 2022 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)
  • Unity 2021.3.43f 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)
• targetSDK 35 빌드 시
  • Unity 6000 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)

Unity (iOS)¶

• Unity 2021.3.0+
• Unity 2022.3.0+
• Unity 2023.1.0+
• Unity 6000.0.0+

Android¶

iOS¶

• Xcode 16.1 이상
• Xcode 버전은 Apple App Store 정책에 따라 업데이트해야 합니다.

필수 항목¶

• Kotlin (Android) v1.9.22
• Kotlin Coroutine (Android) 1.4.3
• AndroidX (Android) v1.2.0+
• Constraint Layout (Android) v2.1.4
• Glide (Android) v4.13.0
• SDWebImage (iOS) v5.20.0

선택 항목¶

IDP¶

• Facebook SDK (Android) v17.0.0
• Facebook SDK (iOS) v17.4.0
• Google Credential Play Services Auth(Android) v1.3.0
• GooglePlay Services-Games v2 (Android) v20.1.2
• Google Sign-In SDK (iOS) v8.0.0
• QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
• QQ (iOS) v3.5.17.4
• WeChat (Android) v6.8.0
• WeChat (iOS) v2.0.4
• LINE (Android) v5.10.0
• LINE (iOS) v5.11.2
• Huawei (Android) v6.12.0.300

IAP¶

• Google Billing Library (Android) v7.0.0
• Samsung GalaxyStore IAP (Android) v6.1.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.2.0
• FCM(FirebaseCloudMessaging) (Android) v24.0.2

MARKETING TRACKING ANALYTICS¶

• Airbridge(Android) v4.3.0
• Airbridge(iOS) v4.3.0
• Adjust(Android) v5.2.0
• Adjust(iOS) v5.2.0
• Singular(Android) v12.7.0
• Singular(iOS) v12.7.1
• AppsFlyer(Android) v6.16.2
• AppsFlyer(iOS) v6.16.1
• FirebaseAnalytics(Android) v22.1.2
• FirebaseAnalytics(iOS) v11.6.0

CHAT¶

• OkHttp(Android) v4.12.0

기타¶

• GooglePlay Services-Review (Android) v2.0.1
• GooglePlay Services-AppUpdate (Android) v2.1.0
• Google reCaptcha (Android) v18.6.1
• Google reCaptcha (iOS) v18.6.0
• YoutubeAndroidWebPlayerApi (Android) v1.0.1

해결한 버그¶

마케팅 어트리뷰션¶

• Android MMP 서비스와 연동에 사용되는 Hive SDK 식별자 중 did 값이 누락되는 오류를 수정합니다.

v4.25.2.0¶

다운로드¶

주의 사항¶

• 인증 보안 프로토콜 변경으로 인해, Hive SDK v4 Unity 25.0.0 이상 사용 시, 반드시 Hive 콘솔 > 보안 키 설정에서 보안 키를 발급 받아야 합니다. 보안 키를 발급받지 않으면, 앱에서 로그인할 수 없습니다.

• PG 결제 프로세스의 변경으로 인해, Hive SDK v4 Unity 25.1.3 이상에서 PG 결제를 사용하려면 PG 결제 동작 과정을 참고하여 코드 구현을 수정해야 합니다.

개발 환경¶

Unity (Android)¶

• Unity 2021.3.43f+
• Unity 2022.3.0+
• Unity 2023.1.0+
• Unity 6000.0.0+

targetSDK 버전에 따른 Unity 호환 버전¶

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

• targetSDK 34 빌드 시
  • Unity 2022 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)
  • Unity 2021.3.43f 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)
• targetSDK 35 빌드 시
  • Unity 6000 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)

Unity (iOS)¶

• Unity 2021.3.0+
• Unity 2022.3.0+
• Unity 2023.1.0+
• Unity 6000.0.0+

Android¶

iOS¶

• Xcode 16.1 이상
• Xcode 버전은 Apple App Store 정책에 따라 업데이트해야 합니다.

필수 항목¶

• Kotlin (Android) v1.9.22
• Kotlin Coroutine (Android) 1.4.3
• AndroidX (Android) v1.2.0+
• Constraint Layout (Android) v2.1.4
• Glide (Android) v4.13.0
• SDWebImage (iOS) v5.20.0

선택 항목¶

IDP¶

• Facebook SDK (Android) v17.0.0
• Facebook SDK (iOS) v17.4.0
• GooglePlay Services-Auth (Android) v20.7.0
• Google Credential Play Services Auth(Android) v1.3.0
• GooglePlay Services-Games v2 (Android) v20.1.2
• Google Sign-In SDK (iOS) v8.0.0
• QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
• QQ (iOS) v3.5.17.3 → v3.5.17.4
• 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.2
• Huawei (Android) v6.12.0.300

IAP¶

• Google Billing Library (Android) v7.0.0
• Samsung GalaxyStore IAP (Android) v6.1.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.2.0
• FCM(FirebaseCloudMessaging) (Android) v24.0.2

MARKETING TRACKING ANALYTICS¶

• Airbridge(Android) v4.1.0 → v4.3.0
• Airbridge(iOS) v4.1.1 → v4.3.0
• Adjust(Android) v5.0.1 → v5.2.0
• Adjust(iOS) v5.0.1 → v5.2.0
• Singular(Android) v12.6.1 → v12.7.0
• Singular(iOS) v12.6.1 → v12.7.1
• AppsFlyer(Android) v6.15.2 → v6.16.2
• AppsFlyer(iOS) v6.15.3 → v6.16.1
• FirebaseAnalytics(Android) v22.1.2
• FirebaseAnalytics(iOS) v11.6.0

CHAT¶

• OkHttp(Android) v4.12.0

기타¶

• GooglePlay Services-Review (Android) v2.0.1
• GooglePlay Services-AppUpdate (Android) v2.1.0
• Google reCaptcha (Android) v18.6.1
• Google reCaptcha (iOS) v18.6.0
• YoutubeAndroidWebPlayerApi (Android) v1.0.1

새로운 기능¶

• Unity Unity 6.1 (6000.1)을 지원합니다.

변경한 기능¶

프로비저닝¶

• All 약관 상세 보기 및 다시 보기 페이지에서 약관 URL이 아닌 웹 주소로 이동하거나 하이퍼링크 태그가 있는 경우 외부 브라우저 이동으로 변경합니다.

인증¶

• All VK 인증 수단을 변경하여 제공합니다. 변경된 인증 방식은 신규 VK 개발자 콘솔에서 사용할 수 있습니다.

• iOS Apple GameCenter 로그인 시 사용하는 deprecated된 GameKit API의 검증 프로토콜을 업데이트합니다.

• Android Google Sign-In 라이브러리 지원 중단에 따라 묵시적 및 명시적 로그인 시 Google Credential Manager와 AuthorizationClient API로 인증하도록 변경합니다.

빌링¶

• Android PG 결제로 구매한 상품을 환불한 경우, 이전 트랜잭션과 구분하기 위해 order_id 값을 추가합니다.
• Android PG 결제 트랜잭션 완료 시, 구매 완료 로그를 클라이언트에서 전송하도록 변경합니다.

프로모션¶

• Android UserAcqutision 공유 시, Telegram이 지원하는 노출 목록에 추가되도록 변경합니다.

• Android 웹뷰 노출 시, 캐싱 정책을 변경합니다.

마케팅 어트리뷰션¶

• All MMP 서비스와 연동을 지원하도록 Hive SDK 식별자를 추가로 전송합니다.
• All 이벤 수동 추적 시 커스텀 어트리뷰트를 추가하여 전송하도록 변경합니다.
• Android Airbridge 초기화 시, 마켓 출처 정보를 전송하도록 변경합니다.
• iOS sendEventWithAttributes API 사용 시, semantic value 타입의 부동소수점 값의 정밀도 범위를 float에서 double형으로 변경합니다.

채팅¶

• All 메시지 데이터를 전송하거나 수신할 때 extraData를 추가로 전송하고 수신합니다.
• All 채팅 서버 연결 시, extraData를 더 이상 전송하지 않습니다.
• All 문자열 시간값이 아닌 정수형 시간값을 추가로 수신합니다.
• All 네트워크 차단 등 통신이 불가능한 상황에서 웹소켓을 정상적으로 해제하지 못하고 재연결을 시도할 때, 중복 연결 상태로 실패하지 않도록 변경합니다.

기타¶

• 외부 라이브러리를 업데이트합니다.
  • Airbridge(Android) v4.1.0 → v4.3.0
  • Airbridge(iOS) v4.1.1 → v4.3.0
  • Adjust(Android) v5.0.1 → v5.2.0
  • Adjust(iOS) v5.0.1 → v5.2.0
  • Singular(Android) v12.6.1 → v12.7.0
  • Singular(iOS) v12.6.1 → v12.7.1
  • AppsFlyer(Android) v6.15.2 → v6.16.2
  • AppsFlyer(iOS) v6.15.3 → v6.16.1
  • GooglePlay Services-Auth(Android) v20.7.0 (지원중단)
  • Google Credential Play Services Auth(Android) v1.3.0 (신규지원)
  • QQ(iOS) 3.5.17.3 → 3.5.17.4

해결한 버그¶

공통¶

• Android 네트워크를 통한 통신 재시도가 필요하거나 분산 서버에 접속해야 하는 상황에서 설정된 최대 타임아웃 시간이 초과하기 전에 응답이 오는 경우, 더 이상 타임아웃을 기다리지 않고 즉시 통신 재시도를 하거나 분산 서버에 접속하도록 수정합니다.

• iOS Configuration 클래스의 setZone 메서드를 사용하여 Hive SDK에서 접속하는 서버 그룹 Zone이 변경되는 경우, hive_config.xml 파일의 gameLanguage 값이 초기화 되는 오류를 수정합니다.

프로비저닝¶

• All SDK의 초기화 이전에 광고 모듈(Adiz) 초기화 진행 시 COPPA나 GDPR와 같은 컴플라이언스를 준수하는 경우, 연령을 체크하는 AgeGate 값이 hive_config.xml에 설정된 값으로 동작하는 오류를 수정합니다.

인증¶

• iOS iOS 18 이상의 기기에서 QQ 웹로그인이 정상적으로 진행되지 않는 오류를 수정합니다.

마케팅 어트리뷰션¶

• Android Adjust를 사용하여 설치 여부를 판단하는 기능을 사용하는 경우, 내용이 없는 푸시 알림이 노출되는 현상을 수정합니다.

• Android Airbridge 사용 시 복수의 개수를 구매하는 이벤트가 발생한 경우, 단가와 개수에 따른 매출 정보를 전달하도록 수정합니다.

채팅¶

• Android 채팅 연결시, 간헐적으로 연결이 실패하는 현상을 수정합니다.

알려진 이슈¶

마케팅 어트리뷰션¶

• Android MMP 서비스와 연동에 사용되는 Hive SDK 식별자 중 did 값이 누락되는 오류가 존재합니다. 해당 이슈가 해결된 SDK v4 Unity Android & iOS 25.2.1 버전을 사용하세요.

개발자 가이드 변경 사항¶

• 기본 설정 > Configuration 파일 > Unity에 HiveConfig Editor 업데이트 내용을 반영하였습니다.
• 인증 > 사전 준비 > 엔진 공통에 라인 IdP 연동 설정을 추가하여습니다.
• 인증 > 사전 준비 > 엔진 공통 > IdP별 키 입력에 VK로 로그인 방법을 변경하였습니다.
• 인증 > 로그인 로그아웃에 로그인 시 Google Credential Manager를 통한 인증 변경 사항을 반영하였습니다.
• 마케팅 어트리뷰선 > 이벤트 수동 추적에 MMP 서비스 연동 지원을 위한 Singular, Appsflyer, Firebase Analytics로 이벤트 수동 추적하기 및 커스텀 어트리뷰트 추가하기내용을 추가하였습니다.
• 마케팅 어트리뷰선 > 참고하기에 Adjust Signature V1 관련 레거시 설정 항목을 제거하였습니다.
• 마케팅 어트리뷰선 > 사전 준비 > 엔진 공통에 Airbridge 앱 마켓별 유입량 측정 설정을 추가헸습니다.
• 채팅 기능 변경점을 반영하여 채팅 > 연결 관리에 연결 요청의 예제 코드 변경 및 재연결 요청을 추가하였습니다.

개발 환경 업데이트¶

Android¶

• Airbridge(Android) v4.1.0 → v4.3.0
• Adjust(Android) v5.0.1 → v5.2.0
• Singular(Android) v12.6.1 → v12.7.0
• AppsFlyer(Android) v6.15.2 → v6.16.2
• GooglePlay Services-Auth(Android) v20.7.0 (지원중단)
• Google Credential Play Services Auth(Android) v1.3.0 (신규지원)

iOS¶

• Airbridge(iOS) v4.1.1 → v4.3.0
• Adjust(iOS) v5.0.1 → v5.2.0
• Singular(iOS) v12.6.1 → v12.7.1
• AppsFlyer(iOS) v6.15.3 → v6.16.1
• QQ(iOS) 3.5.17.3 → 3.5.17.4

v4.25.1.3¶

다운로드¶

주의 사항¶

• 인증 보안 프로토콜 변경으로 인해, Hive SDK v4 Unity 25.0.0 이상 사용 시, 반드시 Hive 콘솔 > 보안 키 설정에서 보안 키를 발급 받아야 합니다. 보안 키를 발급받지 않으면, 앱에서 로그인할 수 없습니다.

• PG 결제 프로세스의 변경으로 인해, Hive SDK v4 Unity 25.1.3 이상에서 PG 결제를 사용하려면 PG 결제 동작 과정을 참고하여 코드 구현을 수정해야 합니다.

개발 환경¶

Unity (Android)¶

• Unity 2021.3.43f+
• Unity 2022.3.0+
• Unity 2023.1.0+
• Unity 6000.0.0+

targetSDK 버전에 따른 Unity 호환 버전¶

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

• targetSDK 34 빌드 시
  • Unity 2022 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)
  • Unity 2021.3.43f 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)
• targetSDK 35 빌드 시
  • Unity 6000 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)

Unity (iOS)¶

• Unity 2021.3.0+
• Unity 2022.3.0+
• Unity 2023.1.0+
• Unity 6000.0.0+

Android¶

iOS¶

• Xcode 16.1 이상
• Xcode 버전은 Apple App Store 정책에 따라 업데이트해야 합니다.

필수 항목¶

• Kotlin (Android) v1.9.22
• Kotlin Coroutine (Android) 1.4.3
• AndroidX (Android) v1.2.0+
• Constraint Layout (Android) v2.1.4
• Glide (Android) v4.13.0
• SDWebImage (iOS) v5.20.0

선택 항목¶

IDP¶

• Facebook SDK (Android) v17.0.0
• Facebook SDK (iOS) v17.4.0
• GooglePlay Services-Auth (Android) v20.7.0
• GooglePlay Services-Games v2 (Android) v20.1.2
• Google Sign-In SDK (iOS) v8.0.0
• QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
• QQ (iOS) v3.5.17.3
• 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.2
• Huawei (Android) v6.12.0.300

IAP¶

• Google Billing Library (Android) v7.0.0
• Samsung GalaxyStore IAP (Android) v6.1.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.2.0
• FCM(FirebaseCloudMessaging) (Android) v24.0.2

MARKETING TRACKING ANALYTICS¶

• Airbridge(Android) v4.1.0
• Airbridge(iOS) v4.1.1
• Adjust(Android) v5.0.1
• Adjust(iOS) v5.0.1
• Singular(Android) v12.6.1
• Singular(iOS) v12.6.1
• AppsFlyer(Android) v6.15.2
• AppsFlyer(iOS) v6.15.3
• FirebaseAnalytics(Android) v22.1.2
• FirebaseAnalytics(iOS) v11.6.0

CHAT¶

• OkHttp(Android) v4.12.0

기타¶

• GooglePlay Services-Review (Android) v2.0.1
• GooglePlay Services-AppUpdate (Android) v2.1.0
• Google reCaptcha (Android) v18.6.1
• Google reCaptcha (iOS) v18.6.0
• YoutubeAndroidWebPlayerApi (Android) v1.0.1

새로운 기능¶

• 해당 없음

변경한 기능¶

마케팅 어트리뷰션¶

• iOS Airbridge 디퍼드 딥링크 추적 기능을 신규 지원합니다.

빌링¶

• Android PG 결제의 동작 방식을 다른 빌링(IAPv4) 기능에 있는 마켓들과 동일하도록 변경합니다. PG 결제 적용 중이라면 PG 결제 동작 과정을 참고하여 코드 구현을 수정해야 합니다.

해결한 버그¶

마케팅 어트리뷰션¶

• iOS Adiz를 통해 광고수익 정보 전송 시, Airbridge에서 Adiz가 아닌 AdMob으로 전송되는 오류를 수정합니다.

빌링¶

• iOS 소비 정보 전송 동의 여부를 질의하는 팝업 UI를 노출 시, 배경화면이 불투명한 오류를 수정합니다.

• iOS 소비 정보 전송 동의 여부를 질의하는 팝업 UI를 닫을 시, 의도하지 않은 방향으로 앱의 화면 방향이 회전하는 오류를 수정합니다.

프로모션¶

• iOS 이미지가 포함된 리뷰팝업 노출 중 회전 이벤트가 발생하는 경우, 노출 중인 이미지가 사리지는 오류를 수정합니다.

v4.25.0.1¶

다운로드¶

주의 사항¶

인증 보안 프로토콜 변경으로 Hive SDK v4 Unity 25.0.0 이상 사용 시, 반드시 Hive 콘솔 > 보안 키 설정에서 보안 키를 발급 받아야 합니다. 보안 키를 발급받지 않으면, 앱 사용자들은 앱에서 로그인을 할 수 없습니다.

개발 환경¶

Unity (Android)¶

• Unity 2021.3.43f+
• Unity 2022.3.0+
• Unity 2023.1.0+
• Unity 6000.0.0+

targetSDK 버전에 따른 Unity 호환 버전¶

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

• targetSDK 34 빌드 시
  • Unity 2022 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)
  • Unity 2021.3.43f 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)
• targetSDK 35 빌드 시
  • Unity 6000 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)

Unity (iOS)¶

• Unity 2021.3.0+
• Unity 2022.3.0+
• Unity 2023.1.0+
• Unity 6000.0.0+

Android¶

iOS¶

• Xcode 16.1 이상
• Xcode 버전은 Apple App Store 정책에 따라 업데이트해야 합니다.

필수 항목¶

• Kotlin (Android) v1.9.22
• Kotlin Coroutine (Android) 1.4.3
• AndroidX (Android) v1.2.0+
• Constraint Layout (Android) v2.1.4
• Glide (Android) v4.13.0
• SDWebImage (iOS) v5.20.0

선택 항목¶

IDP¶

• Facebook SDK (Android) v17.0.0
• Facebook SDK (iOS) v17.4.0
• GooglePlay Services-Auth (Android) v20.7.0
• GooglePlay Services-Games v2 (Android) v20.0.0
• Google Sign-In SDK (iOS) v8.0.0
• QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
• QQ (iOS) v3.5.17.3
• 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.2
• Huawei (Android) v6.12.0.300

IAP¶

• Google Billing Library (Android) v7.0.0
• Samsung GalaxyStore IAP (Android) v6.1.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.2.0
• FCM(FirebaseCloudMessaging) (Android) v24.0.2

MARKETING TRACKING ANALYTICS¶

• Airbridge(Android) v4.1.0
• Airbridge(iOS) v4.1.1
• Adjust(Android) v5.0.1
• Adjust(iOS) v5.0.1
• Singular(Android) v12.6.1
• Singular(iOS) v12.6.1
• AppsFlyer(Android) v6.15.2
• AppsFlyer(iOS) v6.15.3
• FirebaseAnalytics(Android) v22.1.2
• FirebaseAnalytics(iOS) v11.6.0

CHAT¶

• OkHttp(Android) v4.12.0

기타¶

• GooglePlay Services-Review (Android) v2.1.0
• GooglePlay Services-AppUpdate (Android) v2.1.0
• Google reCaptcha (Android) v18.6.1
• Google reCaptcha (iOS) v18.6.0
• YoutubeAndroidWebPlayerApi (Android) v1.0.1

새로운 기능¶

• 해당 없음

변경한 기능¶

• 해당 없음

해결한 버그¶

마케팅 어트리뷰션¶

• iOS Adjust v5 가 적용된 Hive SDK v4 25.0.0 이상 사용 시, SDK에서 자동으로 수집하여 전송하는 did, vid 값이 전송되지 않는 오류를 수정합니다.

v4.25.0.0¶

다운로드¶

주의 사항¶

인증 보안 프로토콜 변경으로 Hive SDK v4 Unity 25.0.0 사용 시, 반드시 Hive 콘솔 > 보안 키 설정에서 보안 키를 발급받아야 합니다. 보안 키를 발급받지 않으면, 앱 사용자들은 앱에서 로그인을 할 수 없습니다.

개발 환경¶

Unity (Android)¶

• Unity 2021.3.43f+
• Unity 2022.3.0+
• Unity 2023.1.0+
• Unity 6000.0.0+

targetSDK 버전에 따른 Unity 호환 버전¶

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

• targetSDK 34 빌드 시
  • Unity 2022 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)
  • Unity 2021.3.43f 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)
• targetSDK 35 빌드 시
  • Unity 6000 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)

Unity (iOS)¶

• Unity 2021.3.0+
• Unity 2022.3.0+
• Unity 2023.1.0+
• Unity 6000.0.0+

Android¶

iOS¶

• Xcode 16.1 이상
• Xcode 버전은 Apple App Store 정책에 따라 업데이트해야 합니다.

필수 항목¶

• Kotlin (Android) v1.9.22
• Kotlin Coroutine (Android) 1.4.3
• AndroidX (Android) v1.2.0+
• Constraint Layout (Android) v2.1.4
• Glide (Android) v4.13.0
• SDWebImage (iOS) v5.20.0

선택 항목¶

IDP¶

• Facebook SDK (Android) v17.0.0
• Facebook SDK (iOS) v17.4.0
• GooglePlay Services-Auth (Android) v20.7.0
• GooglePlay Services-Games v2 (Android) v20.0.0
• Google Sign-In SDK (iOS) v8.0.0
• QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
• QQ (iOS) v3.5.17.3
• 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.2
• Huawei (Android) v6.12.0.300

IAP¶

• Google Billing Library (Android) v7.0.0
• Samsung GalaxyStore IAP (Android) v6.1.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.2.0
• FCM(FirebaseCloudMessaging) (Android) v24.0.2

MARKETING TRACKING ANALYTICS¶

• Airbridge(Android) v4.1.0
• Airbridge(iOS) v4.1.1
• Adjust(Android) v5.0.1
• Adjust(iOS) v5.0.1
• Singular(Android) v12.6.1
• Singular(iOS) v12.6.1
• AppsFlyer(Android) v6.15.2
• AppsFlyer(iOS) v6.15.3
• FirebaseAnalytics(Android) v22.1.2
• FirebaseAnalytics(iOS) v11.6.0

CHAT¶

• OkHttp(Android) v4.12.0

기타¶

• GooglePlay Services-Review (Android) v2.1.0
• GooglePlay Services-AppUpdate (Android) v2.1.0
• Google reCaptcha (Android) v18.6.1
• Google reCaptcha (iOS) v18.6.0
• YoutubeAndroidWebPlayerApi (Android) v1.0.1

새로운 기능¶

인증¶

• All 신규 인증 수단(IdP)으로 텔레그램을 지원합니다. Telegram 로그인을 위한 봇 설정을 참고하세요.

빌링¶

• iOS 유저에게 인앱 상품 소비 정보를 Apple App Store로 전송할지 동의 여부를 질의하는 기능을 지원합니다.

마케팅 어트리뷰션¶

• All 마케팅 추적 이벤트 전송 시 Airbridge로 추가 어트리뷰트 전송하기 기능을 신규 지원합니다.
• Android Airbridge 디퍼드 딥링크 추적 기능을 신규 지원합니다.

채팅¶

• All 채팅 기능을 신규 지원합니다.

매치 메이킹¶

• All 매치 메이킹 기능을 업데이트하여 그룹 매치 메이킹 기능을 신규 지원합니다.

  ※ 이전 버전의 Hive SDK 인터페이스와 호환되지 않습니다. 업데이트된 매치 메이킹 기능을 사용하려면 Hive SDK v4 25.0.0 이상을 사용해야 합니다.

변경한 기능¶

플러그인¶

• Unity Hive Config Setting UI를 개선했습니다.

인증¶

• All 더이상 사용하지 않는 Auth 모듈 클래스 및 인터페이스, 메서드, 대리자, 리스너를 삭제합니다
• All JWT 토큰을 사용해 더 강력한 보안 프로토콜을 적용합니다.
• All TalkPlus 지원 종료에 따라 TalkPlus 인증 토큰 메서드를 삭제합니다.
• Android Apple 로그인 웹뷰에서 로그인 기능 이외에 비밀번호 찾기 등과 같은 브라우징을 허용합니다.

프로모션¶

• All 초대 코드를 입력한 유저가 앱을 설치한 경우 보상을 지급할 수 있도록 로그인 이벤트를 수집합니다.

마케팅 어트리뷰션¶

• All Adjust v5를 지원하도록 업데이트합니다.
  • Adjust Signature 라이브러리를 제거합니다.
• All Adjust로 Adiz 광고 매출 집계 시 AdMob 소스로 광고 매출 소스를 전송하도록 변경합니다.
• Android Appsflyer 광고 매출 집계 라이브러리가 메인 라이브러리에 통합된 부분을 반영합니다.
  • 6.14.2 → 6.15.2
  • Appsflyer ad-revenue 라이브러리를 제거합니다.

기타¶

• All 허큘리스 라이브러리 버전을 업데이트합니다.
  • Android: 20241120
  • iOS: 20241120

해결한 버그¶

인증¶

• Android signIn 메서드 실행 중 네트워크 응답 지연이 발생하면 간헐적으로 UI 스레드를 점유하는 문제를 해결합니다.

빌링¶

• iOS UserEngagement를 사용해 인앱 상품 구매를 유도했을 때, IAP_UPDATE 이벤트가 추가로 발생하는 오류를 수정합니다.

알려진 이슈¶

마케팅 어트리뷰션¶

• iOS Adjust를 사용하는 경우 SDK에서 자동으로 수집하여 전송하는 did, vid 값이 전송되지 않는 오류가 있습니다. Hive SDK v4 25.0.1 이상으로 업데이트가 필요합니다.

개발자 가이드 변경 사항¶

• 마케팅 어트리뷰션의 Adjust Signature 라이브러리를 제거로 인해 SDK Signature 연동 방법 변경되었습니다.

개발 환경 업데이트¶

Android¶

• AppsFlyer v6.14.2 → v6.15.2
• Adjust v4.38.5 → v5.0.1
• Singular v12.6.0 → v12.6.1

iOS¶

• Xcode 15.3 → 16.1
  • Xcode 버전의 업데이트로 iOS 최소 타겟이 13으로 상향되었습니다.
• SDWebImage v5.19.7 → v5.20.0
• Facebook v17.1.0 → v17.4.0
• Google Sign-In v7.1.0 → v8.0.0
• LINE v5.10.0 → v5.11.2
• AirBridge v4.1.0 → v4.1.1
• AppsFlyer v6.14.3 → v6.15.3
• Adjust v4.38.4 → v5.0.1
• Singular v12.5.0 → v12.6.1
• Firebase v10.29.0 → v11.6.0

v4.24.5.0¶

다운로드¶

개발 환경¶

Unity (Android)¶

• Unity 2021.3.0+
• Unity 2022.3.0+
• Unity 2023.1.0+
• Unity 6000.0.0+

targetSDK 버전에 따른 Unity 호환 버전¶

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

• targetSDK 33 빌드 시
  • Unity 2021 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)
• targetSDK 34 빌드 시
  • Unity 2022 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)
  • Unity 2021.3.43f 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)
• targetSDK 35 빌드 시
  • Unity 6000 이상 빌드 가능(Unity 내장 JDK 및 Gradle 적용 기준)

Unity (iOS)¶

• Unity 2021.3.0+
• Unity 2022.3.0+
• Unity 2023.1.0+
• Unity 6000.0.0+

Android¶

iOS¶

• Xcode 15.3 이상
• Xcode 버전은 Apple App Store 정책에 따라 업데이트해야 합니다.

필수 항목¶

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

선택 항목¶

IDP¶

• Facebook SDK Android v17.0.0
• Facebook SDK iOS v17.1.0
• 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.17.3
• 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) v7.0.0
• Samsung GalaxyStore IAP (Android) v6.1.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.2.0
• FCM(FirebaseCloudMessaging) (Android) v24.0.2

MARKETING TRACKING ANALYTICS¶

• Airbridge(Android) v4.1.0
• Airbridge(iOS) v4.1.0
• Adjust(Android) v4.38.5
• adjust-android-signature-3.20.1.aar
• Adjust(iOS) v4.38.4
• AdjustSigSdk 3.20.1
• Singular(Android) v12.6.0
• Singular(iOS) v12.5.0
• AppsFlyer(Android) v6.14.2
• AppsFlyer(iOS) v6.15.3
• FirebaseAnalytics(Android) v22.1.2
• FirebaseAnalytics(iOS) v10.29.0

기타¶

• GooglePlay Services-Review (Android) v2.1.0
• GooglePlay Services-AppUpdate (Android) v2.1.0
• Google reCaptcha (Android) v18.6.1
• Google reCaptcha (iOS) v18.6.0
• YoutubeAndroidWebPlayerApi (Android) v1.0.1

새로운 기능¶

Unity¶

• Unity Unity 6(Unity 6000)을 지원합니다.

인증¶

• All 인증 수단으로 Steam, X(구 Twitter)를 새롭게 지원합니다.
  • 사전 준비: 공통
  • 사전 준비: Android
  • 사전 준비: iOS
  • 브랜딩 가이드
• All 인증된 세션을 공유하는 인웹브라우징 기능을 제공합니다.

매치 메이킹¶

• All 신규 기능으로 매치 메이킹 서비스를 지원합니다.

프로모션¶

• All 스팟 배너에서도 광고 노출이 가능합니다.
• Android 사용자 초대 공유하기 기능에 X(구 Twitter)를 지원합니다.

변경한 기능¶

플러그인¶

• Unity 제공하는 EDM4U의 최신버전을 적용합니다.
  • 1.2.178 → 1.2.183
• Unity GameCenter 로그인을 사용하는 경우 빌드에 필요한 Entitlement 설정값을 자동으로 추가하도록 변경합니다.
  • 기존에는 GameCenter 로그인을 사용하더라도 Capability Manger 설정을 추가로 진행해야 했습니다.
  • Entitlement 설정값이 없는 경우 iOS 18 이상의 기기에서 정상적으로 로그인이 진행되지 않습니다.

인증¶

• All 충돌 팝업에서 노출하는 Provider 이름을 수정합니다.

해결한 버그¶

플러그인¶

• Unity 일부 외부 플러그인과 컴파일 오류를 발생시키는 인터페이스의 중복을 회피하도록 명시적 네임 스페이스를 사용합니다.
• Unity Firebase 마케팅 추적 도구 또는 Huawei 인증 기능 사용시 Android 타겟 플랫폼에서 필요한 설정이 누락되는 오류(SDK v4 24.3.0 이상에서 발생)를 수정합니다.

빌링¶

• iOS 일부 상품 가격이 부동 소수점으로 정확히 표현할 수 없는 가격일 때, 이 값을 JSON 포맷에서 순환 소수로 표현하지 않고 정확한 소수점으로 표현하도록 수정합니다.
  • 예> 4.99$ (string) → 4.9900000000000011 (double) → 4.99 (JSON number)

개발자 가이드 변경 사항¶

• 크로스 프로모션 전면 배너 노출에서 showCustomContents 메서드로 스팟 배너 노출 시 주의 사항을 노트에 업데이트했습니다.
• iOS에서 Steam 로그인 사용 시 주의사항을 노트로 추가했습니다.

개발 환경 업데이트¶

Android¶

• Google reCaptcha 18.4.0 → 18.6.1
• Kotlin 1.8.0 → 1.9.22
• FCM(FirebaseCloudMessaging) 23.2.1 → 24.0.2
• AppsFlyer 6.13.0 → 6.14.2
• Singular 12.5.4 → 12.6.0
• Firebase 21.5.0 → 22.1.2

iOS¶

• SDWebImage 5.18.7 → 5.19.7
• reCaptcha 18.4.0 → 18.6.0
• Facebook 17.0.2 → 17.1.0
• QQ 3.5.16 → 3.5.17 (커스텀)
• AppsFlyer 6.14.3 → 6.15.3
• Singular 12.4.1 → 12.5.0
• Firebase 10.22.0 → 10.29.0

v4.24.4.0¶

다운로드¶

개발 환경¶

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¶

iOS¶

• Xcode 15.3 이상
• Xcode 버전은 Apple App Store 정책에 따라 업데이트해야 합니다.

필수 항목¶

• 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 v17.0.2
• 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) v7.0.0
• Samsung GalaxyStore IAP (Android) v6.1.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.2.0
• FCM(FirebaseCloudMessaging) (Android) v23.2.1

MARKETING TRACKING ANALYTICS¶

• Airbridge(Android) v4.1.0
• Airbridge(iOS) v4.1.0
• Adjust(Android) v4.38.5
• adjust-android-signature-3.20.1.aar
• Adjust(iOS) v4.38.4
• AdjustSigSdk 3.20.1
• 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

새로운 기능¶

마케팅 어트리뷰션¶

• All Hive SDK에 특화된 서비스로 Airbridge를 지원합니다.
  • Airbridge로 이벤트 자동으로 추적하기
  • Airbridge로 이벤트 수동으로 추적하기

빌링¶

• Android PG를 통한 결제 시, 단일 상품을 원하는 수량만큼 구매할 수 있는 기능을 제공합니다.

변경한 기능¶

플러그인¶

• Unity Android의 Package Name 또는 iOS의 Bundle Name이 자동으로 설정되는 기능이 Hive AppId를 통해 선택적으로 동작하도록 변경합니다.

해결한 버그¶

분석¶

• iOS 동의배너 선택지 하나만 선택한 경우 올바르게 반영되지 않는 오류를 수정합니다.

개발 환경 업데이트¶

Android¶

• N/A

iOS¶

• Xcode 15 → 15.3

v4.24.3.0¶

다운로드¶

개발 환경¶

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¶

iOS¶

• Xcode 15 이상
• Xcode 버전은 Apple App Store 정책에 따라 업데이트해야 합니다.

필수 항목¶

• 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 v17.0.2
• 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) v7.0.0
• Samsung GalaxyStore IAP (Android) v6.1.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.2.0
• FCM(FirebaseCloudMessaging) (Android) v23.2.1

MARKETING TRACKING ANALYTICS¶

• Adjust(Android) v4.38.5
• adjust-android-signature-3.20.1.aar
• Adjust(iOS) v4.38.4
• AdjustSigSdk 3.20.1
• 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

새로운 기능¶

프로비저닝¶

• All 약관 화면에서 법정 대리인 동의를 받았는지 확인하는 기능을 추가합니다.

변경한 기능¶

플러그인¶

• Unity Hive External Dependency Manager로 관리하는 XML 파일 개수를 최소화합니다.

인증¶

• All 로그아웃 동작을 변경합니다.
  • 기존: signOut 호출 시 Hive SDK에서 사용자 계정을 로그아웃
  게스트는 signOut APi 호출 시 서버에서 실패 응답
  • 변경: signOut 호출 시 Hive SDK는 Hive 서버에 사용자 계정을 로그아웃시켜도 되는지 확인 요청 후 응답 결과에 따라 로그아웃
• All 게스트 계정 로그아웃 시 더는 성공 응답을 반환하지 않고, 에러 코드를 반환합니다. Hive SDK와 Hive 서버에서 게스트 계정 세션을 유지합니다.
• All 이용 정지 계정은 자동으로 IdP 로그아웃을 시켜서 동일 IdP 다른 계정으로 로그인할 수 있도록 변경합니다. 자동 로그인을 할 수 없는 경우에만 해당합니다.
• All AuthV4.connect 메서드로 IdP 연동을 진행할 때, 이용 정지 계정으로 계정을 전환하면, 로그아웃을 수행하도록 변경합니다.
• All 기기 관리 서비스에서 국제 전화 국가 번호를 기기 접속 지역에 따라 자동으로 적용하도록 변경합니다.
• iOS 앱 추적 투명화(ATT) 동의를 거절한 경우에도 페이스북 로그인을 할 수 있도록 변경합니다.

프로모션¶

• All additionalInfo로 전송하는 값에 불 필요한 정보가 담기지 않도록 수정합니다.
• All 2:3 또는 3:2 비율로 전면 배너를 노출할 수 있도록 변경합니다.
• All 전면 배너에서 "1일 동안 그만 보기" 텍스트를 "오늘은 그만 보기"로 변경합니다.

마케팅 어트리뷰션¶

• All Adjust Signature 버전을 v1 에서 v3로 변경합니다.

해결한 버그¶

Hive SDK 공통¶

• Android 리소스 참조 로직을 수정하여 메모리를 확보하지 못했던 오류를 수정합니다.
• iOS iOS 14 기기에서 앱 추적 투명화(ATT) 동의 여부를 확인할 때 간헐적으로 크래시가 발생하는 오류를 수정합니다.
• iOS 사진첩에서 접근 제한(일부 사진만 접근 허용)을 선택하면 크래시가 발생하는 오류를 수정합니다.

노티피케이션¶

• Android 로컬 푸시 알림에서 지원하지 않는 type 설정 시 푸시 메시지가 정상 노출되지 않는 오류를 수정합니다.
• iOS 앱 버전 정보를 전송하도록 수정합니다.

개발 환경 업데이트¶

Android¶

• Google Play Billing Library 6.1 → 7.0
• Google Play Service Games 20.0.0 → 20.1.2

iOS¶

• Facebook SDK 16.2.1 → 17.0.2

개발자 가이드 변경점¶

• 커스터마이징한 로컬 푸시 알림에서 type 필드 안내를 변경했습니다.
• "대배너" 용어를 "전면 배너"로 변경했습니다.
• Android Life Cycle에서 더는 사용하지 않는 `attachBaseContext` 예제 코드를 삭제했습니다.
• 법정대리인 동의 여부 확인을 `Configuration.getLegalGuardianConsentAgree`로 수행할 수 있음을 안내합니다.
• 이용 제한 계정이 있을 때 IdP 연동 안내를 추가했습니다.
• Hive SDK Unity를 수동 업데이트 또는 수동 설치했을 때, 앱 빌드 전에 XML 파일들을 삭제해야 합니다.

v4.24.2.0 (2024-07-05)¶

새로운 기능¶

Hive SDK 공통¶

• All GDPR을 적용하는 EU 및 EEA 지역에서 16세 미만 유저가 약관에 동의했는지 여부를 반환하는 기능을 제공합니다. 16세 미만 여부를 확인할 수 있습니다.
• Android Android OS 11 이상 기기 또는 지원하는 모듈을 설치한 기기에서 사진첩을 사용할 때 PhotoPicker를 기본으로 사용합니다.
• iOS MacOS 콘솔 앱에서도 Hive SDK 디버그 로그를 확인할 수 있으며, Hive SDK 로그중 특정 로그 타입을 선택해서 볼 수 있습니다.

Unity¶

• All Unity Editor에서 Hive SDK 디버그 로그 노출을 제어하는 기능을 제공합니다.

인증¶

• All휴대폰 번호 1개로 가입 가능한 계정 수를 초과했을 때, 인증 번호 발송을 요청하면 "같은 휴대폰 번호로 생성할 수 있는 계정 수를 초과했습니다."라는 에러 메시지를 표시합니다.

프로모션¶

• All 크로스 프로모션의 노출을 제어할 수 있는 기능을 제공합니다.
• All 오늘은 그만보기 기능을 개선한 N일 동안 그만보기를 지원합니다.

변경한 기능¶

노티피케이션¶

• Android Amazon 신규 Fire 기기에서 동작하는 런타임 라이브러리(Push Amazon Device Message 1.2.0)에 대응합니다.

프로모션¶

• iOS 게임 초대(UA) 기능 사용 시 클립보드 붙여넣기 권한 동의 팝업 노출을 최소화하여 사용성을 개선합니다.
  1. 권한 동의 팝업을 노출하는 시점을 초대받은 사용자가 앱을 실행하자마자에서 앱 실행 후 Hive SDK 초기화하는 시점으로 변경했습니다.
  2. 클립보드에 초대자 URL 데이터가 존재할 때에만 팝업을 노출하도록 변경했습니다.

애널리틱스¶

• iOS 앱에서 크래시 발생 시 미전송 로그를 파일에 저장하는 옵션인 saveAnalyticsLogBeforeCrash 설정값 기본값을 false로 변경합니다.

해결한 버그¶

인증¶

• All 중국에서 접속한 사용자에 대한 실명 인증 과정에서 문자 발송 회수 초과 시 남은 시간을 초기화하지 않고 오류 메시지를 노출하도록 수정합니다.
• Android Google Play 로그인 진행 중 뒤로가기 키를 누름으로써 로그인을 하지 않은 경우, 적절한 응답 콜백이 없었던 오류를 수정합니다.
• Android 낮은 해상도 기기에서 키보드 입력을 수행할 수 없었던 오류를 수정합니다.

프로모션¶

• iOS 새소식 뷰에서 새로운 프레임 뷰 노출하기 동작 시 프리징이 발생하는 오류를 수정합니다.

마케팅 어트리뷰션¶

• Android 커스터마이징한 약관으로 초기화 수행 시 Adjust 이벤트 발송이 지연되는 오류를 수정합니다.

개발 환경 업데이트¶

Android¶

• Samsung GalaxyStore IAP 6.1 → 6.1.1
• Amazon Device Message 1.0.1 → 1.2.0

iOS¶

• N/A

개발자 가이드 변경점¶

• Hive SDK v4 24.2.0부터 Facebook Cloud Games 지원을 중단함에 따라 아래 페이지들에 해당 내용을 추가했습니다.
  • Unity 설정하기
  • Unity 설정하기 > Facebook Cloud Games 설정
  • Android 설정하기
  • 빌링
  • 노티피케이션
• Hive 러비 상점 선택 화면에 관한 설명을 보강했습니다.

v4.24.1.2 (2024-06-27)¶

해결한 버그¶

인증¶

• Android 구글 로그인 진행중 뒤로가기 버튼을 눌러 로그인을 취소했을 때 적절한 응답 콜백이 없었던 오류를 수정합니다. 이 버그는 Hive 콘솔 내에 Google Legacy Support 값이 참인 경우에만 발생했습니다.
• Android 낮은 해상도 기기에서 키보드 입력을 할 수 없었던 오류를 수정합니다.

v4.24.1.0 (2024-05-14)¶

새로운 기능¶

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 인증키로 게스트 계정 playerId와 playerToken 실제 값을 불러오도록 변경했습니다. 샌드박스 서버에 있는 값들을 사용하므로 검증 API 호출(Authorization과 player_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 기본 동작을 위한 필수 적용 프레임워크에서 HiveAppTrackingTransparency와 HiveResource를 제거했습니다.