v4.24.0.0

Download


Unity Android/iOS
DOWNLOAD Hive SDK v4 Unity Android+iOS 24.0.0
RELEASE DATE 2024-04-30

 

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
Gradle Android Gradle Plugin Kotlin Gradle Plugin
v7.5 v7.4.2 v1.8.0

iOS

 

External Libraries

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.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
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


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.

Changed Feature


Hive SDK Common
  • iOS Additional use of CFBundleShortVersionString to differentiate app versions
Unity
  • 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 Hive authentication key in the Hive console sandbox.

    Verify API Calls (Authorization and player_id) are possible because it uses values ​​from the sandbox server.

Billing
User

  • All The PG payment type phrase displayed in the refund user repayment UI has been changed from “HiveStore” to “PG payment”.
  • Android Change the PG payment page to be exposed in the in-app web view rather than the in-app browser. Supports PG payments even on devices that do not support the in-app browser environment.
Analytics
  • Android Change the default advertising identifier collection setting in the Firebase event collection function to true.

Development Environment Updates


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

Changes to developer guide


  • Description of displayOriginalPrice changed.
  • The description of Note at the bottom of displayPrice has been changed.
  • Third-party framework dependencies, Podfile writing example in Setting up iOS has been changed. Removed HiveAppTrackingTransparency and HiveResource from the required enforcement framework for Hive SDK default operation.

 

v4.23.4.0 (2024-04-11)

What’s New


Analytics
  • In accordance with DMA regulations in the EU and EEA regions, supports the personal information collection consent banner exposure feature.
    • If you use one or more MarketTrackingTools and market to the EU and EEA regions, you should apply their features.
    • A re-consent request is required every 14 months, and a re-consent banner is displayed if the number of months set in the app is exceeded.
    • The consent banner can be re-displayed whenever necessary so that users can withdraw their consent at any time.

Changed Feature


Hive SDK Common
  • Android Change the library version used to improve compatibility of CustomTab provided for PG payment.
    • androidx.browser 1.7.0 → 1.5.0
    • androidx.browser 1.7.0 can be used starting from Android Target 34 and cannot be used in Unity 2021 version.
External Libraries Update
  • Android Update the libraries corresponding to GDPR DMA:
    • Adjust 4.38.1 → 4.38.2
    • AppsFlyer 6.12.3 → 6.13.0
    • Singular 12.3.0 → 12.5.4
  • iOS Update the libraries corresponding to GDPR DMA:
    • Adjust 4.37.1 → 4.38.0
    • AppsFlyer 6.12.1 → 6.13.1
    • Singular 12.1.1 → 12.3.2
  • iOS Update external libraries to comply with Apple Privacy Manifest policy:
    • Facebook 16.2.1 → 17.0.0
    • Google SignIn 7.0.0 → 7.1.0

Push & Alarm
  • Android Change to encode and use the Google API Key value used to apply FCM.

 

Fixed Bugs


Hive SDK Common
  • Android Fixes an error that causes an intermittent crash when performing network status monitoring operations.
  • iOS Fixes an error that causes a crash when an unused useCrashReport key exists in the hive_config.xml file.
Chatbot
  • AndroidFix an error where the web view is not resized when entering a chatbot message.

 

Changes to developer guide


 

v4.23.3.0 (2024-03-26)

What’s New


Billing
  • Android We now supports PG payment in mobile environments.

Changed Features


Unity
  • Android Improved the compatibility with com.unity3d.player.UnityPlayerActivity files in Unity versions 2022.3.16f1 and above. Changed the default start Activity package name from com.hive.UnityPlayerActivity to com.hive.HiveUnityPlayerActivity.
  • Android Added the support of builds using GameActivity (Unity 2023 and above). When using GameActivity with Unity 2023 or above, the default start Activity package name is com.hive.HiveUnityPlayerGameActivity.
Hive SDK Common
  • iOS Updated SDWebImage library version: 5.18.35.18.7
Authentication
  • Android Updated reCaptcha library version: 18.2.118.4.0
  • iOS Updated LineSDK library version: 5.10.05.11.0
Marketing Attribution
  • Android Updated Adjust library version: 4.35.14.38.1
  • iOS Updated Adjust library version: 4.35.24.37.1
  • iOS Updated FirebaseAnalytics library version: 10.20.010.22.0

Fixed Bugs


Unity
  • All Fixed a Null-Reference-Exception error occurring in some Hive SDK methods callable from the Unity editor.
Authentication
  • All Fixed issues with identity verification screens.
  • iOS Fixed an issue that some shadows appeared on the real-name verification screen for Chinese IPs.
  • iOS Fixed an issue where the providerInfoData value was empty in the callback result of the connected IdP information when logging in on offline mode.
Community
  • iOS Fixed an issue that the standard error page supposed to be displayed when a network failure occurs during a SocialV4.showCommunity call (SocialV4.ViewType.FullScreen view type) was not displayed.
Device Management
  • iOS Fixed an issue where, despite exceeding the daily limit for sending verification numbers during mobile phone number verification prcoess, the timer for resending was reset anyway.
  • iOS Fixed an issue where text input area was activated despite exceeding the time limit for entering the verification number during mobile phone number verification process.
Promotion
  • iOS Fixed an issue where buttons in news, full banners, etc., intermittently did not work on some devices (including iPhone XS Max).

Developer Guide Changes


  • Added com.com2us.android.hive:hive-iapv4-market-hivestore as one of the values to be entered in the module-level build.gradle file.

 

v4.23.2.0 (2024-03-26)

What’s New


Promotion
  • Android Added a feature to specify SNS not to be used when sharing game invitation messages and invitation links on SNS. Refer to the unsupportedUAShareType element.

Changed Features


Marketing Attribution
  • Android Updated the Firebase Analytics library version: 21.3.021.5.0
  • iOS Updated the Firebase Analytics library version: 10.16.010.20.0

Fixed Bugs


Unity
  • All Fixed an error in the Hive Config Inspector where some UI foldings were not working properly.

 

v4.23.1.0 (2024-02-01)

What’s New


Authentication
  • All Supports automatic login in offline mode when the device cannot be connected to the internet.
Analytics

Changed Features


Hive SDK Common
  • All When user device cannot be connected to the network, it will not attempt to re-execute the methods of Hive SDK features that require network connection.
Analytics
  • All When user device cannot be connected to the network, it will not attempt to re-send analytics logs.

Known Issues


There are no known issues with the release of this Hive SDK version.

 

v4.23.0.0 (2024-01-30)

Changed Features


Unity
  • All The functionality of the external library dependency manager is changed to allow selective application of not only external libraries but also Hive product features. Now, you can use the external library dependency manager to select and apply Hive products as well as external libraries.
    • For IDP, the Google is split into Google Login and Google Play Games Login.
    • You can select the application of Apple Login, GameCenter, or Weverse authentication methods.
    • You can select the application of Android payment markets.
    • You can select the notification service providers.
  • iOS When launching the app, permissions required for the operation of Hive SDK features can be selected and added to Xcode Signing & Capabilities.
Hive SDK Common
  • Android Access to the Java Enum interface ResultAPI class is changed. See the example below.
    • Previously: Only ResultAPI.Companion.getSUCCESS() was supported.
    • Changed: Both ResultAPI.Companion.getSUCCESS() and ResultAPI.SUCCESS are supported.
  • Android Both instance method style and class method style are supported in Java. See the example below.
    • Previously: Only IAPV4.INSTANCE.getProductInfo was supported.
    • Changed: Both IAPV4.INSTANCE.getProductInfo and IAPV4.getProductInfo are supported.
  • Android Adjustments are made so that inquiry windows, chatbots, and adult authentication windows do not exceed the screen range on Z-Flip 5 front display.
  • iOS The supported development environment is changed to Xcode 15 or higher. It can be used on macOS Ventura13.5 or higher. The supported OSs are as follows:
    • iOS 12 or higher
    • iPadOS 13 or higher
Authentication
  • All For device management, real-name verification for China, and etc., the send button is disabled if the user does not enter the SMS within the time limit for SMS verification.
  • Android Each IDP is separated into libraries for optional application. The following libraries can be additionally applied:
    • Apple Sign-In
    • Weverse
    • Hive Membership
  • Android Changes are made to trust only login information directly verified by Hive server during Google Play Games login, resolving some cases of AuthV4ServerResponseError.
  • iOS The reCAPTCHA library used by Hive SDK is updated to the official version.
  • iOS Each IDP is separated into libraries for optional application. The following libraries can be additionally applied:
    • Apple Sign-In
    • GameCenter
    • Hive Membership
Promotion
  • All Changes are made so that only one of either the news or the full banner appears on the screen. Only the window called first will appear, and windows called later will not appear.
  • All Includes campaignId in UA campaign information.
  • iOS Updates the SDWebImage library and applies LRU cache policy related to image caching and downloading.
Billing
  • All No longer supports the IAPv2 interface and features.
  • Android Changes are made so that when there is a pending purchase, the delayed purchase result does not affect the current ongoing payment.
Provisioning
Hercules
  • All Updates the Hercules library version.
    • Android: 20231122
    • iOS: 20231116

Fixed Bugs


Authentication
  • Android Fixed an issue where buttons are displayed incorrectly when the usage restriction popup is shown in Portuguese.
  • iOS Fixed an issue where the app crashes when the camera capture button is tapped rapidly while editing the profile image.
Promotion
  • Android Fixed an error where line breaks do not work correctly when the app is changed from foreground > background > foreground again while the game exit popup is displayed.
  • iOS Fixed an issue where the top notch area is cut off when displaying community webviews, etc., through promotion banners.
Provisioning
  • iOS Modified not to display the remaining time until the suspension is lifted for suspended users.
Datastore
  • iOS If you put an empty value to the set method as an argument, it now deletes the previously set value, ensuring proper operation.
Notification
  • Android Fixed an issue where the push message contents do not appear due to a problem in the process of retrieving push messages for displaying when the app is relaunched.
Analytics
  • All In the concurrent user log transmission, changed the country code sent for unknown countries from Unknown to two space characters.

Known Issues


There are no known issues with this release of this Hive SDK version.

Developer Guide Changes


Common

Android

  • Added minimum versions for Gradle, Android Gradle Plugin, Kotlin Gradle Plugin here.
  • Changed the content of the Android Gradle file as Hive SDK features were internally separated into separate libraries.
  • Removed related content from AndroidManifest.xml settings as WeChat Auth is automatically added by Hive SDK. Also removed content as Hive does not directly use FOREGROUND SERVICE.
  • Changed the content related to setting required libraries in build.gradle for Facebook Cloud Game builds here.
  • Changed the content of the module-level build.gradle file for adding Firebase Analytics here.
  • Updated adding Huawei build settings.
  • Changed the content related to setting required libraries in build.gradle for Google Play Games on PC builds here.
  • Changed the content of the module-level build.gradle file for supporting Google login here.
  • Updated setting external library dependencies for Unity Android.
  • Changed the ways of setting up Facebook Cloud Game builds and Google Play Games on PC builds for Unity Android.
  • Revised the description as the ONE Store version was updated to 21.01.00 here.

iOS

  • Added Apple Game Center to the IdP integration guide.
  • Changed the content of the iOS Podfile as Hive SDK features were internally divided into separate libraries.
  • Updated the description related to automatically adding required permissions for the SDK to Xcode Signing & Capabilities via script in Unity.

 

v4.22.0.4 (2023-11-30)

Changed Features


Hive SDK Common
  • Android The authentication process of Hive SDK has been improved with regard to Google Play Games sign-in.

Known issues


There are no known issues deploying this version of Hive SDK.

 

v4.22.0.2 (2023-11-08)

Changed Features


Billing

Fixed Bugs


Analytics
  • All Fixed an error that the sales event of the Singular marketing attribution was not analyzed properly.
Billing
  • iOS Fixed an error that it was unable to receive the NOT_OWNEND response callback when you try to restore a subscription type product via restoreSubscription, given that there actually was no subscription made in fact.

Known Issues


There are no known issues deploying this version of the Hive SDK.

 

v4.22.0.0 (2023-09-15)

What’s New


Unity Engine
  • iOS Provides a feature that automatically configure your Xcode project to give the Hive SDK a right to send push notification when building the iOS main target.
  • iOS Provides an automatic configuration when using the Firebase marketing tracking tool. Automatically refers the GoogleService-Info.plist and includes it in the Xcode project.
Authentication
analytics
Provisioning

Changed Features


Unity Engine
  • All Updated the EDM4U library version included in the Unity package to v1.2.176. To build an Android target on Unity 2022.2 or above, you must use this version.
Hive SDK Common
  • Android Supports rich text preview when using the share method of the PlatformHelper class on Android OS 10 and higher devices.
  • Android Supports media (image, etc.) preview when using the share method of the PlatformHelper class on Android OS 14 or higher devices.
  • iOS The UI rotation bound to the app configuration is changed to be bound to the HiveOrientation value set in the hive_config.xml. The screen rotation is supported for every UI provided from the Hive SDK.
  • All Move the “close” button (X button) inside the dialog for pop-up UI, review UI, etc.
  • All If you try to initialize the Hive SDK after termination of the game service, the error code will be returned.
Authentication
  • Android Supports real-time screen rotation in all authentication pop-ups, including maintenance, adult authentication, and terms and conditions.
  • All Change the text displayed when using the device management service.
    • A line has been added recommending the use of the device management service.
    • Added a ‘Close’ button to move to the previous step in the text authentication process while using the device management function.
  • All Remove the customer center link URL that is displayed when users accessing from China undergoes real name authentication.
  • All When attempting to log in, an error code is returned due to the termination of the game service.
Billing
  • All When paying in Amazon Market and Apple App Store, the pending purchase feature is supported.
  • Android Applies Google Billing Library 6.0.1, which supports Android OS 14 target build. You must change the version you use as shown below.
    • v5.0.0v6.0.1
Notification
  • Android The supported versions of Firebase Cloud Messaging (FCM) have changed. You must change the version you use as shown below.
    • v20.2.4v23.1.2
Marketing Attribution
  • All When using Adjust, a deep link is provided to run already installed apps. Also, when a user clicks a deep link and runs an already installed app, tracking the Adjust attribution and re-attribution is provided.
  • iOS Change the AppsFlyer library to the latest version.
    • the previous version: v6.9.2
    • the latest version: v6.12.1
  • Android Change the AppsFlyer library to the latest version.
    • the previous version: v6.9.2
    • the latest version: v6.12.2
Community
  • All Puts the domain included the starting URL of the community in the domain whitelist. For example, if the starting URL of the Zenonia community is “https://www.zenonia.co.kr/ko/board/6″,https://www.zenonia.co.kr” is included in the whitelist. On the Whitelisted domains, running JavaScript codes is allowed, and these domains can receive REST API POST requests.

Fixed Bugs


Hive SDK Common
  • All When there is no external library, a separate error code is provided instead of the Unknown or No Response error code.
  • Android Corrects an error that excessive memory was instantly used when outputting large logs.
Unity
  • Android Fixed an error that sending empty data raises an error when using getMyData() and getUserData() API in Data Store.
  • Android Added the Maven configurations required for the build for distribution for OneStore.
  • Android Fixed an parsing issue in logging PromotionBadgeInfo data.
Authentication
  • All About the implicit login function with the AuthV4Helper class, if a restricted account is logged in, the error code that was incorrectly sent as Invalid Session is returned as Need Exit.
  • All You now can also customize maintenance pop-up with more than two buttons.
Marketing Attribution
  • iOS Fixed an error that sending additional information with the wrong key when sending a purchase event with the AppsFlyer.
    • custsom_product_idcustom_product_id
Notification
  • Android Fixed an error that occasionally exposes local pushes without any contents.

Known Issues


There are no known issues deploying this version of the Hive SDK.

Developer Guide Changes


  • Added Data Store error code (RESPONSE_FAIL:DataStoreGameIsBeingInspected).
  • According to the release policy change starting with Hive SDK 4.22.0, the guide structure regarding the release notes and downloads have been updated.The term “crossplay” has been changed to “Windows,” which refers to the OS, and the contents of the existing development guide of the crossplay are merged to the Windows section of the each guide for the Hive SDK module (Authentication, Promotion, Billing, Hercules, etc.), excluding the crossplay launcher.
  • Updated Applying iOS Framework.

 

v4.21.1.4 (2023-11-30)

Download


Unity Android/iOS
Download Hive SDK v4 Unity Android+iOS 21.1.4
Release Date 2023-11-30

 

Changed Features


Hive SDK Common
  • Android The authentication process of Hive SDK has been improved with regard to Google Play Games sign-in.

Known issues


There are no known issues deploying this version of Hive SDK.

 

v4.21.1.3 (2023-11-08)

Fixed Bugs


Analytics
  • All Fixed an error that the sales event of the Singular marketing attribution was not analyzed properly.
Billing
  • iOS Fixed an error that it was unable to receive the NOT_OWNEND response callback when you try to restore a subscription type product via restoreSubscription, given that there actually was no subscription made in fact.

Known Issues


There are no known issues deploying this version of the Hive SDK.