Skip to content

All engines

Regardless of the development engine (Unity, Unreal, ...) and platform (Android, iOS, ...), the Hive SDK settings must be defined in the hive_config.xml file at the point before building the app. Therefore, to use the Hive SDK, you must create a new hive_config.xml file, enter the content, and include it in your app project. The settings in this file apply at the point of initializing the Hive SDK. It is recommended to pre-define all static items that do not change at runtime in this file. The file should be located at the path below.

  • Unity
    • Android
      • Unity 2021 and above: /Assets/HiveSDK/hive.androidlib/src/main/res/raw/hive_config.xml
      • Unity below 2021: /Assets/Plugins/Android/res/raw/hive_config.xml
    • iOS
      • /Assets/Plugins/iOS/hive_config.xml
    • Windows
      • /Assets/Plugins/Windows/res/hive_config.xml
  • Unreal Engine
    • Android
      • /HIVESDK/Source/HIVESDK/ThirdParty/android/resource/res/raw/hive_config.xml
    • iOS
      • /HIVESDK/Source/HIVESDK/ThirdParty/iOS/resource/hive_config.xml
    • Windows
      • /HIVESDK/Source/HIVESDK/ThirdParty/Windows/config/hive_config.xml
  • Android Native
    • /app/res/raw/hive_config.xml
  • iOS Native
    • Create the hive_config.xml file in the desired location and link it directly to the Xcode project

Hive SDK common settings

Regardless of which Hive SDK feature you use, it is fundamentally an item that must be entered in hive_config.xml. Required items must be entered, while optional items are entered as needed. If optional items are not entered, the Hive SDK will operate with the default values.

Item OS Description Required SDK Default
appId Android, iOS, Windows Game build identifier. X
  • Android: Package Name
  • iOS: Bundle ID
  • Windows: Application ID
zone Android, iOS, Windows The server that the Hive client will connect to.
  • real: Production server
  • sandbox: Test server
X `real`
useLog Android, iOS, Windows Whether to enable logging for the internal operations of the Hive client. When logging is enabled, logs will be output to the development tool screen.
  • true: Enable logging
  • false: Disable logging
X `false`
ageGateU13 Android, iOS, Windows COPPA ageGateU13 application status. To apply COPPA ageGateU13 to the Hive SDK, you must register the COPPA terms in the Hive console and set this value to true before initializing the Hive SDK. If you do not want to apply COPPA ageGateU13, you must register terms other than COPPA in the Hive console and set this value to false before initializing the Hive SDK.
  • true: Apply COPPA ageGateU13 to HiveSDK
  • false: Do not apply COPPA ageGateI13 to HiveSDK
X `false`
hiveOrientation Android, iOS, Windows The UI of the Hive SDK will be displayed according to the device orientation settings.
  • all: Displayed according to landscape and portrait orientation
  • portrait: Displayed in portrait mode
  • landscape: Displayed in landscape mode
  • undefined: Follow game app settings
X 'undefined'
channel Android, iOS, Windows The platform for login and in-app support services used in the game app. If you log in to external social media or use in-app purchases through the Hive SDK, it corresponds to C2S. Used for Hive SDK analytics data collection.
  • C2S: Hive platform
  • KAK: Kakao
  • LIN: Line
  • STE: Steam
  • EPI: Epic Store
  • FAS: FastSprint
O `C2S`
market Android, iOS, Windows This is the market for processing in-app purchases. It is used for Hive SDK analytics collection.
  • GO: Google PlayStore
  • AP: Apple AppStore
  • ON: OneStore
  • AM: Amazon AppStore
  • LE: Com2us Lebi
  • HS: Hive Store
  • GA: Samsung GalaxyStore
  • HU: Huawei AppGallery
O Blank value
agreementDetermineBase Android, iOS Determines the criteria for obtaining agreement to the terms. You can choose either `device` or `account`, with the default being `device`.
  • When selecting device, the terms agreement popup is displayed during the initialization phase of AuthV4.setup() and consent is obtained based on the device only once. Once consent is obtained based on the device, the user will not be asked for consent again when logging in with a different account on the same device. You can clear the terms agreement record with `resetAgreement()`.
  • When selecting account, the terms agreement popup is displayed during login and consent is obtained once per PlayerId. This can only be used when COPPA ageGateU13 is not applied. The terms agreement record cannot be cleared with `resetAgreement()`. Marketing tracking tools will operate from the time of the terms agreement.
X `device`
authV1Agreement Android, iOS Hive SDK v1 or Hive SDK C2S individual module specific settings, selects the UI of the terms to be displayed as authentication v1 or v4. Games using Hive SDK v4 do not set this and are not affected by the default.
  • true: Authentication v1 terms
  • false: Authentication v4 terms
X `true`
unsupportedUAShareType Android Android-specific settings, when using the Promotion User Acquisition (UA) Share feature, sets the sharing apps that will not be displayed as icons. The specified targets will not show icons in the UI.
  • SMS
  • URL
  • KAKAO
  • LINE
  • WHATSAPP
  • FACEBOOK
  • MESSENGER
  • WECHAT
X Blank value
httpConnectTimeout Android, iOS, Windows The timeout duration (in seconds) for HTTP Connect used internally by Hive client.
  • The default value is set to 8 seconds, and changing the value is prohibited unless in special circumstances.
X `8` (unit: seconds)
httpReadTimeout Android, iOS, Windows The HTTP Read timeout duration (seconds) used internally by Hive client.
  • The default value is set to 8 seconds, and changing the value is prohibited unless in special circumstances.
X `8` (unit: seconds)
usePrivateBrowsingForAuth Windows Determines whether to use incognito mode during Google login authentication.
  • true: Uses incognito mode authentication.
  • false: Uses normal mode authentication.
Supported only in the PC SDK.
X true
Note

When applying COPPA ageGateU13, only the device-based consent popup can be displayed.
When applying COPPA ageGateU13, if any user responds that they are 13 years or older during the consent process, the Hive SDK will not apply COPPA ageGateU13 to that user. However, the value set in hive_config.xml (true) itself does not change.

Hive SDK feature settings

Settings for the Hive SDK features you want to use, such as authentication, billing, and marketing attribution. Enter only the items corresponding to the Hive SDK features you will use in hive_config.xml. For more details, please refer to the preparation page of each Hive SDK feature developer guide as shown below.

Unsupported configuration

hive_config.xml The items in the file are as follows, which are no longer supported.

Item Description Remarks
usePush Sets whether notifications are used. Deprecated from v4.16.2
permissions Android
This is an Android-specific setting that controls whether Android permissions managed by HiveSDK are used. The permissions settings allow controlling external storage access permissions through the sdwrite setting.
Deprecated from v4.16.2
useCrashReport iOS
This is an iOS-specific feature that detects the situation just before the app crashes due to an error and saves the analytics logs waiting to be sent to the server as a file. If using an external third-party crash reporter with similar functionality, it should be set to false to disable it for collision prevention. (+v4.16.0)
Deprecated from v4.16.3
exitEventEnabled Android iOS The exitEvent indicates that the game should directly exit the app instead of the Hive SDK. If this value is True, this event will be received, and at this time, the Hive SDK will not directly exit the game app. If this value is False, the Hive SDK can directly exit the game app. (+v4.9.0). Deprecated from v4.16.4
company Android iOS Windows
Sets the name of the game publishing company.
Deprecated from v4.23.0
gameLanguage Android iOS
This is the game language set in the Hive SDK.
Deprecated from v4 25.2.0

hive_config.xml example

Below is an example of the hive_config.xml file when using authentication (Google authentication) and payment (Google Play Store). Please change, add, or delete values according to the Hive SDK features you want to use and the app environment. The iOS platform only supports Apple AppStore payments, so in the Unity iOS environment, set the market to AP.

<properties>

    <!-- Hive SDK Common Settings: START -->
    <!-- Set unique game build identifier -->
    <appId>com.sample.your</appId>

    <!-- Select Hive platform server. sandbox for development, real for production
        (sandbox, real) -->
    <zone>real</zone>

    <!-- Set whether to use SDK internal operation logs
        (true, false) -->
    <useLog>false</useLog>

    <!-- Set whether to apply ageGateU13
        (true, false) -->
    <ageGateU13>false</ageGateU13>

    <!-- Hive Orientation setting -->
    <hiveOrientation>landscape</hiveOrientation>

    <!-- Channel setting (login and in-app support service platform)
        (C2S: Hive platform) -->
    <channel>C2S</channel>

    <!-- Payment market setting (GO: Google Play, LE: Com2us Lebi, AP: Apple App Store) -->
    <market>GO</market>

    <!-- Set criteria for receiving agreement to terms
        (device, account) -->
    <agreementDetermineBase>false</agreementDetermineBase>

    <!-- Set terms exposure design (not set for SDK v4)
        (true, false) -->
    <!-- <authV1Agreement>device</authV1Agreement> -->

    <!-- Set sharing apps not to be displayed for Promotion UA Share (Android Only) -->
    <unsupportedUAShareType>
        <value>SMS</value>
        <value>URL</value>
    </unsupportedUAShareType>

    <!-- Set HTTP Connect Timeout used internally by Hive SDK in seconds
        (Do not change unless in special cases) -->
    <httpConnectTimeout>8</httpConnectTimeout>

    <!-- Set HTTP Read Timeout used internally by Hive SDK in seconds
        (Do not change unless in special cases) -->
    <httpReadTimeout>8</httpReadTimeout>
    <!-- Hive SDK Common Settings: END -->

    <!-- Hive SDK Analytics Settings: START -->
        <!-- Analytics settings, refer to Analytics pre-configuration guide -->
    <!-- Hive SDK Analytics Settings: END -->

    <!-- Hive SDK Feature Settings: START -->
    <providers>             
        <!-- Set authentication product, refer to Authentication pre-configuration guide -->
        <!-- Set billing product, refer to Billing pre-configuration guide -->
        <!-- Set marketing attribution product, refer to Marketing Attribution pre-configuration guide -->
    </providers>
    <!-- Hive SDK Feature Settings: END -->

</properties>