Hive Developers

This page informs you how to develop games based on Unreal Engine; porting Hive SDK, or building as Android or iOS apps.

Prerequisites

This guide is based on the following environment.

Common

Hive SDK v4 UE5 Android+iOS 22.0.0
Unreal Engine 5.2.1

Android

JAVA 8
AndroidStudio 4.1
Android NDK r25
Android SDK min version 26
Android SDK target version 33

iOS

Xcode 14.3+
iOS Version 15+
macOS Ventura 13+

Windows

Windows 10+

Porting

To develop apps based on Unreal Engine, port Hive SDK as plugin type to Unreal Engine development environment. As following description, add Hive SDK to the development environment and execute necessary setup and coding.

Build Unreal Engine
Adding Hive SDK to Unreal Editor as Plugin Type
Editing Unreal Engine File
General Settings
Hive Settings

Build Unreal Engine

Refer to Prerequisites and download Unreal Engine source codes and build it.

Activate the Rosetta emulator for macOS

You need to use the Rosetta emulator on the Apple Silicon CPU-installed macOS development machine. Check Product > Destination > Destination Architectures > Show Rosetta Destinations on Xcode.

Adding Hive SDK to Unreal Editor

Add the Hive SDK as a plugin to Unreal Editor. If you do not have the Hive SDK for Unreal Engine, download the Hive SDK for Unreal Engine from SDK download page.

If you already downloaded the Hive SDK for Unreal Engine, follow the instructions below to add the Hive SDK as a plugin to the Unreal Editor:

Unzip the Hive SDK for Unreal Engine downloaded from Hive developers site, and copy all the items in the Plugin folder from the unpacked files to the Plugins folder under the root folder of your Unreal Engine game project.

Add "HIVESDK" to the parameter of PublicDependencyModuleNames.AddRange() method, which is implemented within the <Project_route>;/Source/<Project_route>;/<Project_name>;build.cs file, as the following example code. Replace with your actual project name.

public class <project_name>; : ModuleRules
{
       public <project_name>;(TargetInfo Target)
       {
             PublicDependencyModuleNames.AddRange(new string[] { "Core", "CoreUObject", "Engine", "InputCore" , "HIVESDK"});
                   ...
             }
             ...
      }

public class <project_name>; : ModuleRules

{

public <project_name>;(TargetInfo Target)

{

PublicDependencyModuleNames.AddRange(new string[] { "Core", "CoreUObject", "Engine", "InputCore" , "HIVESDK"});

...

}

...

}

Editing Unreal Engine File

Delete or edit the Unreal Engine file as follows.

Android

When the screen orientation is set to both directions (both horizontal and vertical) in the game build, the code below needs to be modified for the screen auto-rotation.

Go to the /Engine/Build/Android/Java/src/com/epicgames/unreal/GameActivity.java.template.

Add the HiveActivity.onConfigurationChanged() API.


@Override
public void onConfigurationChanged(Configuration newConfig)
{
    HiveActivity.onConfigurationChanged(this, newConfig); // Add
    super.onConfigurationChanged(newConfig);



    // forward the orientation
    boolean bPortrait = newConfig.orientation == Configuration.ORIENTATION_PORTRAIT;
    nativeOnConfigurationChanged(bPortrait);

}

@Override

public void onConfigurationChanged(Configuration newConfig)

{

HiveActivity.onConfigurationChanged(this, newConfig); // Add

super.onConfigurationChanged(newConfig);

// forward the orientation

boolean bPortrait = newConfig.orientation == Configuration.ORIENTATION_PORTRAIT;

nativeOnConfigurationChanged(bPortrait);

}

A compatibility issue exists between the Google Billing Library version 5 used by the Hive SDK and the Google Billing features built into Unreal Engine, causing the build to fail. Modify the code below to fix this issue.

Go to the /Engine/Plugins/Online/Android/OnlineSubsystemGooglePlay/Source/OnlineSubsystemGooglePlay.Build.cs

Comment out the following code


                 //string PluginPath = Utils.MakePathRelativeTo(ModuleDirectory, Target.RelativeEnginePath);
                 //AdditionalPropertiesForReceipt.Add("AndroidPlugin", Path.Combine(PluginPath, "OnlineSubsystemGooglePlay_UPL.xml"));

//string PluginPath = Utils.MakePathRelativeTo(ModuleDirectory, Target.RelativeEnginePath);

//AdditionalPropertiesForReceipt.Add("AndroidPlugin", Path.Combine(PluginPath, "OnlineSubsystemGooglePlay_UPL.xml"));

To use the Singular external library included in the Hive SDK, the files below needs to be modified.

Go to the /Engine/Build/Android/Java/src/com/android/vending/licensing
Delete the following files.
- ILicensingService.aidl
- ILicenseResultListener. aidl

iOS

To use the notification feature provided by the Hive SDK, the modification of Unreal Engine is required.

In the files below, add the lines marked with 'Add' comment.

Engine/Source/Runtime/ApplicationCore/Public/IOS/IOSAppDelegate.h


DECLARE_MULTICAST_DELEGATE_FourParams(FOnOpenURL, UIApplication*, NSURL*, NSString*, id);
static FOnOpenURL OnOpenURL;
        
// Add - Start
DECLARE_MULTICAST_DELEGATE_ThreeParams(FOnOpenURLwithOptions, UIApplication*, NSURL*, NSDictionary* );
static FOnOpenURLwithOptions OnOpenURLwithOptions;
// Add - End

DECLARE_MULTICAST_DELEGATE_FourParams(FOnOpenURL, UIApplication*, NSURL*, NSString*, id);

static FOnOpenURL OnOpenURL;

// Add - Start

DECLARE_MULTICAST_DELEGATE_ThreeParams(FOnOpenURLwithOptions, UIApplication*, NSURL*, NSDictionary* );

static FOnOpenURLwithOptions OnOpenURLwithOptions;

// Add - End


// parameters passed from openURL
@property (nonatomic, retain) NSMutableArray* savedOpenUrlParameters;
@property (nonatomic, retain) NSMutableArray* savedOpenUrlWithOptionsParameters;    // Add

// parameters passed from openURL

@property (nonatomic, retain) NSMutableArray* savedOpenUrlParameters;

@property (nonatomic, retain) NSMutableArray* savedOpenUrlWithOptionsParameters; // Add

Engine/Source/Runtime/ApplicationCore/Private/IOS/IOSAppDelegate.cpp


extern bool GShowSplashScreen;

FIOSCoreDelegates::FOnOpenURL FIOSCoreDelegates::OnOpenURL;
FIOSCoreDelegates::FOnOpenURLwithOptions FIOSCoreDelegates::OnOpenURLwithOptions;  //   Add
FIOSCoreDelegates::FOnWillResignActive FIOSCoreDelegates::OnWillResignActive;
FIOSCoreDelegates::FOnDidBecomeActive FIOSCoreDelegates::OnDidBecomeActive;
TArray<FIOSCoreDelegates::FFilterDelegateAndHandle> FIOSCoreDelegates::PushNotificationFilters;

extern bool GShowSplashScreen;

FIOSCoreDelegates::FOnOpenURL FIOSCoreDelegates::OnOpenURL;

FIOSCoreDelegates::FOnOpenURLwithOptions FIOSCoreDelegates::OnOpenURLwithOptions; // Add

FIOSCoreDelegates::FOnWillResignActive FIOSCoreDelegates::OnWillResignActive;

FIOSCoreDelegates::FOnDidBecomeActive FIOSCoreDelegates::OnDidBecomeActive;

TArray<FIOSCoreDelegates::FFilterDelegateAndHandle> FIOSCoreDelegates::PushNotificationFilters;


@synthesize AccessibilityCacheTimer;
#endif
@synthesize savedOpenUrlParameters;
@synthesize savedOpenUrlWithOptionsParameters;    // Add
@synthesize BackgroundSessionEventCompleteDelegate;

@synthesize AccessibilityCacheTimer;

#endif

@synthesize savedOpenUrlParameters;

@synthesize savedOpenUrlWithOptionsParameters; // Add

@synthesize BackgroundSessionEventCompleteDelegate;


          GShowSplashScreen = false;
    }, TStatId(), NULL, ENamedThreads::ActualRenderingThread);
}
 
// Add - Start
    for (NSDictionary* openUrlParameter in self.savedOpenUrlWithOptionsParameters)
    {
        UIApplication* application = [openUrlParameter valueForKey : @"application"];
        NSURL* url = [openUrlParameter valueForKey : @"url"];
        NSDictionary<NSString*, id> * options = [openUrlParameter valueForKey : @"options"];
        FIOSCoreDelegates::OnOpenURLwithOptions.Broadcast(application, url, options);
    }
    self.savedOpenUrlWithOptionsParameters = nil; // clear after saved openurl delegate running
// Add - End
 
for (NSDictionary* openUrlParameter in self.savedOpenUrlParameters)
{
    UIApplication* application = [openUrlParameter valueForKey : @"application"];

GShowSplashScreen = false;

}, TStatId(), NULL, ENamedThreads::ActualRenderingThread);

}

// Add - Start

for (NSDictionary* openUrlParameter in self.savedOpenUrlWithOptionsParameters)

{

UIApplication* application = [openUrlParameter valueForKey : @"application"];

NSURL* url = [openUrlParameter valueForKey : @"url"];

NSDictionary<NSString*, id> * options = [openUrlParameter valueForKey : @"options"];

FIOSCoreDelegates::OnOpenURLwithOptions.Broadcast(application, url, options);

}

self.savedOpenUrlWithOptionsParameters = nil; // clear after saved openurl delegate running

// Add - End

for (NSDictionary* openUrlParameter in self.savedOpenUrlParameters)

{

UIApplication* application = [openUrlParameter valueForKey : @"application"];


- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions
{
    // save launch options
    self.launchOptions = launchOptions;
 
#if PLATFORM_TVOS
    self.bDeviceInPortraitMode = false;
#else
    // use the status bar orientation to properly determine landscape vs portrait
    self.bDeviceInPortraitMode = UIInterfaceOrientationIsPortrait([[UIApplication sharedApplication] statusBarOrientation]);
    printf("========= This app is in %s mode\n", self.bDeviceInPortraitMode ? "PORTRAIT" : "LANDSCAPE");
#endif
 
    // check OS version to make sure we have the API
    OSVersion = [[[UIDevice currentDevice] systemVersion] floatValue];
    if (!FPlatformMisc::IsDebuggerPresent() || GAlwaysReportCrash)
    {
//        InstallSignalHandlers();
    }
 
    self.savedOpenUrlParameters = [[NSMutableArray alloc] init];
    self.savedOpenUrlWithOptionsParameters = [[NSMutableArray alloc] init];     //  Add
    self.PeakMemoryTimer = [NSTimer scheduledTimerWithTimeInterval:0.1f target:self selector:@selector(RecordPeakMemory) userInfo:nil repeats:YES];
 
#if !BUILD_EMBEDDED_APP

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions

{

// save launch options

self.launchOptions = launchOptions;

#if PLATFORM_TVOS

self.bDeviceInPortraitMode = false;

#else

// use the status bar orientation to properly determine landscape vs portrait

self.bDeviceInPortraitMode = UIInterfaceOrientationIsPortrait([[UIApplication sharedApplication] statusBarOrientation]);

printf("========= This app is in %s mode\n", self.bDeviceInPortraitMode ? "PORTRAIT" : "LANDSCAPE");

#endif

// check OS version to make sure we have the API

OSVersion = [[[UIDevice currentDevice] systemVersion] floatValue];

if (!FPlatformMisc::IsDebuggerPresent() || GAlwaysReportCrash)

{

// InstallSignalHandlers();

}

self.savedOpenUrlParameters = [[NSMutableArray alloc] init];

self.savedOpenUrlWithOptionsParameters = [[NSMutableArray alloc] init]; // Add

self.PeakMemoryTimer = [NSTimer scheduledTimerWithTimeInterval:0.1f target:self selector:@selector(RecordPeakMemory) userInfo:nil repeats:YES];

#if !BUILD_EMBEDDED_APP


    return YES;
}
 
// Add - Start
  //### use option
  
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<NSString*, id> *)options
  {
  #if !NO_LOGGING
  NSLog(@"%s", "IOSAppDelegate openURL options\n");
  #endif
  
  NSString* EncdodedURLString = [url absoluteString];
  NSString* URLString = [EncdodedURLString stringByRemovingPercentEncoding];
  FString CommandLineParameters(URLString);
  
  // Strip the "URL" part of the URL before treating this like args. It comes in looking like so:
  // "MyGame://arg1 arg2 arg3 ..."
  // So, we're going to make it look like:
  // "arg1 arg2 arg3 ..."
  int32 URLTerminator = CommandLineParameters.Find( TEXT("://"), ESearchCase::CaseSensitive);
  if ( URLTerminator > -1 )
  {
    CommandLineParameters.RightChopInline(URLTerminator + 3, false);
  }
  
  FIOSCommandLineHelper::InitCommandArgs(CommandLineParameters);
  self.bCommandLineReady = true;
  [self.CommandLineParseTimer invalidate];
  self.CommandLineParseTimer = nil;
  
  //    Save openurl infomation before engine initialize.
  //    When engine is done ready, running like previous. ( if OnOpenUrl is bound on game source. )
  if (bEngineInit)
  {
    FIOSCoreDelegates::OnOpenURLwithOptions.Broadcast(app, url, options);
  }
  else
  {
  #if !NO_LOGGING
    NSLog(@"%s", "Before Engine Init receive IOSAppDelegate openURL\n");
  #endif
        NSDictionary* openUrlParameter = [NSDictionary dictionaryWithObjectsAndKeys :
                                          app , @"application",
                                          url, @"url",
                                          options, @"options",
                                          nil];
  
    [savedOpenUrlWithOptionsParameters addObject : openUrlParameter];
  }
  
  return YES;
  }
  // Add - End
 
FCriticalSection RenderSuspend;
- (void)applicationWillResignActive:(UIApplication *)application
{

return YES;

}

// Add - Start

//### use option

- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<NSString*, id> *)options

{

#if !NO_LOGGING

NSLog(@"%s", "IOSAppDelegate openURL options\n");

#endif

NSString* EncdodedURLString = [url absoluteString];

NSString* URLString = [EncdodedURLString stringByRemovingPercentEncoding];

FString CommandLineParameters(URLString);

// Strip the "URL" part of the URL before treating this like args. It comes in looking like so:

// "MyGame://arg1 arg2 arg3 ..."

// So, we're going to make it look like:

// "arg1 arg2 arg3 ..."

int32 URLTerminator = CommandLineParameters.Find( TEXT("://"), ESearchCase::CaseSensitive);

if ( URLTerminator > -1 )

{

CommandLineParameters.RightChopInline(URLTerminator + 3, false);

}

FIOSCommandLineHelper::InitCommandArgs(CommandLineParameters);

self.bCommandLineReady = true;

[self.CommandLineParseTimer invalidate];

self.CommandLineParseTimer = nil;

// Save openurl infomation before engine initialize.

// When engine is done ready, running like previous. ( if OnOpenUrl is bound on game source. )

if (bEngineInit)

{

FIOSCoreDelegates::OnOpenURLwithOptions.Broadcast(app, url, options);

}

else

{

#if !NO_LOGGING

NSLog(@"%s", "Before Engine Init receive IOSAppDelegate openURL\n");

#endif

NSDictionary* openUrlParameter = [NSDictionary dictionaryWithObjectsAndKeys :

app , @"application",

url, @"url",

options, @"options",

nil];

[savedOpenUrlWithOptionsParameters addObject : openUrlParameter];

}

return YES;

}

// Add - End

FCriticalSection RenderSuspend;

- (void)applicationWillResignActive:(UIApplication *)application

{

Hive

SDK

application(_:supportedInterfaceOrientationsFor:)

IOSAppDelegate.cpp

Unreal

Engine

iOS

UIInterfaceOrientationMask

landscape

landscape

portrait

portrait

landscape

portrait

Add the following code to /Engine/Source/Runtime/ApplicationCore/Private/IOS/IOSAppDelegate.cpp.

- (UIInterfaceOrientationMask)application:(UIApplication *)application supportedInterfaceOrientationsForWindow:(UIWindow *)window
{
   // TODO: For landscape only
   return UIInterfaceOrientationMaskLandscape;
   // TODO: For portrait only
   return UIInterfaceOrientationMaskPortrait;
   // TODO: For both landscape and portrait
   return UIInterfaceOrientationMaskAll;
}

- (UIInterfaceOrientationMask)application:(UIApplication *)application supportedInterfaceOrientationsForWindow:(UIWindow *)window

{

// TODO: For landscape only

return UIInterfaceOrientationMaskLandscape;

// TODO: For portrait only

return UIInterfaceOrientationMaskPortrait;

// TODO: For both landscape and portrait

return UIInterfaceOrientationMaskAll;

}

Universal Link Settings

From Hive SDK v4.15.8, Universal Link, not a URL scheme, enables you to install and run an app and reward invitees on the invite page.

For more information about the additional console settings for creating invitee links based on Universal Link, see the Operation > Promotion guide from Hive Developers.

In the files below, add the line commented with 'Add'.

Engine/Source/Programs/UnrealBuildTool/Platform/IOS/IOSExport.cs


Text.AppendLine("<dict>"))
Text.AppendLine( "\t<key>get-task-allow</key>"))
Text.AppendLine(string.Format( "\t<{0}/>", bForDistribution ? "false": "true"));

// Add
Text.AppendLine( "\t<key>com.apple.developer.associated-domains</key>"))
Text. AppendLine( "\t<array>"))
Text.AppendLine( "\t\t<string>Add the inviter link which is based on the universal link (ex.applinks:hiveota.withhive.com)</string>"))

/*
Below is an example used in the Hive SDK sample app.
Text.AppendLine("\t\t<string>applinks:hiveota.withhive.com</string>");
Text.AppendLine("\t\t<string>applinks:dev-promotion.qpyou.cn</string>");
Text.AppendLine("\t\t<string>applinks:promotion.qpyou.cn</string>");
Text.AppendLine("\t\t<string>applinks:sandbox-promotion.qpyou.cn</string>");
Text.AppendLine("\t\t<string>applinks:test-promotion.qpyou.cn</string>");
*/

Text.AppendLine( "\t</array>"))
// End
if (bCloudKitSupported) {
     if (iCloudContainerIdentifiersXML != "")

Text.AppendLine("<dict>"))

Text.AppendLine( "\t<key>get-task-allow</key>"))

Text.AppendLine(string.Format( "\t<{0}/>", bForDistribution ? "false": "true"));

// Add

Text.AppendLine( "\t<key>com.apple.developer.associated-domains</key>"))

Text. AppendLine( "\t<array>"))

Text.AppendLine( "\t\t<string>Add the inviter link which is based on the universal link (ex.applinks:hiveota.withhive.com)</string>"))

Below is an example used in the Hive SDK sample app.

Text.AppendLine("\t\t<string>applinks:hiveota.withhive.com</string>");

Text.AppendLine("\t\t<string>applinks:dev-promotion.qpyou.cn</string>");

Text.AppendLine("\t\t<string>applinks:promotion.qpyou.cn</string>");

Text.AppendLine("\t\t<string>applinks:sandbox-promotion.qpyou.cn</string>");

Text.AppendLine("\t\t<string>applinks:test-promotion.qpyou.cn</string>");

Text.AppendLine( "\t</array>"))

// End

if (bCloudKitSupported) {

if (iCloudContainerIdentifiersXML != "")

General Settings

Android

Click Edit >; Project setting menu of Unreal Editor. Project setting screen will show up.
Select Android SDK from the Platforms list. Then you can set the Android version on the Android SDK Setting screen as described below.
- Input android-30(Hive SDK v4.15.1+) and higher in the SDK API Level field.
- Input android-21 in the NDK API Level field.
Select Android from the Platforms list. Then, you can set the fields of APKPackaging section as described below.
- Input AppID of the game in the blank of Android Package Name field.
- Input the app version Store Version: Input the app version shown in Google Play Store. View more information about app version
- Set the Minimum SDK Version as 21 and higher. Even if you set it as under 21, it will be automatically changed as 21 by Unreal Engine operating.
- Set the Target SDK Version as 30(Hive SDK v4.15.1+) and higher.

Hive SDK supports both Google sign-in (iOS, Android) and Google Play Games sign-in (Android). 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/unreal/GameActivity.java.template and ./Engine/Build/Android/Java/src/com/epicgames/unreal/psoservices/PSOProgramServiceAccessor.java.
Remove the following line.

import com.google.android.gms.games.Games;

1

import com.google.android.gms.games.Games;

To use Google or Google Play Games sign-in, select “GOOGLE” or “GOOGLE_PLAY_GAMES” ProviderType and call AuthV4.SignIn().

Add Firebase Analytics

After registering an app in the Firebase console (https://firebase.google.com/), put the issued google–services.json file in the following path.

/Plugins/HIVESDK/Source/HIVESDK
The Hive SDK Plugin includes Firebase Analytics by default. Remove the following line from the following file to remove the default Firebase Analytics.
- /Plugins/HIVESDK/Source/HIVESDK/HIVESDK_APL.xml
- apply plugin: 'com.google.gms.google-services' // Remove the following line to remove Firebase Analytics.

Support One Store

To support One Store, add the following codes to the /Plugins/HIVESDK/Source/HIVESDK/HIVESDK_APL.xml file.

<!-- Add One Store repository. -->
<baseBuildGradleAdditions>
    <insert>
         allprojects {
               repositories {
                   maven { url 'https://repo.onestore.co.kr/repository/onestore-sdk-public' }               }         }
     </insert>
</baseBuildGradleAdditions>
 
<!-- Add One Store dependency. -->
<buildGradleAdditions>
    <insert>
          dependencies {
               implementation(platform("com.com2us.android.hive:hive-sdk-bom:{HIVE_SDK_VERSION}"))
               implementation "com.onestorecorp.sdk:sdk-iap"
               implementation "com.onestorecorp.sdk:sdk-configuration-kr"          }
     </insert>
</buildGradleAdditions>

allprojects {

repositories {

maven { url 'https://repo.onestore.co.kr/repository/onestore-sdk-public' } } }

</insert>

</baseBuildGradleAdditions>

dependencies {

implementation(platform("com.com2us.android.hive:hive-sdk-bom:{HIVE_SDK_VERSION}"))

implementation "com.onestorecorp.sdk:sdk-iap"

implementation "com.onestorecorp.sdk:sdk-configuration-kr" }

</insert>

</buildGradleAdditions>

iOS

Click Edit > Project setting on the Unreal Editor menu. Project setting window will show up.

Select the iOS from the Platforms list. Then, you can set the fields as described below on the setting screen.

Bundle Information group: Input AppID of the game in the blank of Bundle Identifier field.

OS Info group: Unreal Engine 4.25 supports OS 11.0 and later. Set the value of Minimum OSVersion field as 11.0.

Build group: Input -ObjC in the Additional Non-Shipping Linker Flags field and Additional Shipping Linker Flags field.

Extra PList Data group: Input the following codes in the Additional PList Data field.

Access permission request settings

<key>NSCameraUsageDescription</key>
<string>Approval required to take pictures.</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>Approval required to upload image files.</string>
<key>NSUserTrackingUsageDescription</key>
<string>We need your permission to use the Advertising Identifiers (IDFA) for promotion targeting and tracking analysis.</string>

<key>NSCameraUsageDescription</key>

<string>Approval required to take pictures.</string>

<key>NSPhotoLibraryUsageDescription</key>

<string>Approval required to upload image files.</string>

<key>NSUserTrackingUsageDescription</key>

<string>We need your permission to use the Advertising Identifiers (IDFA) for promotion targeting and tracking analysis.</string>

When using Facebook, QQ, VK, WeChat or Line, add the following codes to set Whitelist on the server:

<key>LSApplicationQueriesSchemes</key>
<array>
    <string>weixin</string>
    <string>vk-share</string>
    <string>vkauthorize</string>
    <string>vk</string>
    <string>weixinULAPI</string>
    <string>fbapi</string>
    <string>fb-messenger-api</string>
    <string>fbauth2</string>
    <string>fbshareextension</string>
    <string>mqqOpensdkSSoLogin</string>
    <string>mqqopensdkapiV2</string>
    <string>lineauth2</string>
    <string>mqqopensdkapiV3</string>
    <string>wtloginmqq2</string>
    <string>mqq</string>
    <string>mqqapi</string>
</array>

<key>LSApplicationQueriesSchemes</key>

<array>

<string>weixin</string>

<string>vk-share</string>

<string>vkauthorize</string>

<string>weixinULAPI</string>

<string>fbapi</string>

<string>fb-messenger-api</string>

<string>fbauth2</string>

<string>fbshareextension</string>

<string>mqqOpensdkSSoLogin</string>

<string>mqqopensdkapiV2</string>

<string>lineauth2</string>

<string>mqqopensdkapiV3</string>

<string>wtloginmqq2</string>

<string>mqqapi</string>

</array>

When using Facebook, utilize the following code to add a Facebook AppID and a ClientToken. Make sure to enter the Facebook AppID and ClientToken of your games.

<key>FacebookAppID</key><string>926000000000000</string>
<key>FacebookClientToken</key><string>d123783h7sdfyh8031h23unf81h3</string>

1 2	<key>FacebookAppID</key><string>926000000000000</string> <key>FacebookClientToken</key><string>d123783h7sdfyh8031h23unf81h3</string>

Set the URL Scheme.

<key>CFBundleURLTypes</key>
<array>

<!--For using Facebook. Input the Facebook App ID of your apps-->
<dict><key>CFBundleTypeRole</key><string>Editor</string><key>CFBundleURLSchemes</key><array><string>fb926000000000000</string></array></dict>

<!--For using Hive Deeplink. Input the Hive Deeplink key of your apps-->
<dict><key>CFBundleTypeRole</key><string>Editor</string><key>CFBundleURLSchemes</key><array><string>com.com2us.misample.normal.freefull.apple.global.ios.universal</string></array></dict>

<!--For using Google Sign-in. Input the Google Sign-in key of your apps-->
<dict><key>CFBundleTypeRole</key><string>Editor</string><key>CFBundleURLSchemes</key><array><string>com.googleusercontent.apps.270000000000-0m7r8tb2co1q00000000000000000000</string></array></dict>

<!--For using QQ Sign-in. Input the QQ key of your apps-->
<dict><key>CFBundleTypeRole</key><string>Editor</string><key>CFBundleURLName</key><string>tencent</string>
<key>CFBundleURLSchemes</key><array><string>tencent1106227203</string></array></dict>

<!--For using WeChat Sign-in. Input the WeChat key of your apps-->
<dict><key>CFBundleTypeRole</key><string>Editor</string><key>CFBundleURLName</key><string>weixin</string><key>CFBundleURLSchemes</key><array><string>wx78176cf0c698c0f9</string></array></dict>

<!--For using VK Sign-in. Input the VK key of your apps-->
<dict><key>CFBundleTypeRole</key><string>Editor</string><key>CFBundleURLName</key><string>vk6270065</string><key>CFBundleURLSchemes</key><array><string>vk6270065</string></array></dict>

<!--For using Line Sign-in. Input the Line key of your apps-->
<dict><key>CFBundleTypeRole</key><string>Editor</string>
<key>CFBundleURLSchemes</key><array><string>line3rdp.$(PRODUCT_BUNDLE_IDENTIFIER)</string></array></dict>

</array>

<key>CFBundleURLTypes</key>

<array>

<dict><key>CFBundleTypeRole</key><string>Editor</string><key>CFBundleURLSchemes</key><array><string>fb926000000000000</string></array></dict>

<dict><key>CFBundleTypeRole</key><string>Editor</string><key>CFBundleURLSchemes</key><array><string>com.com2us.misample.normal.freefull.apple.global.ios.universal</string></array></dict>

<dict><key>CFBundleTypeRole</key><string>Editor</string><key>CFBundleURLSchemes</key><array><string>com.googleusercontent.apps.270000000000-0m7r8tb2co1q00000000000000000000</string></array></dict>

<dict><key>CFBundleTypeRole</key><string>Editor</string><key>CFBundleURLName</key><string>tencent</string>

<key>CFBundleURLSchemes</key><array><string>tencent1106227203</string></array></dict>

<dict><key>CFBundleTypeRole</key><string>Editor</string><key>CFBundleURLName</key><string>weixin</string><key>CFBundleURLSchemes</key><array><string>wx78176cf0c698c0f9</string></array></dict>

<dict><key>CFBundleTypeRole</key><string>Editor</string><key>CFBundleURLName</key><string>vk6270065</string><key>CFBundleURLSchemes</key><array><string>vk6270065</string></array></dict>

<dict><key>CFBundleTypeRole</key><string>Editor</string>

<key>CFBundleURLSchemes</key><array><string>line3rdp.$(PRODUCT_BUNDLE_IDENTIFIER)</string></array></dict>

</array>

Following is an example entering all values above into the Additional PList Data field:

<key>NSCameraUsageDescription</key>
<string>Approval required to take pictures.</string>
<key>NSContactsUsageDescription</key>
<string>You must agree to add friends from your Contacts.</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>Approval required to upload image files.</string>
<key>NSUserTrackingUsageDescription</key>
<string>We need your permission to use the Advertising Identifiers (IDFA) for promotion targeting and tracking analysis.</string>
<key>FacebookAppID</key>
<string>1809615065921877</string>
<key>FacebookClientToken</key>
<string>c41e47ba5512ea3fb5bfb29d5cfeb244</string>
<key>CFBundleURLTypes</key>
<array>
<dict>
<key>CFBundleTypeRole</key>
<string>Editor</string>
<key>CFBundleURLSchemes</key>
<array>
<string>line3rdp.$(PRODUCT_BUNDLE_IDENTIFIER)</string>
</array>
</dict>
<dict>
<key>CFBundleTypeRole</key>
<string>Editor</string>
<key>CFBundleURLSchemes</key>
<array>
<string>fb926000000000000</string>
</array>
</dict>
<dict>
<key>CFBundleTypeRole</key>
<string>Editor</string>
<key>CFBundleURLSchemes</key>
<array>
<string>com.com2us.hivesdk.normal.freefull.apple.global.ios.universal</string>
</array>
</dict>
<dict>
<key>CFBundleTypeRole</key>
<string>Editor</string>
<key>CFBundleURLSchemes</key>
<array>
<string>com.googleusercontent.apps.331526026701-s41n272jsv6c0f72kt5o7of0jns350gl</string>
</array>
</dict>
<dict>
<key>CFBundleTypeRole</key>
<string>Editor</string>
<key>CFBundleURLName</key>
<string>tencent</string>
<key>CFBundleURLSchemes</key>
<array>
<string>tencent1106227203</string>
</array>
</dict>
<dict>
<key>CFBundleTypeRole</key>
<string>Editor</string>
<key>CFBundleURLName</key>
<string>weixin</string>
<key>CFBundleURLSchemes</key>
<array>
<string>wx78176cf0c698c0f9</string>
</array>
</dict>
<dict>
<key>CFBundleTypeRole</key>
<string>Editor</string>
<key>CFBundleURLName</key>
<string>vk6270065</string>
<key>CFBundleURLSchemes</key>
<array>
<string>vk6270065</string>
</array>
</dict>
</array>
<key>LSApplicationQueriesSchemes</key>
<array>
<string>weixin</string>
<string>vk-share</string>
<string>vkauthorize</string>
<string>vk</string>
<string>weixinULAPI</string>
<string>fbapi</string>
<string>fb-messenger-api</string>
<string>fbauth2</string>
<string>fbshareextension</string>
<string>mqqOpensdkSSoLogin</string>
<string>mqqopensdkapiV2</string>
<string>lineauth2</string>
<string>mqqopensdkapiV3</string>
<string>wtloginmqq2</string>
<string>mqq</string>
<string>mqqapi</string>
</array>

<key>NSCameraUsageDescription</key>

<string>Approval required to take pictures.</string>

<key>NSContactsUsageDescription</key>

<string>You must agree to add friends from your Contacts.</string>

<key>NSPhotoLibraryUsageDescription</key>

<string>Approval required to upload image files.</string>

<key>NSUserTrackingUsageDescription</key>

<string>We need your permission to use the Advertising Identifiers (IDFA) for promotion targeting and tracking analysis.</string>

<key>FacebookAppID</key>

<key>FacebookClientToken</key>

<key>CFBundleURLTypes</key>

<array>

<dict>

<key>CFBundleTypeRole</key>

<string>Editor</string>

<key>CFBundleURLSchemes</key>

<array>

<string>line3rdp.$(PRODUCT_BUNDLE_IDENTIFIER)</string>

</array>

</dict>

<dict>

<key>CFBundleTypeRole</key>

<string>Editor</string>

<key>CFBundleURLSchemes</key>

<array>

</array>

</dict>

<dict>

<key>CFBundleTypeRole</key>

<string>Editor</string>

<key>CFBundleURLSchemes</key>

<array>

<string>com.com2us.hivesdk.normal.freefull.apple.global.ios.universal</string>

</array>

</dict>

<dict>

<key>CFBundleTypeRole</key>

<string>Editor</string>

<key>CFBundleURLSchemes</key>

<array>

<string>com.googleusercontent.apps.331526026701-s41n272jsv6c0f72kt5o7of0jns350gl</string>

</array>

</dict>

<dict>

<key>CFBundleTypeRole</key>

<string>Editor</string>

<key>CFBundleURLName</key>

<string>tencent</string>

<key>CFBundleURLSchemes</key>

<array>

<string>tencent1106227203</string>

</array>

</dict>

<dict>

<key>CFBundleTypeRole</key>

<string>Editor</string>

<key>CFBundleURLName</key>

<string>weixin</string>

<key>CFBundleURLSchemes</key>

<array>

</array>

</dict>

<dict>

<key>CFBundleTypeRole</key>

<string>Editor</string>

<key>CFBundleURLName</key>

<key>CFBundleURLSchemes</key>

<array>

</array>

</dict>

</array>

<key>LSApplicationQueriesSchemes</key>

<array>

<string>weixin</string>

<string>vk-share</string>

<string>vkauthorize</string>

<string>weixinULAPI</string>

<string>fbapi</string>

<string>fb-messenger-api</string>

<string>fbauth2</string>

<string>fbshareextension</string>

<string>mqqOpensdkSSoLogin</string>

<string>mqqopensdkapiV2</string>

<string>lineauth2</string>

<string>mqqopensdkapiV3</string>

<string>wtloginmqq2</string>

<string>mqqapi</string>

</array>

Add the following codes to the DefaultEngine.ini file in the Project > Config directory to use Apple Sign-in.

bEnableSignInWithAppleSupport=True

1	bEnableSignInWithAppleSupport=True

Add Firebase Analytics

After registering the app in the Firebase console (https://firebase.google.com/), put the issued GoogleService-Info.plist file under the following path.

/Plugins/HIVESDK/Source/HIVESDK/ThirdParty/iOS/resource
Hive SDK Plugin includes the Firebase Analytics by default. Remove the following files to remove the default Firebase Analytics.
- /Plugins/HIVESDK/Source/HIVESDK/ThirdParty/iOS/framework/Hive/ProviderFirebase.embeddedframework.zip
- /Plugins/HIVESDK/Source/HIVESDK/ThirdParty/iOS/framework/external/FirebaseAnalytics.embeddedframework.zip
- /Plugins/HIVESDK/Source/HIVESDK/ThirdParty/iOS/framework/external/FirebaseCore.embeddedframework.zip
- /Plugins/HIVESDK/Source/HIVESDK/ThirdParty/iOS/framework/external/FirebaseCoreDiagnostics.embeddedframework.zip
- /Plugins/HIVESDK/Source/HIVESDK/ThirdParty/iOS/framework/external/FirebaseCoreInternal.embeddedframework.zip
- /Plugins/HIVESDK/Source/HIVESDK/ThirdParty/iOS/framework/external/FirebaseInstallations.embeddedframework.zip

Apply language configuration file

In order to apply multiple languages, you need to add a language configuration file.
- Please copy all the files in the localize folder of configuration file and paste them into the following path.
  
  /Plugins/HIVESDK/Source/HIVESDK/ThirdParty/iOS/resource

Apply HIVEAppDelegate

For iOS builds, the AppDelegate method needs to be modified. In Unreal Engine environment, please use the Swizzling to access AppDelegate.
Add the code below at the initialization stage when starting the game.


/////////////////////////////////////////////// //////////////
// Add IOSAppDelegate.h header
#if PLATFORM_IOS
#include "Runtime/ApplicationCore/Public/iOS/IOSAppDelegate.h"
#endif
/////////////////////////////////////////////// //////////////


/////////////////////////////////////////////// //////////////
// the added code body to modify AppDelegate
#if PLATFORM_IOS
UIApplication * dummyApplication = [UIApplication sharedApplication];

Class clzHIVEAppDelegate = NSClassFromString(@"HIVEAppDelegate");
SEL selApplicationDidFinishLaunchingWithOptions = NSSelectorFromString(@"application:didFinishLaunchingWithOptions:");
if( clzHIVEAppDelegate != nil && [clzHIVEAppDelegate respondsToSelector:selApplicationDidFinishLaunchingWithOptions] ) {
NSMethodSignature *method = [clzHIVEAppDelegate methodSignatureForSelector:selApplicationDidFinishLaunchingWithOptions];
if (method != nil) {

NSInvocation *invocation = [NSInvocation invocationWithMethodSignature:method];
[invocation setSelector:selApplicationDidFinishLaunchingWithOptions];
[invocation setTarget:clzHIVEAppDelegate];
[invocation setArgument:(void*)&dummyApplication atIndex:2];
NSDictionary *localLaunchOptions = [IOSAppDelegate GetDelegate].launchOptions;
if( localLaunchOptions != nil ) {
[invocation setArgument:(void*)&localLaunchOptions atIndex:3];
}
[invocation invoke];
}
}
#endif
/////////////////////////////////////////////// //////////////

/////////////////////////////////////////////// //////////////

// Add IOSAppDelegate.h header

#if PLATFORM_IOS

#include "Runtime/ApplicationCore/Public/iOS/IOSAppDelegate.h"

#endif

/////////////////////////////////////////////// //////////////

// the added code body to modify AppDelegate

#if PLATFORM_IOS

UIApplication * dummyApplication = [UIApplication sharedApplication];

Class clzHIVEAppDelegate = NSClassFromString(@"HIVEAppDelegate");

SEL selApplicationDidFinishLaunchingWithOptions = NSSelectorFromString(@"application:didFinishLaunchingWithOptions:");

if( clzHIVEAppDelegate != nil && [clzHIVEAppDelegate respondsToSelector:selApplicationDidFinishLaunchingWithOptions] ) {

NSMethodSignature *method = [clzHIVEAppDelegate methodSignatureForSelector:selApplicationDidFinishLaunchingWithOptions];

if (method != nil) {

NSInvocation *invocation = [NSInvocation invocationWithMethodSignature:method];

[invocation setSelector:selApplicationDidFinishLaunchingWithOptions];

[invocation setTarget:clzHIVEAppDelegate];

[invocation setArgument:(void*)&dummyApplication atIndex:2];

NSDictionary *localLaunchOptions = [IOSAppDelegate GetDelegate].launchOptions;

if( localLaunchOptions != nil ) {

[invocation setArgument:(void*)&localLaunchOptions atIndex:3];

}

[invocation invoke];

}

#endif

/////////////////////////////////////////////// //////////////

Configure iOS FMallocAnsi

FMallocAnsi settings are required for proper compatibility between the Unreal Engine iOS environment and the C++ standard template library.

Add the following codes to the {YourProject}.Target.cs file in your game project.

public class YourProjectTarget : TargetRules
{    public YourProjectTarget(TargetInfo Target) : base(Target)
    {          // Force to execute ANSI allocator for the game client
        if(Target.Platform == UnrealTargetPlatform.IOS)
        {            GlobalDefinitions.Add("FORCE_ANSI_ALLOCATOR=1");        }    }}

public class YourProjectTarget : TargetRules

{ public YourProjectTarget(TargetInfo Target) : base(Target)

{ // Force to execute ANSI allocator for the game client

if(Target.Platform == UnrealTargetPlatform.IOS)

{ GlobalDefinitions.Add("FORCE_ANSI_ALLOCATOR=1"); } }}

Hive Settings

Configure the setting items to utilize Hive in accordance with the following instructions. If you change the settings, the values of Unreal Editor is automatically saved, and the files saving setting values (hive_config.xml, etc_string.xml and GooglePlayAppID.xml) save the changes automatically. If the file of setting value does not exist, Hive SDK automatically generate it and save at the following route:

Android:
<Project_Root folder>;/Plugins/HIVESDK/Source/HIVESDK/ThirdParty/android/resource/res/raw
iOS:
<Project_Root folder>;/Plugins/HIVESDK/Source/HIVESDK/ThirdParty/iOS/resource/

Follow the instructions below to set the values necessary for Hive:

Click Edit >; Project Settings in the menu on Unreal Editor. Project Settings screen will show up.
On the left panel of the project settings page, click HIVEConfig XML menu below the title, Plugin. Then HIVEConfig XML settings screen will show up.

Replace the setting items as following instruction in the HIVEConfig XML screen.:

Input Facebook AppID of the game in the blank of Facebook App ID field in the Facebook Settings group. If you do not know the Facebook AppID, read Prerequisites.
Input Google Play Game Service AppID received from GAMEVIL or Com2uS in the blank of Google Play App ID field in the Google Play Settings group.

HiveConfig Settings group: Among setting values in the hive_config.xml file, followings are available to configure.

Field	Description	The range of values
Zone	Hive Server Environment	Sandbox (Default) Live
Logging	Whether to save internal action log of Hive Client or not	On (Default) Off
Push	Whether to use Hive-providing push service or not	On (Default) Off
Company	Game publishing company	Com2uS: C2S GAMEVIL: GVI
Channel	Login service platform used by the game app	Hive (Default)
Market	The market to launch this app	Android: GO (Google), LE (Lebi) iOS: AP (App Store)

Open the values of Hive Config Settings

Close the values of Hive Config Settings

HiveConfig Mobile App Tracking Settings: Input the setting value for the marketing attribution to be used. Input the value of AppID, key or token issued from the marketing attribution dashboard.
View the Marketing Attribution Settings Guide
WriteExternalStoragePermission: The value required by Android to request a permission to access external storage to users or not. If checked, Hive Client requests access permission to external storage to users when initializing Hive SDK.

Building

Follow the rules by OS below to utilize Unreal Engine development environment.

Building Android Apps

Build Settings

If the version of Unreal Engine you use is 4.0 and later, set the items necessary to distribute your apps on Google Play Store as following instructions:

Setting Signing Key:
1. 1. Click Edit >; Project Settings in the menu on Unreal Editor. Project Settings screen will show up.
  2. On the left panel of the project settings page, click Android menu below the title, Platform. Then Android settings screen will show up.
  3. Input the Signing Key data in the field of Distribution Signing group on Android settings screen.
Packaging settings:
1. 1. On the left panel of the project settings page, click Packaging menu, below Project title. Then Packaging settings screen will show up.
  2. Check the For Distribution field of Project group in the packaging settings screen.

Building

How to build Hive-porting games for Android is the same with how to build general game apps for Android. Utilize File >; Project Packaging >; Android menu in the Unreal Editor.

For more information about how to build, see Unreal Engine Guidelines.

Building iOS Apps

How to build Hive-porting games for iOS is the same with how to build general game apps for iOS. Utilize File >; Project Packaging >; iOS menu in the Unreal Editor.

For more information about how to build, see Unreal Engine Guidelines.

Prerequisites

Common

Android

iOS

Windows

Porting

Build Unreal Engine

Activate the Rosetta emulator for macOS

Adding Hive SDK to Unreal Editor

Editing Unreal Engine File

Android

iOS

Universal Link Settings

General Settings

Android

Add Firebase Analytics

Support One Store

iOS

Add Firebase Analytics

Apply language configuration file

Apply HIVEAppDelegate

Configure iOS FMallocAnsi

Hive Settings

Building

Building Android Apps

Build Settings

Building

Building iOS Apps

Getting Started

SDK Development

Console Guide

Download

API Document

Support

Unreal Engine 5

Prerequisites

Common

Android

iOS

Windows

Porting

Build Unreal Engine

Activate the Rosetta emulator for macOS

Adding Hive SDK to Unreal Editor

Editing Unreal Engine File

Android

iOS

Universal Link Settings

General Settings

Android

Google and Google Play Games Sign-in support

Add Firebase Analytics

Support One Store

iOS

Add Firebase Analytics

Apply language configuration file

Apply HIVEAppDelegate

Configure iOS FMallocAnsi

Hive Settings

Building

Building Android Apps

Build Settings

Building

Building iOS Apps

Getting Started

SDK Development

Console Guide

Download

API Document

Support