SDK Unity 릴리스 노트¶

Hive SDK Unity의 버전 별 주요 업데이트 사항을 안내합니다.

Hive SDK Unity의 타겟 OS별 업데이트 사항은 아래와 같은 OS 라벨로 구분합니다.

• Android SDK Unity Android에 해당하는 업데이트 사항
• iOS SDK Unity iOS에 해당하는 업데이트 사항
• Windows SDK Unity Windows에 해당하는 업데이트 사항
• All SDK Unity Android, iOS, Windows에 모두 해당하는 업데이트 사항

필수 숙지 사항¶

Hive SDK 각 릴리스 버전을 사용하기에 앞서, 버전별 제약 사항과 관련해 필수로 숙지해야 하는 설정 사항을 안내합니다.

웨* Hive SDK v4 Unity 25.0.0 이상에서 보안 키 발급 필수 * 인증 보안 프로토콜 변경으로 인해, Hive SDK v4 Unity 25.0.0 이상 사용 시, 반드시 Hive 콘솔 > 보안 키 설정에서 보안 키를 발급 받아야 합니다. 보안 키를 발급받지 않으면, 앱에서 로그인할 수 없습니다. * Hive SDK v4 Unity 25.1.3 이상에서 PG 결제 구현 변경 필요 * Android&iOS 25.1.3 이상 혹은 Windows 25.1.0 이상에서 PG 결제를 구현하려면 PG 결제 동작 과정을 참고하여 PG 결제 구현 코드를 변경해야 합니다. * Hive SDK v4 Unity Windows 25.8.1 이상에서 프로모션 전면 배너 클릭 시 링크 이동이 정상적으로 안 되는 문제가 있습니다. 이를 해결하려면 전면 배너용 HTML 파일을 아래 방법대로 교체해야 합니다. 1. 수정 HTML 파일이 있는 폴더 압축 파일을 다운로드 및 압축 해제합니다. 2. 폴더째로 복사해 Plugins/HIVESDK/Source/HiveSDKWindows/assets/additional 하위에 덮어 씌웁니다. 3. 앱을 다시 빌드합니다. * Hive SDK v4 Unity 25.4.0 이상에서 SDK 매니저 사용 시, SDK Manager v 2.0.0 이상으로 업데이트 하세요.

v4.26.1.0¶

본 SDK 버전의 개발 환경을 확인하세요.

새로운 기능¶

리모트 플레이¶

• Windows 리모트 플레이 플러그인 1.01.02 이상부터 리모트 플레이 실행 중 외부 링크를 클릭하면 페이지를 원격 기기에서 열 수 있습니다. 이에 따라 리모트 플레이 중에도 PG결제가 가능합니다.

마케팅 어트리뷰션¶

• Windows Steam이 아닌 데스크탑 PC 환경에서 필요한 정보를 전송하는 Appsflyer for Native PC를 출시합니다.
• Windows Airbridge 1.1.4 버전부터 사용자 로그인 이후에 MMP 서버로 Install 이벤트 로그를 전송하도록 전송 시점을 지연할 수 있는 기능을 제공합니다. 게임사는 로그인 이후에 Install 이벤트 로그를 전송함으로써 PlayerID를 비롯한 계정 정보를 MMP 서버에 전송할 수 있습니다.

빌링¶

• Android Xiaomi로 빌링을 사용하도록 지원합니다.

인증¶

• All 생년월일을 입력하는 팝업을 노출한 후, 사용자가 생년월일을 입력하면 그 값을 콜백으로 리턴하는 AuthV4.checkAgeGate 메서드를 제공합니다.
• All 현재가 아닌 다음 로그인 세션을 자동 로그인용 세션으로 등록(ON/OFF)하는 AuthV4.setAutoLoginEnabled 메서드를 추가합니다. ON으로 설정 후 AuthV4.Helper.signIn을 실행하거나 AuthV4.signIn을 ProviderType.AUTO로 실행하면 자동 로그인을 사용할 수 있습니다.
• Android Xiaomi로 로그인을 사용하도록 지원합니다.

프로모션¶

• All 앱 미설치 사용자가 다이렉트 링크를 클릭하면, 앱 설치 완료 후에도 링크에 지정된 앱 내 페이지로 이동시키는 디퍼드 딥링크를 지원합니다.

기타¶

• All Configuration 클래스에 getGameLanguage 메서드로 SDK에 설정한 언어 설정값을 확인할 수 있습니다.
• Android 게임 내 웹뷰로 열기에서 PlatformHelper 클래스의 showInWebView 메소드로 웹뷰를 노출하는 경우 Hive Activity가 아닌 Game Activity를 사용하여 노출하는 옵션을 제공합니다.
• iOS CocoaPod 서비스 종료에 따라 SPM(Swift Package Manager)를 통한 배포 서비스를 제공합니다.

변경한 기능¶

라이브러리 업데이트¶

• Windows Microsoft Visual C++ Redistributable이 14.44.35211.0 이상 버전을 사용하도록 변경하였습니다.
• Android Amazon AppStore (Android) v3.0.4 → v3.0.8
  • Samsung GalaxyStore IAP (Android) v6.1.1 → v6.5.0
  • Google Billing Library (Android) v7.0.0 → v8.0.0
  • QQ (Android) v3.5.17 → v3.5.18
  • Xiaomi (Android) v3.2.5_12798 → v3.4.6
• iOS Adjust (iOS) 5.4.3 → 5.4.6
  • Airbridge (iOS) 4.7.0 → 4.8.1
  • AppsFlyer (iOS) 6.17.2 → 6.17.7
  • Firebase (iOS) 11.15.0 → 12.5.0
  • Singular (iOS) 12.8.1 → 12.9.0
  • Facebook (iOS) 18.0.0 → 18.0.2
  • Line (iOS) 5.13.0 → 5.14.0
  • QQ (iOS) 3.5.17.5 → 3.5.18
  • SDWebImage (iOS) 5.21.1 → 5.21.5
  • Recaptcha (iOS) 18.7.0 → 18.8.2

마케팅 어트리뷰션¶

• All MMP에 전송하는 동일 영수증의 매출 로그가 중복 발송되지 않도록 변경합니다.
• All Firebase 구매 이벤트 전송 시 value 키에도 매출값을 전송하도록 추가합니다.
  • 기존에는 revenue 키에 매출값을 전송하였습니다.

빌링¶

• Windows PG 결제가 외부 브라우저를 통해 수행되도록 변경되었습니다.
• Android Google Play 결제 시 사용하는 라이브러리를 Google Play Billing Library 8.0 으로 변경합니다.

애널리틱스¶

• All DMA 동의 배너 노출하기의 팝업 디자인을 변경하고 동작을 개선합니다.
  • 기존 동의 배너에서 이미 동의한 이력은 그대로 유지되며, 재노출 시 개선된 문구와 UI의 새로운 동의 배너가 표시됩니다.
  • 기존 동의 배너의 문구를 커스텀하여 사용 중이었다면, 변경된 데이터 구조에 맞춰 커스텀 동의 배너 UI 설정를 참고하여 다시 설정해야 합니다.

인증¶

• All 성인 인증 방식으로 웹 뿐만 아니라 앱을 통한 방식도 지원합니다.
• All SNS 로그인 시 프로필 이미지 및 닉네임 자동 수집 기능을 제거합니다.
• All AuthV4.setAutoLoginEnabled(기본값: PC OFF / Mobile ON) 추가에 따라 자동 로그인 동작 정책을 다음과 같이 변경합니다.
• 기존: 계정 충돌 발생 후 다른 계정으로 전환할 때, 바뀐 계정은 모바일은 자동 로그인을 유지하고, PC는 자동 로그인을 해제
• 변경: 계정 충돌 발생 후 다른 계정으로 전환할 때, 바뀐 계정은 모바일과 PC 모두 AuthV4.setAutoLoginEnabled로 자동 로그인 세션 등록을 했다면 자동 로그인 유지, 안 했다면 해제 (예외 상황 존재)
• Windows 스팀덱에서 본인인증 기능 사용 시 Pass 미지원에 대한 안내 팝업이 추가되었습니다.
• Windows Google 로그인 시 Credential Manager와 PlayService Auth를 모두 사용하도록 변경합니다. Credential Manager에서 FailOver시 PlayService Auth로 로그인을 시도합니다.

푸시¶

• iOS 푸시 발송을 위한 토큰 수집 시, 빌드 환경에 따라 토큰 추가 정보를 수집하도록 변경합니다.

프로모션¶

• Windows 커스텀 뷰/다이렉트 뷰를 통해 외부 브라우저로 이동할 때 웹뷰가 깜빡거리는 오류를 해결합니다.
• All 커스텀 뷰/다이렉트 뷰를 통해 외부 브라우저로 이동할 때 웹뷰가 깜빡거리는 오류를 해결합니다.

프로비저닝¶

• All 앱스토어 책임법에 대응할 수 있는 Age Range API를 선택 적용할 수 있도록 분리하여 제공합니다.
  • 2026년 1월 1일 미국 텍사스주에서 시행되는 앱 스토어 책임법은 시행 보류 중인 상태로 개발 상황에 따라 선택하여 적용할 수 있습니다.
  • 2026년 5월 미국 유타주, 7월 루이지애나 주에서 시행되는 앱 스토어 책임법에 대응하여 선택하여 적용할 수 있습니다.

기타¶

• All Configuration.setZone 동작이 초기화 이전까지만 유효하도록 변경되었습니다.
• All PlatformHelper 클래스의 showInAppView 메소드로 노출되는 웹뷰 닫기 버튼의 시인성을 개선합니다.
• Windows HTTP 통신 로직을 개선하여 안정성을 강화하였습니다.

플러그인¶

• iOS SDK에 포함하여 배포하고 있는 JSONObject 클래스의 호환성을 개선합니다.
  • 빌드환경 내의 다른 JSONObject 클래스와 이름이 중복되지 않도록 합니다.

해결한 버그¶

• Android 전체 공통된 영역의 UI의 뒷배경이 불투명한 경우 컷아웃 영역 이내로 노출되도록 수정합니다.

기타¶

• iOS PlatformHelper 클래스의 showInAppBrowser 메소드를 적용했을 때, 게임 앱 사용자의 네트워크 상태가 오프라인 상태이거나 오프라인으로 변경되는 경우 게임 앱이 깜빡이며 창이 닫히는 현상을 수정합니다.
• Windows interwork:// 등 내부 스킴에서 ?831020처럼 key-value 형식이 아닌 query 값이 입력될 때 831020=로 잘못 전달하던 문제를 수정하여 831020 그대로 전달되도록 개선했습니다.
• Windows 리모트 플레이 등 플러그인 이용 시 Configuration.setZone으로 설정한 Zone이 반영되지 않는 문제를 수정했습니다.
• Windows 리모트 플레이에서 JWT 토큰 갱신 시 크래시가 발생하던 문제를 수정하였습니다.

마케팅 어트리뷰션¶

• iOS Firebase 에서 Install 또는 Update 이벤트가 누락되는 오류를 수정합니다.
• Windows 마케팅 어트리뷰션의 구매 로그가 중복으로 수집되는 문제를 수정했습니다.

인증¶

• iOS 챗봇 사용 중 채팅 메시지 입력 필드가 간헐적으로 노출되지 않는 오류를 수정합니다.
• iOS 기기관리 등록 개수를 초과한 상태에서 성인 인증 후 등록된 기기를 삭제하면 다시 성인 인증 팝업이 노출되는 오류을 수정합니다.
• Windows AuthV4 인증 진행 도중 앱 종료 시도시 종료되지 않는 문제를 수정했습니다.
• Windows 본인인증 페이지를 요청한 앱이 종료된 뒤 다른 앱(또는 재실행된 앱)에서 인증을 요청하면, 이전 요청의 인증 결과가 잘못 전달되어 오류(-1200001, -8)가 발생하던 문제를 수정했습니다.

푸시¶

• Android COPPA 대상인 경우에도 푸시 알림을 위한 토큰이 수집되는 오류을 수정합니다.
• iOS ForegroundPush 설정이 False로 변경되지 않는 오류를 수정합니다.

프로모션¶

• iOS 새소식 메뉴의 개수가 일정 수를 초과하면 정상적으로 동작하지 않는 오류를 수정합니다.
• iOS 전면 배너에 노출하는 이미지의 가로 또는 세로의 길이가 '0'이거나 서버에서 잘못된 정보를 전송하는 경우 정상적으로 동작하지 않는 오류를 수정합니다.
• iOS 다이렉트 링크로 커뮤니티를 노출하는 경우 URL 파라미터가 없으면 다이렉트 링크가 동작하지 않는 오류를 수정합니다.
• Windows 프로모션에서 "오늘 하루 안 보기"를 클릭하면 해당 프로모션이 영구적으로 표시되지 않던 문제를 수정했습니다.

v4.26.0.1¶

변경한 기능¶

• iOS Hive SDK 개발 환경으로 Xcode 버전이 아래와 같이 변경됩니다.
  • 기존: Xcode 26.2 Beta2
  • 변경: Xcode 26.2

프로비저닝¶

• Android 앱스토어 책임법 대응하여 Hive SDK에서 지원하는 Google Play Age Signals API버전이 아래와 같이 변경됩니다.
  • 기존: 0.0.1-Beta2
  • 변경: 0.0.2

v4.26.0.0¶

본 SDK 버전의 개발 환경을 확인하세요.

새로운 기능¶

• iOS iOS Xcode 26.2 이상에서 Hive SDK를 빌드할 수 있습니다.
  • 최소 지원 OS 버전은 iOS 15 입니다.

프로비저닝¶

• Android 컴플라이언스 기능을 새롭게 추가합니다.
  • Google Play와 Amazon Appstore로 게임 앱을 배포하는 경우, Hive SDK에서는 2026년 1월 1일 미국 텍사스주에서 시행되는 앱 스토어 책임법에 대응하기 위해 사용자 연령 범위를 확인하는 Age Range API 를 제공합니다.
• iOS 컴플라이언스 기능을 새롭게 추가합니다.
  • Apple App Store로 게임 앱을 배포하는 경우, Hive SDK에서는 2026년 1월 1일 미국 텍사스주에서 시행되는 앱 스토어 책임법에 대응하기 위해 사용자 연령 범위를 확인하는 Age Range API 를 제공합니다.
    • iOS 26.2 이상에서만 지원합니다.

알려진 이슈¶

프로비저닝¶

• Android 앱스토어 책임법에 대응하여 Hive SDK 26.0.0 Beta에서 지원하는Google Play Age Signals API 0.0.1-beta02 버전은 실제 연령 신호를 수신하는 사용자 환경에서는 사용할 수 없습니다.
  ※ 실제 연령 신호를 수신하려면 Google Play Age Signals API 0.0.2 버전(비베타 버전)을 지원하는 Hive SDK v4.26.0.1로 업데이트하세요.

v4.25.8.2¶

본 SDK 버전의 개발 환경을 확인하세요.

해결한 버그¶

결제¶

• Windows Google Play Games PC 결제에서 등록된 상품이 20개를 초과할 경우, 모든 상품 정보를 가져오지 못하던 문제를 수정하였습니다.

v4.25.8.1¶

안내 사항: 본 SDK 버전은 별도 배포 파일을 제공하지 않으며, 해당 기능은 상위 버전 SDK에 포함됩니다.

해결한 버그¶

기타¶

• Windows 게임언어 변경 후 닫기 안내 UI가 최초 설정된 언어로 노출되는 문제를 해결했습니다.

채팅¶

• Windows 한글 메시지에 대해 콜백이 호출되지 않는 오류를 수정했습니다.

v4.25.9.0¶

본 SDK 버전의 개발 환경을 확인하세요.

새로운 기능¶

인증¶

• All 본인 확인 서비스를 제공합니다.
  • SteamDeck에서는 본인 확인 서비스(본인 확인, 성인 인증, 보호자 동의)를 제공하지 않습니다. 모바일 또는 PC에서 본인 확인 서비스를 이용 후 다시 SteamDeck에서 게임에 접속해야 합니다.

해결한 버그¶

기타¶

• Windows 게임 언어 변경 후 닫기 안내 UI가 최초 설정된 언어로 노출되는 문제를 해결했습니다.

v4.25.7.1¶

안내 사항: 본 SDK 버전은 별도 배포 파일을 제공하지 않으며, 해당 기능은 상위 버전 SDK에 포함됩니다.

해결한 버그¶

기타¶

• Windows DX12 렌더러 GPU 동기화 적용으로 렌더링 안정성을 강화했습니다.
• Windows 프로모션 새 소식에서 간헐적으로 닫기 버튼이 동작하지 않는 이슈를 해결했습니다.

v4.25.8.0¶

본 SDK 버전의 개발 환경을 확인하세요.

새로운 기능¶

• All 지원하는 Unity 최소 버전이 변경됩니다.
  • 16KB 페이지 사이즈 대응이 완료된 지원하는 Unity 버전 목록
    • Unity 6000.1.0f1
    • Unity 6000.0.38f1
    • Unity 2022.3.56f1
    • Unity 2021.3.48f1
  • Android 16 타겟을 지원하는 Unity 버전 목록
    • Unity 6000.1.0f1
    • Unity 2022.3.62f1
    • Unity 2021.3.51f1
• Android Android OS 16(API Level 36)을 지원합니다.
• Android Android OS 15(API Level 35) 이상으로 빌드 시, 16KB Page Size 빌드를 지원합니다.

데이터스토어¶

• Windows 데이터스토어 기능을 추가했습니다.

채팅¶

• Windows 채팅 기능이 추가되었습니다.

변경한 기능¶

• Android 더 이상 사용하지 않는 android.permission.FOREGROUND_SERVICE 권한을 제거합니다.
• Android Android 최소 빌드 타겟이 19 → 23으로 변경됩니다.

라이브러리 업데이트¶

• Android Adjust(Android) 5.2.0 → 5.4.2
  • Airbridge(Android) 4.3.0 → 4.7.1
  • AppsFlyer(Android) 6.16.2 → 6.17.3
  • Firebase-analytics(Android) 22.1.2 → 23.0.0
  • Singular(Android) 12.7.0 → 12.10.0
  • Facebook(Android) 17.0.0 → 18.0.1
  • Line(Android) 5.10.0 → 5.11.1
  • play-services-auth(Android) (Google Sign-In) 20.7.0 → 21.3.0
  • play-services-games-v2(Android) (Play Games Services) 20.1.2 → 21.0.0
  • play-services-ads-identifier(Android) 18.0.1 → 18.2.0
  • play-services-analytic(Android) 18.0.4 → 18.1.1
  • firebase messaging(Android) 24.0.2 → 25.0.0
  • onestore(Android) 21.01.00 → 21.02.01
  • google-core-review(Android) 2.0.1 → 2.0.2
  • Recaptcha(Android) 18.6.1 → 18.7.1
  • Kotlin(Android) 1.9.22 → 2.1.21
• iOS Adjust(iOS) 5.2.0 → 5.4.3
  • Airbridge(iOS) 4.3.0 → 4.7.0
  • AppsFlyer(iOS) 6.16.1 → 6.17.2
  • Firebase(iOS) 11.6.0 → 11.15.0
  • Singular(iOS) 12.7.1 ->12.8.1
  • Facebook(iOS) 17.4.0 → 18.0.0
  • Google Sign-In(iOS) 8.0.0 → 9.0.0
  • Line(iOS) 5.11.2 ->5.13.0
  • QQ(iOS) 3.5.17.4 → 3.5.17.5
  • SDWebImage(iOS) 5.20.0 → 5.21.1
  • Recaptcha(iOS) 18.6.0 → 18.7.0

빌링¶

• Windows Google Play for Native PC (EAP) 연동을 Web API 방식에서 Google Play Games PC SDK 기반으로 전환했습니다.
  • 이제 Hive SDK 인증이 아니라 Google Play Games PC 앱을 통해 Google 계정으로 로그인해야 합니다. 초기화 시 참고 사항을 확인하세요.
  • 기존 프로젝트와 신규 프로젝트 모두 Google 가이드를 따라 매니페스트 구성과 코드 서명을 준비해야 합니다.

인증¶

• iOS Xcode 26에서 빌드 시 사용할 수 없는 라이브러리 참조를 제거합니다.

허큘리스 업데이트¶

• Windows Hercules 버전을 2025.08.11으로 업데이트했습니다.

해결한 버그¶

기타¶

• Windows 빠른 연속 메서드 호출에 대한 안정성을 높였습니다.

리모트 플레이¶

• Windows Application.CancelQuit 또는 Application.wantsToQuit로 리모트 플레이 연결 종료를 취소했음에도 연결이 종료되던 문제를 수정했습니다. 이제 애플리케이션이 실제로 종료될 때 연결을 종료합니다.

분석¶

• Android 클라이언트 동접 전송 실패 시, 불필요한 정보를 포함하여 재전송하지 않도록 수정합니다.

인증¶

• iOS 챗봇 팝업 노출 시, 세로 모드가 아닌 가로 모드가 간헐적으로 노출되는 오류를 수정합니다.
• iOS 빈배열 참조 오류가 발생하지 않도록 수정합니다.
  • Authv4 클래스의 showConflict 메서드 사용 시, 필수 입력 데이터가 없는 경우 크래시가 발생합니다.

v4.25.7.0¶

안내 사항: 본 SDK 버전은 별도 배포 파일을 제공하지 않으며, 해당 기능은 상위 버전 SDK에 포함됩니다.

새로운 기능¶

인증¶

• All 성인 인증을 완료하면 성인 인증된 사용자를 식별할 수 있습니다. 식별하는 값을 얻는 메서드를 제공합니다. 식별 정보는 해시한 DI값 입니다.

변경한 기능¶

인증¶

• All Hive 콘솔에서 성인 인증을 사용하는 앱을 설정하면, 로그인 이후 성인 인증 절차가 자동으로 수행됩니다.
  • 한국에서만 지원하는 기능입니다.
• All 성인 인증을 수행하는 showAdultConfirm 메서드를 deprecated합니다.
  • showAdultConfirm 메서드는 이후 업데이트 시 제거할 수 있습니다.

해결한 버그¶

기타¶

• Windows 게임이 관리자 권한으로 실행된 상태에서 Hive SDK를 통해 외부 웹 브라우저를 열 때, URL 길이가 800자 이상이면 웹브라우저가 정상적으로 열리지 않는 문제를 수정했습니다.

인증¶

• Windows 보호자 동의 실패로 로그인 실패 시, 로그인 정보가 리셋되지 않는 문제를 수정했습니다.
• Windows 커스텀 로그인으로 로그인한 유저가 게임에서 아이템을 구매 후 앱 마켓에서 다시 환불을 받은 상황에서, 동일 계정으로 게임에 재접속 시 로그인에 실패했던 문제를 해결했습니다.
• Windows AuthV4.signOut 콜백 내부에서 AuthV4.showSignIn 호출 시 크래시가 발생하는 문제를 수정했습니다.

v4.25.6.0¶

안내 사항: 본 SDK 버전은 별도 배포 파일을 제공하지 않으며, 해당 기능은 상위 버전 SDK에 포함됩니다.

새로운 기능¶

채팅¶

• All 특정 채팅 메시지에 '좋아요'를 표현하거나, 표기할 수 있는 기능을 추가합니다.
• All 특정 채팅 메시지의 '답글'을 작성하거나, 답글 연결 관계를 표기할 수 있는 정보를 제공합니다.
• All 특정 사용자를 멘션하거나, 사용자를 멘션하는 정보를 제공하는 기능을 제공합니다.

변경한 기능¶

채팅¶

• All 채널 메시지 조회 방식을 인덱스 기준에서 메시지 아이디 기준으로 조회하도록 변경합니다.

v4.25.5.2¶

본 SDK 버전의 개발 환경을 확인하세요.

해결한 버그¶

인증¶

• iOS 가로모드에서 챗봇을 노출하는 경우 크래시가 발생하는 오류를 수정합니다.

v4.25.5.1¶

안내 사항: 본 SDK 버전은 별도 배포 파일을 제공하지 않으며, 해당 기능은 상위 버전 SDK에 포함됩니다.

본 SDK 버전의 개발 환경을 확인하세요.

새로운 기능¶

노티피케이션¶

• All 푸시 액션 버튼을 신규로 제공합니다.
  • 푸시 알람 수신 시, 푸시 선택 액션 버튼을 통해 사전에 정의된 액션을 수행할 수 있습니다.

인증¶

• All 여러 계정 간 전환 기능을 신규로 제공합니다. 관련 세부 기능은 아래와 같습니다.
  • 현재 로그인된 계정을 기기에 저장
  • 저장된 계정을 조회
  • 저장된 계정을 로그아웃하고 삭제
  • 저장된 다른 계정으로 빠른 로그인

채팅¶

• All 메시지 전송
  • 채팅 메시지가 사용자의 언어로 자동 번역되어 수신하는 기능과 특정 메시지를 번역하는 기능을 추가합니다.
  • 특정 언어 사용자만 수신할 수 있는 공지 메시지 기능을 추가합니다.
  • 웹소켓 메시지에 메시지 id값을 추가하여 콜백의 순서 보장을 제공합니다.
• All 채널
  • 채팅 채널 입장 시 이전 대화 이력을 조회할 수 있는 기능을 추가합니다.
  • 현재 채널에 참여한 인원수를 제공합니다.
  • 채널 목록 조회시 정렬 기준 기능을 제공합니다.
• All 이벤트 관리
  • 채팅 커스텀 데이터 이벤트를 바이너리로 전송할 수 있는 기능을 추가합니다.
• All 연결 관리
  • 재연결 기능을 추가합니다.

프로모션¶

• All 다이렉트 링크 기능를 신규로 추가합니다.

허큘리스 업데이트¶

• All 20241120 -> 20250217
• Android 20241125-2 -> 20250527
• iOS 20241120 -> 20250218

변경한 기능¶

• Android 빌드에 필요한 난독화 규칙을 업데이트합니다.
• iOS 분리되어 제공되었던 HiveAppTrackingTransparents.framework 라이브러리가 Service.framework에 통합됩니다.

마케팅 어트리뷰션¶

• iOS 자동으로 수집하는 Firebase 구매 이벤트를 활성화한 경우 지원하도록 변경합니다.

인증¶

• All Hive 멤버십 계정을 사용하지 않는 경우 동작하지 않았던 showMyInquiry 메소드를 사용 시 문의하기 페이지가 노출되도록 변경합니다.
• Android VK 인증 팝업을 웹뷰에서 인앱브라우저로 변경합니다.

해결한 버그¶

분석¶

• iOS 약관 동의가 끝난 직후 Analytics 로그를 전송 가능하도록 로직을 수정합니다.

프로모션¶

• iOS iPad 기기에서 새소식 UI의 모서리 곡률을 수정합니다.

프로비저닝¶

• iOS 약관 노출시 웹뷰 스크롤이 되지 않도록 수정합니다.

알려진 이슈¶

기타¶

• iOS 가로모드에서 챗봇을 사용하는 경우 크래시가 발생하는 오류가 발생합니다.
  • Hive SDK Unity iOS 25.5.2 이상으로 업데이트 하세요.

v4.25.5.0¶

본 SDK 버전의 개발 환경을 확인하세요.

새로운 기능¶

분석¶

• Windows 에어브릿지 로그에 device.platform을 추가했습니다. "Steam 또는 "Desktop" 값을 가집니다. 이 값은 에어브릿지 대시보드에서도 실시간으로 볼 수 있습니다.

인증¶

• Windows 보호자 동의 기능을 추가하였습니다.

변경한 기능¶

기타¶

• Windows MMP 관련해 내부 로직을 개선했습니다.

해결한 버그¶

기타¶

• Windows Hive SDK에서 새 창을 띄울 때 발생하던 NVIDIA 그래픽 드라이버 572.16 ↔ DirectX 11 간 호환성 충돌(Apple 로그인, Facebook 로그인, PG 결제)을 해결했습니다.

인증¶

• Windows 여러 계정 간 전환 사용 시, 자동 로그인 후 로그아웃을 호출하면 세션을 만료시켜버려 다시 로그인을 할 수 없었던 문제를 해결하였습니다.

프로모션¶

• Windows Promotion.updatePromotionData() 호출 직후 새소식 페이지를 열 때 간헐적으로 발생하던 충돌을 수정했습니다.

v4.25.4.0¶

본 SDK 버전의 개발 환경을 확인하세요.

새로운 기능¶

기타¶

• Windows Hive SDK와 관련 종속성을 별도의 폴더로 격리 할 수 있는 기능이 추가되었습니다.

인증¶

• Windows 여러 계정 간 전환 기능을 신규로 제공합니다. 관련 세부 기능은 아래와 같습니다.
  • 현재 로그인된 계정을 기기에 저장
  • 저장된 계정을 조회
  • 저장된 계정을 로그아웃하고 삭제
  • 저장된 다른 계정으로 빠른 로그인
• Windows 게임 이용이 정지된 사용자가 로그인을 시도하면, 앱을 종료하지 않고 앱에서 로그아웃만 하도록 변경합니다.
• Windows 리모트플레이 플러그인에서 강화된 인증 프로토콜을 사용할 수 있습니다.

해결한 버그¶

기타¶

• Windows Hive 기능 동작에 대한 퍼널로그 미집계 문제를 해결했습니다.

v4.25.3.0¶

안내 사항: 본 SDK 버전은 별도 배포 파일을 제공하지 않으며, 해당 기능은 상위 버전 SDK에 포함됩니다.

새로운 기능¶

기타¶

• Windows 크로스플레이 런처로 게임을 실행했을 때, 실행 URI에 첨부한 실행 파라미터를 조회하는 기능을 추가합니다.
• Windows 컨트롤러 키 맵핑 지원 대상에 특정 UI를 추가합니다.
• Windows 컨트롤러 버튼을 통해 닫기가 가능할 때 닫기 버튼에 대한 안내를 출력하도록 UI를 추가합니다.

프로모션¶

• Windows Promotion.getBannerInfo 호출 시 typeCampaign 값을 전달하도록 수정합니다.
• Windows 초대 코드를 입력한 유저가 앱을 설치한 경우 보상을 지급할 수 있도록 로그인 이벤트를 수집합니다.

변경한 기능¶

라이브러리 업데이트¶

• Windows Chromium Embedded Framework 라이브러리 버전을 128.45 버전으로 교체했습니다.

해결한 버그¶

기타¶

• Windows 게임 엔진에서 기본 마우스 커서를 설정한 경우, 웹뷰가 닫힌 후 마우스 조작 시 윈도우 기본 커서가 번갈아 나타나는 현상을 수정했습니다.
• Windows Hive SDK 내부에서 결과로 JSON이 아닌 HTML을 전달할 때 오류가 발생하는 현상을 수정했습니다.
• Windows Steam 마켓 연결 실패 에러코드를 세분화해 전달하도록 변경합니다.
  • 에러 코드 IAPV4SteamMarketResponseError(-6101001)를 추가했습니다.
  • [IAPv4] Steam server response error : (code: ... , message: ...) 형식으로 에러 코드와 메시지를 전달합니다.
• Windows Steam 오프라인 모드에서 Steam 로그인 시도 시 콜백을 반환하지 못하는 문제를 수정했습니다.

v4.25.2.2¶

본 SDK 버전의 개발 환경을 확인하세요.

변경한 기능¶

라이브러리 업데이트¶

• Android * GooglePlay Services-Auth(Android) v20.7.0 (Google Sign-In 롤백 재지원)
  • Google Credential Play Services Auth(Android) v1.3.0 (Google Sign-In 롤백 제거)

인증¶

• Android Google Credential Manager의 호환성이 낮아 일부 유저가 접속할 수 없는 이슈로 인해, 인증 방법을 기존의 Google Sign-In 으로 롤백하여 변경합니다.

v4.25.2.1¶

본 SDK 버전의 개발 환경을 확인하세요.

해결한 버그¶

마케팅 어트리뷰션¶

• Android MMP 서비스와 연동에 사용되는 Hive SDK 식별자 중 did 값이 누락되는 오류를 수정합니다.

v4.25.2.0¶

본 SDK 버전의 개발 환경을 확인하세요.

새로운 기능¶

• All Unity 6.1 (6000.1)을 지원합니다.

매치 메이킹¶

• Windows 신규 기능으로 매치 메이킹을 지원합니다.

인증¶

• Windows 신규 인증 수단(IdP)으로 라인을 지원합니다.

프로비저닝¶

• Windows 계정 기반으로 약관을 노출하는 기능(agreementDetermineBase) 지원을 추가합니다.

변경한 기능¶

라이브러리 업데이트¶

• Android Airbridge(Android) v4.1.0 → v4.3.0
  • Adjust(Android) v5.0.1 → v5.2.0
  • Singular(Android) v12.6.1 → v12.7.0
  • AppsFlyer(Android) v6.15.2 → v6.16.2
  • GooglePlay Services-Auth(Android) v20.7.0 (지원중단)
  • Google Credential Play Services Auth(Android) v1.3.0 (신규지원)
• iOS Airbridge(iOS) v4.1.1 → v4.3.0
  • Adjust(iOS) v5.0.1 → v5.2.0
  • Singular(iOS) v12.6.1 → v12.7.1
  • AppsFlyer(iOS) v6.15.3 → v6.16.1
  • QQ(iOS) 3.5.17.3 → 3.5.17.4

마케팅 어트리뷰션¶

• All MMP 서비스와 연동을 지원하도록 Hive SDK 식별자를 추가로 전송합니다.
• Windows 마케팅 어트리뷰션 지원을 위해 Hive SDK 식별자를 추가로 전송합니다.
• All 이벤 수동 추적 시 커스텀 어트리뷰트를 추가하여 전송하도록 변경합니다.
• Android Airbridge 초기화 시, 마켓 출처 정보를 전송하도록 변경합니다.
• iOS sendEventWithAttributes API 사용 시, semantic value 타입의 부동소수점 값의 정밀도 범위를 float에서 double형으로 변경합니다.

빌링¶

• Android PG 결제로 구매한 상품을 환불한 경우, 이전 트랜잭션과 구분하기 위해 order_id 값을 추가합니다.
• Android Windows PG 결제 트랜잭션 완료 시, 구매 완료 로그를 마케팅 어트리뷰션을 통해 전송하도록 변경합니다.

인증¶

• All VK 인증 수단을 변경하여 제공합니다. 변경된 인증 방식은 신규 VK 개발자 콘솔에서 사용할 수 있습니다.
• iOS Apple GameCenter 로그인 시 사용하는 deprecated된 GameKit API의 검증 프로토콜을 업데이트합니다.
• Android Google Sign-In 라이브러리 지원 중단에 따라 묵시적 및 명시적 로그인 시 Google Credential Manager와 AuthorizationClient API로 인증하도록 변경합니다.

채팅¶

• All 메시지 데이터를 전송하거나 수신할 때 extraData를 추가로 전송하고 수신합니다.
• All 채팅 서버 연결 시, extraData를 더 이상 전송하지 않습니다.
• All 문자열 시간값이 아닌 정수형 시간값을 추가로 수신합니다.
• All 네트워크 차단 등 통신이 불가능한 상황에서 웹소켓을 정상적으로 해제하지 못하고 재연결을 시도할 때, 중복 연결 상태로 실패하지 않도록 변경합니다.

프로모션¶

• Android UserAcqutision 공유 시, Telegram이 지원하는 노출 목록에 추가되도록 변경합니다.
• Android 웹뷰 노출 시, 캐싱 정책을 변경합니다.

프로비저닝¶

• All 약관 상세보기 및 다시 보기 페이지에서 아래 경우에는 약관 페이지(웹뷰)가 아니라 외부 브라우저를 새로 열어서 로딩하도록 변경합니다.
  • 약관 URL을 벗어나는 웹페이지로 이동하는 경우
  • 약관 내 하이퍼링크 HTML 태그(a 태그, tel:// 등)를 클릭한 경우

해결한 버그¶

• Android 네트워크를 통한 통신 재시도가 필요하거나 분산 서버에 접속해야 하는 상황에서 설정된 최대 타임아웃 시간이 초과하기 전에 응답이 오는 경우, 더 이상 타임아웃을 기다리지 않고 즉시 통신 재시도를 하거나 분산 서버에 접속하도록 수정합니다.
• iOS Configuration 클래스의 setZone 메서드를 사용하여 Hive SDK에서 접속하는 서버 그룹 Zone이 변경되는 경우, hive_config.xml 파일의 gameLanguage 값이 초기화 되는 오류를 수정합니다.

마케팅 어트리뷰션¶

• Android Adjust를 사용하여 설치 여부를 판단하는 기능을 사용하는 경우, 내용이 없는 푸시 알림이 노출되는 현상을 수정합니다.
• Android Airbridge 사용 시 복수의 개수를 구매하는 이벤트가 발생한 경우, 단가와 개수에 따른 매출 정보를 전달하도록 수정합니다.

빌링¶

• Windows Hive SDK 메서드 콜백을 다중으로 중첩한 상태에서 다음 메서드중 하나를 호출 시 앱이 멈추는 문제를 수정했습니다.
  • IAPV4.transactionFinish
  • IAPV4.transactionMultiFinish
  • IAPV4.restore

인증¶

• iOS iOS 18 이상의 기기에서 QQ 웹로그인이 정상적으로 진행되지 않는 오류를 수정합니다.
• Windows 강화된 보안 프로토콜용 JWT 토큰이 Hive SDK 웹뷰를 활용한 통신에 전달되지 않는 이슈를 수정하였습니다.

채팅¶

• Android 채팅 연결시, 간헐적으로 연결이 실패하는 현상을 수정합니다.

프로비저닝¶

• All SDK의 초기화 이전에 광고 모듈(Adiz) 초기화 진행 시 COPPA나 GDPR와 같은 컴플라이언스를 준수하는 경우, 연령을 체크하는 AgeGate 값이 hive_config.xml에 설정된 값으로 동작하는 오류를 수정합니다.

알려진 이슈¶

마케팅 어트리뷰션¶

• Android MMP 서비스와 연동에 사용되는 Hive SDK 식별자 중 did 값이 누락되는 오류가 존재합니다. 해당 이슈가 해결된 SDK v4 Unity Android & iOS 25.2.1 버전을 사용하세요.

v4.25.1.3¶

본 SDK 버전의 개발 환경을 확인하세요.

변경한 기능¶

마케팅 어트리뷰션¶

• iOS Airbridge 디퍼드 딥링크 추적 기능을 신규 지원합니다.

빌링¶

• Android PG 결제의 동작 방식을 다른 빌링(IAPv4) 기능에 있는 마켓들과 동일하도록 변경합니다. PG 결제를 적용중이라면 PG 결제 문서를 참고해 코드 구현을 수정해야 합니다.

해결한 버그¶

마케팅 어트리뷰션¶

• iOS Adiz를 통해 광고수익 정보 전송 시, Airbridge에서 Adiz가 아닌 AdMob으로 전송되는 오류를 수정합니다.

빌링¶

• iOS 소비 정보 전송 동의 여부를 질의하는 팝업 UI를 노출 시, 배경화면이 불투명한 오류를 수정합니다.
• iOS 소비 정보 전송 동의 여부를 질의하는 팝업 UI를 닫을 시, 의도하지 않은 방향으로 앱의 화면 방향이 회전하는 오류를 수정합니다.

프로모션¶

• iOS 이미지가 포함된 리뷰팝업 노출 중 회전 이벤트가 발생하는 경우, 노출 중인 이미지가 사리지는 오류를 수정합니다.

v4.25.1.0¶

본 SDK 버전의 개발 환경을 확인하세요.

새로운 기능¶

기타¶

• Windows 구글 로그인 시 시크릿 모드 사용 여부를 설정할 수 있는 Configuration.setUsePrivateBrowsingForAuth 함수를 제공합니다.
  • hive_config.xml 파일에서도 설정을 제공합니다.
• Windows URL을 사용해 브라우저를 열 수 있는 PlatformHelper.openBrowser 함수를 제공합니다.

인증¶

• Windows 신규 인증 수단(IdP)으로 텔레그램을 지원합니다. Telegram 로그인을 위한 봇 설정을 참고하세요.
• Windows 인증 수단으로 X(구 Twitter)를 새롭게 지원합니다.
• Windows 인증된 세션을 공유하는 인웹브라우징 기능을 제공합니다.

변경한 기능¶

개발환경 변경¶

• Windows 필요한 Microsoft Visual C++ Redistributable 최소 버전을 14.42.34438로 업데이트합니다.

빌링¶

• Windows PG 결제의 동작 방식을 다른 빌링(IAPv4) 기능에 있는 마켓들과 동일하도록 변경합니다. PG 결제를 적용중이라면 PG 결제 문서를 참고해 코드 구현을 수정해야 합니다.

프로모션¶

• Windows additionalInfo로 전송하는 값에 불 필요한 정보가 담기지 않도록 수정합니다.

해결한 버그¶

인증¶

• Windows 사용자가 Hive 멤버십 이외의 로그인을 선택한 후 로그인을 취소했을 때, Hive SDK 컨트롤러로 마우스를 조작하는 기능이 작동하는 오류를 수정하였습니다.

v4.25.0.1¶

본 SDK 버전의 개발 환경을 확인하세요.

새로운 기능¶

마케팅 어트리뷰션¶

• iOS Adjust v5 가 적용된 Hive SDK v4 25.0.0 이상 사용 시, SDK에서 자동으로 수집하여 전송하는 did, vid 값이 전송되지 않는 오류를 수정합니다.

변경한 기능¶

개발환경 변경¶

• Windows 필요한 Microsoft Visual C++ Redistributable 최소 버전을 14.38.33130으로 업데이트합니다.

해결한 버그¶

빌링¶

• Windows JWT 토큰을 사용해 강화된 보안 프로토콜 사용 시 환불 유저 재결제가 노출되지 않는 이슈를 수정하였습니다.

v4.25.0.0¶

본 SDK 버전의 개발 환경을 확인하세요.

새로운 기능¶

기타¶

• Windows ASUS ROG Ally와 같은 터치스크린을 탑재한 핸드헬드 디바이스에서 터치 제스처을 지원합니다.
• Windows 게임 컨트롤러를 사용 시, 컨트롤러 키 맵핑을 신규 지원하며 일부 Hive UI 요소를 포커싱하고 조작할 수 있습니다.
• Windows 일반 마우스 커서 대신 사용자 정의 커서를 적용하도록 신규 지원합니다
• Windows 게임 컨트롤러의 조작을 활성화 혹은 비활성화할 수 있는 설정이 추가되었습니다.

마케팅 어트리뷰션¶

• All 마케팅 추적 이벤트 전송 시 Airbridge로 추가 어트리뷰트 전송하기 기능을 신규 지원합니다.
• Android Airbridge 디퍼드 딥링크 추적 기능을 신규 지원합니다.

매치 메이킹¶

• All 매치 메이킹 기능을 업데이트하여 그룹 매치 메이킹 기능을 신규 지원합니다. ※ 이전 버전의 Hive SDK 인터페이스와 호환되지 않습니다. 업데이트된 매치 메이킹 기능을 사용하려면 Hive SDK v4 25.0.0 이상을 사용해야 합니다.

빌링¶

• iOS 유저에게 인앱 상품 소비 정보를 Apple App Store로 전송할지 동의 여부를 질의하는 기능을 지원합니다.

인증¶

• All 신규 인증 수단(IdP)으로 텔레그램을 지원합니다. Telegram 로그인을 위한 봇 설정을 참고하세요.

채팅¶

• All 채팅 기능을 신규 지원합니다.

프로모션¶

• All 초대 코드를 입력한 유저가 앱을 설치한 경우 보상을 지급할 수 있도록 로그인 이벤트를 수집합니다.

변경한 기능¶

Unity¶

• All Hive Config Setting UI를 개선했습니다.

마케팅 어트리뷰션¶

• All Adjust v5를 지원하도록 업데이트합니다.
  • Adjust Signature 라이브러리를 제거합니다.
• All Adjust로 Adiz 광고 매출 집계 시 AdMob 소스로 광고 매출 소스를 전송하도록 변경합니다.
• Android Appsflyer 광고 매출 집계 라이브러리가 메인 라이브러리에 통합된 부분을 반영합니다.
  • 6.14.2 → 6.15.2
  • Appsflyer ad-revenue 라이브러리를 제거합니다.

인증¶

• All 더이상 사용하지 않는 Auth 모듈 클래스 및 인터페이스, 메서드, 대리자, 리스너를 삭제합니다
• All JWT 토큰을 사용해 더 강력한 보안 프로토콜을 적용합니다.
• All TalkPlus 지원 종료에 따라 TalkPlus 인증 토큰 메서드를 삭제합니다.
• Android Apple 로그인 웹뷰에서 로그인 기능 이외에 비밀번호 찾기 등과 같은 브라우징을 허용합니다.

프로모션¶

• Windows 새소식의 메뉴 탭에 새로운 컨텐츠 알림 표시를 추가했습니다.

허큘리스 업데이트¶

• All 2024.11.20

해결한 버그¶

기타¶

• Windows 루프 반복 조건을 최적화하여 CPU 사용량이 정상으로 복원되도록 수정했습니다. ※ 영향을 받는 버전(4.24.1.0 이상) 사용 중이라면, SDK v4 Unity Windows 25.0.0으로 업데이트 후 CPU 사용량이 안정화되는지 확인하세요.

빌링¶

• iOS UserEngagement를 사용해 인앱 상품 구매를 유도했을 때, IAP_UPDATE 이벤트가 추가로 발생하는 오류를 수정합니다.
• Windows Steam 결제 진행 중 ESC 키 또는 기타 키 조작으로 오버레이를 닫을 경우, 결제를 계속 진행할 수 없었던 문제를 수정하였습니다.

인증¶

• Android signIn 메서드 실행 중 네트워크 응답 지연이 발생하면 간헐적으로 UI 스레드를 점유하는 문제를 해결합니다.
• Windows 환불 유저 재결제 상태의 사용자가 PC에 로그인할 시, 발생하는 CommonUnknown 오류를 수정합니다.
• Windows 로그인 상태 유지 텍스트를 드래그했을 때 '개인정보 보호 경고' 문구가 나타나지 않도록 UI를 개선합니다.

알려진 이슈¶

마케팅 어트리뷰션¶

• iOS Adjust를 사용하는 경우 SDK에서 자동으로 수집하여 전송하는 did, vid 값이 전송되지 않는 오류가 있습니다. Hive SDK v4 25.0.1 이상으로 업데이트가 필요합니다.

v4.24.5.0¶

본 SDK 버전의 개발 환경을 확인하세요.

새로운 기능¶

• All Unity 6(Unity 6000)을 지원합니다.
• Windows Hive SDK v4 Unity Android & iOS 24.5.0 인터페이스와 호환을 위한 업데이트를 추가합니다.

매치 메이킹¶

• All 신규 기능으로 매치 메이킹 서비스를 지원합니다.

인증¶

• All 인증 수단으로 Steam, X(구 Twitter)를 새롭게 지원합니다.
  • 사전 준비: 공통
  • 사전 준비: Android
  • 사전 준비: iOS
  • 브랜딩 가이드
• Android 인증된 세션을 공유하는 인웹브라우징 기능을 제공합니다.

프로모션¶

• All 스팟 배너에서도 광고 노출이 가능합니다.
• Android 사용자 초대 공유하기 기능에 X(구 Twitter)를 지원합니다.

변경한 기능¶

인증¶

• All 충돌 팝업에서 노출하는 Provider 이름을 수정합니다.

플러그인¶

• iOS GameCenter 로그인을 사용하는 경우 빌드에 필요한 Entitlement 설정값을 자동으로 추가하도록 변경합니다.
  • 기존에는 GameCenter 로그인을 사용하더라도 Capability Manger 설정을 추가로 진행해야 했습니다.
  • Entitlement 설정값이 없는 경우 iOS 18 이상의 기기에서 정상적으로 로그인이 진행되지 않습니다.

해결한 버그¶

빌링¶

• iOS 일부 상품 가격이 부동 소수점으로 정확히 표현할 수 없는 가격일 때, 이 값을 JSON 포맷에서 순환 소수로 표현하지 않고 정확한 소수점으로 표현하도록 수정합니다.
  • 예> 4.99$ (string) → 4.9900000000000011 (double) → 4.99 (JSON number)

플러그인¶

• All 일부 외부 플러그인과 컴파일 오류를 발생시키는 인터페이스의 중복을 회피하도록 명시적 네임 스페이스를 사용합니다.
• Android Firebase 마케팅 추적 도구 또는 Huawei 인증 기능 사용시 Android 타겟 플랫폼에서 필요한 설정이 누락되는 오류(SDK v4 24.3.0 이상에서 발생)를 수정합니다.

v4.24.4.2¶

안내 사항: 본 SDK 버전은 별도 배포 파일을 제공하지 않으며, 해당 기능은 상위 버전 SDK에 포함됩니다.

변경한 기능¶

• Windows UI에서 사용하지 않는 불필요 리소스를 제거했습니다.

v4.24.4.1¶

본 SDK 버전의 개발 환경을 확인하세요.

새로운 기능¶

리모트 플레이¶

• Windows Hive SDK Unity Windows v4.24.4.1 이상부터 리모트 플레이를 지원합니다.

변경한 기능¶

인증¶

• Windows IdP 선택 UI에서 로그인 유지하기 UI 선택 여부를 보다 명확히 알 수 있도록 변경하였습니다.
• Windows IdP 선택 UI의 영문 번역 문구를 수정하였습니다.
  • 변경 전: Keep me logged in
  • 변경 후: Stay signed in

v4.24.4.0¶

본 SDK 버전의 개발 환경을 확인하세요.

새로운 기능¶

마케팅 어트리뷰션¶

• All Hive SDK에 특화된 서비스로 Airbridge를 지원합니다.
  • Airbridge로 이벤트 자동으로 추적하기
  • Airbridge로 이벤트 수동으로 추적하기

빌링¶

• Android Windows PG 결제 요청 시, IAPv4.purchase를 사용한 다중 수량 구매를 지원합니다.

원격 실행¶

• Windows 크로스플레이 런처 원격 실행을 지원합니다.

변경한 기능¶

플러그인¶

• All Android의 Package Name 또는 iOS의 Bundle Name이 자동으로 설정되는 기능이 Hive AppId를 통해 선택적으로 동작하도록 변경합니다.

해결한 버그¶

분석¶

• iOS 동의배너 선택지 하나만 선택한 경우 올바르게 반영되지 않는 오류를 수정합니다.

v4.24.3.0¶

본 SDK 버전의 개발 환경을 확인하세요.

새로운 기능¶

마케팅 어트리뷰션¶

• Windows Appsflyer 1.0.1 ???+ warning Appsflyer(Steam 전용) 1.0.1이 출시되었습니다. Hive SDK v4 24.0.0 버전 이상부터는 마케팅 어트리뷰션 기능으로 Appsflyer 1.0.1 버전 이상만 지원합니다.

프로비저닝¶

• All 약관 화면에서 법정 대리인 동의를 받았는지 확인하는 기능을 추가합니다.

변경한 기능¶

라이브러리 업데이트¶

• 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

마케팅 어트리뷰션¶

• All Adjust Signature 버전을 v1 에서 v3로 변경합니다.

인증¶

• All 로그아웃 동작을 변경합니다. * 기존: signOut 호출 시 Hive SDK에서 사용자 계정을 로그아웃
게스트는 signOut APi 호출 시 서버에서 실패 응답 * 변경: signOut 호출 시 Hive SDK는 Hive 서버에 사용자 계정을 로그아웃시켜도 되는지 확인 요청 후 응답 결과에 따라 로그아웃
• All 게스트 계정 로그아웃 시 더는 성공 응답을 반환하지 않고, 에러 코드를 반환합니다. Hive SDK와 Hive 서버에서 게스트 계정 세션을 유지합니다.
• All 이용 정지 계정은 자동으로 IdP 로그아웃을 시켜서 동일 IdP 다른 계정으로 로그인할 수 있도록 변경합니다. 자동 로그인을 할 수 없는 경우에만 해당합니다.
• All AuthV4.connect 메서드로 IdP 연동을 진행할 때, 이용 정지 계정으로 계정을 전환하면, 로그아웃을 수행하도록 변경합니다.
• All 기기 관리 서비스에서 국제 전화 국가 번호를 기기 접속 지역에 따라 자동으로 적용하도록 변경합니다.
• iOS 앱 추적 투명화(ATT) 동의를 거절한 경우에도 페이스북 로그인을 할 수 있도록 변경합니다.
• Windows 성인 인증 후 기기 관리 서비스 가입 시, 휴대폰 번호 1개로 가입 가능한 계정 수를 초과했을 때, "같은 휴대폰 번호로 가입할 수 있는 계정 수를 초과했습니다" 라는 에러 메세지를 표시합니다.

프로모션¶

• All additionalInfo로 전송하는 값에 불 필요한 정보가 담기지 않도록 수정합니다.
• All 2:3 또는 3:2 비율로 전면 배너를 노출할 수 있도록 변경합니다.
• All 전면 배너에서 "1일 동안 그만 보기" 텍스트를 "오늘은 그만 보기"로 변경합니다.

플러그인¶

• All Hive External Dependency Manager로 관리하는 XML 파일 개수를 최소화합니다.

해결한 버그¶

• Android 리소스 참조 로직을 수정하여 메모리를 확보하지 못했던 오류를 수정합니다.
• iOS iOS 14 기기에서 앱 추적 투명화(ATT) 동의 여부를 확인할 때 간헐적으로 크래시가 발생하는 오류를 수정합니다.
• iOS 사진첩에서 접근 제한(일부 사진만 접근 허용)을 선택하면 크래시가 발생하는 오류를 수정합니다.

노티피케이션¶

• Android 로컬 푸시 알림에서 지원하지 않는 type 설정 시 푸시 메시지가 정상 노출되지 않는 오류를 수정합니다.
• iOS 앱 버전 정보를 전송하도록 수정합니다.

v4.24.2.1¶

안내 사항: 본 SDK 버전은 별도 배포 파일을 제공하지 않으며, 해당 기능은 상위 버전 SDK에 포함됩니다.

새로운 기능¶

커뮤니티¶

• Windows Hive 규약을 따르는 커뮤니티에서 withhive.com, com2us.com 이 아닌 커스텀 도메인 주소를 사용할 수 있도록 변경합니다.

v4.24.1.3¶

안내 사항: 본 SDK 버전은 별도 배포 파일을 제공하지 않으며, 해당 기능은 상위 버전 SDK에 포함됩니다.

변경한 기능¶

인증¶

• All 기기 관리 서비스에서 국제 전화 국가 번호를 기기 접속 지역에 따라 자동으로 적용하도록 변경합니다.

v4.24.2.0¶

본 SDK 버전의 개발 환경을 확인하세요.

새로운 기능¶

• All GDPR을 적용하는 EU 및 EEA 지역에서 16세 미만 유저가 약관에 동의했는지 여부를 반환하는 기능을 제공합니다. 16세 미만 여부를 확인할 수 있습니다.
• Android Android OS 11 이상 기기 또는 지원하는 모듈을 설치한 기기에서 사진첩을 사용할 때 PhotoPicker를 기본으로 사용합니다.
• iOS MacOS 콘솔 앱에서도 Hive SDK 디버그 로그를 확인할 수 있으며, Hive SDK 로그중 특정 로그 타입을 선택해서 볼 수 있습니다.
• All Unity Editor에서 Hive SDK 디버그 로그 노출을 제어하는 기능을 제공합니다.

인증¶

• All 휴대폰 번호 1개로 가입 가능한 계정 수를 초과했을 때, 인증 번호 발송을 요청하면 "같은 휴대폰 번호로 생성할 수 있는 계정 수를 초과했습니다."라는 에러 메시지를 표시합니다.
• Windows 스팀 IdP 묵시적 로그인을 지원합니다. AuthV4.Helper.signIn을 사용하세요.

프로모션¶

• All 크로스 프로모션의 노출을 제어할 수 있는 기능을 제공합니다.
• All 오늘은 그만보기 기능을 개선한 N일 동안 그만보기를 지원합니다.

변경한 기능¶

노티피케이션¶

• Android Amazon 신규 Fire 기기에서 동작하는 런타임 라이브러리(Push Amazon Device Message 1.2.0)에 대응합니다.

라이브러리 업데이트¶

• Android Samsung GalaxyStore IAP 6.1 → 6.1.1 Amazon Device Message 1.0.1 → 1.2.0

분석¶

• iOS 앱에서 크래시 발생 시 미전송 로그를 파일에 저장하는 옵션인 saveAnalyticsLogBeforeCrash 설정값 기본값을 false로 변경합니다.

인증¶

• Windows 구글 로그인 시 Google Play Games 정보를 확인하는 games_lite 권한을 받지 않도록 변경합니다.

프로모션¶

• iOS 게임 초대(UA) 기능 사용 시 클립보드 붙여넣기 권한 동의 팝업 노출을 최소화하여 사용성을 개선합니다.
  1. 권한 동의 팝업을 노출하는 시점을 초대받은 사용자가 앱을 실행하자마자에서 앱 실행 후 Hive SDK 초기화하는 시점으로 변경했습니다.
  2. 클립보드에 초대자 URL 데이터가 존재할 때에만 팝업을 노출하도록 변경했습니다.

해결한 버그¶

마케팅 어트리뷰션¶

• Android 커스터마이징한 약관으로 초기화 수행 시 Adjust 이벤트 발송이 지연되는 오류를 수정합니다.

인증¶

• All 중국에서 접속한 사용자에 대한 실명 인증 과정에서 문자 발송 회수 초과 시 남은 시간을 초기화하지 않고 오류 메시지를 노출하도록 수정합니다.
• Android Google Play 로그인 진행 중 뒤로가기 키를 누름으로써 로그인을 하지 않은 경우, 적절한 응답 콜백이 없었던 오류를 수정합니다.
• Android 낮은 해상도 기기에서 키보드 입력을 수행할 수 없었던 오류를 수정합니다.
• Windows 기기 관리 서비스 본인 확인을 위한 휴대폰 인증 화면에서, 에러 팝업 노출 시 "이전 페이지로 돌아가기"를 클릭했음에도 이전 화면으로 돌아가지 않는 현상을 수정하였습니다.
• Windows 기기 관리 서비스 본인 확인을 위한 휴대폰 인증 화면의 인증 번호 입력란이 활성화된 상태일 때, 마우스 휠을 조작하면 입력란에 값이 입력되는 현상을 수정하였습니다.
• Windows 중첩된 콜백 내부에서 AuthV4.Helper.switchAccount, AuthV4.Helper.resolveConflict를 호출하는 경우 Hive SDK 콜백 전달이 불가능한 현상을 수정했습니다.
• Windows AuthV4.Helper.switchAccount, AuthV4.Helper.resolveConflict에서 PlayerInfo Unity Plugin 매개변수 전달을 할 수 없었던 문제를 수정합니다.

프로모션¶

• iOS 새소식 뷰에서 새로운 프레임 뷰 노출하기 동작 시 프리징이 발생하는 오류를 수정합니다.
• Windows Promotion Custom Direct Fullscreen에서 Frame으로 이동하는 경우 크래쉬 발생 현상을 수정합니다.

프로비저닝¶

• Windows 약관 다시 보기를 할 때 과거에 저장된 데이터가 아니라 Hive 서버에서 새롭게 내려준 약관 URL 데이터를 사용하도록 수정했습니다.

v4.24.1.2¶

본 SDK 버전의 개발 환경을 확인하세요.

해결한 버그¶

인증¶

• Android 구글 로그인 진행중 뒤로가기 버튼을 눌러 로그인을 취소했을 때 적절한 응답 콜백이 없었던 오류를 수정합니다. 이 버그는 Hive 콘솔 내에 Google Legacy Support 값이 참인 경우에만 발생했습니다.
• Android 낮은 해상도 기기에서 키보드 입력을 할 수 없었던 오류를 수정합니다.

v4.24.1.0¶

본 SDK 버전의 개발 환경을 확인하세요.

변경한 기능¶

• Windows Hive SDK가 구현한 UI상에서 게임 컨트롤러를 통한 마우스 이동 기능을 지원합니다.

라이브러리 업데이트¶

• iOS AppsFlyer(iOS) v6.13.1 → v6.14.3 QQ (iOS) v3.5.14 → v3.5.16 Facebook SDK v17.0.0 → v16.2.1

분석¶

• iOS 기기의 추적 동의 여부에 따라 동의배너 노출여부를 결정하도록 변경합니다.
  • 추적 동의를 거절한 경우에는 동의배너를 노출하지 않습니다.

해결한 버그¶

빌링¶

• iOS Hive SDK v4 24.0.0 미만 버전(예: v4 23.4.0)에서 v4 24.0.0으로 업데이트하는 경우, 상품 조회가 되지 않는 오류를 수정합니다.

v4.24.0.0¶

본 SDK 버전의 개발 환경을 확인하세요.

새로운 기능¶

• Windows 게임 서비스 종료 후 Hive SDK 초기화를 시도하면 에러 코드를 반환하는 기능이 추가되었습니다.

빌링¶

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

인증¶

• Windows Hive 커뮤니티 로그인을 통한 PC 게임 자동 로그인 기능이 추가되었습니다.

프로모션¶

• Android 외부 페이지 노출을 위해 기기에 설정된 기본 브라우저를 이용하는 커스텀 탭을 지원합니다. PlatformHelper 클래스 showInAppBrowser 메서드로 인앱 브라우저를 노출할 수 있습니다.
• iOS 외부 페이지 노출을 위해 브라우저를 이용하는 SafariViewController를 지원합니다. PlatformHelper 클래스 showInAppBrowser 메서드로 인앱 브라우저를 노출할 수 있습니다.

변경한 기능¶

• iOS 앱 버전을 구분할 때 CFBundleShortVersionString을 추가로 사용합니다.
• Windows HIVE SDK의 UI 및 웹뷰가 모니터 해상도가 아닌, DPI 설정에 따라 출력되도록 변경되었습니다.

라이브러리 업데이트¶

• 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
• iOS WeChat 2.0.2 → 2.0.4
• Hercules 2024.01.23 → 2024.04.11
• Singular 12.3.2 → 12.4.1
• Windows Steamworks 1.55 → 1.59

분석¶

• Android Firebase 이벤트 수집 기능 중 광고 식별자 수집 설정 기본값을 true로 변경합니다.

빌링¶

• All 환불 유저 재결제 UI에서 노출되는 PG 결제 타입 문구를 "HiveStore"에서 "PG 결제"로 변경했습니다.
• Android PG 결제 페이지를 인앱 브라우저가 아니라 인앱 웹뷰에서 노출하도록 변경합니다. 인앱 브라우저 환경을 지원하지 않는 기기에서도 PG 결제를 지원합니다.

인증¶

• Windows 구글 로그인 시, 윈도우에 설정된 기본 웹 브라우저의 ‘시크릿 모드’를 사용하여 로그인할 수 있도록 변경되었습니다. 해당하는 웹 브라우저는 아래와 같습니다.
  • Google Chrome
  • Microsoft Edge
  • Mozilla Firefox
  • Naver whale
• Windows 상위 웹브라우저 외 다른 웹브라우저로 로그인하는 경우, ‘일반 모드’를 사용하여 로그인합니다.

해결한 버그¶

기타¶

• Windows 특정 사이즈의 윈도우에서 클릭 등의 입력 이벤트 수행시 UI가 깜빡거리는 오류를 수정했습니다.

빌링¶

• Windows 환불 유저 재결제 UI에서 PG결제가 Hive Store로 노출되는 오류를 수정했습니다.
• Windows 환불 유저 재결제 UI의 아랍어 화면에서 아랍어 특성에 맞는 UI를 사용하도록 수정했습니다.

인증¶

• Windows 중국 실명 인증 시, 인증 시간 만료 후에 인증 번호 입력이 가능한 오류를 수정했습니다.
• Windows 특정 웹페이지(애플 로그인 등)의 언어가 영문으로만 출력되는 오류를 수정하였습니다.
• Windows 중첩된 콜백 함수 내부에서 IAPv4 getSubscriptionProductInfo이 호출될 때, SDK의 callback 전달이 불가능한 오류를 수정했습니다.
• Windows 구글 로그인 시, 구글로부터 프로필 사진을 전달받지 못하면 로그인에 실패하는 오류를 수정하였습니다. (프로필 사진을 전달받지 못해도 로그인 가능하도록 수정하였습니다.)

프로모션¶

• Windows getBannerInfo, getBannerInfoString 함수가 동작하지 않는 오류를 수정했습니다.
• Windows Promotion API가 AuthV4 인증과 무관하게 동작하도록 수정했습니다.

알려진 이슈¶

인증¶

• iOS Facebook SDK iOS 17.0.0 사용 시 iOS 17.0 이상 기기에서 사용자가 "앱 추적 투명성(App Tracking Transparency)"에 동의하지 않는 경우 로그인을 할 수 없는 문제가 있습니다. 해당 조건에서 Facebook 로그인을 구현하려면 Hive SDK v4 24.1.0을 사용하세요.