iOS

v4.22.0.2

다운로드

	iOS
다운로드	Hive SDK v4 iOS 22.0.2
배포일	2023-11-07

개발 환경

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

외부 라이브러리

필수 항목

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

해결한 버그

결제

구독 상품을 restoreSubscription으로 복구하려고 할 때, 구독한 상품이 없는 경우 NOT_OWNEND 응답 콜백을 수신하지 못하는 오류를 수정합니다.

애널리틱스

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

알려진 문제점

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

v4.22.0.0

새로운 기능

애널리틱스

마케팅 추적 도구인 Singular, Adjust, AppsFlyer, Firebase에서 광고 매출을 포함한 광고 노출 정보를 수집(Analytics.sendAdRevenueEvent)할 수 있습니다. 이 기능을 사용하려면 먼저 Podfile 파일을 Hive SDK 4.22.0 버전에 맞게 업데이트해야 합니다.

인증

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

변경한 기능

Hive SDK 공통

앱 설정에 따라 회전을 지원하였던 UI를 hive_config.xml에 설정한 HiveOrientation값에 따라 회전하도록 변경합니다. Hive SDK가 제공하는 모든 UI에서 화면 회전을 지원합니다.
팝업 UI, 리뷰 UI 등에서 닫기 버튼(X 버튼)을 다이얼로그 내부로 이동합니다.
게임 서비스 종료 후 Hive SDK 초기화를 시도하면 에러 코드를 반환합니다.

인증

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

빌링

Amazon 마켓과 Apple App Store에서 결제 시 지연 구매(Pending Purchase) 기능을 지원합니다.
- UserEngagement 전역 콜백 핸들러 선언 예제 코드가 변경되었습니다. IAP_UPDATED 이벤트 EventEnd 콜백 코드가 변경되었으며, Amazon 마켓과 Apple App Store에서 결제 시 지연 결제 기능을 제공하려면 이 코드 변경을 먼저 적용해야 합니다.

마케팅 어트리뷰션

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

커뮤니티

커뮤니티 시작 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개 이상을 가진 점검 팝업도 커스터마이징할 수 있도록 수정합니다.

마케팅 어트리뷰션

AppsFlyer로 구매 이벤트 전송 시 잘못된 키로 부가 정보를 보내는 오류를 수정합니다.
- custsom_product_id → custom_product_id

알려진 문제점

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

개발자 가이드 변경점

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

v4.21.1.3

다운로드

	iOS
다운로드	Hive SDK v4 iOS 21.1.3
배포일	2023-11-07

해결한 버그

결제

구독 상품을 restoreSubscription으로 복구하려고 할 때, 구독한 상품이 없는 경우 NOT_OWNEND 응답 콜백을 수신하지 못하는 오류를 수정합니다.

애널리틱스

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

알려진 문제점

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