v4.24.3.0
다운로드
| iOS | |
|---|---|
| 다운로드 | Hive SDK v4 Native iOS 24.3.0 |
| 배포일 | 2024-09-03 |
개발 환경
- Xcode 15 이상
- Xcode 버전은 Apple App Store 정책에 따라 업데이트해야 합니다.
새로운 기능
프로비저닝
- 약관 화면에서 법정 대리인 동의를 받았는지 확인하는 기능을 추가합니다.
변경한 기능
인증
- 로그아웃 동작을 변경합니다.
- 기존:
signOut호출 시 Hive SDK에서 사용자 계정을 로그아웃 - 변경:
signOut호출 시 Hive SDK는 Hive 서버에 사용자 계정을 로그아웃시켜도 되는지 확인 요청 후 응답 결과에 따라 로그아웃
게스트는 signOut APi 호출 시 서버에서 실패 응답
- 기존:
- 게스트 계정 로그아웃 시 더는 성공 응답을 반환하지 않고, 에러 코드를 반환합니다. Hive SDK와 Hive 서버에서 게스트 계정 세션을 유지합니다.
- 이용 정지 계정은 자동으로 IdP 로그아웃을 시켜서 동일 IdP 다른 계정으로 로그인할 수 있도록 변경합니다. 자동 로그인을 할 수 없는 경우에만 해당합니다.
AuthV4.connect메서드로 IdP 연동을 진행할 때, 이용 정지 계정으로 계정을 전환하면, 로그아웃을 수행하도록 변경합니다.- 기기 관리 서비스에서 국제 전화 국가 번호를 기기 접속 지역에 따라 자동으로 적용하도록 변경합니다.
- 앱 추적 투명화(ATT) 동의를 거절한 경우에도 페이스북 로그인을 할 수 있도록 변경합니다.
프로모션
additionalInfo로 전송하는 값에 불 필요한 정보가 담기지 않도록 수정합니다.- 2:3 또는 3:2 비율로 전면 배너를 노출할 수 있도록 변경합니다.
- 전면 배너에서 “1일 동안 그만 보기” 텍스트를 “오늘은 그만 보기”로 변경합니다.
마케팅 어트리뷰션
- Adjust Signature 버전을
v1에서v3로 변경합니다.
해결한 버그
Hive SDK 공통
- iOS 14 기기에서 앱 추적 투명화(ATT) 동의 여부를 확인할 때 간헐적으로 크래시가 발생하는 오류를 수정합니다.
- 사진첩에서 접근 제한(일부 사진만 접근 허용)을 선택하면 크래시가 발생하는 오류를 수정합니다.
노티피케이션
- 앱 버전 정보를 전송하도록 수정합니다.
개발 환경 업데이트
Android
- Google Play Billing Library 6.1 → 7.0
- Google Play Service Games 20.0.0 → 20.1.2
iOS
- Facebook SDK 16.2.1 → 17.0.2
개발자 가이드 변경점
- 커스터마이징한 로컬 푸시 알림에서
type필드 안내를 변경했습니다. - “대배너” 용어를 “전면 배너”로 변경했습니다.
- Android Life Cycle에서 더는 사용하지 않는
attachBaseContext예제 코드를 삭제했습니다. - 법정대리인 동의 여부 확인을
Configuration.getLegalGuardianConsentAgree로 수행할 수 있음을 안내합니다. - 이용 제한 계정이 있을 때 IdP 연동 안내를 추가했습니다.
- Hive SDK Unity를 수동 업데이트 또는 수동 설치했을 때, 앱 빌드 전에 XML 파일들을 삭제해야 합니다.
v4.24.2.0 (2024-07-05)
새로운 기능
Hive SDK 공통
- GDPR을 적용하는 EU 및 EEA 지역에서 16세 미만 유저가 약관에 동의했는지 여부를 반환하는 기능을 제공합니다. 16세 미만 여부를 확인할 수 있습니다.
- MacOS 콘솔 앱에서도 Hive SDK 디버그 로그를 확인할 수 있으며, Hive SDK 로그중 특정 로그 타입을 선택해서 볼 수 있습니다.
인증
- 기기 관리 서비스에서 휴대폰 번호 1개로 가입 가능한 계정 수를 초과했을 때, 인증 번호 발송을 요청하면 “같은 휴대폰 번호로 생성할 수 있는 계정 수를 초과했습니다.”라는 에러 메시지를 표시합니다.
프로모션
- 크로스 프로모션의 노출을 제어할 수 있는 기능을 제공합니다.
- 오늘은 그만보기 기능을 개선한 N일 동안 그만보기를 지원합니다.
변경한 기능
프로모션
- 게임 초대(UA) 기능 사용 시 클립보드 붙여넣기 권한 동의 팝업 노출을 최소화하여 사용성을 개선합니다.
- 권한 동의 팝업을 노출하는 시점을 초대받은 사용자가 앱을 실행하자마자에서 앱 실행 후 Hive SDK 초기화하는 시점으로 변경했습니다.
- 클립보드에 초대자 URL 데이터가 존재할 때에만 팝업을 노출하도록 변경했습니다.
애널리틱스
- 앱에서 크래시 발생 시 미전송 로그를 파일에 저장하는 옵션인
saveAnalyticsLogBeforeCrash설정값 기본값을false로 변경합니다.
해결한 버그
인증
- 중국에서 접속한 사용자에 대한 실명 인증 과정에서 문자 발송 회수 초과 시 남은 시간을 초기화하지 않고 오류 메시지를 노출하도록 수정합니다.
프로모션
- 새소식 뷰에서 새로운 프레임 뷰 노출하기 동작 시 프리징이 발생하는 오류를 수정합니다.
개발 환경 업데이트
iOS
- N/A
개발자 가이드 변경점
- Hive SDK v4 24.2.0부터 Facebook Cloud Games 지원을 중단함에 따라 아래 페이지들에 해당 내용을 추가했습니다.
- Hive 러비 상점 선택 화면에 관한 설명을 보강했습니다.
v4.24.1.3
다운로드
| iOS | |
|---|---|
| 다운로드 | Hive SDK v4 iOS 24.1.3 |
| 배포일 | 2024-07-25 |
변경한 기능
인증
- 기기 관리 서비스 이용중 모바일 기기 등록 시, 국제 전화 국가 번호를
+82가 아니라 기기 접속 지역에 따라 자동으로 적용하도록 변경합니다.
v4.24.1.2 (2024-06-27)
새로운 기능
N/A
변경한 기능
N/A
개발 환경 업데이트
N/A
개발자 가이드 변경점
N/A
v4.24.1.0 (2024-05-14)
새로운 기능
N/A
변경한 기능
애널리틱스
- 기기의 추적 동의 여부에 따라 동의배너 노출여부를 결정하도록 변경합니다.
- 추적 동의를 거절한 경우에는 동의배너를 노출하지 않습니다.
개발 환경 업데이트
외부 라이브러리 업데이트
- Apple Privacy Manifest 정책 대응에 따라 외부 라이브러리를 업데이트 합니다.
- AppsFlyer(iOS) v6.13.1 → v6.14.3
- QQ (iOS) v3.5.14 → v3.5.16
- Facebook SDK를 다운그레이드합니다.
- Facebook SDK v17.0.0 → v16.2.1
해결한 버그
빌링
- Hive SDK v4 24.0.0 미만 버전(예: v4 23.4.0)에서 v4 24.0.0으로 업데이트하는 경우, 상품 조회가 되지 않는 오류를 수정합니다.
개발자 가이드 변경점
N/A
v4.24.0.0 (2024-04-30)
새로운 기능
프로모션
- 외부 페이지 노출을 위해 브라우저를 이용하는 SafariViewController를 지원합니다.
PlatformHelper클래스showInAppBrowser메서드로 인앱 브라우저를 노출할 수 있습니다.
빌링
- 첫 구독 할인 정보가 있는 경우 상품 정보 조회 시 함께 전달합니다.
getProductInfo사용 시 콜백으로 받는IAPV4Product객체 목록에서original_price필드값과price필드값의 차이로 할인 정보를 확인할 수 있습니다.
변경한 기능
Hive SDK 공통
- 앱 버전을 구분할 때
CFBundleShortVersionString을 추가로 사용합니다.
빌링
- 환불 유저 재결제 UI에서 노출되는 PG 결제 타입 문구를 “HiveStore”에서 “PG 결제”로 변경했습니다.
알려진 문제점
인증
- Facebook SDK iOS 17.0.0 사용 시 iOS 17.0 이상 기기에서 사용자가 “앱 추적 투명성(App Tracking Transparency)”에 동의하지 않는 경우 로그인을 할 수 없는 문제가 있습니다. 해당 조건에서 Facebook 로그인을 구현하려면 Hive SDK v4 24.1.0을 사용하세요.
개발 환경 업데이트
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.5.1
다운로드
| iOS | |
|---|---|
| 다운로드 | Hive SDK v4 iOS 23.5.1 |
| 배포일 | 2024-06-27 |
개발 환경
- Xcode 15 이상
- Xcode 버전은 Apple App Store 정책에 따라 업데이트해야 합니다.
새로운 기능
N/A
변경한 기능
N/A
개발 환경 업데이트
N/A
개발자 가이드 변경점
N/A
v4.23.5.0 (2024-05-31)
변경한 기능
애널리틱스
- 기기의 추적 동의 여부에 따라 동의 배너 노출 여부를 결정하도록 변경합니다. 추적 동의를 거절한 경우에는 동의 배너를 노출하지 않습니다.
개발 환경 업데이트
외부 라이브러리 업데이트
- Apple Privacy Manifest 정책 대응에 따라 외부 라이브러리를 업데이트 합니다.
- AppsFlyer(iOS) v6.13.1 → v6.14.3
- QQ (iOS) v3.5.14 → v3.5.16
- WeChat 2.0.2 → 2.0.4
- Hercules 2024.01.23 → 2024.04.11
- Singular 12.3.2 → 12.4.1
- Facebook SDK를 다운그레이드합니다. 다운그레이드로 앱 추적 투명성(App Tracking Transparency)에 동의하지 않은 경우 로그인이 되지 않는 이슈를 해결합니다.
- Facebook SDK v17.0.0 → v16.2.1
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
알려진 문제점
인증
- Facebook SDK iOS 17.0.0 사용 시 iOS 17.0 이상 기기에서 사용자가 “앱 추적 투명성(App Tracking Transparency)”에 동의하지 않는 경우 로그인을 할 수 없는 문제가 있습니다. 해당 조건에서 Facebook 로그인을 구현하려면 Hive SDK v4 24.1.0 또는 곧 릴리즈되는 v4 23.5.0을 사용하세요.
해결한 버그
공통
- hive_config.xml 파일 내에 더 이상 사용하지 않는
useCrashReport키가 존재하는 경우, 크래시가 발생하는 오류를 수정합니다
개발자 가이드 변경점
- 애널리틱스 동의배너 노출하기 가이드를 새로 추가했습니다.
v4.23.3.0 (2024-03-26)
개발 환경
- Xcode 15 이상
- Xcode 버전은 Apple App Store 정책에 따라 업데이트해야 합니다.
변경한 기능
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에서 결제 시 지연 결제 기능을 제공하려면 이 코드 변경을 먼저 적용해야 합니다.
- UserEngagement 전역 콜백 핸들러 선언 예제 코드가 변경되었습니다.
마케팅 어트리뷰션
- 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 버전 배포 시 알려진 문제점은 없습니다.