Skip to main content

Player Network SDK Integration - Unity

Prerequisites​

caution

The versions of every SDK plugin used in the game (including the version used by the game launcher) must remain consistent.If the game needs to access multiple versions of the Player Network SDK at the same time or only one component needs to be upgraded, please contact the Player Network assistant.

Enter the PlayerNetwork SDK Download Page and choose the appropriate engine and platform to download the PlayerNetwork SDK.For details, refer to the PlayerNetwork SDK Download Guide.

Step 1: Install the SDK​

Engine version support

Unity 2021 ~ Unity 6

Version Requirements

androidx
minSdkVersion: 21
targetSdkVersion: 34
compileSdkVersion: 34

If you integrate with LINE, minSdkVersion must be upgraded to 24.

If you integrate with Discord, minSdkVersion must be upgraded to 23.

Note before project submission for review: Starting from SDK V1.24.00, Google has added foreground service permissions declaration.If this declaration is not approved by Google, resubmitting for review may take about a week.For more information, see Specify Foreground Service Types.

1. Add Player Network SDK to your project​

  1. Extract the SDK package.
  2. Copy the INTLSDK folder to your project's Assets folder.
  3. Merge the Plugins folder from Player Network SDK into your project's Plugins folder.
Player Network SDK package
├─INTLSDK       // Player Network SDK CS scripts that offer APIs and callbacks
│  ├─Editor     // Editor scripts for Player Network SDK including Player Network SDK XUPorter
│  └─Scripts    // Scripts for Player Network SDK that include INTLCore and other plugin scripts
├─LevelInfinite // LI PASS APIs
├─Plugins       // Plugins for Player Network SDK for various platforms
│  ├─Android
│  ├─iOS
│  ├─MacOS
│  └─Windows~
├─Symbols       // Symbol table *.so files for Player Network SDK
└─UnionAdapter  // UnionAdapter APIs that adapt to both MSDK and Player Network SDK
INTLSDK/Scripts/INTLCore
├─INTLSDK
│  ├─Editor
│  └─Scripts
│    ├─INTLConfig
|    └─INTLCore
|      ├─Editor     // INTLCore PostProcess.cs / PreProcess.cs files for different platforms
|      |  ├─INTLCoreAndroidPostProcess.cs
|      |  ├─INTLCoreiOSPostProcess.cs
|      |  ├─INTLCoreMacOSPostProcess.cs
|      |  ├─INTLCoreWindowsPostProcess.cs
|      |  └─INTLCoreWindowsPreProcess.cs
|      └─Scripts    // INTLCore scripts
|        ├─INTLAPI.cs       // Player Network SDK APIs
|        ├─INTLConfig.cs    // Player Network SDK data structures
|        ├─INTLDefine.cs    // Player Network SDK static strings
|        ├─INTLErrorCode.cs // Player Network SDK error codes
|        ├─Modules
|        └─Utils
├─LevelInfinite
├─Plugins
├─Symbols
└─UnionAdapter
INTLSDK/Script/INTLConfig
├─INTLSDK
│  ├─Editor
│  └─Scripts
│    ├─INTLConfig
|    | └─Editor     // Configuration files for Player Network SDK, PostProcess.cs files, and encryption tools
|    |    ├─Encrypt
|    |    | ├─decrypt           // Decryption tool for Player Network SDK for INTLConfig.ini
|    |    | ├─Decrypt.exe       // Decryption tool for Player Network SDK for INTLConfig.ini
|    |    | ├─encrypt           // Encryption tool for Player Network SDK for INTLConfig.ini
|    |    | ├─Encrypt.exe       // Encryption tool for Player Network SDK for INTLConfig.ini
|    |    | ├─EncryptConfig.ini // File to enable or disable encryption for INTLConfig.ini in Player Network SDK
|    |    | ├─INTLConfigINI.cs
|    |    | ├─INTLConfigINIEditor.cs
|    |    | └─INTLEditorTools.cs
|    |    ├─INTLConfigAndroidPostProcess.cs
|    |    ├─INTLConfigiOSPostProcess.cs
|    |    ├─INTLConfigMacOSPostProcess.cs
|    |    ├─INTLConfigSwitchPreProcess.cs
|    |    ├─INTLConfigWindowsPostProcess.cs
|    |    └─Resources   // Configurations for Player Network SDK
|    |      ├─APASConfig.ini    // Configuration file for APAS device level
|    |      └─INTLConfig.ini    // Main configuration file for Player Network SDK
|    └─INTLCore
├─LevelInfinite
└─Plugins

2. Load required permissions and plug-ins​

note

If your game has not created an Android custom activity, please refer to Create a custom activity.

Add the Player Network SDK code for loading permissions, libraries, and plug-ins to your custom launch activity (Android games request permissions and load plug-ins here).

Add code to load libraries​
MainActivity.java
static {
    try {
        System.loadLibrary("INTLFoundation");
        System.loadLibrary("INTLCore");
        System.loadLibrary("INTLUnityAdapter");
    }
    catch (Exception e) {
        e.printStackTrace();
    }
}
Register activity lifecycle​
MainActivity.java
import com.intlgame.api.INTLSDK;
import android.content.Intent;
import android.os.Bundle;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // add this line
    INTLSDK.initialize(MainActivity.this);
}

@Override
public void onNewIntent(Intent intent) {
    super.onNewIntent(intent);
    // add this line
    INTLSDK.onNewIntent(intent);
}

@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    // add this line
    INTLSDK.onActivityResult(requestCode, resultCode, data);
}

@Override
public void onRequestPermissionsResult(int arg0, String[] arg1, int[] arg2) {
    super.onRequestPermissionsResult(arg0, arg1, arg2);
    // add this line
    INTLSDK.onRequestPermissionsResult(arg0, arg1, arg2);
}
Load dynamic permissions​
Acquire dynamic permissions through code

Add the following code to apply for permissions dynamically:

import android.app.Activity;
import androidx.core.app.ActivityCompat;
import androidx.core.content.ContextCompat;
import java.util.ArrayList;
import java.util.List;

private void RequestPermission(Activity activity, List<String> permissionList, int requestCode) {
    if (null != activity && null != permissionList) {
        List<String> permissionNeeded = new ArrayList();

        for (int i = 0; i < permissionList.size(); ++i) {
            String permission = (String) permissionList.get(i);
            if (null != permission && 0 != ContextCompat.checkSelfPermission(activity.getApplicationContext(), permission)) {
                permissionNeeded.add(permission);
            }
        }

        if (permissionNeeded.size() > 0) {
            ActivityCompat.requestPermissions(activity, (String[]) permissionNeeded.toArray(new String[permissionNeeded.size()]), requestCode);
        }
    }
}

private void RequestDynamicPermissions() {
    List<String> permissions = new ArrayList();
    permissions.add("android.permission.INTERNET");
    permissions.add("android.permission.READ_PHONE_STATE");
    this.RequestPermission(this, permissions, 100);
}

Call RequestDynamicPermissions:

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // add this line
    RequestDynamicPermissions();
    INTLSDK.initialize(MainActivity.this);
}
Notched screen compatibility settings​

After Android P, Android provides a standard API for notched screens.However, for Android O devices, different vendors have different implementation logics.Player Network SDK provides unified C++ API and Java API to support various Android O devices such as Xiaomi, Huawei, Samsung, VIVO, and OPPO.

Player Network SDK includes an INTLUnityAdapter module which supports Unity games using C# to make unmanaged calls to C++ API.For more information, see Async Cutout Info Reading.

Generally, the full screen aspect ratio of mobile phones is greater than 2.1.To avoid black borders, users must modify android.max_aspect to be greater than 2.1.
For Huawei and Xiaomi phones using the Android Oreo operating system, users must configure the AndroidManifest.

<!--Supports full-screen aspect ratio of 2.4 to adapt to the future 21:9 ultra-widescreen-->
<meta-data android:name="android.max_aspect" android:value="2.4" />
<!--Xiaomi O version definition: Whether to use ear areas (high-risk area)-->
<!--values: 
none: ear areas not rendered in portrait or landscape mode, 
portrait: ear areas rendered in portrait mode,
landscape: ear areas rendered in landscape mode,
portrait|landscape: ear areas rendered in both portrait and landscape mode
-->
<meta-data android:name="notch.config" android:value="portrait|landscape"/>
<!--Huawei O version definition: App pages use notch area-->
<meta-data android:name="android.notch_support" android:value="true"/>

For games that use Android API to obtain notched screen safe area information, please add the following configuration:

Add the following code in MainActivity.

MainActivity.java
import android.os.Build;
import android.view.WindowManager;
import android.view.View;


private void setFullScreen()
{
    getWindow().setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN,
            WindowManager.LayoutParams.FLAG_FULLSCREEN);// Set full screen
    int systemUiVisibility = 0;
    if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.HONEYCOMB) {
        systemUiVisibility = this.getWindow().getDecorView().getSystemUiVisibility();
        int flags = View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
                | View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
                | View.SYSTEM_UI_FLAG_FULLSCREEN;
        systemUiVisibility |= flags;
        getWindow().getDecorView().setSystemUiVisibility(systemUiVisibility);
    }
    // P version is allowed to use the notch area
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
        WindowManager.LayoutParams lp = this.getWindow().getAttributes();
        lp.layoutInDisplayCutoutMode = WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES;
        this.getWindow().setAttributes(lp);
    }
}

Call setFullScreen() here.

MainActivity.java
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // add this line
    setFullScreen();
    this.RequestDynamicPermissions();
    INTLSDK.initialize(this);
}

In PlayerSetting, select Render outside safe area.

Image: Android Unity Setting

3. Generate JAR package​

note

Before generating the JAR package, replace all com.intlgame.unity.MainActivity in Plugins/Android/AndroidManifest.xml with the actual package name of your game, for example com.example.myapp.MainActivity.

Player Network SDK uses Gradle to generate JAR packages.The Gradle configuration files include third-party SDK version numbers as well as dependencies required by Player Network SDK and third-party channels.Games need to add the necessary dependencies according to the required plug-ins.

mainTemplate.gradle and INTLCore.mainTemplate.gradle files are the Player Network SDK Gradle configuration files.Update the Gradle configuration according to the game requirements.

Unity 2018
FileFile path
mainTemplate.gradlePlugins/Android
INTLCore.mainTemplate.gradlePlugins/Android/Gradle

At least two updates:

  1. Merge your game's mainTemplate.gradle into the Player Network SDK's mainTemplate.gradle, and retain the content marked by Player Network SDK.
mainTemplate.gradle
buildscript {
    repositories {**ARTIFACTORYREPOSITORY**
        // ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓ Player Network SDK ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓
        maven {
            url "https://mirrors.tencent.com/nexus/repository/maven-public/"
        }
        maven {
            url "https://mirrors.tencent.com/repository/maven/thirdparty"
        }
        // ↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑ Player Network SDK ↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑
        mavenCentral()
        google()
        jcenter()
    }

    dependencies {
        // ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓ Player Network SDK ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓
        classpath 'com.android.tools.build:gradle:4.0.1'
        // ↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑ Player Network SDK ↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑
**BUILD_SCRIPT_DEPS**
    }
}

allprojects {
    repositories {**ARTIFACTORYREPOSITORY**
        // ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓ Player Network SDK ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓
        maven {
            url "https://mirrors.tencent.com/nexus/repository/maven-public/"
        }
        maven {
            url "https://mirrors.tencent.com/repository/maven/thirdparty"
        }
        // ↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑ Player Network SDK ↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑
        mavenCentral()
        google()
        jcenter()
        flatDir {
            dirs 'libs'
        }
    }
}
  1. Follow the instructions for integrating third-party channels.
  2. Replace the {placeholder} text in INTLCore.mainTemplate.gradle with the value from the INTLConfig.ini configuration file.
INTLCore.mainTemplate.gradle
android {
    compileSdkVersion rootProject.ext.common.compileSdkVersion
    buildToolsVersion rootProject.ext.common.buildToolsVersion

    defaultConfig {
        minSdkVersion rootProject.ext.common.minSdkVersion
        targetSdkVersion rootProject.ext.common.targetSdkVersion
        multiDexEnabled rootProject.ext.common.minSdkVersion < 21

        manifestPlaceholders = [
                "FACEBOOK_APPID"                : "{INTL_FACEBOOK_APP_ID}",
                "GOOGLE_APPID"                  : '{INTL_GOOGLE_APP_ID}',
                "FACEBOOK_CLIENT_TOKEN"         : "{INTL_FACEBOOK_CLIENT_TOKEN}",
                'GOOGLEPGS_APPID'               : '{INTL_GOOGLEPGS_APPID}',
                'VK_APPID'                      : '{INTL_VK_APP_ID}',
                'GARENA_APP_ID'                 : '{INTL_GARENA_APP_SDK_ASSIGN_ID}',
                'QQ_APPID'                      : '{INTL_QQ_APP_ID}',
                'GOOGLE_CLIENT_ID'              : '{INTL_GOOGLE_CLIENT_KEY_ANDROID}',
                'DISCORD_APP_ID'                : '{INTL_DISCORD_APP_ID}',
                'DISCORD_REDIRECT_SCHEME'       : '{INTL_DISCORD_REDIRECT_SCHEME}',
                'DISCORD_REDIRECT_HOST'         : '{INTL_DISCORD_REDIRECT_HOST}',
                'DISCORD_REDIRECT_PATH'         : '{INTL_DISCORD_REDIRECT_PATH}',
                'DMM_LOGIN_ACTIVITY_DATA_SCHEME': '{INTL_DMM_LOGIN_ACTIVITY_DATA_SCHEME}',
                'WEBVIEW_TASK_AFFINITY'         : '',
                'VNG_GG_APP_ID'                 : '{INTL_VNG_GG_APP_ID}',
                'VNG_GG_CLIENT_TOKEN'           : '{INTL_VNG_GG_CLIENT_TOKEN}',
        ]
    }
}

Unity 2019 and above
FileFile path
mainTemplate.gradlePlugins/Android
baseProjectTemplate.gradlePlugins/Android
launcherTemplate.gradlePlugins/Android
INTLCore.mainTemplate.gradlePlugins/Android/Gradle
INTLCore.baseProjectTemplate.gradlePlugins/Android/Gradle
INTLCore.launcherTemplate.gradlePlugins/Android/Gradle

At least two updates exist:

  1. Merge your game's mainTemplate.gradle, baseProjectTemplate.gradle, and launcherTemplate.gradle into the corresponding Player Network SDK Gradle files and retain the content marked by Player Network SDK.
mainTemplate.gradle
// ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓ Player Network SDK - INTLCore ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓
dependencies {
    implementation "androidx.appcompat:appcompat:1.4.0-alpha03"
    implementation "androidx.annotation:annotation:1.0.0"
    implementation "com.google.android.gms:play-services-ads-identifier:17.0.0"
    // Migrated to :app
    // implementation "com.google.android.play:core:1.10.0"
}
// ↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑ Player Network SDK - INTLCore ↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑

// ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓ Player Network SDK - INTLFacebook ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓
dependencies {
    implementation "androidx.annotation:annotation:1.0.0"
    implementation "com.facebook.android:facebook-login:16.1.3"
    implementation "com.facebook.android:facebook-share:16.1.3"
    implementation "com.facebook.android:facebook-core:16.1.3"
    implementation "com.facebook.android:facebook-gamingservices:16.1.3"
    implementation "com.facebook.android:facebook-common:16.1.3"
    implementation "com.facebook.android:facebook-applinks:16.1.3"
}
// ↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑ Player Network SDK - INTLFacebook ↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑

// ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓ Player Network SDK ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓
apply from: "$rootDir/INTL.Gradle/INTLCore.mainTemplate.gradle"
// ↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑ Player Network SDK ↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑
  1. Follow the instructions for integrating third-party channels.
  2. Replace the {placeholder} text in INTLCore.launcherTemplate.gradle with the values from the INTLConfig.ini configuration file.
INTLCore.mainTemplate.gradle
android {
    compileSdkVersion rootProject.ext.common.compileSdkVersion
    buildToolsVersion rootProject.ext.common.buildToolsVersion

    defaultConfig {
        minSdkVersion rootProject.ext.common.minSdkVersion
        targetSdkVersion rootProject.ext.common.targetSdkVersion
        multiDexEnabled rootProject.ext.common.minSdkVersion < 21

        manifestPlaceholders = [
                "FACEBOOK_APPID"                : "{INTL_FACEBOOK_APP_ID}",
                "FACEBOOK_CLIENT_TOKEN"         : "{INTL_FACEBOOK_CLIENT_TOKEN}",
                "GOOGLE_APPID"                  : '{INTL_GOOGLE_APP_ID}',
                'GOOGLEPGS_APPID'               : '{INTL_GOOGLEPGS_APPID}',
                'VK_APPID'                      : '{INTL_VK_APP_ID}',
                'GARENA_APP_ID'                 : '{INTL_GARENA_APP_SDK_ASSIGN_ID}',
                'QQ_APPID'                      : '{INTL_QQ_APP_ID}',
                'GOOGLE_CLIENT_ID'              : '{INTL_GOOGLE_CLIENT_KEY_ANDROID}',
                'DISCORD_APP_ID'                : '{INTL_DISCORD_APP_ID}',
                'DISCORD_REDIRECT_SCHEME'       : '{INTL_DISCORD_REDIRECT_SCHEME}',
                'DISCORD_REDIRECT_HOST'         : '{INTL_DISCORD_REDIRECT_HOST}',
                'DISCORD_REDIRECT_PATH'         : '{INTL_DISCORD_REDIRECT_PATH}',
                'DMM_LOGIN_ACTIVITY_DATA_SCHEME': '{INTL_DMM_LOGIN_ACTIVITY_DATA_SCHEME}',
                'WEBVIEW_TASK_AFFINITY'         : '',
                'VNG_GG_APP_ID'                 : '{INTL_VNG_GG_APP_ID}',
                'VNG_GG_CLIENT_TOKEN'           : '{INTL_VNG_GG_CLIENT_TOKEN}',
        ]
    }
}

4. Player Network SDK Configuration​

note

When manually modifying the INTLConfig.ini file, please contact the Player Network support to confirm that the changes are as expected. For details, see SDK Config Instructions.

Please configure according to the instructions in INTLConfig.ini.

5. Initialize Player Network SDK​

Player Network SDK must be initialized before integrating third-party channels.For more details, see Initialize SDK.

using INTL;// import INTL namespace

void InitializeINTLSDK()
{
    INTLAPI.IsDebug = true; // Set SDK to Debug mode for log output, default is false
    INTLAPI.InitSDK();
}

Step 2: Verify successful Player Network SDK integration​

  1. Modify the configuration under the INTL Log node in the INTLConfig.ini file.
[INTL Log]
LOG_LEVEL = 1
LOG_ENCRYPT_ENABLE = 0
LOG_COMPRESS_ENABLE = 0
LOG_CONSOLE_OUTPUT_ENABLE = 1
LOG_FILE_OUTPUT_ENABLE = 1
  1. Run the program. If the log shows Init INTL SDK success., integration is successful.
Privacy PolicyTerms of ServiceDPAOpen Source Licenses
©2025 Proxima Beta Pte. Ltd. All rights reserved.