Windows

UE4.21 ~ UE4.27 & UE5 ~ UE5.4

系统要求

支持 64-bit 的 Windows 7、Windows 10、Windows 11 操作系统。

由于 Windows 平台的特性，游戏的安装目录不能含有英文字符分号（;），否则会导致游戏无法找到必要的 DLL，导致游戏运行失败。

如果 Windows 平台接入 Google、Facebook、LINE、Apple 等渠道，需要引入 WebView。

版本要求

建议基于 Microsoft Visual C++ Redistributable 2015-2022 编译器运行。

Windows 7:
1. 安装 Microsoft Visual C++ Redistributable packages 并添加 VC_redist.x64.exe /install /quiet /norestart 命令到安装程序脚本。
2. 安装 Windows 7 安全更新 (KB3063858)。
Windows 8 和 Windows 8.1：
安装 Microsoft Visual C++ Redistributable packages 并添加 VC_redist.x64.exe /install /quiet /norestart 命令到安装程序脚本。

前提条件

警告

游戏使用的每个 SDK 插件的版本（包括游戏启动器使用的版本）必须保持一致。如果游戏需要同时访问多个版本的 Player Network SDK，或者只有一个组件需要升级，请联系 Player Network 助手。

步骤1：安装 SDK

1. 将 Player Network SDK 添加到您的项目

解压 SDK 软件包。
将 INTLSDK 文件夹复制到项目的 Plugins 文件夹中。
如果项目中没有 Plugins 文件夹，请创建一个。

打开项目的 {项目名称}.Build.cs 文件，并按照示例将 Player Network SDK 添加到 Unreal Engine 中。

public INTLSample(ReadOnlyTargetRules Target) : base(Target)
{
    PrivateDependencyModuleNames.AddRange(new string[] {
        "INTLCore",
        "INTLFoundation",
        "INTLConfig",
    });
}

Player Network SDK package

├─INTLSDK
│  ├─INTLSDK.uplugin    // Player Network SDK plugins description files
│  ├─Resources          // Player Network SDK resources
│  └─Source             // Player Network SDK plugin modules. Each module contains its own Build.cs file, libraries, and interfaces.
│    ├─INTLApple
│    ├─INTLConfig       // Player Network SDK configurations
│    ├─INTLCore         // Player Network SDK Core module
│    ├─INTLDiscord
│    ├─INTLEpic
│    ├─INTLFacebook
│    ├─INTLFoundation
│    ├─INTLGoogle
│    ├─INTLKakao
│    ├─INTLLine
│    ├─INTLSteam
│    ├─INTLTwitter
│    └─INTLVK
├─LevelInfinite     // LI PASS APIs
└─Symbols           // Player Network SDK symbol table *.so files

INTLSDK/Source/INTLCore

└─INTLSDK
   ├─INTLSDK.uplugin
   ├─Resources
   └─Source
     ├─INTLConfig
     ├─INTLCore
     |  ├─INTLCore.Build.cs // INTLCore Build.cs file
     |  ├─Libs              // INTLCore libraries for different platforms which contain dll, lib, and other binary files.
     |  |  ├─Android
     |  |  ├─include
     |  |  ├─iOS
     |  |  ├─MacOS
     |  |  └─Win
     |  ├─Private           // Player Network SDK private folder
     |  └─Public            // Player Network SDK public interfaces
     |                      // INTLSDKAPI.h: Player Network SDK APIs
     |                      // INTLSDKPluginObserver.h: Player Network SDK observer classes
     |                      // INTLSDKPluginDefine.h: Player Network SDK data types
     |                      // INTLSDKOutputUtility.h: Player Network SDK utility to process callbacks
     |                      // INTLSDKBaseUserWidget.h: Player Network SDK base class for UserWidget which includes registration and deregistration APIs
     ├─INTLCustomer
     ├─INTLDiscord
     ├─INTLEpic

INTLSDK/Source/INTLConfig

└─INTLSDK
   ├─INTLSDK.uplugin
   ├─Resources
   └─Source
     ├─INTLConfig
     |  ├─Configs       // Player Network SDK configurations for different platform
     |  |  ├─Android
     |  |  |  └─INTLConfig_APL.xml  // Player Network SDK Android gradle configuration file
     |  |  ├─iOS
     |  |  |  ├─INTL.plist
     |  |  |  ├─INTLConfig_UPL.xml
     |  |  |  ├─mergeplist.sh
     |  |  |  └─Plist
     |  |  ├─Resources
     |  |  |  ├─APASConfig.ini      // APAS device level configuration file
     |  |  |  └─INTLConfig.ini      // Player Network SDK main configuration file
     |  ├─Encrypt
     |  ├─INTLConfig.Build.cs
     |  ├─INTLConfig.uplugin  
     |  ├─Private
     |  ├─Public
     |  └─Resources
     ├─INTLCore

2. 更改缓存目录

默认情况下，Player Network SDK PC 用户和应用程序生成的缓存目录为：

C:/ProgramData/INTL
C:/Users/{name}/AppData/Local/INTL/local/INTL。

在调用 InitSDK 之前，游戏开发者必须设置缓存目录。更多信息，请参见更改用户数据文件夹目录 API。

// For example, game id is 11, and the game application name is INTLSDKDemo.
// Then the game invokes the interface like this: 
UINTLSDKAPI::SetDefaultUserStorageDirectory("D:\\game_data\\")
// The data cache path for Player Network SDK will be D:\game_data\11\INTLSDKDemo\.

3. Player Network SDK 配置

注意

手动修改 INTLConfig.ini 配置时，请联系 Player Network 助手确认内容变更是否符合预期，详见 SDK Config Information。

请按照 INTLConfig.ini 的说明进行相应配置。

4. 初始化 Player Network SDK

在集成第三方渠道之前，必须先初始化 Player Network SDK。更多详情，请参见初始化 SDK。

UINTLSDKAPI::Init();

注意

为了释放 Player Network SDK 的全局状态，建议在编辑器中的应用程序生命周期结束时重启或关闭 SDK。

有关上述 Windows 专用 API 的更多详情，请参见 Restart（重启）和 ShutDown（关闭）。

步骤2：验证 Player Network SDK 接入成功

修改 INTLConfig.ini 文件中 INTL Log 节点下的配置。

[INTL Log]
LOG_LEVEL = 1
LOG_ENCRYPT_ENABLE = 0
LOG_COMPRESS_ENABLE = 0
LOG_CONSOLE_OUTPUT_ENABLE = 1
LOG_FILE_OUTPUT_ENABLE = 1

运行程序，当日志中显示 Init INTL SDK success. 时，表示接入成功。

前提条件​

步骤1：安装 SDK​

1. 将 Player Network SDK 添加到您的项目​

2. 更改缓存目录​

3. Player Network SDK 配置​

4. 初始化 Player Network SDK​

步骤2：验证 Player Network SDK 接入成功​

推荐使用​