Android

v4.25.1.3¶

다운로드¶

주의 사항¶

• 인증 보안 프로토콜 변경으로 Hive SDK v4 Native Android 25.0.0 이상 사용 시, 반드시 Hive 콘솔 > 보안 키 설정에서 보안 키를 발급 받아야 합니다. 보안 키를 발급받지 않으면 앱에서 로그인할 수 없습니다.

• PG 결제 프로세스의 변경으로 인해, Hive SDK v4 Native Android 25.1.3 이상에서 PG 결제를 사용하려면 PG 결제 동작 과정을 참고하여 코드 구현을 수정해야 합니다.

개발 환경¶

필수 항목¶

• Kotlin (Android) v1.9.22
• Kotlin Coroutine (Android) 1.4.3
• AndroidX (Android) v1.2.0+
• Constraint Layout (Android) v2.1.4
• Glide (Android) v4.13.0

선택 항목¶

IDP¶

• Facebook SDK Android v17.0.0
• GooglePlay Services-Auth (Android) v20.7.0
• GooglePlay Services-Games v2 (Android) v20.1.2
• QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
• VK (Android) v3.5.1
• WeChat (Android) v6.8.0
• LINE (Android) v5.10.0
• Huawei (Android) v6.12.0.300

IAP¶

• Google Billing Library (Android) v7.0.0
• Samsung GalaxyStore IAP (Android) v6.1.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.2.0
• FCM(FirebaseCloudMessaging) (Android) v24.0.2

MARKETING TRACKING ANALYTICS¶

• Airbridge(Android) v4.1.0
• Adjust(Android) v5.0.1
• Singular(Android) v12.6.1
• AppsFlyer(Android) v6.15.2
• FirebaseAnalytics(Android) v22.1.2

CHAT¶

• OkHttp(Android) v4.12.0

기타¶

• GooglePlay Services-Review (Android) v2.0.1
• GooglePlay Services-AppUpdate (Android) v2.1.0
• Google reCaptcha (Android) v18.6.1
• YoutubeAndroidWebPlayerApi (Android) v1.0.1

새로운 기능¶

• 해당 없음

변경한 기능¶

빌링¶

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

해결한 버그¶

• 해당 없음

v4.25.0.1¶

다운로드¶

주의 사항¶

인증 보안 프로토콜 변경으로 Hive SDK v4 Native Android 25.0.0 이상 사용 시, 반드시 Hive 콘솔 > 보안 키 설정에서 보안 키를 발급 받아야 합니다. 보안 키를 발급받지 않으면, 앱 사용자들은 앱에서 로그인을 할 수 없습니다.

개발 환경¶

필수 항목¶

• Kotlin (Android) v1.9.22
• Kotlin Coroutine (Android) 1.4.3
• AndroidX (Android) v1.2.0+
• Constraint Layout (Android) v2.1.4
• Glide (Android) v4.13.0

선택 항목¶

IDP¶

• Facebook SDK Android v17.0.0
• GooglePlay Services-Auth (Android) v20.7.0
• GooglePlay Services-Games v2 (Android) v20.0.0
• QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
• VK (Android) v3.5.1
• WeChat (Android) v6.8.0
• LINE (Android) v5.10.0
• Huawei (Android) v6.12.0.300

IAP¶

• Google Billing Library (Android) v7.0.0
• Samsung GalaxyStore IAP (Android) v6.1.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.2.0
• FCM(FirebaseCloudMessaging) (Android) v24.0.2

MARKETING TRACKING ANALYTICS¶

• Airbridge(Android) v4.1.0
• Adjust(Android) v5.0.1
• Singular(Android) v12.6.1
• AppsFlyer(Android) v6.15.2
• FirebaseAnalytics(Android) v22.1.2

CHAT¶

• OkHttp(Android) v4.12.0

기타¶

• GooglePlay Services-Review (Android) v2.1.0
• GooglePlay Services-AppUpdate (Android) v2.1.0
• Google reCaptcha (Android) v18.6.1
• YoutubeAndroidWebPlayerApi (Android) v1.0.1

새로운 기능¶

• 해당 없음

변경한 기능¶

• 해당 없음

해결한 버그¶

• 해당 없음

v4.25.0.0¶

다운로드¶

주의 사항¶

인증 보안 프로토콜 변경으로 Hive SDK v4 Native Android 25.0.0 사용 시, 반드시 Hive 콘솔 > 보안 키 설정에서 보안 키를 발급받아야 합니다. 보안 키를 발급받지 않으면, 앱 사용자들은 앱에서 로그인을 할 수 없습니다.

개발 환경¶

필수 항목¶

• Kotlin (Android) v1.9.22
• Kotlin Coroutine (Android) 1.4.3
• AndroidX (Android) v1.2.0+
• Constraint Layout (Android) v2.1.4
• Glide (Android) v4.13.0

선택 항목¶

IDP¶

• Facebook SDK Android v17.0.0
• GooglePlay Services-Auth (Android) v20.7.0
• GooglePlay Services-Games v2 (Android) v20.0.0
• QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
• VK (Android) v3.5.1
• WeChat (Android) v6.8.0
• LINE (Android) v5.10.0
• Huawei (Android) v6.12.0.300

IAP¶

• Google Billing Library (Android) v7.0.0
• Samsung GalaxyStore IAP (Android) v6.1.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.2.0
• FCM(FirebaseCloudMessaging) (Android) v24.0.2

MARKETING TRACKING ANALYTICS¶

• Airbridge(Android) v4.1.0
• Adjust(Android) v5.0.1
• Singular(Android) v12.6.1
• AppsFlyer(Android) v6.15.2
• FirebaseAnalytics(Android) v22.1.2

CHAT¶

• OkHttp(Android) v4.12.0

기타¶

• GooglePlay Services-Review (Android) v2.1.0
• GooglePlay Services-AppUpdate (Android) v2.1.0
• Google reCaptcha (Android) v18.6.1
• YoutubeAndroidWebPlayerApi (Android) v1.0.1

새로운 기능¶

인증¶

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

마케팅 어트리뷰션¶

• 마케팅 추적 이벤트 전송 시 Airbridge로 추가 어트리뷰트 전송하기 기능을 신규 지원합니다.

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

채팅¶

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

매치 메이킹¶

• 매치 메이킹 기능을 업데이트하여 그룹 매치 메이킹 기능을 신규 지원합니다.

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

변경한 기능¶

인증¶

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

프로모션¶

• 초대 코드 정확도 향상을 위해 로그인 이벤트를 수집합니다.

마케팅 어트리뷰션¶

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

기타¶

• 허큘리스 라이브러리 버전을 업데이트합니다.
  • Android: 20241120

해결한 버그¶

인증¶

• signIn 메서드 실행 중 네트워크 응답 지연이 발생하면 간헐적으로 UI 스레드를 점유하는 문제를 해결합니다.

개발자 가이드 변경 사항¶

• 마케팅 어트리뷰션의 Adjust Signature 라이브러리를 제거로 인해 SDK Signature 연동 방법 변경되었습니다.

개발 환경 업데이트¶

Android¶

• AppsFlyer v6.14.2 → v6.15.2
• Adjust v4.38.5 → v5.0.1
• Singular v12.6.0 → v12.6.1

v4.24.5.0¶

다운로드¶

개발 환경¶

필수 항목¶

• Kotlin (Android) v1.9.22
• Kotlin Coroutine (Android) 1.4.3
• AndroidX (Android) v1.0.0+
• Constraint Layout (Android) v2.1.4
• Glide (Android) v4.13.0

선택 항목¶

IDP¶

• Facebook SDK Android v17.0.0
• GooglePlay Services-Auth (Android) v20.7.0
• GooglePlay Services-Games v2 (Android) v20.0.0
• QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
• VK (Android) v3.5.1
• WeChat (Android) v6.8.0
• LINE (Android) v5.10.0
• Huawei (Android) v6.12.0.300

IAP¶

• Google Billing Library (Android) v7.0.0
• Samsung GalaxyStore IAP (Android) v6.1.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.2.0
• FCM(FirebaseCloudMessaging) (Android) v24.0.2

MARKETING TRACKING ANALYTICS¶

• Airbridge(Android) v4.1.0
• Adjust(Android) v4.38.5
• adjust-android-signature-3.20.1.aar
• Singular(Android) v12.6.0
• AppsFlyer(Android) v6.14.2
• FirebaseAnalytics(Android) v22.1.2

기타¶

• GooglePlay Services-Review (Android) v2.1.0
• GooglePlay Services-AppUpdate (Android) v2.1.0
• Google reCaptcha (Android) v18.6.1
• YoutubeAndroidWebPlayerApi (Android) v1.0.1

새로운 기능¶

인증¶

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

매치 메이킹¶

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

프로모션¶

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

변경한 기능¶

인증¶

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

해결한 버그¶

• N/A

개발자 가이드 변경 사항¶

• 크로스 프로모션 전면 배너 노출에서 showCustomContents 메서드로 스팟 배너 노출 시 주의 사항을 노트에 업데이트했습니다.

개발 환경 업데이트¶

Android¶

• Google reCaptcha 18.4.0 → 18.6.1
• Kotlin 1.8.0 → 1.9.22
• FCM(FirebaseCloudMessaging) 23.2.1 → 24.0.2
• AppsFlyer 6.13.0 → 6.14.2
• Singular 12.5.4 → 12.6.0
• Firebase 21.5.0 → 22.1.2

v4.24.4.0¶

다운로드¶

개발 환경¶

필수 항목¶

• 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

선택 항목¶

IDP¶

• Facebook SDK Android v17.0.0
• GooglePlay Services-Auth (Android) v20.7.0
• GooglePlay Services-Games v2 (Android) v20.0.0
• QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
• VK (Android) v3.5.1
• WeChat (Android) v6.8.0
• LINE (Android) v5.10.0
• Huawei (Android) v6.12.0.300

IAP¶

• Google Billing Library (Android) v7.0.0
• Samsung GalaxyStore IAP (Android) v6.1.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.2.0
• FCM(FirebaseCloudMessaging) (Android) v23.2.1

MARKETING TRACKING ANALYTICS¶

• Airbridge(Android) v4.1.0
• Adjust(Android) v4.38.5
• adjust-android-signature-3.20.1.aar
• Singular(Android) v12.5.4
• AppsFlyer(Android) v6.13.0<
• FirebaseAnalytics(Android) v21.5.0

기타¶

• GooglePlay Services-Review (Android) v2.1.0
• GooglePlay Services-AppUpdate (Android) v2.1.0
• Google reCaptcha (Android) v18.4.0
• YoutubeAndroidWebPlayerApi (Android) v1.0.1

새로운 기능¶

마케팅 어트리뷰션¶

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

빌링¶

• PG를 통한 결제 시, 단일 상품을 원하는 수량만큼 구매할 수 있는 기능을 제공합니다.

변경한 기능¶

• N/A

해결한 버그¶

• N/A

개발 환경 업데이트¶

Android¶

• N/A

v4.24.3.0¶

다운로드¶

개발 환경¶

필수 항목¶

• 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.2
• 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.16
• 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) v7.0.0
• Samsung GalaxyStore IAP (Android) v6.1.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.2.0
• FCM(FirebaseCloudMessaging) (Android) v23.2.1

MARKETING TRACKING ANALYTICS¶

• Adjust(Android) v4.38.5
• adjust-android-signature-3.20.1.aar
• Adjust(iOS) v4.38.4
• AdjustSigSdk 3.20.1
• Singular(Android) v12.5.4
• Singular(iOS) v12.4.1
• AppsFlyer(Android) v6.13.0
• AppsFlyer(iOS) v6.14.3
• 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

새로운 기능¶

프로비저닝¶

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

변경한 기능¶

인증¶

• 로그아웃 동작을 변경합니다.
  • 기존: `signOut` 호출 시 Hive SDK에서 사용자 계정을 로그아웃
  게스트는 signOut APi 호출 시 서버에서 실패 응답
  • 변경: `signOut` 호출 시 Hive SDK는 Hive 서버에 사용자 계정을 로그아웃시켜도 되는지 확인 요청 후 응답 결과에 따라 로그아웃
• 게스트 계정 로그아웃 시 더는 성공 응답을 반환하지 않고, 에러 코드를 반환합니다. Hive SDK와 Hive 서버에서 게스트 계정 세션을 유지합니다.
• 이용 정지 계정은 자동으로 IdP 로그아웃을 시켜서 동일 IdP 다른 계정으로 로그인할 수 있도록 변경합니다. 자동 로그인을 할 수 없는 경우에만 해당합니다.
• `AuthV4.connect` 메서드로 IdP 연동을 진행할 때, 이용 정지 계정으로 계정을 전환하면, 로그아웃을 수행하도록 변경합니다.
• 기기 관리 서비스에서 국제 전화 국가 번호를 기기 접속 지역에 따라 자동으로 적용하도록 변경합니다.

프로모션¶

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

마케팅 어트리뷰션¶

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

해결한 버그¶

Hive SDK 공통¶

• 리소스 참조 로직을 수정하여 메모리를 확보하지 못했던 오류를 수정합니다.

노티피케이션¶

• 로컬 푸시 알림에서 지원하지 않는 `type` 설정 시 푸시 메시지가 정상 노출되지 않는 오류를 수정합니다.

개발 환경 업데이트¶

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세 미만 여부를 확인할 수 있습니다.
• Android OS 11 이상 기기 또는 지원하는 모듈을 설치한 기기에서 사진첩을 사용할 때 PhotoPicker를 기본으로 사용합니다.

인증¶

• 휴대폰 번호 1개로 가입 가능한 계정 수를 초과했을 때, 인증 번호 발송을 요청하면 "같은 휴대폰 번호로 생성할 수 있는 계정 수를 초과했습니다."라는 에러 메시지를 표시합니다.

프로모션¶

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

변경한 기능¶

노티피케이션¶

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

해결한 버그¶

인증¶

• 중국에서 접속한 사용자에 대한 실명 인증 과정에서 문자 발송 회수 초과 시 남은 시간을 초기화하지 않고 오류 메시지를 노출하도록 수정합니다.
• Google Play 로그인 진행 중 뒤로가기 키를 누름으로써 로그인을 하지 않은 경우, 적절한 응답 콜백이 없었던 오류를 수정합니다.
• 낮은 해상도 기기에서 키보드 입력을 수행할 수 없었던 오류를 수정합니다.

마케팅 어트리뷰션¶

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

개발 환경 업데이트¶

Android¶

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

개발자 가이드 변경점¶

• Hive SDK v4 24.2.0부터 Facebook Cloud Games 지원을 중단함에 따라 아래 페이지들에 해당 내용을 추가했습니다.
  • Unity 설정하기
  • Unity 설정하기 > Facebook Cloud Games 설정
  • Android 설정하기
  • 빌링
  • 노티피케이션
• Hive 러비 상점 선택 화면에 관한 설명을 보강했습니다.

v4.24.1.3¶

다운로드¶

변경한 기능¶

인증¶

• 기기 관리 서비스 이용중 모바일 기기 등록 시, 국제 전화 국가 번호를 `+82`가 아니라 기기 접속 지역에 따라 자동으로 적용하도록 변경합니다.

v4.24.1.2 (2024-06-27)¶

해결한 버그¶

인증¶

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

v4.24.1.0 (2024-05-14)¶

새로운 기능¶

N/A

변경한 기능¶

N/A

개발 환경 업데이트¶

N/A

개발자 가이드 변경점¶

N/A

v4.24.0.0 (2024-04-30)¶

새로운 기능¶

프로모션¶

• 외부 페이지 노출을 위해 기기에 설정된 기본 브라우저를 이용하는 커스텀 탭을 지원합니다. `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

개발자 가이드 변경점¶

• `displayOriginalPrice` 설명을 변경했습니다.
• `displayPrice` 하단 Note 설명을 변경했습니다.