iOS

v4.24.0.0

다운로드

	iOS
다운로드	–
배포일	2024-04-30

개발 환경

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.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.14
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) v6.0.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.0.1
FCM(FirebaseCloudMessaging) (Android) v23.2.1

MARKETING TRACKING ANALYTICS

Adjust(Android) v4.38.2
Adjust(iOS) v4.38.0
Singular(Android) v12.5.4
Singular(iOS) v12.4.1
AppsFlyer(Android) v6.13.0
AppsFlyer(iOS) v6.13.1
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

새로운 기능

프로모션

외부 페이지 노출을 위해 브라우저를 이용하는 SafariViewController를 지원합니다. PlatformHelper 클래스 showInAppBrowser 메서드로 인앱 브라우저를 노출할 수 있습니다.

빌링

첫 구독 할인 정보가 있는 경우 상품 정보 조회 시 함께 전달합니다. getProductInfo 사용 시 콜백으로 받는 IAPV4Product 객체 목록에서 original_price 필드값과 price 필드값의 차이로 할인 정보를 확인할 수 있습니다.

변경한 기능

Hive SDK 공통

앱 버전을 구분할 때 CFBundleShortVersionString을 추가로 사용합니다.

빌링

환불 유저 재결제 UI에서 노출되는 PG 결제 타입 문구를 “HiveStore”에서 “PG 결제”로 변경했습니다.

개발 환경 업데이트

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를 제거했습니다.

v4.23.4.0 (2024-04-11)

새로운 기능

애널리틱스

EU 및 EEA지역의 DMA 규정에 따라 개인정보 수집 동의배너 노출 기능을 지원합니다.
- MarketTrackingTool을 하나 이상 사용하고, EU 및 EEA 지역에 마케팅을 수행하는 경우 해당 기능을 적용해야 합니다.
- 14개월마다 재동의 요청이 필요하며, 앱에서 설정한 개월 수를 초과하는 경우 재동의 배너를 노출합니다.
- 사용자가 수시로 동의 철회를 할 수 있도록 필요할 때마다 동의 배너를 다시 노출할 수 있습니다.

변경한 기능

외부 라이브러리 업데이트

GDPR DMA에 대응하는 라이브러리로 업데이트 합니다:
- Adjust 4.37.1 → 4.38.0
- AppsFlyer 6.12.1 → 6.13.1
- Singular 12.1.1 → 12.3.2
Apple Privacy Manifest 정책 대응에 따라 외부 라이브러리를 업데이트합니다:
- Facebook 16.2.1 → 17.0.0
- Google SignIn 7.0.0 → 7.1.0

해결한 버그

공통

hive_config.xml 파일 내에 더 이상 사용하지 않는 useCrashReport 키가 존재하는 경우, 크래시가 발생하는 오류를 수정합니다

개발자 가이드 변경점

애널리틱스 동의배너 노출하기 가이드를 새로 추가했습니다.

v4.23.3.0 (2024-03-26)

개발 환경

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 v16.2.0
Facebook SDK iOS v16.2.1
GooglePlay Services-Auth (Android) v20.7.0
GooglePlay Services-Games v2 (Android) v19.0.0
Google Sign-In SDK (iOS) v7.0.0
QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
QQ (iOS) v3.5.14
VK (Android) v3.5.1
VK (iOS) v1.6.4
WeChat (Android) v6.8.0
WeChat (iOS) v2.0.2
LINE (Android) v5.9.1
LINE (iOS) v5.11.0
Huawei (Android) v6.12.0.300

IAP

Google Billing Library (Android) v6.0.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.0.1
FCM(FirebaseCloudMessaging) (Android) v23.2.1

MARKETING TRACKING ANALYTICS

Adjust(Android) v4.38.1
Adjust(iOS) v4.37.1
Singular(Android) v12.3.0
Singular(iOS) v12.1.1
AppsFlyer(Android) v6.12.3
AppsFlyer(iOS) v6.12.1
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

변경한 기능

Hive SDK 공통

SDWebImage 라이브러리 버전을 업데이트했습니다: 5.18.3 → 5.18.7

인증

LineSDK 라이브러리 버전을 업데이트했습니다: 5.10.0 → 5.11.0

마케팅 어트리뷰션

Adjust 라이브러리 버전을 업데이트했습니다: 4.35.2 → 4.37.1
FirebaseAnalytics 라이브러리 버전을 업데이트했습니다: 10.20.0 → 10.22.0

해결한 버그

인증

본인 인증 화면 문제를 수정했습니다.
중국 IP를 대상으로 하는 실명 인증 화면에 음영이 나타나는 문제를 수정했습니다.
오프라인 모드에서 로그인 시, 연동된 IdP 정보를 제공하는 콜백 결과인 providerInfoData값이 비어있던 문제를 해결했습니다.

커뮤니티

네트워크 장애 상태에서 SocialV4.showCommunity(SocialV4.ViewType.FullScreen 뷰 타입) 호출 시, 네트워크 장애 발생 시 노출되어야 하는 표준 에러 페이지가 노출되지 않는 문제를 수정했습니다.

기기 관리

휴대폰 번호 인증 시 일일 인증 번호 발송 횟수 한도를 초과했음에도, 재발송을 위한 타이머가 초기화되는 오류를 수정했습니다.
휴대폰 번호 인증 시, 인증 번호 입력 제한 시간을 초과했음에도 텍스트 입력이 활성화되는 오류를 수정했습니다.

프로모션

일부 기기(iPhone XS Max)에서 새 소식, 대배너 등에 있는 버튼이 간헐적으로 동작하지 않는 오류를 수정했습니다.

v4.23.2.0 (2024-03-26)

변경한 기능

마케팅 어트리뷰션

Firebase Analytics 라이브러리 버전을 업데이트했습니다: 10.16.0 → 10.20.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 공통

지원하는 개발 환경을 Xcode 15 이상으로 변경합니다. macOS Ventura13.5 이상에서 사용할 수 있습니다. 지원하는 OS는 아래와 같습니다.
- iOS 12 이상
- iPadOS 13 이상

인증

기기 관리, 중국 실명 인증 등에서 고객이 문자 인증 시 문자 입력 제한 시간 내에 문자를 입력하지 않으면 전송 버튼을 비활성화합니다.
Hive SDK에서 사용하는 reCAPTCHA 라이브러리를 공식 버전으로 업데이트합니다.
각 IDP를 라이브러리로 분리하여 선택 적용할 수 있도록 변경합니다. 다음 라이브러리들을 추가적으로 선택 적용할 수 있습니다.
- Apple Sign-In
- GameCenter
- Hive 멤버십

프로모션

새소식 또는 대배너 둘 중 하나만 화면에 나타나도록 변경합니다. 먼저 호출한 창만 나타나며, 나중에 호출한 창은 나타나지 않습니다.
UA 캠패인 정보에 campaignId를 포함하여 전달합니다.
SDWebImage 라이브러리를 업데이트했고, 이미지 캐싱 및 다운로드와 관련하여 LRU 캐시 정책을 적용합니다.

빌링

IAPv2 인터페이스와 기능을 더는 지원하지 않습니다.

프로비저닝

계정 기반으로 약관을 노출하는 기능을 추가합니다.

허큘리스

Hercules 라이브러리 버전을 업데이트 합니다.
- Android: 20231122
- iOS: 20231116

해결한 버그

인증

프로필 이미지 수정 시 카메라 촬영 버튼을 빠르게 연타하면 크래시가 발생하는 문제를 수정합니다.

프로모션

프로모션 배너로 커뮤니티 웹뷰 등을 노출하는 경우 상단 노치 영역이 잘리는 현상을 수정합니다.

프로비저닝

이용이 정지된 유저는 정지 해제까지 남은 시간을 노출하지 않도록 수정합니다.

데이터스토어

set 메서드에 빈 값을 넣으면 값을 삭제하는 기능이 정상적으로 동작하도록 수정합니다.

애널리틱스

동시 접속자 로그 전송에서 국가 코드 전송 시 알 수 없는 국가에 대한 국가코드를 Unknown에서 공백 문자(Space) 2개로 변경합니다.

알려진 문제점

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

개발자 가이드 변경점

공통

COPPA ageGateU13을 직접 설정할 수 있는 값으로 변경했습니다.
hive_config.xml 예제를 업데이트했습니다.
지원하지 않는 IdP인 WEIBO 관련 내용을 제거합니다.
Unity에서 허큘리스 사용, 제거 관련 내용을 업데이트했습니다.
인앱 업데이트 설명을 수정했습니다.

iOS

IdP 연동 안내에 Apple Game Center를 추가했습니다.
Hive SDK 기능들이 내부적으로 별도 라이브러리로 분리됨에 따라, iOS Podfile 내용이 변경되었습니다.
Unity에서 스크립트로 SDK 필요 권한을 자동으로 Xcode Signing & Capabilities에 추가 관련 설명을 업데이트했습니다.

v4.22.0.2 (2023-11-08)

해결한 버그

결제

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

애널리틱스

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

알려진 문제점

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

v4.22.0.0 (2023-09-15)

새로운 기능

애널리틱스

마케팅 추적 도구인 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 (2023-11-08)

다운로드

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

해결한 버그

결제

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

애널리틱스

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

알려진 문제점

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