This page offers the release notes and the file downloads (per game engine) of the Hive SDK 4.15 ~ 4.21.
4.21
Hive SDK v4.21.1.0 (June 29, 2023)
Hive SDK v4.21.0.1 (June 13, 2023)
Release Notes
Hive SDK v4.21.0 ~ Hive SDK v4.21.1
V4.21.1 (July 20, 2023)
New Features
- All
- [Authentication] Based on relevant regulations such as the [Notice on Stricter Management of Minors’ Online Game Addiction] published by China National Newspaper Press, limited to the games with a China Publishing License, added the real-name verification for the game users from China.
- [Hercules] From Hive SDK v4.21.1, the Unreal plugin for Hercules is officially supported.
Changed Features
- All
- Prerequisites for Unreal environment has been updated.
- Common (Android, iOS)
- Unreal Engine 4.27 Plus (commit hash: 6d964b43aa6892200b8058b30d60cdf51ca8f209)
- iOS
- Xcode 14.3
- macOS Ventura 13.3+
- Common (Android, iOS)
- Prerequisites for Unreal environment has been updated.
Bug Fixes
- iOS
- [Authentication] Fixed an issue that the user profile webview page is terminated when it is requested to rapidly and repeatedly redirect (handled as an error) to another page. The redirect request handled as an error will be ignored.
Developer Guide Updates
- Added the guide to set compatibility with the Apple Silicon chipsets before building Unreal Engine 4 on Xcode. If you develop with Unreal Engine 4 on macOS machine installed with the Apple Silicon CPU, you should follow this guide.
- Added the guide to let you use Google Play Games sign-in with Unreal.
V4.21.0.1 (June 13, 2023)
Bug Fixes
- Android
- [Analytics] Fixed an error that a crash occurs when the orientation of the device screen is changed (widthwise or heightwise) before the Hive SDK is initialized.
V4.21.0.0 (June 9, 2023)
New Features
- All
- [Analytics] The device hardware information (resolution, screen density, memory, disk size, graphic driver information, etc.) is automatically collected and sent to the Hive Analytics server.
- [Notification] The notification group feature is supported. The notification group displays the notifications sent from the same app in a group on a user’s device.
- [Authentication] You can collect the email address in the user’s account profile. To collect it, you first need to turn on the email collection in the Hive console. By IdP, you may require to first be authorized for collecting email addresses.
- the IdPs available to collect email addresses: Google, Facebook, Huawei (Android), Hive membership, Apple (iOS)
- the IdPs unavailable to collect email addresses: Google Play Games, Apple Game Center, QQ, VK, WeChat, Line, Weverse
Changed Features
- All
- [Promotion] the Hive SDK now collects the number of clicks of exposed interstitial banner, and the status of “Don’t show this again today.”
- [Community] Changed to allow the use of custom domain name for the community site that is subject to the Hive policy except withhive.com and com2us.com. For more details, see here.
- [Billing] Changed the pop-up texts exposed to the target users of the refund user repurchase.
- CS CODE → CS Code
- Android
- [Authentication] The Google and Google Play Games authentication types become separated from each other. Now, if a user signs in with a Google Play Games account, the Google Play Games authentication information is used, not the Google authentication information, so this user only can sign in on the Android OS platform.
- When you use
AuthV4Helper
, it is changed to use the Google Play Games authentication type instead of the Google authentication type for the implicit login on the Android GooglePlay platform. - See the Upgrade Guide for the details of Hive SDK 4.21.0 configuration changes.
- If your game company wants to provide the Google Play Games authentication for Google Play Games on PC, you must upgrade your Hive SDK version to v4.21.0.
- References
- When you use
- [Notification] Changed to remove only the clicked notifications in the notification list of the notification center.
- [All] the supported Kotlin Gradle plugin version is changed and the Hive SDK now includes some androidx.lifecycle libraries. See Upgrade Guide for details.
- [Promotion] Improved the GooglePlay Core library compatibility, related to native review features, for the use of
showNativeReview
method. Prevented the version conflicts when using PlayAssetDeilvery. The following GooglePlay Core library versions are confimred to be compatible.- 1.8.0
- 1.8.1
- 1.10.3
- 2.0.0
- [Billing] Added more markets to support iapPayload. The following markets will be supported in line.
- OneStore v7
- Samsung GalaxyStore
- Amazon AppStore
- Facebook Cloud Games
- Huawei AppConnect
- [Authentication] The Google and Google Play Games authentication types become separated from each other. Now, if a user signs in with a Google Play Games account, the Google Play Games authentication information is used, not the Google authentication information, so this user only can sign in on the Android OS platform.
Known Issues
- iOS
- [Promotion] Due to Apple’s service failure, in iOS 11.x ~ 12.x, the requesting review pop-up is not exposed on the App Store though the showNativeReview method was called. This issue occurs in all Hive SDK versions.
- [IAPV4] Due to that iOS 11.x does not support the Apple sandbox account login, the marketConnect method cannot be called in iOS 11.x. This issue occurs in all Hive SDK versions.
Bug Fixes
- All
- [Authentication] The company code in the Terms of Service was changed to the company name in English when using device management service.
- Android
- [All] Fixed an error for a foldable device that the common pop-ups (server maintenance, blacklist, notice, etc.) were not automatically relocated according to the UI size.
- [Authentication] Fixed not to expose the icons for accessing photo album or camera for Google Play Games users on devices where these options were unavailable.
- iOS
- [Authentication] Fixed a QQ IdP error that it was not thread-safe when using Connect method.
- [Authentication] Added an error handling callback support when you tried to use reCAPTCHA features without the reCAPTCHA library.
- [Authentication] Fixed a crash that occurred when the user-defined field
game_data
was empty after theAuthV4Helper
showConflict
was called. - [Authentication] Changed to deliver an error callback (considered as log-in cancellation) when a user tries to sign in at Game Center and fails again, after the first sign-in trial at Apple Game Center failed due to the login cancellation or an error. If considered as login cancellation, you can expose “Proceed Game Center sign-in in the Settings of your device” pop-up.
Developer Guide Updates
- More billing event information sent to the third party marketing attribution apps is added.
- Hive initialization: Changed the did definition
- iapPayload: Added its maximum size
- explicit login, explicit login customizing: Example code update
- hive_config.xml example: Added
Google Play Games
in the IdP provider configuration - Unity > Settings for externel library dependency: Changed the Google and Facebook IdP configuration
- Unity > Hive Configuration: Changed the Google and Google Play Games configuration
- the push notification and the app icon badge guide: Added the app icon badge and the push notification guide
- the use of Custom URL Scheme: Corrected the WeChat Auth contents part.
- Added the Steam purchase support for Windows: Updated the table contents following the Steam purchase support.
Appendix
Required libraries
- Kotlin (Android) v1.6.20
- Kotlin Coroutine (Android) 1.4.0
- AndroidX (Android) v1.0.0+
- Constraint Layout (Android) v2.1.1
- Glide (Android) v4.13.0
- SDWebImage (iOS) v5.13.4
Optional libraries
Authentication
- Facebook SDK Android v13.0.0
- Facebook SDK iOS v14.1.0 (iOS Native or Unity, iOS 11 or higher)
- Facebook SDK iOS v15.0.0 (iOS Native or Unity, iOS 12 or higher)
- Facebook SDK iOS v16.0.0 (Unreal, iOS 12 or higher)
- GooglePlay Services–Auth (Android) v17.0.0
- GooglePlay Services–Games v2 (Android) v17.0.0
- Google Sign–In SDK (iOS) v6.2.4
- QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
- QQ (iOS) v3.5.12
- VK (Android) v3.5.1
- VK (iOS) v1.6.3
- WeChat (Android) v6.8.0
- WeChat (iOS) v1.9.6
- LINE (Android) v5.7.0
- LINE (iOS) v5.8.2
- Huawei (Android) v6.7.0.300
Billing
- Google Billing Library (Android) v5.0.0
- OneStore (Android) v21.00.01
- WeChat (Android) v6.8.0
- Amazon (Android) v3.0.2
- Huawei (Android) v6.3.0.300
Push
- Amazon (Android) v1.0.1
- FCM(FirebaseCloudMessaging) (Android) v20.2.4
Market Tracking Tool
- Adjust(Android) v4.32.0
- Adjust(iOS) v4.33.3
- Singular(Android) v12.0.8
- Singular(iOS) v12.0.1
- AppsFlyer(Android) v6.9.2
- AppsFlyer(iOS) v6.9.1
- FirebaseAnalytics(Android) v20.1.2
- FirebaseAnalytics(iOS) v10.4.0
Others
- GooglePlay Services–Review (Android) v2.0.0
- Google Recaptcha (Android) v17.0.1
- Google Recaptcha (iOS) v16.0.0
- YoutubeAndroidWebPlayerApi (Android) v1.0.1
Upgrade Guide
Hive SDK v4.21.0 ⇨ Hive SDK v4.21.1
Use Google Play Games sign-in on Unreal Android
To provide Google Play Games sign-in, Hive SDK v4.21.1 includes com.google.android.gms:play-services-games-v2
library. It causes a conflict against com.google.android.gms:play-services-games
library included in Unreal Engine. So, to use Google Play Games sign-in, you first need to modify the Unreal Engine codes as below.
- Open ./Engine/Build/Android/Java/src/com/epicgames/ue4/GameActivity.java.template.
- Remove the following line.
1import com.google.android.gms.games.Games; - Follow Use Google sign-in and Google Play Games sign-in on Unreal guide introduced below.
Use Google sign-in and Google Play Games sign-in on Unreal
Hive SDK supports both Google sign-in (iOS, Android) and Google Play Games sign-in (Android) for Unreal Engine. To use Google or Google Play Games sign-in, select “GOOGLE” or “GOOGLE_PLAY_GAMES” ProviderType
and call AuthV4.SignIn().
To use Google sign-in under Hive SDK v4.21.1, open /Plugins/HIVESDK/Source/HIVESDK/HIVESDK_APL.xml and change AS-IS
to TO-BE
and call AuthV4.SignIn()
.
1 2 3 4 5 |
<!-- AS-IS --> implementation "com.com2us.android.hive:hive-service-extension-google" <!-- TO-BE --> implementation "com.com2us.android.hive:hive-service-extension-google-signin" |
Hive SDK v4.16.4 ~ Hive SDK v4.21.0 ⇨ Hive SDK v4.21.0
Kotlin Gradle Plugin Version Change:
- Changed the required version of the Kotlin Gradle Plugin from 1.5.10 to 1.6.20.
- Hive SDK now includes the androidx.lifecycle library.
The change of external library settings for the Android native
Separate the external libraries of Google authentication from the external libraries of Google Play Games authentication in the module-level build.gradle
file.
The google
and googlev2
which supported both Google Authentication and Google Play Games Authentication are deprecated.
1 2 3 4 5 6 7 |
// Before 4.21.0 implementation "com.com2us.android.hive:hive-service-extension-google" implementation "com.com2us.android.hive:hive-service-extension-googlev2" // 4.21.0 and After implementation "com.com2us.android.hive:hive-service-extension-google-signin" implementation "com.com2us.android.hive:hive-service-extension-google-playgames" |
Adding External Libraries | < 4.21.0 | >= 4.21.0 | GooglePlayGames Sign-in | Google Sign-in |
---|---|---|---|---|
com.com2us.android.hive:hive-service-extension-google | O | X | O | O |
com.com2us.android.hive:hive-service-extension-googlev2 | O | X | O | O |
com.com2us.android.hive:hive-service-extension-google-signin | X | O | X | O |
com.com2us.android.hive:hive-service-extension-google-playgames | X | O | O | X |
Before 4.21.0: the list of external libraries included in google
and googlev2
- com.com2us.android.hive:hive–service–extension–google
- com.google.firebase:firebase–iid
- com.google.firebase:firebase–messaging
- com.google.android.gms:play–services–auth
- com.google.android.gms:play–services–games
- com.google.android.gms:play–services–ads–identifier
- com.google.android.gms:play–services–analytics
- com.google.android.gms:play–services–recaptcha
- com.google.android.play:review
- com.com2us.android.hive:hive–service–extension–googlev2
- com.google.firebase:firebase–iid
- com.google.firebase:firebase–messaging
- com.google.android.gms:play–services–auth
- com.google.android.gms:play–services–games-v2
- com.google.android.gms:play–services–ads–identifier
- com.google.android.gms:play–services–analytics
- com.google.android.gms:play–services–recaptcha
- com.google.android.play:review
4.21.0: the list of external libraries included in google-signin
and google-playgames
- com.com2us.android.hive:hive–service–extension–google–signin
- com.google.firebase:firebase–iid
- com.google.firebase:firebase–messaging
- com.google.android.gms:play–services–auth
- com.google.android.gms:play–services–ads–identifier
- com.google.android.gms:play–services–analytics
- com.google.android.gms:play–services–recaptcha
- com.google.android.play:review
- com.com2us.android.hive:hive–service–extension–google–playgames
- com.google.firebase:firebase–iid
- com.google.firebase:firebase–messaging
- com.google.android.gms:play–services–games-v2
- com.google.android.gms:play–services–ads–identifier
- com.google.android.gms:play–services–analytics
- com.google.android.gms:play–services–recaptcha
- com.google.android.play:review
The change of external library names
1 2 3 4 5 |
// Before 4.21.0 implementation 'com.android.billingclient:billing-ktx' // 4.21.0 and After implementation 'com.android.billingclient:billing' |
For more details, see Add Hive SDK and external libraries to Gradle.
Setting up a Google Play Games on PC build for the Android native
How to set the external library dependencies is unified into a single way (previously split into: Before 4.16.2, and 4.16.2 and after) Change hive–service–extension–google-v2 to hive–service–extension–google–playgames. hive–service–extension–google–playgames already includes play–service–games-v2 library.
For more details, see Setting up a Google Play Games on PC build.
Configure Facebook Cloud Game build in the Android native
To configure Facebook Cloud Game build, you need to remove hive–service–extension–google–signin and hive–service–extension–google–playgames, not hive–service–extension–google.
For more details, see Configure Facebook Cloud Game Build.
Change Google V2 into Google Play Games for the Android Unity
1 2 3 4 5 |
// Before 4.21.0 <androidPackage spec="com.com2us.android.hive:hive-service-extension-googlev2:HIVE_SDK_VERSION"/> // 4.21.0 and After <androidPackage spec="com.com2us.android.hive:hive-service-extension-google-playgames:HIVE_SDK_VERSION"/> |
For more details, see Setting up a Google Play Games on PC build for Android Unity Project.
Separate the Google authentication external libraries from those of Google Play Games for the Android Unity.
The google-playgames
only supports the Google Play Games authentication, and the google-signin
only supports the Google authentication. The com.com2us.android.hive:hive-service-extension-google
is not supported anymore.
External Libraries | < 4.21.0 | >= 4.21.0 | GooglePlayGames Sign-in | Google Sign-in |
---|---|---|---|---|
com.com2us.android.hive:hive-service-extension-google-signin | X | O | X | O |
com.com2us.android.hive:hive-service-extension-google-playgames | X | O | O | X |
For more details, see the Google Sign-in Support.
4.16
Hive SDK v4.16.4 (May 12, 2023)
Hive SDK v4.16.3.1 (Feb 27, 2023)
Hive SDK v4.16.2.1 (Jan 11, 2023)
Unity® | Hive_SDK_Unity_v4.16.2.1_withCore.zip |
---|---|
Cocos2D-X | Hive_SDK_Cocos_v4.16.2.1_withCore.zip |
Android | Hive_SDK_Android_v4.16.2.1_withCore.zip |
iOS | Hive_SDK_iOS_v4.16.2.1_withCore.zip |
Unreal | Hive_SDK_Unreal_v4.16.2_withCore.zip (Jan 04, 2023 Released) |
The SDK for Cocos2D-X includes a C++ interface.
Hive SDK v4.16.1.8 (Jan 11, 2023)
Unity® | Hive_SDK_Unity_v4.16.1.8_withCore.zip |
---|---|
Cocos2D-X | Hive_SDK_Cocos_v4.16.1.8_withCore.zip |
Android | Hive_SDK_Android_v4.16.1.8_withCore.zip |
iOS | Hive_SDK_iOS_v4.16.1.8_withCore.zip |
The SDK for Cocos2D-X includes a C++ interface.
Hive SDK v4.16.0.6 (Nov 15, 2022)
Unity® | Hive_SDK_Unity_v4.16.0.6_withCore.zip |
---|---|
Cocos2D-X | Hive_SDK_Cocos_v4.16.0.6_withCore.zip |
Android | Hive_SDK_Android_v4.16.0.6_withCore.zip | iOS | Hive_SDK_iOS_v4.16.0.6_withCore.zip |
The SDK for Cocos2D-X includes a C++ interface.
Release Notes
Hive SDK v4.16.4
V4.16.4.0 (Apr. 21, 2023)
New Features
- Android
- [Payment] Support the payments with the One Store v7 library. See the followings for how to add One Store library to Hive SDK.
- [Common] Support BOM (Bill of Materials), a Maven library version manager, when installing Hive SDK. With this, you do not need to directly enter the external library version when you install the Hive SDK in the Android native development environment. See Upgrade Guide for details.
Changed Features
- All
- [Authentication] In the situations where a game app needs to be terminated, such as displaying a server maintenance pop-up or a user not agreeing to the terms and conditions, the Hive SDK no longer immediately terminates the app but forwards the termination event to the game client. The game must implement its own codes to listen for the termination event and then terminate the game app. See Upgrade Guide for details.
- If the file I/O or network transmission/reception is in progress, the app process must be terminated after those operations are terminated.
- You must safely terminate all threads that are not spawned from the main process as daemon threads before terminating the app process.
- [Promotion] Added the badge notifying the available period for receiving gift at the news event banner.
- [Billing] When requesting a purchase or a subscription if you use the
iapPayload
as an argument, the additional information pre-defined by the game studio can be passed to the payment transaction. The game studio can use this to track and analyze user purchase activity, and give back the pending game items to users. For more details, see use iapPayload.- When you proceed with a purchase via purchase method, put the additional information defined in advance in the
iapPayload
argument.additionalInfo
is no longer used. - Added a builder pattern method that takes an
IAPV4PurchaseParam
object as an argument when requesting a subscription change via purchaseSubscription method. - When you proceed with a subscription via purchaseSubscriptionUpdate method, put the additional information defined in advance in the
iapPayload
argument.additionalInfo
is no longer used.
- When you proceed with a purchase via purchase method, put the additional information defined in advance in the
- [Authentication] Improve the UI that guides users to use the currently logged-in account when there is a conflict between the account the user is currently logged in and the account already linked to the Idp, if there is no game play record in the Idp-linked account. For more details, see Handling account conflicts when working with an IdP.
- [Analytics] Added a fixed starting section (401: Hive SDK initialization starting point) to the funnel analysis metric. Starting from the initialization of the Hive SDK, you can discover which section a user strayed from while using the game app. For more details, see Sending Funnel Log on Entry Section of Game.
- [Authentication] In the situations where a game app needs to be terminated, such as displaying a server maintenance pop-up or a user not agreeing to the terms and conditions, the Hive SDK no longer immediately terminates the app but forwards the termination event to the game client. The game must implement its own codes to listen for the termination event and then terminate the game app. See Upgrade Guide for details.
- Android
- [Common] Updated the versions of the supported external libraries. For more details, see the Appendix below.
- OneStore v7: v21.00.01
- From Hive SDK 4.16.4, you do not need to directly enter the external library versions in the module-level
build.gradle
when you use the Hive SDK on the Android native development environment. See Upgrade Guide for details.
- [Common] Changed the minimum supported Android OS version to 5.0 (API Level 21).
- [Billing] Changed to support multi-quantity purchase (consumable items only) for Google Play Billing.
- [Billing] Changed to support Google subscription V2 API for Google Play Billing.
- [Billing] Changed to support OOAP(Out of App Purchase) for Google Play Billing.
- [Authentication] Changed to support Google login.
- [Community] Now the community page goes back to the previous page or will be closed as a user touches the Back button.
- [Analytics] The response time metric is separated to the response time and the reaction time.
- [Common] Updated the versions of the supported external libraries. For more details, see the Appendix below.
- iOS
- [Common] Updated the versions of the supported external libraries. For more details, see the Appendix below.
- Updated the Facebook SDK version to 14.1 (iOS 11 compatible).
- Updated the Facebook SDK version to 16.0 (iOS 12 compatible).
- [Common] When you build a iOS project, it is now allowed that the “HiveResource” (the UI resource bundles used for Hive SDK) is included in any build target only if it is included with the “HiveSDK” (also allowed to be in the main target).
- [Common] The Facebook SDK version 16.0.0 must be used in the Unreal environment. For more details, see the Appendix below.
- [Common] In the Unreal environment, you need to apply FMallocAnsi settings to be properly compatible with the C++ standard template library.
- [Analytics] The response time metric is separated to the response time and the reaction time.
- [Common] Updated the versions of the supported external libraries. For more details, see the Appendix below.
Bug Fixes
- All
- [Promotion] Correct the spelling of the keys in
getBannerInfo
method responses.- Before:
start_unixtimstamp
,end_unixtimstamp
- After:
start_unixtimestamp
,end_unixtimestamp
- Before:
- [Promotion] Correct the spelling of the keys in
- Android
- [Authentication] Modified the download log to include SDK build time.
- iOS
- [Authentication] Fixed an issue that some unnecessary information was included in the response value of the adult authentication.
- [Authentication] Fixes an error that there was no response when you faced account conflicts in the moment of network disconecction.
- [Common] Changed the thread safe logic exposed to plugins or outside the Hive SDK to be implemented inside Hive SDK.
- Windows
- [Authentication] Modified not to transmit Advertising Id for COPPA target users.
Appendix
Required libraries
- Kotlin (Android) v1.5.20
- Kotlin Coroutine (Android) 1.4.0
- AndroidX (Android) v1.0.0+
- Constraint Layout (Android) v2.1.1
- Glide (Android) v4.13.0
- SDWebImage (iOS) v5.13.4
Optional libraries
Authentication
- Facebook SDK Android v13.0.0
- Facebook SDK iOS v14.1.0 (iOS Native or Unity, iOS 11 or higher)
- Facebook SDK iOS v15.0.0 (iOS Native or Unity, iOS 12 or higher)
- Facebook SDK iOS v16.0.0 (Unreal, iOS 12 or higher)
- GooglePlay Services–Auth (Android) v17.0.0
- GooglePlay Services–Games (Android) v17.0.0
- Google Sign–In SDK (iOS) v6.2.4
- QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
- QQ (iOS) v3.5.12
- VK (Android) v3.5.1
- VK (iOS) v1.6.3
- WeChat (Android) v6.8.0
- WeChat (iOS) v1.9.6
- LINE (Android) v5.7.0
- LINE (iOS) v5.8.2
- Huawei (Android) v6.7.0.300
Billing
- Google Billing Library (Android) v5.0.0
- OneStore (Android) v21.00.01
- WeChat (Android) v6.8.0
- Amazon (Android) v3.0.2
- Huawei (Android) v6.3.0.300
Push
- Amazon (Android) v1.0.1
- FCM(FirebaseCloudMessaging) (Android) v20.2.4
Market Tracking Tool
- Adjust(Android) v4.32.0
- Adjust(iOS) v4.33.3
- Singular(Android) v12.0.8
- Singular(iOS) v12.0.1
- AppsFlyer(Android) v6.9.2
- AppsFlyer(iOS) v6.9.1
- FirebaseAnalytics(Android) v20.1.2
- FirebaseAnalytics(iOS) v10.4.0
Others
- GooglePlay Services–Review (Android) v2.0.0
- Google Recaptcha (Android) v17.0.1
- Google Recaptcha (iOS) v16.0.0
- YoutubeAndroidWebPlayerApi (Android) v1.0.1
Hive SDK v4.16.3.0 ~ Hive SDK v4.16.3.1
V4.16.3.1 (Feb 27, 2023)
Bug Fixes
-
Android
- [Payment] Fixed an issue that the information of subscription product could not be loaded after restarting the app.
V4.16.3.0 (Feb 20, 2023)
New Features
- Android
- [Unity/Plugin] Provide the UI that can optimize the build by the language actually used in the game. You can reduce the size of your app by using only some languages.
- iOS
- [Common] Change the minimum requirements of iOS build for the Hive SDK to Xcode 14.1 and iOS SDK 16.1.
- As per Apple’s notice, the minimum requirements were changed to Xcode 14.1 and iOS SDK 16.1 from March 2023.
- The Xcode 14.1 or higher does not support the Armv7 architecture.
- You must build your release candidate app in an Xcode 14.1 or higher environment, then test your app to pass app review before submitting it to the App Store. Starting in April 2023, all iOS and iPadOS apps submitted to the App Store must be built with Xcode 14.1 and the iOS 16.1 SDK or higher versions.
- [Payment] StoreKit 2 is supported on the devices with iOS 15 or higher.
- [Common] Change the minimum requirements of iOS build for the Hive SDK to Xcode 14.1 and iOS SDK 16.1.
Changed Features
- All
- [Hive Configuration] You now can set
Channel
value when making a payment with a third-party payment system other than the Hive SDK,- You now can check the Channel value set by the
getChannel
method. - You now can set the Channel value by the
getChannel
method.
- You now can check the Channel value set by the
- [Social Authentication/Login] Changed to pass login session token information to the Hive Community when automatically logging in to it.
- [Promotion] When using
Promotion.showNews()
API that exposes the news UI, the interface was changed to display the gift box icon image on the event banner that is of an achieved event with thegiftPidList
argument (the gift box exposure information).- Aimed to prevent the
setAddtionalInfo()
method from setting the information to expose the gift box.
- Aimed to prevent the
- [Payment] Improved the
IAPv4.marketConnect()
method responsiveness. - [Promotion]
campaignType
was added to the returns of thegetBannerInfo
method.
- [Hive Configuration] You now can set
- Android
- [Common] Updated the versions of the supported external libraries.
- QQ IdP: v3.5.13.83 (rc564928) → v3.5.14 (3.5.14.3_rc26220c)
- [Authentication] Changed the text that appears when you press Back on the device when displaying the Terms of Service agreement screen.
- [Unreal/Plugin] Updated the compatibility to build on Unreal Engine 4.27.2, Unreal Engine 5 or higher.
-
[Promotion] Removed the unnecessary content from
UserEngagement
callback response. -
[Common] Changed not to support devices that do not operate due to SSL errors given that the Android System WebView version is 53 or 54.
- We recommend not handling exceptions in the Google Play Console.
- [Promotion][HiveWebView] Changed not to exposed the error page when a content error other than the main page error occurs among WebView contents.
-
[Payment] Changed to pass payer information to detect users that abuse payment systems when making a payment with Google‘s GooglePlay Billing. We deliver the obfuscated
PlayerId
via GooglePlay Billing’sobfuscatedAccountId
.
- [Common] Updated the versions of the supported external libraries.
- iOS
- [Common] Updated the versions of the supported external libraries.
- Adjust: v4.32.1 → v4.33.3
- Singular: v11.0.10 → v12.0.1
- AppsFlyer: 6.8.1 → 6.9.1
- Firebase: 9.6.0 → 10.4.0
- [Unreal/Plugin] Updated the compatibility to build on Unreal Engine 4.27.2, Unreal Engine 5 or higher.
-
[Hive Configuration] The external crash report may conflict with the Hive Analytics log collection or storage function. The name of the option that controls the Hive Analytics behavior was changed from
useCrashReport
tosaveAnalyticsLogBeforeCrash
to make it easy to understand. -
[Payment] Changed to pass payer information to detect users that abuse payment systems when making a payment with Apple’s AppStore. Now the obfuscated
PlayerId
is passed using StoreKit‘sappAccountToken
.
- [Common] Updated the versions of the supported external libraries.
Bug Fixes
- All
- [Plugin/Unity] Fixed an issue that response callbacks could not be delivered when an exception occurred in some interfaces.
- Android
-
[Hive Configuration] Fixed an issue that calling
getHiveTimeZone()
before the initialization withAuthV4
setup()
passes a dummy response value. No response value will be delivered after fixing this issue. - [Promotion] Fixed an issue that the banner was not exposed in case of the forced exposure when a user checked Do not see this banner today not to see the banner.
-
[Hive Configuration] Fixed an issue that calling
- iOS
- [Market Tracking Tool] Fixed an issue that Adjust initialization did not proceed when the
AppSecret
value was not set.
- [Market Tracking Tool] Fixed an issue that Adjust initialization did not proceed when the
Appendix
Required libraries
- Kotlin (Android) v1.5.20
- Kotlin Coroutine (Android) 1.4.0
- AndroidX (Android) v1.0.0+
- Constraint Layout (Android) v2.1.1
- Glide (Android) v4.13.0
- SDWebImage (iOS) v5.13.4
Optional libraries
Authentication, Login (IDP)
- Facebook SDK Android v13.0.0
- Facebook SDK iOS v12.3.1 (Legacy Support, iOS 10+ supported)
- Facebook SDK iOS v13.2.0 (iOS 11+ supported)
- Facebook SDK iOS v15.0.0 (iOS 12+ supported)
- GooglePlay Services–Auth (Android) v17.0.0
- GooglePlay Services–Games (Android) v17.0.0
- Google Sign–In SDK (iOS) v6.2.4
- QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
- QQ (iOS) v3.5.12
- VK (Android) v3.5.1
- VK (iOS) v1.6.3
- WeChat (Android) v6.8.0
- WeChat (iOS) v1.9.6
- LINE (Android) v5.7.0
- LINE (iOS) v5.8.2
- Huawei (Android) v6.7.0.300
Payment (IAP)
- Google Billing Library (Android) v5.0.0
- OneStore (Android) v19.00.02
- WeChat (Android) v6.8.0
- Amazon (Android) v3.0.2
- Huawei (Android) v6.3.0.300
Push
- Amazon (Android) v1.0.1
- FCMFirebaseCloudMessaging) (Android) v20.2.4
Market Tracking Tool
- AdjustAndroid) v4.32.0
- AdjustiOS) v4.33.3
- SingularAndroid) v12.0.8
- SingulariOS) v12.0.1
- AppsFlyerAndroid) v6.9.2
- AppsFlyeriOS) v6.9.1
- FirebaseAnalyticsAndroid) v20.1.2
- FirebaseAnalyticsiOS) v10.4.0
Etc.
- GooglePlay Services–Review (Android) v2.0.0
- Google Recaptcha (Android) v17.0.1
- Google Recaptcha (iOS) v16.0.0
- YoutubeAndroidWebPlayerApi (Android) v1.0.1
Hive SDK v4.16.2.0 ~ Hive SDK v4.16.2.1
V4.16.2.1 (Jan 11, 2023)
Bug Fixes
- iOS
- [Auth][Auth v4] Fixed an issue in adding photos using the photo album on iOS 16+, built with Xcode 14.
- Changing user profile, 1:1 inquiry, chat-bot, etc.
- [Unreal][Promotion] Fixed an issue that showNativeReview crashes.
- [Auth][Auth v4] Fixed an issue in adding photos using the photo album on iOS 16+, built with Xcode 14.
V4.16.2 (Dec 15, 2022)
New Features
- All
- [Common] Provide Hercules as the common feature.
- [Auth v4] Provide sync and unsync functions for the custom login.
- Android
- [Auth v4] The Huawei authentication is added as an IDP, which can be used on the Huawei market platform.
- [Auth v4] Support Google Play Games on PC platform.
- iOS
- [Common] iOS SDK is now distributed via CocoaPods.
Changed Features
- All
- [Promotion] The badge exposure for news view contents has been improved.
- [Plugin/Unity] Updated the JSONObject library used in the Unity package to the latest.
- [Auth v4] Changed the UI of reviewing terms and conditions.
- [Plugin/Unity] The default value of HiveConfig Inspector‘s SDK timeout setting in Unity changed from 15 seconds to 8 seconds
- Android
- [Common] The dependencies of resources provided by SDK has been separated.
- [Promotion] Fixed a problem that it seemed flickering when closing the interstitial banner.
- [Promotion][Gradle] Updated the Youtube playback library.
- [Common] Modified to no longer expose permission notices.
- [Common] Maintained the support to customize permission notices.
- [Push] Added the feature to request notification permission on devices with Android 13 or higher.
- [Common] Updated the versions of the supported external libraries
- Adjust: 4.29.1 → 4.32.0
- Singular: 12.0.5 → 12.0.8
- AppsFlyers : 6.5.2 → 6.9.2
- VK : 1.6.9 → 3.5.1
- Alipay : 15.6.8 → 15.8.11 (aar → maven)
- YoutubeAndroidWebPlayerApi : 1.0 → 1.0.1 (jar → maven)
- Huawei : 6.4.0.300 → 6.7.0.300
- [Community] The domain inspection when logging in to the HiveCommuity has become strict in terms of information delivery.
- iOS
- [Common] The dependencies of Facebook SDK and Google Sign–In library have been separated.
- [Promotion] Improved the behavior when displaying the interstitial banner.
- [Common] Modified to no longer expose permission notices.
- [Common] Maintained the support to customize permission notices.
- [Common] Updated the versions of the supported external libraries
- Adjust: 4.29.1 → 4.32.1
- Singular: 11.0.4 → 11.0.10
- AppsFlyers : 6.5.2 → 6.8.1
- Firebase : 9.3.0 → 9.6.0
- Google–SignIn : 6.1.0 → 6.2.4
- QQ : 3.3.9 → 3.5.12
- VK : 1.6.1 → 1.6.3
- WeChat : 1.8.6.2 → 1.9.6
- Line : 5.7.0 → 5.8.2
- SDWebImage : 5.12.5 → 5.13.4
- [Community] The domain inspection when logging in to the HiveCommuity has become strict in terms of information delivery.
Bug Fixes
- All
- [Plugin/Unity] Fixed an issue that the Line IDP configuration was missing in the HiveConfig Inspector provided for Unity build.
- Android
- [Plugin/CPP][UserEngagement] Fixed an error that the event callback was not delivered when HiveCommuity was exposed through UserEngagement.
- [Auth/Auth v4/SocialFacebook] Fixed an error that the build with the Facebook Gaming Service library worked as if it were on Facebook Cloud environment though it wasn’t.
- In the Facebook Cloud environment, the Facebook Gaming Service library must be included for normal operation.
- iOS
- [Auth][Auth v4] Modified the negative remaining time when a maintenance pop-up is exposed to be 0.
- [Promotion] Fixed an issue that “Do not see this banner today” text is flickering when this is the first exposure for a news banner.
- [Promotion] Fixed an issue that, on a device with a notch area, some background colors are exposed differently from the color set when custom view is exposed in FullScreen mode.
- [SDK v1][Auth][AU] Fixed an error that sometimes the Terms of Service were not exposed according to the whitelist configuration.
- [Plugin/CPP] Fixed an error that the event callback was not delivered when HiveCommuity was exposed through UserEngagement.
- Added EngagementEventType.COMMUNITY_VIEW type
The supported third-party library versions (As of Hive SDK SDK V4.16.2)
Required libraries
-
-
- Kotlin 1.5.20
- Kotlin Coroutine 1.4.0
- AndroidX (Android) v1.0.0+
- constraintlayout (Android) v2.1.1
- glide (Android) v4.13.0
- SDWebImage (iOS) v5.13.5
-
IDP
-
- Google Sign–In SDK (iOS) v6.1.0
Optional libraries
IDP
-
-
- Facebook SDK Android v13.0.0
- Facebook SDK iOS v12.3.1
- Facebook SDK iOS v13.2.0
- Facebook SDK iOS v15.0.0 (added in the optionals, supports iOS 12+ and higher)
- GooglePlay Services–Auth (Android) v17.0.0
- GooglePlay Services–Games (Android) v17.0.0
- Google Sign–In SDK (iOS) v6.2.4 (Changed from a required library to an optional library)
- QQ (Android) v3.5.13.83 (rc564928)
- QQ (iOS) v3.5.12
- VK (Android) v3.5.1
- VK (iOS) v1.6.3
- WeChat (Android) v6.8.0
- WeChat (iOS) v1.9.6
- LINE (Android) v5.7.0
- LINE (iOS) v5.8.2
- Huawei (Android) v6.7.0.300
-
IAP
-
-
- Google Billing Library (Android) v5.0.0
- OneStore (Android) v19.00.02
- WeChat (Android) v6.8.0
- Amazon (Android) v3.0.2
- Huawei (Android) v6.3.0.300
-
PUSH
-
-
- Amazon (Android) v1.0.1
- FCM (Android) v20.2.4
-
MARKETING TRACKING ANALYTICS
-
- AdjustAndroid) v4.32.0
- AdjustiOS) v4.32.1
- SingularAndroid) v12.0.8
- SingulariOS) v11.0.10
- AppsFlyerAndroid) v6.9.2
- AppsFlyeriOS) v6.8.1
- FirebaseAndroid) v20.1.2
- FirebaseiOS) v9.6
Etc.
-
- GooglePlay Services–Review (Android) v2.0.0
- Google Recaptcha (Android) v17.0.1
- Google Recaptcha (iOS) v16.0.0
- YoutubeAndroidWebPlayerApi (Android) v1.0.1
Hive SDK v4.16.1.0 ~ Hive SDK v4.16.1.8
V4.16.1.8 (Jan 11, 2023)
New Features
-
- None
Changed Features
-
- None
Bug Fixes
- iOS
- [Auth][Auth v4] Fixed an issue in adding photos using the photo album on iOS 16+, built with Xcode 14.
- Changing user profile, 1:1 inquiry, chat-bot, etc.
- [Auth][Auth v4] Fixed an issue in adding photos using the photo album on iOS 16+, built with Xcode 14.
V4.16.1.7 (Nov 23, 2022)
New Features
-
- None
Changed Features
-
- None
Bug Fixes
- iOS
- [Analytics] Fixed an issue where crashes occurred intermittently while saving the logs. When an app starts to run in the background or it crashes during the log transferring, some logs that failed to send are saved.
V4.16.1.6 (Nov 15, 2022)
New Features
-
- None
Changed Features
- Android
- [Promotion] Add some effects on button touching on the News page UI.
Bug Fixes
-
- None
V4.16.1.4 (Nov 03, 2022)
New Features
-
- None
Changed Features
-
- None
Bug Fixes
- Android
- [Auth v4][ProviderGoogle v1/v2] Forced the update of the GooglePlayService app to always update it when it is required
V4.16.1.3 (Oct 31, 2022)
New Features
- All
- [IAPv4] Added the getMarketProductInfo method to return the information of a single product.
Changed Features
- All
- [IAPv4] Reduced the network bandwidth usage for marketConnect and getProductInfo methods via caching.
- iOS
- [IAPv4] Added a feature that classify the products by the currency code when executing marketConnect.
Bug Fixes
- All
- [Unity/Plugin] Fixed an issue that ExternalDependacyEditor could not load the settings of the previous version when updating from a version lower than 4.16.1.
V4.16.1.2 (Sep 26, 2022)
New Features
-
- None
Changed Features
-
- None
Bug Fixes
- All
- [Unity/Plugin][DataStore] Fixed an issue that the response value received using the get method was incorrectly decoded.
- Android
- [Common] Fixed an intermittent crash due to an error in the communication time measurement.
V4.16.1.1 (Sep 8, 2022)
New Features
-
- None
Changed Features
-
- Android
- [Common] Rolled back the version of a library to support the lower Android OS target.
- applied version: AppCompat 1.4.0
- roll-back version: AppCompat 1.4.0-alpha01
- [Common] Changed the Emoji library dependency from the optional to the required.
- [Common] Rolled back the version of a library to support the lower Android OS target.
- Android
Bug Fixes
-
- None
V4.16.1 (Sep 8, 2022)
New Features
- All
- [Auth v4] Added a feature that deletes a logged in account using PlayerId.
- [MarketTrackingTool] Added the support for the Firebase Analytics (optional) as one of the market performance analysis tools.
- Android
- [Common] Hive SDK is now distributed via MavenCentral.
- [FacebookCloud] Added the Facebook cloud game platform support for applications
- [FacebookCloud][Push] Added the remote push support for Facebook Cloud
Changed Features
- All
- [Analytics] Changed to send the play time and the Hive country code within a transmission interval when sending the information of simultaneous access.
- [Promotion] Added a feature to expose detail view pop-ups on large banners and spot banners as frame views.
- [Promotion] Removed the unused video play scheme logic.
- [Configuration] Changed the default value of API timeout from 15 to 8 seconds.
- The value in hive_config.xml will be used regardless of the change of the default value.
- Android
- [Common] Changed the SDK library dependency from the optional to the required.
- The targets of the dependency changes: recaptcha, Emoji, FCM, Youtube
- [Common] Removed the Emoji–bundle font file which was packaged for supporting Emoji.
- [Promotion] Updated the PlayCore library version which supports the Play Asset Delivery in GooglePlay Market.
- Before: PlayCore 1.8.3
- After: PlayCore 2.0.0, Play–Review 2.0.0
- [Common] Changed the SDK library dependency from the optional to the required.
- iOS
- [Common] Changed the SDK library from Framework to Xcframework to support M1 device simulator target.
Bug Fixes
- Android
- [Auth v4] Fixed the issue that Weverse log-in screen was not exposed.
- iOS
- [Auth v4] Fixed the issue that the time preset of the device was not displayed correctly in the management information of the device management service.
The supported third-party library versions (As of Hive SDK SDK V4.16.0)
Required libraries
-
-
- Kotlin 1.5.10
- Kotlin Coroutine 1.4.0
- AndroidX (Android) v1.0.0+
- constraintlayout (Android) v2.1.1
- glide (Android) v4.13.0
- SDWebImage (iOS) v5.12.5
-
IDP
-
- Google Sign–In SDK (iOS) v6.1.0
Optional libraries
IDP
-
-
- Facebook SDK Android v13.0.0
- Facebook SDK iOS v12.3.1
- Facebook SDK iOS v13.2.0
- GooglePlay Services–Auth (Android) v17.0.0
- GooglePlay Services–Games (Android) v17.0.0
- QQ (Android) v3.5.4.11 (r3f56456)
- QQ (iOS) v3.3.9
- VK (Android) v1.6.9
- VK (iOS) v1.6.1
- WeChat (Android) v6.8.0
- WeChat (iOS) v1.8.6.2
- LINE (Android) v5.7.0
- LINE (iOS) v5.7.0
- Huawei (Android) v6.4.0.300
-
IAP
-
-
- Google Billing Library (Android) v5.0.0
- OneStore (Android) v19.00.02
- WeChat (Android) v6.8.0
- Amazon (Android) v3.0.2
- Huawei (Android) v6.3.0.300
-
PUSH
-
-
- Amazon (Android) v1.0.1
- FCM (Android) v20.2.4
-
MARKETING TRACKING ANALYTICS
-
- AdjustAndroid) v4.29.1
- AdjustiOS) v4.29.7
- Singular(Android) vv12.0.5
- SingulariOS) v11.0.4
- AppsFlyerAndroid) v6.5.2
- AppsFlyeriOS) v6.5.2
- FirebaseAndroid) v20.1.2
- FirebaseiOS) v9.3
Etc.
-
- GooglePlay Services–Review (Android) v2.0.0
- Google Recaptcha (Android) v17.0.1
- Google Recaptcha (iOS) v16.0.0
- YoutubeAndroidWebPlayerApi (Android) v1.0
Hive SDK v4.16.0.0 ~ Hive SDK v4.16.0.6
V4.16.0.6 (Nov 15, 2022)
New Features
- None
Changed Features
- Android
- [Promotion] Add some effects for buttons during news exposure
Bug Fixes
- None
V4.16.0.5 (Sep 1, 2022)
New Features
- None
Changed Features
- None
Bug Fixes
- Android
- [Promotion] Fixed an error that an app freezes on some devices when a user selects not to expose all banners
V4.16.0.4 (Aug 19, 2022)
New Features
- None
Changed Features
- All
- [Auth v1] Supports the account deletion of Hive Membership
- Returned an error code after deleting an account to recognize the user withdraw
- [Auth v1] Supports the account deletion of Hive Membership
Bug Fixes
- Android
- [Auth v4][Provider] Fixed an error where the login UI exposes on game UI transparently when using Sign in with Apple
- [Promotion] Fixed an error that an app freezes on some devices when running an app that has no interstitial banner to be exposed
- [AuthV4] Fixed an error that an app freezes on specific devices when calling
AuthV4.showSignIn()
to sign in with LINE
V4.16.0.3 (Aug 1, 2022)
Unreal | Hive_SDK_Unreal_v4.16.0.3_withCore.zip |
---|
New Features
- None
Changed Features
- Android
- [MarketTrackingTool] Updated Singular SDK
- Used version: v11.0.0
- Updated version: v12.0.5
- [MarketTrackingTool] Updated Singular SDK
- iOS
- [IAPv4] Deactivate the function supporting StoreKit2
- [Plugin/Unity] Changed the Podfile settings to set up automatically a required option for building Unity that includes Line IdP.
Bug Fixes
- None
V4.16.0.2 (Jul 8, 2022)
New Features
- None
Changed Features
- None
Bug Fixes
- Android
- [MarketTrackingTool] Fixed a crash by a dependency problem when the marketing attribution tool(Adjust, AppsFlyer, and Singular) libraries are excluded in building Hive SDK
V4.16.0.1 (Jul 4, 2022)
New Features
- None
Changed Features
- None
Bug Fixes
- Android
- [Auth v4] Fixed to send an appropriate result value when a maintenance popup has no message
V4.16.0 (Jun 30, 2022)
New Features
- All
- [Auth v4] Supports Google reCAPCHA when creating guest accounts to avoid auto-generating guest accounts via bots
- When selecting Guest on the option shown by calling the
showSignin()
method, you can see this feature applied - When calling the
Signin()
method and selecting Guest, you can see this feature applied
- When selecting Guest on the option shown by calling the
- [Auth v4] Supports Google reCAPCHA when creating guest accounts to avoid auto-generating guest accounts via bots
- Android
- [Promotion] Supports the feature to expose Direct Banners on the current activity
Changed Features
- All
- [Configuration] Provides API that excludes logs other than service logic
- [Auth v4] Added cases for initialization failure
- [Tracking] Changed to additionally transfer the information below when sending Adjust purchase events
- Price
- Currency Code
- Order No.
- Product Code
- Product Title
- Server Value
- [Provisioning] Improved to maintain the initial settings of
HiveCountry
andTimeZone
- [Plugin/Unity] Updated the EDM4U library version that includes in the Unity distribution
- Used version: v1.2.167
- Updated version: v1.2.171
- [Auth v1] Changed to transfer the callback if a user proceeds with the account deletion when exposing SocialDialog
- [Push] Changed to renew Push token information when calling the
updateServerId()
andupdateGameLanguage()
method of the Configuration class
- Android
- [Auth v4][IAP v4] Updated the Wechat library version
- Used version: v1.4.0
- Updated version: v6.8.0
- [IAPv4] Applied GoogleBillingLibrary 5.0
- [Analytics] Separated the logic getting Install Referrer information and the logic initializing Hive IAP v4
- [IAPv4] Changed to return an error if the product information is empty when calling the
marketConnect()
method - [Common] Added the WebView initializing settings to use the WebView that guaranteed 320dp on a device under 320dp width
- [Auth v4][IAP v4] Updated the Wechat library version
- iOS
- [IAPv4] Supports StoreKit2 available on iOS 15 and higher
- [Promotion] Applied the SDWebImage library to improve the resource management
- [Common] Updated the version of Facebook SDK
- Used version: v13.1
- Updated version: v13.2
Bug Fixes
- All
- [Auth v4] Fixed an error that deletes the session information when you tried switching accounts and canceled it in account conflict
- Android
- [Plugin][Cocos] Fixed an error that your app restarts depending on running what kind of MainActivity on the deferred deep link
- [Auth v4] Fixed an error that exposes the maintenance popup before receiving user‘s touch events when calling the
checkMaintenance()
method to show the maintenance popup - [Auth v4] Fixed the phrase shown on the account conflict popup that exposed when calling the
showConflict()
method after the Apple account conflicts
- iOS
- [Auth v4] Fixed exposing the UI changing process as dimed during UI changing on a low-end device
- [Promotion] Fixed to send missing values to page information when clicking a news banner
- [Promotion] Fixed a crash when exposing Direct banner as a frame type
Version of third-party Libraries for Hive SDK V4.15.8
Common item
- Kotlin 1.5.10
- Kotlin Coroutine 1.4.0
- AndroidX (Android) v1.0.0+
- Firebase Library (Android) v20.2.4
- constraintlayout (Android) v2.1.1
- Google Sign–In SDK (iOS) v6.1.0
IDP
Optional item
-
IDP
- Facebook SDK Android v13.0.0
- Facebook SDK iOS v12.3.1
- Facebook SDK iOS v13.2.0
- GooglePlay Services–Auth (Android) v17.0.0
- GooglePlay Services–Games (Android) v17.0.0
- QQ (Android) v3.5.4.11 (r3f56456)
- QQ (iOS) v3.3.9
- VK (Android) v1.6.9
- VK (iOS) v1.6.1
- WeChat (Android) v6.8.0
- WeChat (iOS) v1.8.6.2
- LINE (Android) v5.7.0
- LINE (iOS) v5.7.0
- Huawei (Android) v6.4.0.300
- Google Billing Library (Android) v5.0.0
- OneStore (Android) v19.00.02
- WeChat (Android) v6.8.0
- Amazon (Android) v3.0.2
- Huawei (Android) v6.3.0.300
- Amazon (Android) v1.0.1
- Adjust(Android) v4.29.1
- Adjust(iOS) v4.29.7
- Singular(Android) v11.0.0
- Singular(iOS) v11.0.4
- AppsFlyer(Android) v6.5.2
- AppsFlyer(iOS) v6.5.2
IAP
PUSH
MARKETING TRACKING ANALYTICS
Upgrade Guide
Hive SDK v4.13.0 ~ Hive SDK v4.16.4 ⇨ Hive SDK v4.16.4
When installing the Hive SDK in the Android native development environment, you do not need to directly enter the external library version.
When adding the Hive SDK and external libraries to the module-level build.gradle file, you no longer need to manually enter the external library versions. If you enter only the external library items to be used, Hive SDK automatically sets the external library versions that matches the Hive SDK version. For more details, see here.
If necessary, you can manually enter the external library versions, like it was in the earlier versions of Hive SDK 4.16.4. Refer to the guides below.
- Add the repository to your project-level build.gradle file to import the external library.
1234567allprojects {repositories {google()mavenCentral()maven { url 'https://maven.singular.net/' } // only for singular}} - Set the Hive SDK and external library dependencies in the module-level build.gradle file.
$HIVE_SDK_VERSION
is the Hive SDK version you want to use (example: 4.16.3). To apply the VK library, targetSdkVersion 32 or higher is required.
1234567891011121314151617181920212223242526272829303132333435363738394041dependencies {// Hive SDKimplementation "com.com2us.android.hive:hive-sdk:$HIVE_SDK_VERSION"// Herculesimplementation "com.com2us.android.hive:hercules:$HIVE_SDK_VERSION"// Please add the Youtube Helper dependency only if you included the promotion video feature.implementation "com.com2us.android.hive:youtube-helper:1.0.1"// Add dependencies only if you included Google (Google Play Services, FCM) features.implementation "com.com2us.android.hive:hive-service-extension-google:$HIVE_SDK_VERSION"// Please add dependencies only if you included Facebook features.implementation "com.com2us.android.hive:hive-service-extension-facebook:$HIVE_SDK_VERSION"// Add the IAPV2 dependency only if you are using the IAPV2 module.implementation "com.com2us.android.hive:hive-service-extension-iapv2:$HIVE_SDK_VERSION"// Add the Hive SDK plugin dependency only if this is for non-native development.implementation "com.com2us.android.hive:hive-plugin:$HIVE_SDK_VERSION"// IDP Dependencyimplementation 'com.tencent.mm.opensdk:wechat-sdk-android-without-mta:6.8.0'implementation 'com.vk:android-sdk-core:3.5.1' // minSdkVersion 21implementation 'com.vk:android-sdk-api:3.5.1' // minSdkVersion 21implementation 'com.linecorp:linesdk:5.7.0'// Analytics Dependencyimplementation 'com.adjust.sdk:adjust-android:4.32.0'implementation 'com.appsflyer:af-android-sdk:6.9.2'implementation 'com.singular.sdk:singular_sdk:12.0.8'implementation 'com.google.firebase:firebase-analytics:20.1.2'// IAP Dependencyimplementation 'com.android.billingclient:billing-ktx:5.0.0'implementation 'com.amazon.device:amazon-appstore-sdk:3.0.2'implementation 'com.alipay.sdk:alipaysdk-android:15.8.11'implementation 'com.android.installreferrer:installreferrer:2.2'}To check the external library versions you need to use for each Hive SDK version, check out Sample/library.gradle after downloading each Hive SDK version.
When you want to close the game app, you need to implement the termination of the app by yourself.
The Hive SDK no longer terminates the game apps for you. In the process of Hive Authentication and Hive initialization, you may need to close the game app. For example, when the game server is under maintenance, the game must be closed even if the user launches the game app. Also, the game app may need to be closed when the user does not agree to the terms and conditions. Starting from Hive SDK 4.16.4, the Hive SDK does not forcibly terminate the game app in certain situations including those where the game needs to be terminated, and the game company must implement the code to terminate the game app directly in the callback function.
More specifically, from Hive SDK 4.16.4 onwards, the
exitEventEnabled
in the Hive_config.xml cannot be set. Instead, this value is always applied asTrue
. Therefore, if the result of Result API class instanceneedExit()
method call isTrue
during the Hive authentication and Hive initialization process, you will need to implement your own code to close the game. For more details, please refer to the API example codes in the Hive initialization and Hive authentication documentation.The example codes below shows handling the app termination event when implementing the login function provided by Hive SDK authentication.
Unity®API Reference: hive.AuthV4.signIn
123456AuthV4.signIn(AuthV4.ProviderType.FACEBOOK, (ResultAPI result, AuthV4.PlayerInfo playerInfo) => {if (result.needExit()) {// TODO: Implement the termination of the app.// Example) Application.Quit();}});C++API Reference: Auth4::signIn
123456789AuthV4::signIn(ProviderType::FACEBOOK, [=](ResultAPI const & result, PlayerInfo const & playerInfo){if (result.needExit()) {// TODO: Implement the termination of the app.// Users of the Cocos2d-x engine// ex) exit(0);// Unreal engine users// Example) UKismetSystemLibrary::QuitGame(GetWorld(), nullptr, EQuitPreference::Quit, false);}});KotlinAPI Reference: com.hive.Auth4.signIn
12345678AuthV4.signIn(AuthV4.ProviderType.FACEBOOK, object: AuthV4.AuthV4SignInListener{override fun onAuthV4SignIn(result: ResultAPI, playerInfo: AuthV4.PlayerInfo?) {if (result.needExit()) {// TODO: Implement the termination of the app.// ex) exitProcess(0)}}})JavaAPI Reference: com.hive.Auth4.signIn
123456789AuthV4.signIn(AuthV4.ProviderType.FACEBOOK, new AuthV4.AuthV4SignInListener() {@Overridepublic void onAuthV4SignIn(ResultAPI result, AuthV4.PlayerInfo playerInfo) {if (result.needExit()) {// TODO: Implement the termination of the app.// ex) System.exit(0);}}});SwiftAPI Reference: HIVEAuth4:signIn
123456AuthV4Interface.signIn(.Facebook) { (result, playerInfo) inif result.needExit() {// TODO: Implement the termination of the app.// Example) exit(0)}}Obj-CAPI Reference: HIVEAuth4:signIn
123456[HIVEAuthV4 signIn:HIVEProviderTypeFacebook handler:^(HIVEResultAPI *result, HIVEPlayerInfo *playerInfo) {if (result.needExit) {// TODO: Implement the termination of the app.// ex) exit(0);}}];
4.15
Hive SDK v4.15.8.5 (Aug 22, 2022)
Unity® | Hive_SDK_Unity_v4.15.8.5_withCore.zip |
---|---|
Cocos2D-X | Hive_SDK_Cocos_v4.15.8.5_withCore.zip |
Android | Hive_SDK_Android_v4.15.8.5_withCore.zip | iOS | Hive_SDK_iOS_v4.15.8.5_withCore.zip |
The SDK for Cocos2D-X includes a C++ interface.
Hive SDK v4.15.7 (Feb 25, 2022)
Unity® | Hive_SDK_Unity_v4.15.7_withCore.zip |
---|---|
Cocos2D-X | Hive_SDK_Cocos_v4.15.7_withCore.zip (Mar 24, 2022 Release) |
Android | Hive_SDK_Android_v4.15.7_withCore.zip (Mar 24, 2022 Release) |
iOS | Hive_SDK_iOS_v4.15.7_withCore.zip (Mar 24, 2022 Release) |
The SDK for Cocos2D-X includes a C++ interface.
Hive SDK v4.15.6.1 (Aug 2, 2022)
Unity® | Hive_SDK_Unity_v4.15.6.1_withCore.zip |
---|---|
Cocos2D-X | Hive_SDK_Cocos_v4.15.6.1_withCore.zip | Android | Hive_SDK_Android_v4.15.6.1_withCore.zip | iOS | Hive_SDK_iOS_v4.15.6.1_withCore.zip |
The SDK for Cocos2D-X includes a C++ interface.
Hive SDK v4.15.5.1 (Dec 6, 2021)
Unity® | Hive_SDK_Unity_v4.15.5.1_withCore.zip |
---|---|
Cocos2D-X | Hive_SDK_Cocos_v4.15.5.1_withCore.zip | Android | Hive_SDK_Android_v4.15.5.1_withCore.zip | iOS | Hive_SDK_iOS_v4.15.5.1_withCore.zip |
Unreal | Hive_SDK_Unreal_v4.15.5.1_withCore.zip (Jan 18, 2022 Release) |
Hive SDK v4.15.4.1 (May 13, 2022)
Hive SDK v4.15.3 (Sep 16, 2021)
Release Notes
Hive SDK v4.15.8.0 ~ Hive SDK v4.15.8.5
V4.15.8.5 (Aug 22, 2022)
New Features
- None
Changed Features
- None
Bug Fixes
- Android
- [Promotion] Fixed an error that an app freezes on some devices when running an app that has no interstitial banner to be exposed
- [Common] Fixed a crash caused when requesting additional permission on a permission request dialog
V4.15.8.4 (Aug 1, 2022)
New Features
- None
Changed Features
- Android
- [MarketTrackingTool] Updated Singular SDK
- Used version: v11.0.0
- Updated version: v12.0.5
- [MarketTrackingTool] Updated Singular SDK
Bug Fixes
- None
V4.15.8.3 (May 16, 2022)
New Features
- None
Changed Features
- All
- Used Google reCAPCHA keys to avoid auto-generating guest accounts via bots
- When selecting guest on the option shown by calling the
showSignin()
method, exposes an I’m not a robot checkbox
- When selecting guest on the option shown by calling the
- Used Google reCAPCHA keys to avoid auto-generating guest accounts via bots
- Android
- [Tracking] Modified to can not send the Play Install Referrer manually to AppsFlyer
Bug Fixes
- None
V4.15.8.1 (Apr 15, 2022)
Unreal | Hive_SDK_Unreal_v4.15.8.1_withCore.zip (Jun 02, 2022 Release) |
---|
New Features
- All
- [Common] Updated the Facebook SDK to the latest version
- Used version: v12.3 / Updated version: v13.0+
- The minimum supported version of iOS: Changed to iOS 11 (No changes in Android) See note
- [Common] Updated the Facebook SDK to the latest version
Changed Features
- None
Bug Fixes
- iOS
- [Auth v4] Fixed an error where not automatically set the PlayerID in proceeding Auth v4 Inquiry by calling showInquiry API
Version of third-party Libraries for Hive SDK V4.15.8
Common item
- Kotlin 1.5.10
- Kotlin Coroutine 1.4.0
- AndroidX (Android) v1.0.0+
- Firebase Library (Android) v20.2.4
- constraintlayout (Android) v2.1.1
- Facebook SDK iOS v13.1.0
- Google Sign–In SDK (iOS) v6.1.0
IDP
Optional item
-
IDP
- Facebook (Android) v13.0.0
- GooglePlay Services–Auth (Android) v17.0.0
- GooglePlay Services–Games (Android) v17.0.0
- QQ (Android) v3.5.4.11 (r3f56456)
- QQ (iOS) v3.3.9
- VK (Android) v1.6.9
- VK (iOS) v1.6.1
- WeChat (Android) v1.4.0
- WeChat (iOS) v1.8.6.2
- LINE (Android) v5.7.0
- LINE (iOS) v5.7.0
- Google Billing Library (Android) v3.0.3
- OneStore (Android) v19.00.02
- WeChat (Android) v1.4.0
- Amazon (Android) v3.0.2
- Amazon (Android) v1.0.1
- Adjust(Android) v4.29.1
- Adjust(iOS) v4.29.7
- Singular(Android) v11.0.0
- Singular(iOS) v11.0.4
- AppsFlyer(Android) v6.5.2
- AppsFlyer(iOS) v6.5.2
IAP
PUSH
MARKETING TRACKING ANALYTICS
V4.15.8 (Apr 6, 2022)
New Features
- All
- Android
- [Auth v4] Added openbrowser scheme to move to an expernal browser for running Chatbot
Changed Features
- All
- [Auth][SocialFacebook] Delete the user_friends authority from the basic request elements when logging in facebook
- [Auth][SocialHive] Get rid of the Hive logo from Hive WebView
- [Cpp/Plugin] Added HiveJson instead of Picojson library which is deleted
- Updated the version of external libraries See more
- Adjust
- Singular
- AppsFlyer
- Google–SignIn
- Android
- [IAP v4][Repayment] Added Huawei to the Refund User Repayment market
Bug Fixes
- Android
- [Protocol][Promotion] Fixed to send whether or not the restriction of advertisement identifier as well when CPI communication
- [Auth v1][Social] Fixed an error callback that called when SocialDialog is closing
- [IAP v4] Fixed an error that occurs while purchasing an item in the ONE store sandbox environment
- iOS
- [Common] Fixed an error where the app behavior frozen or slowed down in a network environment that involved network communication with the synchronous API
Hive SDK v4.15.7
V4.15.7 (Feb 25, 2022)
New Features
- All
- [Auth v4] Added Custom Login which implements an external IdP login that Hive SDK does not support (Guide)
- Android
- [Auth v4] Added processing
openbrowser
scheme which can move to an external browser from Chatbot
- [Auth v4] Added processing
Changed Features
- None
Bug Fixes
- Android
- [Auth v4] Fixed to resize the displayed Chatbot UI when the on-screen keyboard exposes on the Chatbot page
Version of third-party Libraries for Hive SDK V4.15.7
Common item
- Kotlin 1.5.10
- Kotlin Coroutine 1.4.0
- AndroidX (Android) v1.0.0+
- Firebase Library (Android) v20.2.4
- constraintlayout (Android) v2.1.1
- Facebook SDK iOS v9.1.0
- Google Sign–In SDK (iOS) v5.0.2+
IDP
Optional item
-
IDP
- Facebook (Android) v12.1.0
- GooglePlay Services–Auth (Android) v17.0.0
- GooglePlay Services–Games (Android) v17.0.0
- QQ (Android) v3.5.4.11 (r3f56456)
- QQ (iOS) v3.3.9
- VK (Android) v1.6.9
- VK (iOS) v1.6.1
- WeChat (Android) v1.4.0
- WeChat (iOS) v1.8.6.2
- LINE (Android) v5.7.0
- LINE (iOS) v5.7.0
- Google Billing Library (Android) v3.0.3
- OneStore (Android) v19.00.02
- WeChat (Android) v1.4.0
- Amazon (Android) v3.0.2
- Amazon (Android) v1.0.1
- Adjust(Android) v4.28.0
- Adjust(iOS) v4.29.6
- Singular(Android) v9.6.0
- Singular(iOS) v10.4.0
- AppsFlyer(Android) v6.3.0
- AppsFlyer(iOS) v6.2.6
IAP
PUSH
MARKETING TRACKING ANALYTICS
Hive SDK v4.15.6.0 ~ Hive SDK v4.15.6.1
V4.15.6.1 (Aug 2, 2022)
New Features
- None
Changed Features
- Android
- [MarketTrackingTool] Updated Singular SDK
- Used version: v9.6.0
- Updated version: v12.0.5
- [MarketTrackingTool] Updated Singular SDK
Bug Fixes
- Android
- [AuthV4] Fixed an intermittent freeze issue on some devices when signing in with LINE by calling showSignIn API
V4.15.6 (Jan 20, 2022)
New Features
- All
- [HivePromotion] Added a function to expose information of a user who invited a friend to the game through the UA link to the in-game UI of the invited user (Guide)
- Android
- [Auth V4] Added an authentication, Sign in with Apple
- [Common] Added the EmojiCompat library
- Avoided displaying the form of ☐ when you use unsupported emoji characters
Changed Features
- All
- [Auth v4] Enhanced security for device identification of the device management service
- [Auth v4] Changed some of the initialization steps from sequential to parallel processing to speed up the Hive SDK initialization
- [Provisioning] Improved the distributed server works
- Unable to progress on the distributed server the first time running the app
- [Provisioning] Applied the distributed server to Hive Provisioning
- [Common] Updated the text that displays on the screen of the permission notice and request
- [Auth v1][SocialFacebook] Excluded the user_friends permission, which used to authenticate Facebook, from default permission
- Android
- [Promotion] Updated the text on the exit popup to be properly line-wrapped
- [Promotion] Changed the
showReview
method’s behavior to expose the Hive Review Popup on the Android markets but not Google Play Store (Guide) - [IAP v4] Updated to test the Galaxy store billing with the sandbox environment
- [IAP v4] Improved the error handling that is caused by abnormally connected with Google Play Service
- [IAP v4] Updated Amazon AppStore SDK to 3.0.2
- [IAP v4] Updated to pass the
AddtionalInfo
value to developerPayload when using ONE store API v4 - [Auth v4][Auth v1][SocialFacebook] Updated the Facebook SDK to the latest version
- Used version: v9.1.1
- Updated version: v12.1.0
- [Auth v4] Updated the LINE SDK to the latest version
- Used version: v5.3.1
- Updated version: v5.7.0
- [IAP v4] Updated the OneStore SDK to the latest version
- Used version: v19.0.0.1
- Updated version: v19.0.0.2
- [Unity/Plugin] Updated the EDM4U included in the Unity distribution package to the latest version
- Updated version: 1.2.167
- [Unity/Plugin] Improved the compatibility handling by changing the minimum supported version to 22 from Unity 2021.2 and higher
- [Unity/Plugin] Changed the location where the hive_config.xml file should be created as the location of the res directory in the Android library changes from Unity 2021.1
- Used path(under Unity 2021.1): Assets/Plugins/Android/res
- Changed path(Unity 2021.1 and higher): Assets/HiveSDK/hive.androidlib/src/main/res
- iOS
- [Common][Unity][Cpp] Improved interface to enable building plug-in code even in any environment besides Swift
Bug Fixes
- iOS
- [IAPv4] Fixed an error not to enable the receipt verification and
transactionFinish
method when the item needed to be restored is not on the list of Refund user repayment
- [IAPv4] Fixed an error not to enable the receipt verification and
Version of third-party Libraries for Hive SDK V4.15.6
Common item
- Kotlin 1.5.10
- Kotlin Coroutine 1.4.0
- AndroidX (Android) v1.0.0+
- Firebase Library (Android) v20.2.4
- constraintlayout (Android) v2.1.1
- Facebook SDK iOS v9.1.0
- Google Sign–In SDK (iOS) v5.0.2+
IDP
Optional item
-
IDP
- Facebook (Android) v12.1.0
- GooglePlay Services–Auth (Android) v17.0.0
- GooglePlay Services–Games (Android) v17.0.0
- QQ (Android) v3.5.4.11 (r3f56456)
- QQ (iOS) v3.3.9
- VK (Android) v1.6.9
- VK (iOS) v1.6.1
- WeChat (Android) v1.4.0
- WeChat (iOS) v1.8.6.2
- LINE (Android) v5.7.0
- LINE (iOS) v5.7.0
- Google Billing Library (Android) v3.0.3
- OneStore (Android) v19.00.02
- WeChat (Android) v1.4.0
- Amazon (Android) v3.0.2
- Amazon (Android) v1.0.1
- Adjust(Android) v4.28.0
- Adjust(iOS) v4.29.6
- Singular(Android) v9.6.0
- Singular(iOS) v10.4.0
- AppsFlyer(Android) v6.3.0
- AppsFlyer(iOS) v6.2.6
IAP
PUSH
MARKETING TRACKING ANALYTICS
Hive SDK v4.15.5.0 ~ Hive SDK v4.15.5.1
V4.15.5.1 (Dec 6, 2021)
New Features
- All
- Updated relevant contents in accordance with the CI change
Changed Features
- None
Bug Fixes
- None
V4.15.5 (Nov 8, 2021)
New Features
- All
- Supports the device management service for game security enhancements (Guide)
Changed Features
- None
Bug Fixes
- None
Version of third-party Libraries for Hive SDK v4.15.5
Common item
- Kotlin 1.4.32
- Kotlin Coroutine 1.4.0
- AndroidX (Android) v1.0.0+
- Firebase Library (Android) v20.2.4
- constraintlayout (Android) v2.1.1
- Facebook SDK iOS v9.1.0
- Google Sign–In SDK (iOS) v5.0.2+
IDP
Optional item
-
IDP
- Facebook (Android) v9.1.1
- GooglePlay Services–Auth (Android) v17.0.0
- GooglePlay Services–Games (Android) v17.0.0
- QQ (Android) v3.5.4.11 (r3f56456)
- QQ (iOS) v3.3.9
- VK (Android) v1.6.9
- VK (iOS) v1.6.1
- WeChat (Android) v1.4.0
- WeChat (iOS) v1.8.6.2
- LINE (Android) v5.3.1
- LINE (iOS) v5.7.0
- Google Billing Library (Android) v3.0.3
- OneStore (Android) v19.00.01
- WeChat (Android) v1.4.0
- Amazon (Android) v2.0.76
- Amazon (Android) v1.0.1
- Adjust(Android) v4.28.0
- Adjust(iOS) v4.29.6
- Singular(Android) v9.6.0
- Singular(iOS) v10.4.0
- AppsFlyer(Android) v6.3.0
- AppsFlyer(iOS) v6.2.6
IAP
PUSH
MARKETING TRACKING ANALYTICS
Hive SDK v4.15.4.0 ~ Hive SDK v4.15.4.1
V4.15.4.1 (May 13, 2022)
New Features
- None
Changed Features
- All
- Used Google reCAPCHA keys to avoid auto-generating guest accounts via bots
- When selecting guest on the option shown by calling the
showSignin()
method, exposes an I’m not a robot checkbox
- When selecting guest on the option shown by calling the
- Used Google reCAPCHA keys to avoid auto-generating guest accounts via bots
Bug Fixes
- None
V4.15.4 (Oct 26, 2021)
AndroidHive_SDK_Android_V4.15.4.1_withCore.zipiOSHive_SDK_iOS_V4.15.4.1_withCore.zip
Cocos2D-X | Hive_SDK_Cocos_V4.15.4.1_withCore.zip |
---|
The SDK for Cocos2D-X includes a C++ interface.
New Features
- All
Changed Features
- All
- [Promotion] Added a mark on the menu tab of News to notify a new content has been updated (Image)
- [Auth v4] Updated Hive Membership v4 design to give the dialog a consistent look with game UI
- [Promotion] Updated Coupon Use URL of Hive Coupon API
- [Promotion] Added Campaign order to set an exposing order of UA Campaigns (Guide)
- Added order value to
eachCampaigns
andstageCampaigns
on theAppInvitationData
object that delivered bygetAppInvitationData()
method
- Added order value to
- iOS
- [IAP v4] Updated logic to issue an iOS 7 style receipt on a purchase succeed
- [Auth v4] Updated GameCenter identifier on devices running iOS 15 and higher
- [Push] Updated settings of app notifications to allow use Time Sensitive Notifications on devices running iOS 15 and higher (Guide)
- Users can receive the event of an emergency if Time Sensitive Notifications activates, even when the user has a Focus set up.
Bug Fixes
- Android
- [Analytics][CCU] Fixed an error that can’t send Funnel log when the user had changed the device time settings while the app was running
- iOS
- [Auth][Social] Fixed an issue where to be a loading spinner positions to center on a screen that uses safe areas
- [Auth][Provision] Fixed an issue where User Agreement Log redundantly sends when SDK is initializing
- [Unity] Fixed an error that the version of Singular SDK is downgraded when using ExternalDependency
Version of third-party Libraries for Hive SDK v4.15.4
Common item
- Kotlin 1.4.32
- Kotlin Coroutine 1.4.0
- AndroidX (Android) v1.0.0+
- Firebase Library (Android) v20.2.4
- Facebook SDK iOS v9.1.0
- Google Sign–In SDK (iOS) v5.0.2+
IDP
Optional item
-
IDP
- Facebook (Android) v9.1.1
- GooglePlay Services–Auth (Android) v17.0.0
- GooglePlay Services–Games (Android) v17.0.0
- QQ (Android) v3.5.4.11 (r3f56456)
- QQ (iOS) v3.3.9
- VK (Android) v1.6.9
- VK (iOS) v1.6.1
- WeChat (Android) v1.4.0
- WeChat (iOS) v1.8.6.2
- LINE (Android) v5.3.1
- LINE (iOS) v5.7.0
- Google Billing Library (Android) v3.0.3
- OneStore (Android) v19.00.01
- WeChat (Android) v1.4.0
- Amazon (Android) v2.0.76
- Amazon (Android) v1.0.1
- Adjust(Android) v4.28.0
- Adjust(iOS) v4.29.6
- Singular(Android) v9.6.0
- Singular(iOS) v10.4.0
- AppsFlyer(Android) v6.3.0
- AppsFlyer(iOS) v6.2.6
IAP
PUSH
MARKETING TRACKING ANALYTICS
Hive SDK v4.15.3
V4.15.3 (Sep 16, 2021)
New Features
- All
- [Auth v1/Auth v4][IAP v4] Reissued the user‘s payment for the refunded items that had been refunded on the Google, Apple, or Amazon market
- Users are available to log in after completing payments to the refunded item.
- [Auth v1/Auth v4][IAP v4] Reissued the user‘s payment for the refunded items that had been refunded on the Google, Apple, or Amazon market
- Android
- [Common] Declare the exported attribute to your app components that use intent filters
- Add explicit exported declaration for the components that include intent-filter to AndroidManifest
- [Common] Added the com.google.android.gms.permission.AD_ID permission to use an advertising ID on devices running Android 12 and higher
- [Common] Declare the exported attribute to your app components that use intent filters
Changed Features
- Android
[Common] Returned null when advertising ID is unable to acquire on devices running Android 12 and higher
- [Auth v1][Auth v4] Removed the permission regarding collecting phone numbers and sending SMS that used on marketing
- Removed READ_PHONE_STATE and READ_PHONE_NUMBER
- [Push] Changed how notifications behave on devices running Android 12 and higher
Bug Fixes
- None
Version of third-party Libraries for Hive SDK v4.15.3
Common item
- Kotlin 1.4.32
- Kotlin Coroutine 1.4.0
- AndroidX (Android) v1.0.0+
- Firebase Library (Android) v20.2.4
- Facebook SDK Android v9.1.1
- Facebook SDK iOS v9.1.0
- GooglePlay Services–Games, Auth (Android) v17.0.0
- Google Sign–In SDK (iOS) v5.0.2+
- Google Billing Library (Android) v3.0.3
IDP
IAP
Optional item
-
IDP
- QQ (Android) v3.5.4.11 (r3f56456)
- QQ (iOS) v3.3.9
- VK (Android) v1.6.9
- VK (iOS) v1.6.1
- WeChat (Android) v1.4.0
- WeChat (iOS) v1.8.6.2
- LINE (Android) v5.3.1
- LINE (iOS) v5.7.0
- OneStore (Android) v19.00.01
- WeChat (Android) v1.4.0
- Amazon (Android) v2.0.76
- Amazon (Android) v1.0.1
- Adjust(Android) v4.28.0
- Adjust(iOS) v4.29.1
- Singular(Android) v9.6.0
- Singular(iOS) v10.4.0
- AppsFlyer(Android) v6.3.0
- AppsFlyer(iOS) v6.2.6
IAP
PUSH
MARKETING TRACKING ANALYTICS
Upgrade Guide
There are no checkpoints for upgrading from the versions under v4.15 to v4.15 and its patches.
4.21 Windows (Crossplay 4.21)
Crossplay v4.21.0 (June 9, 2023)
Release Date | Download | Game Engine |
---|---|---|
2023-06-09 | Hive_Crossplay_Unity_4.21.0.zip | Unity |
Release Notes
Crossplay v4.21.0
V4.21.0 (June 9, 2023)
New Features
- Windows
- [Billing] The purchase in Steam is supported as a new purchase method.
- Reference: Added the Steam purchase support for Windows
- [Billing] The purchase in Steam is supported as a new purchase method.
Changed Features
- Windows
- [All] The Unity version for Windows build is updated.
- 4.16.4: Unity 2018.4.32f
- 4.21.0: Unity 2021.3.22f
- [All] Pre-build setup > player settings was changed. The scripting runtime version requirement is removed, and the API compatibility is updated.
- [Authentication] You now can use automatic login feature for the Crossplay.
- [Authentication] You can collect the email address in a signed-in user’s account profile. For more details about the email address collection, see Hive SDK 4.21.0 release notes.
- [Authentication] Changed the account conflict pop-up texts to make users recognize that a guest account will be lost if that is the case.
- [All] The Unity version for Windows build is updated.
Not Supported Features
Crossplay 4.21.0 Unsupported Features
Authentication
Crossplay supports some functions only of Auth v4 and none of the Auth class.
-
Supported IdP
You can log in to Crossplay with the IdPs below only:
- Hive Membership
- SignIn-with-apple
-
Guest Login
Crossplay doesn’t support Geust Login.
-
View Terms of Service Again
Crossplay doesn’t support View Terms of Service Again.
-
Adult Confimation
Crossplay doesn’t support Adult Confirmation that implements through the
showAdultConfirm()
method of the AuthV4 class.
Membership and Social
Crossplay doesn’t support Membership & Social functions other than Contact us.
Promotion
-
Review/Exit Popups
Crossplay doesn’t support Review/Exit Popups because it has no market currently.
-
Offerwall
Crossplay doesn’t support Offerwall that implements with
getOfferwallState()
andshowOfferwall()
. -
Spot banner & Direct banner
Crossplay doesn’t support Spot banner and Direct banner.
-
User Acquisition
showUAShare()
Crossplay doesn’t support User Acquisition that implements with
showUAShare()
, however, you can configure an invitation screen by calling thegetAppInvitationData()
method. - Show news page (4.16.4 or later)
showNews (...)
Crossplay does not support displaying the news page using theshowNews
method and highlighting the achieved event banner with an event number (pid). It just works as showing the news page.
Billing
Crossplay Billing supports PG payment. PG payment doesn’t issue receipts and delivers the item through the game server when a user requests payment immediately.
-
Purchase
Purchasing with PG payment returns ErrorCode : IAPSUCCESS = 90 and Code : IAPV4HiveStoreSuccess = -6110000 through a Result API after calling the
purchase()
method immediately. These errors mean nothing to be handled separately as delivering an item immediately after the user purchases. For more details, see About Hive PG payment. -
Verify receipt
PG payment doesn’t issue the client-based receipt. For more details, see About Hive PG payment.
-
Promotional IAP
Crossplay doesn’t support Promotional IAP.
-
Subscriptions
Crossplay doesn’t support the subscription system.
-
Hive Lebi
Crossplay doesn’t support Hive Lebi.
Notification
Crossplay doesn’t support the Notification functions.
Marketing Attribution
Crossplay doesn’t support the Marketing Attribution functions.
Analytics
Crossplay doesn’t support the Analytics functions.
Data Store
Crossplay doesn’t support the Data Store functions.
Etc.
- Permission notice popup
- Customization of permission notice screen
- the
getPermissionViewData()
method of the Configuration class - the
getChannel()
method of the Configuration class - the
setChannel (...)
method of Configuration class - the IAPV4Class’s
getAccountUuid()
method - Remote log-in
Upgrade Guide
There are no checkpoints for upgrading from the versions under Crossplay v4.21 to Crossplay v4.21 and its patches.
4.16 Windows (Crossplay 4.16)
Crossplay v4.16.4.1 (May 26, 2023)
Release Date | Download | Game Engine |
---|---|---|
2023-05-26 | Hive_Crossplay_Unreal_4.16.4.1.zip | Unreal |
Crossplay v4.16.2 (Dec 15, 2022)
Release Date | Download | Game Engine |
---|---|---|
2023-01-04 | Hive_Crossplay_Unreal_4.16.2.zip | Unreal |
2022-12-15 | Hive_Crossplay_Unity_4.16.2.zip | Unity® |
Release Notes
Crossplay v4.16.4.0 ~ Crossplay v4.16.4.1
V4.16.4.1 (May 26, 2023)
Changed Features
- [Authentication] The Crossplay now also supports AuthV4.ShowProfile. If it is called, it tries to load the webview for the user profile.
Developer Guide Updates
- Added
AuthV4::showProfile
to the description of the IME foreign language input part in the Unreal C++ interface settings - Changed the folder where the hive_config.xml file is located to the config folder in Unreal pre-build settings
V4.16.4 (May 15, 2023)
Bug Fixes
- Windows
- [Common] Fixed an issue where you could not enter ‘@’ by pressing
Alt + Gr + 2
in the WebView when using certain keyboard layouts (such as French and some European keyboards). li>
- [Common] Fixed an issue where you could not enter ‘@’ by pressing
Crossplay v4.16.2
V4.16.2 (Dec 15, 2022)
Update Features
- Windows
- [Common] Provide Hercules as the common feature
- Optionally removable when not in use
- [AuthV4] Provide linking and unlinking for custom login
- [Community] Use the information registered in the App Center for Community product setting values
- [Promotion] Added spot banner and direct view type
- [Promotion] Add frame view type to detail view pop-up UI of large banner and spot banner
- [Common] Provide Hercules as the common feature
Changed Features
- Windows
- [Promotion] Improved badge exposure for news view contents
- [Auth v4] Changed the UI of reviewing terms and conditions
- [Plugin/Unity] Update the JSONObject library used in the Unity package to the latest
- [Plugin/Unity] Changed SDK timeout setting default value of HiveConfig Inspector in Unity from 15 seconds to 8 seconds
- [Analytics] Changed to send the play time and the Hive country code within a transmission interval when sending the information of simultaneous access.
- [Common] Change the network default timeout time inside the SDK to 8 seconds
Bug Fixes
- Windows
- [Auth v4] Fixed a bug that email login was exposed when logging in from China
- [Promotion] Fixed an issue that you could not click the large banner’s “Do not see this banner today” in some resolutions of the window mode supported by the game
- [Promotion] Fixed an issue that web banners were not exposed in the large banners
- [Common] Fixed an issue that boolean values were not properly set in some communications
Upgrade Guide
There are no checkpoints for upgrading from the versions under Crossplay v4.16 to Crossplay v4.16 and its patches.
4.15 Windows (Crossplay 4.15)
Crossplay 4.15.8.3 (Feb 24, 2023)
Release Date | Download | Game Engine |
---|---|---|
2023-02-24 | Hive_Crossplay_Unity_4.15.8.3.zip | Unity® |
2022-11-21 | Hive_Crossplay_Unity_4.15.8.2.zip | Unity® |
2022-10-14 | Hive_Crossplay_Unity_4.15.8.1.zip | Unity® |
2022-09-22 | Hive_Crossplay_Unreal_4.15.8.zip | Unreal |
2022-09-07 | Hive_Crossplay_Unity_4.15.8.zip | Unity® |
Crossplay v4.15.7 (May 26, 2022)
Distributed on | Download | Game Engine |
---|---|---|
2022-06-30 | HIVE_Crossplay_Unreal_4.15.7.zip | Unreal |
2022-05-26 | HIVE_Crossplay_Unity_4.15.7.zip | Unity® |
Release Notes
Crossplay v4.15.8.0 ~ Hive SDK v4.15.8.3
V4.15.8.3 (Feb 24, 2023)
Bug Fixes
- Windows
- [Common] Fixed the problem that the character ‘@’ couldn’t be typed when you press
Alt + Gr + 2
in a web view if you were using certain keyboard layouts (such as French and some European keyboards). li>
- [Common] Fixed the problem that the character ‘@’ couldn’t be typed when you press
V4.15.8.2 (Nov 21, 2022)
Bug Fixes
- Windows
- [Common] Fix abnormal memory consumption
- Fixed a bug that the memory consumption of the cef.subprocess.exe increased linearly over time
- [AuthV4] Modified checkMaintenance to return the same ResultAPI as mobile Hive SDK when a network error occurs
- [Common] Fix abnormal memory consumption
V4.15.8.1 (Oct 14, 2022)
Update Features
- Windows
- [Promotion] Improved visibility in the PC environment by increasing the size of the large banner
V4.15.8 (Sep 07, 2022)
Update Features
- Windows
- [Analytics] Client log transfer
- For crossplay, the client logs are now also transferred using Analytics class
- [AuthV4] Custom login
- Offering sign-in with custom log-in
- Additional functions such as Connect and Disconnect are not supported
- [AuthV4] Adding revisit of terms and conditions
- AuthV4.showTerms()
- [Remote Configuration] Deliver metadata at the SDK initialization stage
- Pass the server URL for each app version to the game
- [Common / UI] Improved visibility of UI for high resolution
- [Common] Addding Arabic to the supported languages for Hive
- [Common] Change the game controller not to operate while the webview is exposed
- [Analytics] Client log transfer
Bug Fixes
- Windows
- [AuthV4] Fixed a bug that the checkBlacklist function did not work properly
- [Promotion] Fixed an issue that large banners were not normally exposed to some users
Crossplay v4.15.7
V4.15.7 (May 26, 2022)
- First official release
Upgrade Guide
There are no checkpoints for upgrading from the versions under Crossplay v4.15 to Crossplay v4.15 and its patches.