跳到主要内容

Windows

引擎版本支持

UE4.21 ~ UE4.27 & UE5 ~ UE5.5

系统要求

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

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

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

版本要求

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

前提条件​

警告

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

  1. 在 Player Network 获取登录账号。
  2. 创建新项目。
  3. [可选] 邀请用户加入业务。
  4. 下载 SDK。

步骤1：安装 SDK​

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

  1. 解压 SDK 软件包。

  2. 将 INTLSDK 文件夹复制到项目的 Plugins 文件夹中。
    如果项目中没有 Plugins 文件夹，请创建一个。

  3. 打开项目的 {项目名称}.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
     |  |  |  └─INTLConfig_UPL.xml
     |  |  ├─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 须知。

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

4. 初始化 Player Network SDK​

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

#include "INTLSDKAPI.h" // Include the INTL header file

void UExample::Init()
{
    UINTLSDKAPI::Init();
}
注意

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

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

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

  1. 修改 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
  1. 运行程序，当日志中显示 Init INTL SDK success. 时，表示接入成功。

推荐使用​

您已完成 Player Network SDK 的接入，并可开始为您的项目编写程序。

我们建议使用以下 Player Network 的服务：

  • 參考 登录鉴权 教程，为您的项目添加第三方渠道登录。
  • 查看有关 社交 服务的更多信息，了解如何促进玩家之间的互动。
  • 有关配置公告和推送通知的详细步骤，请参见 玩家参与。
  • 查看 数据洞察 服务的相关文档，了解如何收集和上报数据。
  • 通过 Player Network 提供的 Deep Link、WebView 等 实用工具，增强 Player Network 服务体验。
  • 根据您的发行国家/地区，为您的项目制定 合规保障 方案。

除此之外，您也可以选择接入 LEVEL INFINITE PASS，接入后便可使用上述所有功能。
一般用户可通过简单快捷的流程实现适用于大部分游戏的标准解决方案，而希望定制项目的各种细节的用户也可省去不必要的集成动作，直接开始配置。

更多详情，请联系 Player Network 助手进行咨询。