Android & iOS

v4.24.5.0¶

Download¶

Development environment¶

Unity (Android)¶

• Unity 2021.3.0+
• Unity 2022.3.0+
• Unity 2023.1.0+
• Unity 6000.0.0+

Unity versions compatible with targetSDK version¶

The following are the Unity versions compatible with Android build targetSDK versions after Hive SDK v4.24.5.0.

• When building targetSDK 33
  • Buildable with Unity 2021 or later (based on Unity's built-in JDK and Gradle)
• When building targetSDK 34
  • Buildable with Unity 2022 or later (based on Unity's built-in JDK and Gradle)
  • Buildable with Unity 2021.3.43f or later (based on Unity's built-in JDK and Gradle)
• When building targetSDK 35
  • Buildable with Unity 6000 or later (based on Unity's built-in JDK and Gradle)

Unity (iOS)¶

• Unity 2021.3.0+
• Unity 2022.3.0+
• Unity 2023.1.0+
• Unity 6000.0.0+

Android¶

iOS¶

• Xcode 15.3 or later
• The Xcode version should be updated following the Apple App Store policy.

Required¶

• 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
• SDWebImage (iOS) v5.19.7

Optional¶

IDP¶

• Facebook SDK Android v17.0.0
• Facebook SDK iOS v17.1.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.17
• 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) v24.0.2

MARKETING TRACKING ANALYTICS¶

• Airbridge(Android) v4.1.0
• Airbridge(iOS) v4.1.0
• Adjust(Android) v4.38.5
• adjust-android-signature-3.20.1.aar
• Adjust(iOS) v4.38.4
• AdjustSigSdk 3.20.1
• Singular(Android) v12.6.0
• Singular(iOS) v12.5.0
• AppsFlyer(Android) v6.14.2
• AppsFlyer(iOS) v6.15.3
• FirebaseAnalytics(Android) v22.1.2
• FirebaseAnalytics(iOS) v10.29.0

Others¶

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

What's new¶

Unity¶

• Unity Supports Unity 6 (Unity 6000).

Authentication¶

• All Newly supports Steam and X (formerly Twitter) as authentication methods.
  • Preparation: All Engines
  • Preparation: Android
  • Preparation: iOS
  • Branding Guide
• All Provides in-app browsing that provides authenticated sessions for web-view.

Matchmaking¶

• All Match making is newly available helping gamers play with other gamers.

Promotion¶

• All Ads can now be exposed on spot banners.
• Android Supports X (formerly Twitter) for the sharing the user invitation feature.

Changed features¶

Plugin¶

• 1.2.178 → 1.2.183
• Unity When using GameCenter login, it is changed to automatically adds the necessary Entitlement settings for the build.
  • Previously, additional Capability Manager settings were required even when using GameCenter login.
  • Without Entitlement settings, login will not proceed correctly on devices with iOS 18 or higher.

Authentication¶

• All Modified Provider name displayed on the conflict popup.

Fixed Bugs¶

Plugin¶

• Unity Changed to use explicit namespaces to avoid the duplication of interface causing some external plugin errors and compile errors.
• Unity Fixed an error (occur in SDK v4 24.3.0 or higher) that configurations required in Android target platform is missing when using Firebase marketing tracking tools or Huwawi authentication.

Billing¶

• iOS Some product prices that cannot be accurately represented as floating-point numbers are now correctly represented as exact decimals in JSON format.
  • Example: 4.99$ (string) → 4.9900000000000011 (double) → 4.99 (JSON number)

Developer guide changes¶

• Updated the note for cross-promotion interstitial banner exposure when displaying spot banners using the showCustomContents method.
• Added a note for using Steam login on iOS.

Development environment updates¶

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

iOS¶

• SDWebImage 5.18.7 → 5.19.7
• reCaptcha 18.4.0 → 18.6.0
• Facebook 17.0.2 → 17.1.0
• QQ 3.5.16 → 3.5.17 (custom)
• AppsFlyer 6.14.3 → 6.15.3
• Singular 12.4.1 → 12.5.0
• Firebase 10.22.0 → 10.29.0

v4 24.4.0¶

Download¶

Development environment¶

Unity (Android )¶

• Unity 2021.3.0+
• Unity 2022.3.0+
• Unity 2023.1.0+

Unity compatible versions according to targetSDK version¶

The following are the Unity versions compatible with Android build targetSDK versions after Hive SDK v4.23.0.0. .

• When building targetSDK 33
  • Buildable with Unity 2021 or later (based on Unity's built-in JDK and Gradle)
• When building targetSDK 34
  • Buildable with Unity 2022 or later (based on Unity's built-in JDK and Gradle)

Unity (iOS)¶

• Unity 2021.3.0+
• Unity 2022.3.0+
• Unity 2023.1.0+

Android¶

iOS¶

• Xcode 15.3 or later
• Xcode version Apple App Store Policies require updates.

REQUIRED¶

• 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

OPTIONAL¶

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¶

• Airbridge(Android) v4.1.0
• Airbridge(iOS) v4.1.0
• 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

Else¶

• 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

What's new¶

Marketing Attribution¶

• We support Airbridge as a service specialized for Hive SDK.
  • Automatically track events with Airbridge
  • Manually track events with Airbridge

Billing¶

• Android When paying via PG, we provide the ability to purchase a single product in any quantity.

Changed features¶

Plugin¶

• Unity Changed the feature of automatically setting Package Name on Android or Bundle Name on iOS to work optionally via Hive AppId.

Fixed bugs¶

Analysis¶

• Fixed an error where the consent banner option was not reflected correctly when only one was selected.

Development environment updates¶

Android¶

• N/A

iOS¶

• Xcode 15 -> 15.3

v4.24.3.0¶

Download¶

Development environment¶

Unity (Android)¶

• Unity 2021.3.0+
• Unity 2022.3.0+
• Unity 2023.1.0+

Compatibility with Unity versions based on targetSDK version¶

Unity versions compatible with Android build targetSDK versions after Hive SDK v4.23.0.0 are as follows.

• targetSDK 33 Build:
  • Unity 2021 or higher can be used for building (based on Unity's built-in JDK and Gradle standards)
• targetSDK 34 Build:
  • Unity 2022 or higher can be used for building (based on Unity's built-in JDK and Gradle standards)

Unity (iOS)¶

• Unity 2021.3.0+
• Unity 2022.3.0+
• Unity 2023.1.0+

Android¶

iOS¶

• XXcode 15+
  • The Xcode version should be updated following the Apple App Store policy.

REQUIRED¶

• 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

OPTIONAL¶

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

Others¶

• 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

What's new¶

Provisioning¶

• All A feature has been added to check whether consent from the legal representative has been obtained on the terms and conditions screen.

Changed features¶

Plugin¶

• Unity Minimizes the number of XML files managed by the External Dependency Manager.

Authentication¶

• All Modified the logout behavior.
  • Previous: User account is logged out from the Hive SDK when signOut is called.
  Guest receives a failure response from the server when calling the signOut API.
  • Changed: When signOut is called, the Hive SDK will request confirmation from the Hive Server to log out the user account and will log out based on the response.
• All Guest account logout will no longer return a success response but will return an error code. The guest account session will be maintained by the Hive SDK and Hive Server.
• All Accounts that are suspended will automatically log out from IdP to allow login with a different account for the same IdP. This only applies if automatic login is not possible.
• All When integrating with IdP using the AuthV4.connect method, switching to a suspended account will trigger a logout.
• All Changed the device management service to automatically apply international phone country codes according to the device access region.
• iOS Changed to allow Facebook login even if App Tracking Transparency (ATT) consent is denied.

Promotion¶

• All Modified to ensure that unnecessary information is not included in the values sent via additionalInfo.
• All Changed to allow displaying full banners in a 2:3 or 3:2 ratio.
• All Changed the text from "Don't show for 1 day" to "Don't show today" on full banners.

Marketing attribution¶

• All Changed the Adjust Signature version from v1 to v3.

Resolved bugs¶

Hive SDK common¶

• Android Fixes an issue where memory could not be freed by modifying the resource reference logic.
• iOS Fixes a crash that occurred intermittently when checking for App Tracking Transparency (ATT) consent on iOS 14 devices.
• iOS Fixes a crash that occurred when selecting restricted access (allowing access to only some photos) in the photo library.

Notification¶

• Android Fixes an issue where push messages did not display correctly when an unsupported type setting was used in local push notifications.
• iOS Modifies to send app version information.

Development environment updates¶

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

Developer guide changes¶

• The guidance for the type field in customized local push notifications has been updated.
• The term "large banner" has been changed to "full banner."
• The example code for attachBaseContext, which is no longer used in the Android Life Cycle, has been removed.
• It is now indicated that checking for legal guardian consent can be performed using Configuration.getLegalGuardianConsentAgree.
• Added IdP integration guidance for accounts with usage restrictions.
• When manually updating or installing Hive SDK Unity, you must delete XML files before building the app.

v4.24.2.0 (2024-07-05)¶

What's New¶

Hive SDK Common¶

• All Provides a feature that returns whether users under 16 in the EU and EEA regions where GDPR applies have agreed to the terms of service, and checks if they are under 16. Check this feature here.
• Android Uses the PhotoPicker feature by default when using the photo album on devices with Android OS 11 or higher or devices with the supporting module installed.
• iOS Allows viewing Hive SDK debug logs and selecting specific log types to view on the MacOS console app.

Unity

• All Provides a feature to control the exposure of Hive SDK debug logs in the Unity Editor.

Authentication¶

• All When the number of accounts that can be registered with a single mobile phone number is exceeded, requesting the sending of an authentication code will display the error message: "You have exceeded the number of accounts that can be created with the same mobile phone number."

Promotion¶

• All Provides a feature to control the exposure of cross-promotion.
• All Supports "Do not show for N days" feature that improved the previous "Do not show again today".

Changed features¶

Notification¶

• Android Supports the runtime library (Push Amazon Device Message 1.2.0) that works on new Amazon Fire devices. See more here.

Promotion¶

• iOS Improves usability by minimizing the consent popup for clipboard paste permission when using the game invitation (UA) feature.
  1. Changed the timing of the consent popup from immediately after launching the app to the point of initializing Hive SDK after the app is launched.
  2. Displays the popup only when there is inviter URL data in the clipboard.

Analytics¶

• iOS Changes the default value of the saveAnalyticsLogBeforeCrash, which saves untransmitted logs to a file when a crash occurs, to false.

Bug Fixes¶

Authentication¶

• All During the real-name verification process for users accessing from China, an error message will be displayed when the message sending limit was exceeded with the remaining time not being reset.
• Android Fixes an issue where there was no appropriate response callback when the back key was pressed during Google Play login without completing the login.
• Android Fixes an issue where keyboard input could not be performed on low-resolution devices.

Promotion¶

• iOS Fixes an issue where freezing occurred when exposing a new frame view for the news view.

Marketing Attribution¶

• Android Fixes an issue where Adjust event transmission was delayed when initializing with a customized terms of service.

Development environment updates¶

Android¶

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

iOS¶

• N/A

Developer guide changes¶

• Due to the discontinuation of Facebook Cloud Games support starting from Hive SDK v4 24.2.0, the following pages have been updated accordingly:
  • Setting up Unity
  • Setting up Unity > Configuring Facebook Cloud Games
  • Setting up Android
  • Billing
  • Notifications
• Enhanced the explanation on the market selection screen for Lebi.

v4.24.1.2 (2024-06-27)¶

Bug fixes¶

Authentication¶

• Android Fixed an issue where no appropriate response callback was provided when canceling Google login by pressing the back button during the login process. This bug occurred only when the Google Legacy Support value in the Hive Console was set to true.
• Android Fixed an issue where keyboard input was not possible on low-resolution devices.

v4.24.1.0 (2024-05-14)¶

What’s new¶

N/A

Changed features¶

Analytics

• iOS Changed to determine whether to display the consent banner based on whether the device consents to tracking.
  • If you refuse consent to tracking, the consent banner will not be displayed.

Development environment updates¶

iOS¶

• Update external libraries in accordance with Apple Privacy Manifest policy.
  • AppsFlyer(iOS) v6.13.1 → v6.14.3
  • QQ (iOS) v3.5.14 → v3.5.16
• Downgrade Facebook SDK.
  • Facebook SDK v17.0.0 → v16.2.1

Fixed bugs¶

Billing¶

• iOS Fix an issue where product queries fail when updating Hive SDK from versions below v4 24.0.0 (e.g., v4 23.4.0) to v4 24.0.0.

Changes to developer guide¶

N/A

v4.24.0.0 (2024-04-30)¶

What’s new¶

Promotion¶

• Android Support Custom tab using the default browser set on the device to display external pages. You can expose In-App Browser with the showInAppBrowser method of the PlatformHelper class.
• iOS Support SafariViewController using a browser to expose external pages. You can expose In-App Browser with the showInAppBrowser method of the PlatformHelper class.

Billing¶

• iOS If there is discount information for the first subscription, it will be sent along with the product information inquiry. When using getProductInfo`, you can check discount information by the difference between the original_price field value and the price field value in the list of IAPV4Product objects received as a callback.

• All Unity When using Login Simulator, the actual values ​​of the guest account playerId and playerToken have been changed to be retrieved using the AppID and authentication key in the Hive Console sandbox. Verify API Calls (`Authorization and player_id`) are possible because it uses values ​​from the sandbox server.