v4.24.0.0
다운로드
Android | |
---|---|
다운로드 | – |
배포일 | 2024-04-30 |
개발 환경
Gradle | Android Gradle Plugin | Kotlin Gradle Plugin |
---|---|---|
v7.5 | v7.4.2 | v1.8.0 |
새로운 기능
프로모션
- 외부 페이지 노출을 위해 기기에 설정된 기본 브라우저를 이용하는 커스텀 탭을 지원합니다.
PlatformHelper
클래스showInAppBrowser
메서드로 인앱 브라우저를 노출할 수 있습니다.
변경한 기능
빌링
- 환불 유저 재결제 UI에서 노출되는 PG 결제 타입 문구를 “HiveStore”에서 “PG 결제”로 변경했습니다.
- PG 결제 페이지를 인앱 브라우저가 아니라 인앱 웹뷰에서 노출하도록 변경합니다. 인앱 브라우저 환경을 지원하지 않는 기기에서도 PG 결제를 지원합니다.
애널리틱스
- Firebase 이벤트 수집 기능 중 광고 식별자 수집 설정 기본값을
true
로 변경합니다.
개발 환경 업데이트
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
개발자 가이드 변경점
v4.23.4.0 (2024-04-11)
새로운 기능
애널리틱스
- EU 및 EEA지역의 DMA 규정에 따라 개인정보 수집 동의배너 노출 기능을 지원합니다.
- MarketTrackingTool을 하나 이상 사용하고, EU 및 EEA 지역에 마케팅을 수행하는 경우 해당 기능을 적용해야 합니다.
- 14개월마다 재동의 요청이 필요하며, 앱에서 설정한 개월 수를 초과하는 경우 재동의 배너를 노출합니다.
- 사용자가 수시로 동의 철회를 할 수 있도록 필요할 때마다 동의 배너를 다시 노출할 수 있습니다.
변경한 기능
외부 라이브러리 업데이트
- GDPR DMA에 대응하는 라이브러리로 업데이트 합니다:
- Adjust 4.38.1 → 4.38.2
- AppsFlyer 6.12.3 → 6.13.0
- Singular 12.3.0 → 12.5.4
푸시&알림
- FCM 적용에 사용하는 Google API Key 값을 인코딩하여 사용하도록 변경합니다.
공통
- PG결제를 위해 제공한 CustomTab의 호환성을 개선하도록 사용하는 라이브러리 버전을 변경합니다
- androidx.browser 1.7.0 → 1.5.0
- androidx.browser 1.7.0 은 Android Target 34부터 사용이 가능하며, Unity 2021 버전에서 사용이 불가능합니다.
해결한 버그
챗봇
- 챗봇 메시지를 입력하는 경우 웹뷰가 리사이즈 되지 않는 오류를 수정합니다.
공통
- 네트워크 상태 모니터링 동작 수행시, 간헐적으로 크래시가 발생하는 오류를 수정합니다.
개발자 가이드 변경점
- 애널리틱스 동의배너 노출하기 가이드를 새로 추가했습니다.
v4.23.3.0 (2024-03-26)
새로운 기능
빌링
- 모바일 환경에서도 PG 결제를 지원합니다.
변경한 기능
인증
- reCaptcha 라이브러리 버전을 업데이트했습니다: 18.2.1 → 18.4.0
마케팅 어트리뷰션
- Adjust 라이브러리 버전을 업데이트했습니다: 4.35.1 → 4.38.1
해결한 버그
인증
- 본인 인증 화면 문제를 수정했습니다.
개발자 가이드 변경점
- 모듈 수준 build.gradle 파일에 입력할 내용으로
com.com2us.android.hive:hive-iapv4-market-hivestore
를 추가했습니다.
v4.23.2.0 (2024-03-26)
새로운 기능
프로모션
- 게임 초대 메세지와 초대 링크를 소셜 미디어로 공유 시, 사용하지 않을 SNS를 지정하는 기능을 추가했습니다.
unsupportedUAShareType
요소를 참고하세요.
변경한 기능
마케팅 어트리뷰션
- Firebase Analytics 라이브러리 버전을 업데이트했습니다: 21.3.0 → 21.5.0
v4.23.1.0 (2024-02-01)
새로운 기능
인증
- 기기를 네트워크에 연결할 수 없을 때, 오프라인 모드로 자동 로그인을 지원합니다.
애널리틱스
- 동시 접속자 현황 로그 전송을 Hive 콘솔 설정에 따라 활성/비활성화할 수 있는 기능을 제공합니다.
- 로그 정의: hive_concurrent_user_log
- 게임별 지표, 종합 지표
변경한 기능
Hive SDK 공통
- 기기를 네트워크에 연결할 수 없을 때, 네트워크 연결이 필요한 Hive SDK 기능을 다시 실행하려고 시도하지 않습니다.
애널리틱스
- 기기를 네트워크에 연결할 수 없을 때, 애널리틱스 로그를 다시 전송하려고 시도하지 않습니다.
알려진 문제점
이 Hive SDK 버전 배포 시 알려진 문제점은 없습니다.
v4.23.0.0 (2024-01-30)
변경한 기능
Hive SDK 공통
- Java Enum 인터페이스 ResultAPI 클래스 접근자를 변경합니다. 아래 예시를 참고하세요.
- 기존:
ResultAPI.Companion.getSUCCESS()
만 지원 - 변경:
ResultAPI.Companion.getSUCCESS()
와ResultAPI.SUCCESS
모두 지원
- 기존:
- Java에서 인스턴스 메서드 스타일과 클래스 메서드 스타일을 모두 지원합니다. 아래 예시를 참고하세요.
- 기존:
IAPV4.INSTANCE.getProductInfo
만 지원 - 변경:
IAPV4.INSTANCE.getProductInfo
와IAPV4.getProductInfo
모두 지원
- 기존:
- Z-Flip 5 전면 디스플레이에서 1:1 문의, 챗봇, 성인인증 창이 화면 범위를 넘어가지 않도록 수정합니다.
인증
- 기기 관리, 중국 실명 인증 등에서 고객이 문자 인증 시 문자 입력 제한 시간 내에 문자를 입력하지 않으면 전송 버튼을 비활성화합니다.
- 각 IDP를 라이브러리로 분리하여 선택 적용할 수 있도록 변경합니다. 다음 라이브러리들을 추가적으로 선택 적용할 수 있습니다.
- Apple Sign-In
- Weverse
- Hive 멤버십
- Google Play Games 로그인 시 Hive 서버에서 직접 확인한 로그인 정보만 신뢰하도록 변경하여
AuthV4ServerResponseError
가 발생하는 케이스 일부를 해결했습니다.
프로모션
- 새소식 또는 대배너 둘 중 하나만 화면에 나타나도록 변경합니다. 먼저 호출한 창만 나타나며, 나중에 호출한 창은 나타나지 않습니다.
- UA 캠패인 정보에
campaignId
를 포함하여 전달합니다.
빌링
- IAPv2 인터페이스와 기능을 더는 지원하지 않습니다.
- 지연 구매(Pending Purchase)가 있었을 때, 지연된 구매 결과가 현재 진행중인 결제에 영향을 미치지 않도록 변경합니다.
프로비저닝
- 계정 기반으로 약관을 노출하는 기능을 추가합니다.
허큘리스
- Hercules 라이브러리 버전을 업데이트 합니다.
- Android: 20231122
- iOS: 20231116
해결한 버그
인증
- 이용 제한 팝업을 포르투갈어로 노출 시 버튼이 잘못 노출되는 문제를 수정합니다.
프로모션
- 게임 종료 팝업 노출 시 앱을 포그라운드 > 백그라운드 > 다시 포그라운드 상태로 변경하면 줄바꿈이 정상 동작하지 않는 오류를 수정합니다.
노티피케이션
- 앱을 다시 실행하면 노출할 푸시 메세지들을 불러오는 과정에서 문제가 발생해 푸시 내용이 보이지 않는 문제를 수정합니다.
애널리틱스
- 동시 접속자 로그 전송에서 국가 코드 전송 시 알 수 없는 국가에 대한 국가코드를
Unknown
에서 공백 문자(Space) 2개로 변경합니다.
알려진 문제점
이 Hive SDK 버전 배포 시 알려진 문제점은 없습니다.
개발자 가이드 변경점
공통
- COPPA ageGateU13을 직접 설정할 수 있는 값으로 변경했습니다.
- hive_config.xml 예제를 업데이트했습니다.
- 지원하지 않는 IdP인 WEIBO 관련 내용을 제거합니다.
- Unity에서 허큘리스 사용, 제거 관련 내용을 업데이트했습니다.
- 인앱 업데이트 설명을 수정했습니다.
Android
- Gradle, Android Gradle Plugin, Kotlin Gradle Plugin 최소 버전을 추가했습니다.
- Hive SDK 기능들이 내부적으로 별도 라이브러리로 분리됨에 따라, Android Gradle 파일 내용이 변경되었습니다.
- WeChat Auth를 SDK에서 자동으로 추가함에 따라 AndroidManifest.xml 설정하기에서 관련 내용을 삭제했습니다. 또 Hive에서 FOREGROUND SERVICE를 직접 사용하지 않음에 따라 관련 내용을 삭제했습니다.
- Facebook Cloud Game 빌드 설정하기에서 build.gradle에 필요한 라이브러리 설정 내용을 변경했습니다.
- Firebase Analytics 추가하기에서 모듈 수준의 build.gradle 파일 내용을 변경했습니다.
- 화웨이 빌드 설정 추가하기를 업데이트했습니다.
- Google Play Games on PC 빌드 설정하기에서 build.gradle에 필요한 라이브러리 설정 내용을 변경했습니다.
- 일반 구글 로그인 지원에서 모듈 수준 build.gradle 파일 내용을 변경했습니다.
- Unity Android 외부 라이브러리 의존성 설정하기를 업데이트했습니다.
- Unity Android Facebook Cloud Game 빌드, Google Play Games on PC 빌드를 설정하는 방법이 변경되었습니다.
- ONE Store 버전이 21.01.00으로 올라감에 따라 설명을 수정했습니다.
v4.22.0.4 (2023-11-30)
변경한 기능
Hive SDK 공통
- Google Play Games 로그인 시 Hive SDK 인증 로직을 개선했습니다.
알려진 문제점
이 Hive SDK 버전 배포 시 알려진 문제점은 없습니다.
v4.22.0.2 (2023-11-08)
변경한 기능
결제
- ONE Store 글로벌 버전을 지원하는 OneStore Iap v21.00.02를 제공합니다.
해결한 버그
애널리틱스
- Singular 마케팅 분석 도구 이용 시 매출 이벤트를 정상적으로 분석하지 못했던 오류를 수정합니다.
알려진 문제점
이 Hive SDK 버전 배포 시 알려진 문제점은 없습니다.
v4.22.0.0 (2023-09-15)
새로운 기능
애널리틱스
- 마케팅 추적 도구인 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 섹션으로 통합되었습니다.
v4.21.1.4 (2023-11-30)
다운로드
Android | |
---|---|
다운로드 | Hive SDK v4 Android 21.1.4 |
배포일 | 2023-11-30 |
변경한 기능
Hive SDK 공통
- Google Play Games 로그인 시 Hive SDK 인증 로직을 개선했습니다.
알려진 문제점
이 Hive SDK 버전 배포 시 알려진 문제점은 없습니다.
v4.21.1.3 (2023-11-08)
해결한 버그
애널리틱스
- Singular 마케팅 분석 도구 이용 시 매출 이벤트를 정상적으로 분석하지 못했던 오류를 수정합니다.
알려진 문제점
이 Hive SDK 버전 배포 시 알려진 문제점은 없습니다.