Android

v4.22.0.4

다운로드

	Android
다운로드	Hive SDK v4 Android 22.0.4
배포일	2023-11-30

개발 환경

Gradle	Android Gradle Plugin	Kotlin Gradle Plugin
v6.1.1	v4.0.0	v1.6.20

외부 라이브러리

필수 항목

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

선택 항목

IDP

Facebook SDK Android v13.0.0
Facebook SDK iOS v14.1.0 (iOS 11+ 이상 지원)
Facebook SDK iOS v16.0.0 (iOS 12+ 이상 지원)
GooglePlay Services-Auth (Android) v17.0.0
GooglePlay Services-Games v2 (Android) v17.0.0
Google Sign-In SDK (iOS) v6.2.4
QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
QQ (iOS) v3.5.12
VK (Android) v3.5.1
VK (iOS) v1.6.3
WeChat (Android) v6.8.0
WeChat (iOS) v1.9.6
LINE (Android) v5.7.0
LINE (iOS) v5.8.2
Huawei (Android) v6.7.0.300

IAP

Google Billing Library (Android) v6.0.1
OneStore (Android) v21.00.02
WeChat (Android) v6.8.0
Amazon (Android) v3.0.4
Huawei (Android) v6.3.0.300

PUSH

Amazon (Android) v1.0.1
FCM(FirebaseCloudMessaging) (Android) v23.1.2

MARKETING TRACKING ANALYTICS

Adjust(Android) v4.32.0
Adjust(iOS) v4.33.3
Singular(Android) v12.0.8
Singular(iOS) v12.0.1
AppsFlyer(Android) v6.12.2
AppsFlyer(iOS) v6.12.1
FirebaseAnalytics(Android) v21.3.0
FirebaseAnalytics(iOS) v10.4.0

기타

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

변경한 기능

Hive SDK 공통

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

알려진 문제점

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

v4.22.0.2

변경한 기능

결제

ONE Store 글로벌 버전을 지원하는 OneStore Iap v21.00.02를 제공합니다.

해결한 버그

애널리틱스

Singular 마케팅 분석 도구 이용 시 매출 이벤트를 정상적으로 분석하지 못했던 오류를 수정합니다.

알려진 문제점

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

v4.22.0.0

새로운 기능

애널리틱스

마케팅 추적 도구인 Singular, Adjust, AppsFlyer, Firebase에서 광고 매출을 포함한 광고 노출 정보를 수집(Analytics.sendAdRevenueEvent)할 수 있습니다. AppsFlyer에 광고 노출 정보를 전송하려면 모듈 수준의 build.gradle 파일에 com.appsflyer:adrevenue를 추가해야 합니다.

프로비저닝

인앱 업데이트 기능을 제공합니다.

인증

약관 동의 내역을 초기화할 수 있는 메서드를 추가합니다. resetAgreement() 메서드를 호출하여 약관 동의 내역을 초기화할 수 있습니다.

변경한 기능

Hive SDK 공통

Android OS 10 이상 기기에서 PlatformHelper 클래스 share 메서드 사용 시, 서식이 있는 텍스트 미리보기를 지원합니다.
Android OS 14 이상 기기에서 PlatformHelper 클래스 share 메서드 사용 시, 미디어(이미지 등) 미리보기를 지원합니다.
팝업 UI, 리뷰 UI 등에서 닫기 버튼(X 버튼)을 다이얼로그 내부로 이동합니다.
게임 서비스 종료 후 Hive SDK 초기화를 시도하면 에러 코드를 반환합니다.

인증

점검, 성인 인증, 약관 등 모든 인증 팝업에서 실시간 화면 회전을 지원합니다.
기기 관리 기능 사용 시 노출하는 문구를 변경합니다.
- 기기 관리 서비스 사용을 권장하는 문구가 추가됩니다.
- 기기 관리 기능 사용중 문자 인증 과정에서 이전 단계로 이동하는 ‘닫기’버튼을 추가합니다.
중국에서 접속하는 유저가 실명 인증을 진행할 때 노출하는 고객센터 링크 URL을 제거합니다.
게임 서비스를 종료하면 더는 로그인과 PlayerID 생성이 불가능하며, 로그인 시도 시 게임 서비스 종료에 따른 에러 코드를 반환합니다.

빌링

Amazon 마켓과 Apple App Store에서 결제 시 지연 구매(Pending Purchase) 기능을 지원합니다.
- UserEngagement 전역 콜백 핸들러 선언 예제 코드가 변경되었습니다. IAP_UPDATED 이벤트 EventEnd 콜백 코드가 변경되었으며, Amazon 마켓과 Apple App Store에서 결제 시 지연 결제 기능을 제공하려면 이 코드 변경을 먼저 적용해야 합니다.
Android OS 14 타겟 빌드를 지원하는 Google Billing Library 6.0.1을 적용합니다. 아래와 같이 사용 버전을 변경해야 합니다.
- v5.0.0 → v6.0.1

노티피케이션

지원하는 FCM(Firebase Cloud Messaging) 버전이 변경되었습니다. 아래와 같이 사용 버전을 변경해야 합니다.
- v20.2.4 → v23.1.2

마케팅 어트리뷰션

Adjust 사용 시 이미 설치된 앱을 실행할 수 있는 딥링크를 제공합니다. 또 유저가 딥링크를 클릭해 이미 설치된 앱을 실행할 때 Adjust 어트리뷰션과 리어트리뷰션 추적 기능을 제공합니다.
AppsFlyer 라이브러리를 최신 버전으로 변경합니다.
- 이전 버전: v6.9.2
- 변경 버전: v6.12.2

커뮤니티

커뮤니티 시작 URL에 포함된 도메인을 도메인 화이트리스트에 포함합니다. 예를 들어, 제노니아 커뮤니티의 시작 URL이 “https://www.zenonia.co.kr/ko/board/6″이라면, “https://www.zenonia.co.kr”은 화이트리스트에 포함합니다. 화이트리스트에 포함된 도메인은 JavaScript 코드 실행을 허용하고 POST 방식 REST API 요청을 수신할 수 있습니다.

해결한 버그

Hive SDK 공통

외부 라이브러리가 없을 때 Unknown 또는 응답 없음 에러 코드가 아닌 별도 에러코드를 제공합니다.
대용량 로그출력 시 순간적으로 지나치게 많은 메모리를 사용했던 오류를 수정합니다.

인증

AuthV4Helper 클래스로 묵시적 로그인 기능을 제공할 때 제재받은 계정으로 로그인하면 Invalid Session으로 잘못 전송했던 오류 코드를 Need Exit으로 수정합니다.
버튼 2개 이상을 가진 점검 팝업도 커스터마이징할 수 있도록 수정합니다.

노티피케이션

간헐적으로 내용이 없는 로컬 푸시를 노출하는 오류를 수정합니다.

알려진 문제점

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

개발자 가이드 변경점

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

v4.21.1.4

다운로드

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

변경한 기능

Hive SDK 공통

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

알려진 문제점

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

v4.21.1.3

해결한 버그

애널리틱스

Singular 마케팅 분석 도구 이용 시 매출 이벤트를 정상적으로 분석하지 못했던 오류를 수정합니다.

알려진 문제점

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