跳到主要内容

Windows

Unity 2021.3.33f1 ~ Unity 2022
系统要求

支持 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 文件夹复制到项目的 Assets 文件夹中。
  3. 将 Player Network SDK 的 Plugins 文件夹合并到项目的 Plugins 文件夹中。
Player Network SDK package
├─INTLSDK       // Player Network SDK CS scripts which provide APIs and callbacks
│  ├─Editor     // Player Network SDK Editor scripts which include Player Network SDK XUPorter
│  └─Scripts    // Player Network SDK scripts which include INTLCore and other plugin scripts
├─LevelInfinite // LI PASS APIs
├─Plugins       // Player Network SDK plugins for various platforms
│  ├─Android
│  ├─iOS
│  ├─MacOS
│  └─Windows~
├─Symbols       // Player Network SDK symbol table *.so files
└─UnionAdapter  // UnionAdpater APIs which adapts 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     // Player Network SDK configuration files, PostProcess.cs files, and encryption tools
|    |    ├─Encrypt
|    |    | ├─decrypt           // Player Network SDK decryption tool for INTLConfig.ini
|    |    | ├─Decrypt.exe       // Player Network SDK decryption tool for INTLConfig.ini
|    |    | ├─encrypt           // Player Network SDK encryption tool for INTLConfig.ini
|    |    | ├─Encrypt.exe       // Player Network SDK encryption tool for INTLConfig.ini
|    |    | ├─EncryptConfig.ini // Player Network SDK file to enable or disable INTLConfig.ini encryption
|    |    | ├─INTLConfigINI.cs
|    |    | ├─INTLConfigINIEditor.cs
|    |    | └─INTLEditorTools.cs
|    |    ├─INTLConfigAndroidPostProcess.cs
|    |    ├─INTLConfigiOSPostProcess.cs
|    |    ├─INTLConfigMacOSPostProcess.cs
|    |    ├─INTLConfigSwitchPreProcess.cs
|    |    ├─INTLConfigWind...sPostProcess.cs
|    |    └─Resources   // Player Network SDK configurations
|    |      ├─APASConfig.ini    // APAS device level configuration file
|    |      └─INTLConfig.ini    // Player Network SDK main configuration file
|    └─INTLCore
├─LevelInfinite
└─Plugins

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: 
INTLAPI.SetSDKDefaultUserStorage("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。

INTLAPI.IsDebug = true; // Set the SDK to the Debug mode to print out logs. The default value is false.
INTLAPI.InitSDK();
注意

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

有关上述 Windows 专用 API 的更多详情，请参见 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 助手进行咨询。

最后于 更新