v4.22.0 (2023-09-26)
다운로드
Hive SDK v4 Android 22.0.0
개발 환경
Gradle | Android Gradle Plugin | Kotlin Gradle Plugin |
---|---|---|
v6.1.1 | v4.0.0 | v1.6.20 |
새로운 기능
애널리틱스
- 마케팅 추적 도구인 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에서 결제 시 지연 결제 기능을 제공하려면 이 코드 변경을 먼저 적용해야 합니다.
- UserEngagement 전역 콜백 핸들러 선언 예제 코드가 변경되었습니다.
- 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 섹션으로 통합되었습니다.