Funtap Publisher Integration Guide

Overview¶

The Funtap publisher Software Development Kit (SDK) integration guide explains how to apply this SDK to an Android game after completing a publishing contract with Funtap and configure an Appraisal Build for Vietnam publishing license review and a Service Build for live service. Hive SDK integrates the User Interface (UI) and Application Programming Interface (API) required for the sign-in screen and user information update feature by using different Funtap modules and configuration values depending on the build type. With this configuration, you can prepare Android builds that comply with Vietnam service policies and government regulations.

How to apply Appraisal Build¶

Appraisal Build is the build submitted for Vietnam publishing license review. In this build, the Funtap sign-in feature must work properly.

Preparation¶

Before you start the Appraisal Build process, you must obtain the appraisal appKey from Funtap. In Native, enter this value in hive_config.xml; in Unity, enter it in the Funtap appKey field under [Top toolbar > Hive > HiveConfig > Optional]. If this value is not ready, you cannot complete Step 3.

Step 1. Set up the Funtap-Appraisal library¶

In Native, add the dependency for Appraisal to the module-level build.gradle file.

// Funtap Appraisal module
implementation "com.com2us.android.hive:hive-authv4-provider-funtap-appraisal"

In Unity, click ExternalDependency in [Top toolbar > Hive], then select the Funtap-Appraisal item.

In Unreal Engine, select the Funtap-Appraisal item in [Edit > Project Settings > Hive SDK > Dependency - Android].

Step 2. Set permissions for the Funtap-Appraisal library¶

To integrate the Funtap-Appraisal library, add the following permission settings to the AndroidManifest.xml file.

In Native, add the permissions to the module-level AndroidManifest.xml file.

• <project>/app/src/main/AndroidManifest.xml

In Unity, add the permissions to the AndroidManifest.xml file in Plugins/Android.

• <project>/Assets/Plugins/Android/AndroidManifest.xml

In Unreal Engine, add the permissions to HiveSDKAndroid_UPL.xml in Plugins/HIVESDK/Source/HiveSDKAndroid.

• <project>/Assets/Plugins/HIVESDK/Source/HiveSDKAndroid/HiveSDKAndroid_UPL.xml

Add the following permissions.

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.VIBRATE" />
<uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" />

Step 3. Apply the Funtap publisher setting value (appKey)¶

In Native, add the appKey received from the Funtap publisher to the hive_config.xml file.

<funtap-appraisal appKey="YOUR_APP_KEY" />

In Unity, click Optional in [Top toolbar > Hive > HiveConfig], then enter the issued key in Funtap's appKey field.

In Unreal Engine, expand the FuntapAppraisal item in [Edit > Project Settings > Hive Config > Android], then enter the issued key in the appKey field.

Step 4. Verify Funtap sign-in behavior¶

In Appraisal Build, call Funtap sign-in and verify that the sign-in screen is displayed correctly and that sign-in succeeds. Hive SDK includes the Funtap SDK internally and uses ProviderType.FUNTAP when calling AuthV4.signIn(). After sign-in succeeds, the follow-up processing required for publisher integration proceeds automatically inside the Funtap SDK.

using hive;

AuthV4.signIn(AuthV4.ProviderType.FUNTAP, (ResultAPI result, AuthV4.PlayerInfo playerInfo) => {
    if (result.isSuccess()) {
        // ProviderType FUNTAP sign-in succeeded
    }
});

#include "HiveAuthV4.h"

FHiveAuthV4::SignIn(EHiveProviderType::FUNTAP,
                    FHiveAuthV4OnSignInDelegate::CreateLambda([this](const FHiveResultAPI& Result, const FHivePlayerInfo& PlayerInfo) {

    if (Result.IsSuccess()) {
        // ProviderType FUNTAP sign-in successful
    }
}));

#include <HIVE_SDK_Plugin/HIVE_CPP.h>

AuthV4::signIn(ProviderType::FUNTAP, [=](ResultAPI const & result, PlayerInfo const & playerInfo) {
    if (result.isSuccess()) {
        // ProviderType FUNTAP sign-in succeeded
    }
});

import com.hive.AuthV4
import com.hive.ResultAPI

AuthV4.signIn(AuthV4.ProviderType.FUNTAP, object : AuthV4.AuthV4SignInListener {
    override fun onAuthV4SignIn(result: ResultAPI, playerInfo: AuthV4.PlayerInfo?) {
        if (result.isSuccess) {
            // ProviderType FUNTAP sign-in succeeded
        }
    }
})

import com.hive.AuthV4;
import com.hive.ResultAPI;

AuthV4.signIn(AuthV4.ProviderType.FUNTAP, (result, playerInfo) -> {
    if (result.isSuccess()) {
        // ProviderType FUNTAP sign-in succeeded
    }
});

How to apply Service Build¶

Service Build is the build used to operate the live service after obtaining the Vietnam publishing license. In this build, use the service Funtap module and the token setting.

Preparation¶

Before you start the Service Build process, you must obtain the service token from Funtap. In Native, enter this value in hive_config.xml; in Unity, enter it in the Funtap token field under [Top toolbar > Hive > HiveConfig > Optional]. If this value is not ready, you cannot complete Step 2.

Use the Service Build features only after completing the login flow already implemented in the game. After sign-in succeeds, use the PlayerID received in the PlayerInfo response as the userId for subsequent Funtap APIs.

Step 1. Set up the Funtap library¶

In Native, add the dependency for service use to the module-level build.gradle file.

// Funtap Service module
implementation "com.com2us.android.hive:hive-authv4-provider-funtap"

In Unity, click ExternalDependency in [Top toolbar > Hive], then select the Funtap item.

In Unreal Engine, select the Funtap item in [Edit > Project Settings > Hive SDK > Dependency - Android].

Step 2. Apply the Funtap publisher setting value (token)¶

In Native, add the token received from the Funtap publisher to the hive_config.xml file.

<funtap token="YOUR_TOKEN" />

In Unity, click Optional in [Top toolbar > Hive > HiveConfig], then enter the issued key in Funtap's token field.

In Unreal Engine, expand the Funtap item in [Edit > Project Settings > Hive Config > Android], then enter the issued key in the token field.

Step 3. Check whether the government review is in progress¶

To decide whether to display the manual information update menu in Service Build, the user must first be signed in successfully. When opening the character information screen or settings screen after sign-in, call ProviderFuntap.isFuntapUnderGovernmentReview() to check whether the review is in progress. If the result is true, it is the government review period, so Hive SDK automatically displays the WebView-style identity verification screen shown below immediately after sign-in. In this case, do not display a separate manual information update UI.

If the result is false, proceed to the next step.

using hive;

bool result = ProviderFuntap.isFuntapUnderGovernmentReview();

#include "HiveProviderFuntap.h"

bool bResult = FHiveProviderFuntap::IsFunTapUnderGovernmentReview();

#include <HIVE_SDK_Plugin/HIVE_CPP.h>

bool result = ProviderFuntap::isFuntapUnderGovernmentReview();

import com.hive.ProviderFuntap

val result = ProviderFuntap.isFuntapUnderGovernmentReview()

import com.hive.ProviderFuntap;

boolean result = ProviderFuntap.isFuntapUnderGovernmentReview();

Step 4. Check whether the user has completed information entry¶

If the result in Step 3 is false, determine whether the user can proceed with a manual information update. For userId, pass the PlayerID received in the PlayerInfo response after successful sign-in as a string. For more information about the PlayerInfo response values, refer to Before you start.

If the isCompleted value returned by ProviderFuntap.checkUserInfoComplete(userId) is true, the information has already been entered, so do not display the UI. If the isCompleted value is false, provide the information update UI in the next step.

using hive;

string userId = "USER_ID";

ProviderFuntap.checkUserInfoComplete(userId, (ResultAPI result, bool isCompleted) => {
    if (result.isSuccess()) {
        // Display the information update UI if isCompleted is false
    }
});

#include "HiveProviderFuntap.h"

FString UserId = "USER_ID";

FHiveProviderFuntap::CheckUserInfoComplete(UserId, FHiveProviderFuntapOnCheckUserInfoCompleteDelegate::CreateLambda([this](const FHiveResultAPI& Result, bool bIsCompleted) {
    if (Result.IsSuccess()) {
        // If isCompleted is false, display the user info update UI
    }
}));

#include <HIVE_SDK_Plugin/HIVE_CPP.h>

std::string userId = "USER_ID";

ProviderFuntap::checkUserInfoComplete(userId, [=](ResultAPI const & result, bool isCompleted) {
    if (result.isSuccess()) {
        // Display the information update UI if isCompleted is false
    }
});

import com.hive.ProviderFuntap
import com.hive.ResultAPI

val userId = "USER_ID"

ProviderFuntap.checkUserInfoComplete(userId) { result: ResultAPI, isCompleted: Boolean ->
    if (result.isSuccess) {
        // Display the information update UI if isCompleted is false
    }
}

import com.hive.ProviderFuntap;
import com.hive.ResultAPI;

String userId = "USER_ID";

ProviderFuntap.checkUserInfoComplete(userId, (result, isCompleted) -> {
    if (result.isSuccess()) {
        // Display the information update UI if isCompleted is false
    }
});

Step 5. Display the information update UI¶

If the isCompleted value in Step 4 is false, provide a menu that the user can select directly on the character information screen or settings screen. When the user selects that menu, call ProviderFuntap.showUpdateUserInfo(userId) to open the information update screen.

using hive;

string userId = "USER_ID";

ProviderFuntap.showUpdateUserInfo(userId, (ResultAPI result) => {
    if (result.isSuccess()) {
        // API call succeeded
    }
});

#include "HiveProviderFuntap.h"

FString UserId = "USER_ID";

FHiveProviderFuntap::ShowUpdateUserInfo(UserId, FHiveProviderFuntapOnShowUpdateUserInfoDelegate::CreateLambda([this](const FHiveResultAPI& Result) {
    if (Result.IsSuccess()) {
        // API call succeeded
    }
}));

#include <HIVE_SDK_Plugin/HIVE_CPP.h>

std::string userId = "USER_ID";

ProviderFuntap::showUpdateUserInfo(userId, [=](ResultAPI const & result) {
    if (result.isSuccess()) {
        // API call succeeded
    }
});

import com.hive.ProviderFuntap
import com.hive.ResultAPI

val userId = "USER_ID"

ProviderFuntap.showUpdateUserInfo(userId) { result: ResultAPI ->
    if (result.isSuccess) {
        // API call succeeded
    }
}

import com.hive.ProviderFuntap;
import com.hive.ResultAPI;

String userId = "USER_ID";

ProviderFuntap.showUpdateUserInfo(userId, (result) -> {
    if (result.isSuccess()) {
        // API call succeeded
    }
});