Player Network SDK 更新日志
警告
- 升级到最新版本时,请查看所有版本的升级指引。
- 游戏使用的各插件版本必须一致,包括登录器使用的 SDK 版本也必须与游戏一致。如果业务需要同时接入不同版本的 Player Network SDK,或者只升级一个插件,需要联系 Player Network 助手。
Android: Android
iOS: iOS
Windows: PC
Console: PS5, XSX
All: Android, iOS, PC, PS5, XSX
iOS: iOS
Windows: PC
Console: PS5, XSX
All: Android, iOS, PC, PS5, XSX
V1.28.01
发布时间: 2025.6.24
新特性
- Console 新增支持 Console 平台
功能优化
- Windows 修改 COMPLIANCE_NEW_CREDIT_CARD_VERIFY 的默认值为1,默认使用新版信用卡认证流程
问题修复
- Windows 修复 Steam DLL 与 Unreal Engine 4 不兼容导致崩溃的问题,降低 Steam SDK 版本至 V1.46
升级指引
- 本次版本支持 Android、iOS、Windows、Console平台
V1.28.00
发布时间: 2025.5.30
新特性
- AndroidiOSWindows 新增集成 Discord Social SDK,支持授权绑定、好友、文字聊天和大厅功能,详细指引请见 Discord 社交 SDK
功能优化
- Windows 优化客户端云控调用频率,支持配置自动云控拉取的模式及规则,详细指引请见 Player Network SDK 云控
版本升级
- Android 支持 Android targetSDKVersion 35,详情请见 Android 15 适配指引
- Windows 升级 Steam SDK 至 1.62
- Windows 升级 Epic SDK 至 1.16.4
问题修复
- Windows 修复 LITools 模块
ETargetPlatform
与游戏插件命名冲突的问题 - iOS 修复 Unreal 引擎 iOS 端偶现的崩溃问题
- 复若干已知问题
升级指引
- 本次版本支持 Android、iOS、Windows平台
V1.27.00
发布时间: 2025.3.21
新特性
- All 新增支持 Unity 6 适配
功能优化
- Android 优化 Android 15 的 WebView 异形屏适配,对应 Android 15 & targetSdkVersion 35 以及之后的系统:
LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES
以及LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER
被弃用,所有应用默认使用刘海区域显示内容WebViewActivity
的异形屏适配方案改为decorView
padding
版本升级
- AndroidiOS 升级 Facebook Android SDK 至 18.0.0,iOS SDK 至 17.4.0
- AndroidiOS 升级 Firebase Android FirebaseAnalytics 至 22.2.0,FirebaseMessage 至 24.1.0,iOS SDK 至 11.7.0
- AndroidiOS 升级 Adjust Android 和 iOS SDK 至 5.0.2
- AndroidiOS 升级 QQ Android 至 3.5.17.3,iOS SDK 至 3.5.17.4
- iOS 升级 TikTok iOS SDK 至 2.5.0
- iOS 升级 LINE iOS SDK 至 5.11.2
问题修复
- 修复若干已知问题
升级指引
- 本次版本支持 Android、iOS、Windows、Console(仅 Unreal 引擎)平台
- V1.27.0 版本起,Kakao 渠道和 SquareEnix 渠道插件不再对外提供,若有接入需求请联系 Player Network 助 手
- iOS按 Apple 要求,自2025年4月24日起,提交至 App Store Connect 的 app 均需使用 Xcode 16 或更高版本编译,并适用 iOS 18、iPadOS 18、Apple tvOS 18、visionOS 2 或 watchOS 11 的 SDK,详见 使用最新 Beta 版本,做好充足准备
V1.26.00
发布时间: 2025.1.9
新特性
- All 新增 Unreal Engine 5.5 适配
- AndroidiOS 新增二维码插件,支持二维码扫描、生成和显示二维码,详细指引请参见 二维码插件 接入指引
- AndroidiOS 新增支持视频分享功能,分享渠道支持 Youtube、Facebook reels 和 TikTok
- AndroidiOS 新增支持 Wechat 及 QQ 渠道的扫码登录功能
- AndroidiOS 新增支持卸载重装后自动登录的能力,实现卸载重装后不丢失登录态,可通过配置项 AUTO_LOGIN_REINSTALL_ENABLE 进行开关控制
- AndroidiOS 新增支持 Garena-Line 登录方式
- Android 新增接入 TikTok Event SDK 以支持数据上报,支持通过配置 TikTok 分析平台,直接将分析数据上报至 TikTok 的广告板块,详细指引请参见 配置 TikTok 上报
功能优化
- Console 适配使用 PXUID 作为 Xbox Series X/S 平台绑定渠道的唯一 ID 标识
版本升级
- AndroidiOS Garena Android SDK 升级至 5.10.2,iOS SDK 升级至 5.9.0(适配 XCode 15.0-15.2 的版本)
- Android 升级 LINE Android SDK 至 5.10.1
- Console 升级 PlayStation 5 SDK 至 10.000
- Console 升级 Xbox Series X|S Microsoft Game Development Kit (GDK) 至 June 2024 Update 2
问题修复
- WindowsConsole 修复网络证书文件
cacert.pem
重名冲突的问题,新文件名为intl_cacert.pem
- 修复若干 Garena 相关问题
升级指引
- 本次版本支持 Android、iOS、Windows、Console(仅 Unreal 引擎)平台
- AndroidiOS V1.26.0 版本起,所有插件的 Android minSdkVersion 调整为 21,iOS MinimumOSVersion 统一为 12
- Android 由于 LINE Android SDK 仅与 minSdkVersion >= 24 兼容,因此在 Android 7.0 或更低版本的设备上运行时可能会出现问题,接入 LINE 渠道的业务必须设置 minSdkVersion >= 24
- iOS 自 iOS 18 起,iOS 设备不再支持使用
openURL(_:)
方法,导致INTLWebView
无法跳转到 Safari 浏览器
SDK V1.26.00 已使用open(_:options:completionHandler:)
方法进行替换,建议受影响的业务升级此版本,详见 OpenUrl
V1.25.00
发布时间: 2024.11.5
新特性
- AndroidiOS 新增 Android 15 及 iOS 18 适配
- Android 15 适配:由于 Unreal 及 Unity 当前引擎版本的限制,本次版本仅支持 4KB(Android 15 新增 16KB 特性,官方说明请参见 支持 16 KB 页面大小)
- iOS 18 适配:当前 Player Network SDK 使用 XCode 15 编译,已支持 XCode 16(iOS 18)
- 详细升级指引,请参见 Android API 35 & iOS 18 适配文档
版本升级
- iOS 升级 Kakao iOS SDK 至 3.19.4,新版本支持 Apple 隐私清单政策要求
- Android 升级 Appsflyer Android SDK 至 6.15.1
问题修复
- AndroidiOS 修复欧盟 DMA 协议 Google CMP 功能的 Consent Mode 配置开关问题
- 修复若干已知问题
升级指引
- 本次版本支持 Android、iOS、Windows、Console(仅 Unreal 引擎)平台
V1.24.01
发布时间: 2024.9.2
新特性
- All 新增 Unreal Engine 5.4 适配
- All 新增封装 IEGG GPT-Translator 服务,为业务提供翻译服务,详见 Translate
- All 新增支持 WeChat 多渠道包能力,支持各渠道包配置不同的微信 AppID,实现账号同步使玩家从不同的渠道包登录后被识别为同一个 OpenID
- Console 新增支持 Nintendo Switch 平台
版本升级
- AndroidiOS 升级 VNG Android SDK 至 3.1.0,iOS SDK 至 3.0.1
- Console 升级 Switch SDK 至 18.3.1
- Console 升级 PlayStation 5 SDK 至 9.00.00
- Console 升级 Xbox Series X|S Microsoft Game Development Kit (GDK) 至 October 2023 Update 3
功能优化
- All 优化适配 Unreal Engine 5.3 的
-game
模式 - All 优化修复 Unreal Engine 5.3 编译时的告警,减少不必要的告警触发
- All 优化减少非必要的开发日志上报,降低对研发的干扰
- All 优化支持切换 IEGG 合规的新旧版本信用卡认证流程,新增配置项 COMPLIANCE_NEW_CREDIT_CARD_VERIFY,默认为 0 跳转旧版本信用卡认证流程
升级指引
- 本次版本支持 Android、iOS、Windows、Console(仅 Unreal 引擎)平台,支持 LI PASS 版本 V1.17.01
- iOS 使用 Unreal Engine 5.3 和 5.4 的游戏,请注意在 iOS 16 及以下版本会发生非首次启动闪退的问题,iOS 17 则不受影响,后续将在 Unreal Engine 5.5 版本配置
FORCE_ANSI_ALLOCATOR
后修复 - Console 若游戏接入 Switch 版本,请注意 Switch SDK V18.3.1 目前只支持 UE5.4-dotnet8 引擎
- Console 从 SDK V1.24.01 起,接入 Unreal 引擎 Xbox Series X|S 渠道登录时,游戏无需再在引擎源码
UEBuildXSX.cs
中的SetUpEnvironment()
方法中添加advapi32.lib
和oldnames.lib
,该处理改为在组件插件代码中集成
V1.24.00
发布时间: 2024.7.12
新特性
- AndroidiOSWindows 新增支持 IEGG 合规的未成年用户社交功能,支持通过家长认证或游戏内拉起社交功能认证页面进行授权,详见 合规接入指引
- iOS 新增支持 Unreal Engine 5.3 的现代化 Xcode 模式
版本升级
- AndroidiOS 升级 Garena Android SDK 至 5.8.0,iOS SDK 至 5.7.1
- Android 升级 DMM Android SDK 至 3.3.3
- Android 支持 Android targetSDKVersion 34,详情请见 Android 14 适配指引
功能优化
- All 升级第三方渠道信用卡认证流程
问题修复
- Windows 修复 WebView SDL 创建 renderer 失败导致的偶现 crash 问题
升级指引
- 本次版本支持 Android、iOS、Windows、Console(仅 Unreal 引擎)平台,支持 LI PASS 版本 V1.17.00
- Android 按 Google Play 的要求,自2024年8月31日起新应用和应用更新必须以 Android 14(API 级别 34)或更高版本为目标平台,才能提交到 Google Play,详见 符合 Google Play 的目标 API 级别要求
- 建议涉及 Android 的业务尽快升级此版本,并注意在升级后将不再支持 Unity 2021 之前的引擎版本
- 若无法在 Google Play 要求的时间内完成升级,可以在 Google Play 管理中心申请延期,至2024年11月1日
- All 因 IEGG 合规团队对第三方渠道信用卡认证流程进行了升级,从 Player Network SDK V1.24.00 开始,游戏只需到 Midas 新官网 进行
offerid
的授权即可,无需到 Midas 旧官网进行配置- 接入 Player Network SDK V1.24.00 以下版本的游戏,保持旧版本信用卡认证流程,已接入的业务依然提供合规支持,但不再承接新业务
- 接入 Player Network SDK V1.24.00 或以上的游戏,将默认使用新版本信用卡认证流程
V1.23.01
发布时间: 2024.5.31
版本升级
- iOS 升级 LINE iOS SDK 至 5.11.1
升级指引
- 本次版本支持 Android、iOS、Windows、Console(仅 Unreal 引擎)平台,支持 LI PASS 版本 V1.16.01
- LINE iOS SDK V5.11.1 版本已移除 bitcode,将有助于通过苹果 App Store 的审核。之前包含 bitcode 的版本可能会被苹果审核拒绝,因此建议已接入 LINE 渠道的业务尽快升级到最新的 SDK 版本
V1.23.00
发布时间: 2024.5.10
新特性
- iOS 新增主流渠道的隐私清单,配合将于 2024 年春季正式纳入审核流程的 Apple 隐私清单 和 SDK 签名 政策,详见 iOS 17 隐私清单
- Windows 新增支持 Microsoft Edge WebView2
版本升级
- iOS 升级 Facebook iOS SDK 至 17.0.0
- iOS 升级 Google iOS SDK 至 7.1.0
- iOS 升级 Firebase iOS SDK 至 10.24.0
- iOS 升级 Adjust iOS SDK 至 4.38.0
- iOS 升级 AppsFLyer iOS SDK 至 6.14.0
- iOS 升级 Garena iOS SDK 至 4.0.23
- iOS 升级 DMM iOS SDK 至 3.4.3
- iOS 升级 QQ iOS SDK 至 3.5.16
- iOS 升级 WeChat iOS SDK 至 2.0.4
功能优化
- Android 优化变更 Android target 33 的后台存储权限,从
READ_EXTERNAL_STORAGE
、WRITE_EXTERNAL_STORAG
修改为READ_MEDIA_IMAGES
、READ_MEDIA_AUDIO
、READ_MEDIA_VIDEO
- iOS 优化移除 Unity .projmods 文件中依赖的 libstdc++ 库,因为 Xcode 10 默认已不提供
libstdc++.tbd
- AndroidiOSWindows 优化自定义 config 的处理,支持通过
RemoveCustomConfigKey
接口移除业务自定义配置的 key
问题修复
- Android 修复 WebView 对部分机型的异形屏适配问题
- 修复若干已知问题
升级指引
- 本次版本支持 Android、iOS、Windows 平台
- 若游戏已接入以下任意渠道或插件,iOS SDK 需要升级到版本 12 或以上,包括 Facebook、Google、DMM、WeChat、Firebase、Adjust、AppsFlyer,详情请参见 iOS 最低版本需求
- 由于 Facebook iOS SDK V17.0.0 版本引入的新特性 - 当用户的 ATT 广告跟踪未开启时,Facebook Login 会被强制切换为 Limited Login 模式。因此若业务已接入 Facebook 渠道,需注意以下问题:
- 升级本次 SDK 版本时需要在 Player Network 控制台的 Facebook 渠道配置设置新的配置项 App type,可根据业务 Facebook 应用的类型进行选择
- 若接入 Facebook 同玩好友功能,在 Limited Login 模式下将无法获取用户昵称和头像,并且好友列表的更新机制依赖平台政策,可能存在缓存更新不及时的情况
V1.22.01
发布时间: 2024.3.14
新特性
- iOS 新增更新部分渠道的隐私清单,配合将于 2024 年春季正式纳入审核流程的 Apple 隐私清单 和 SDK 签名 政策,Player Network SDK 将继续在后续版本提供更完整支持,详见 iOS 17 隐私清单 iOS 17 隐私清单
- Console 新增 PlayStation 5 和 Xbox Series X|S 的 Unity 引擎支持
- Console 新增 Unity 引擎 2022.3 适配
- Console 新增 Unreal Engine 5.3 适配
- Console 新增适配 C++ 20
- Console 新增支持 Xbox Series X|S 平台的好友关系链功能
- All 新增支持多渠道配置的能力:
- 支持使用应用包名进行云控配置规则的拉取,Android 端使用应用的 package name, iOS 端使用应用的 bundle ID,PC 和主机平台需要在
INTLConfig.ini
中使用INTL_PACKAGE_NAME
配置应用包名 - 支持在 Player Network 控制台配置多渠道包,详细配置指引请参见 登录配置指引
- 支持使用应用包名进行云控配置规则的拉取,Android 端使用应用的 package name, iOS 端使用应用的 bundle ID,PC 和主机平台需要在
版本升级
- Console 升级 PlayStation 5 SDK 至 8.00.00
功能优化
- Console 优化支持使用 PlayStation 5 平台的系统错误弹窗展示异常报错,以满足主机的提审要求
升级指引
- 本次版本支持 Android、iOS、Windows、Console 平台
V1.22.00
发布时间: 2024.2.2
新特性
- iOS 新增支持部分隐私清单并附上接入指引,配合将于 2024 年春季正式纳入审核流程的 Apple 隐私清单 和 SDK 签名 政策,Player Network SDK 将在后续版本提供完整支持,详见 iOS 17 隐私清单
- AndroidiOSWindows 新增 Unity 引擎 2022.3 适配
- AndroidiOSWindows 新增 Unreal Engine 5.3 适配
- AndroidiOSWindows 新增适配 C++ 20
- AndroidiOS 新增支持 Adjust 的 卸载重装监测功能
- Android 新增支持 Google Play Games Services 功能,可以通过 GooglePGS 同步登录态到 Google Play PC 模拟器,详细指引请参见 Google Play Games Services
版本升级
- AndroidiOS 升级 DMM Android SDK 至 3.3.2,iOS SDK 至 3.4.2
- AndroidiOS 升级 Garena Android SDK 至4.0.31,iOS SDK 至 4.0.22
- Android 升级 Kakao 渠道 SDK 至 3.17.0
- iOS 升级 LINE 渠道 SDK 至 5.11.0
功能优化
- Windows WebView 打开合规认证页面时将屏蔽浏览器打开的按钮,不可使用系统浏览器打开合规认证页面
问题修复
- Android 解决部分机型 Google 渠道登录时停留登录页面后会闪退的问题。新配置
GOOGLE_LOGIN_FOREGROUND_SERVICE_ENABLED
用于控制 Google 渠道登录时是否启动前台服务进行保活,配置等于 1 时打开,默认为 0 关闭
升级指引
- 本次版本支持 Android、iOS、Windows 平台
- 若游戏已接入 Garena 渠道,升级本次 SDK 版本时需要添加新的配置,详细指引请参见 Garena - 入门指引
- 若游戏接入 LINE 渠道,iOS SDK 需要升级到版本 13 或以上
- 当 Unity 引擎的游戏接入 DMM 渠道时,iOS 需要在
INTLCoreiOSPostProcess.cs
文件中添加 keychain 配置,详细指引请参见 为 DMM 登录配置 SDK - 因 Twitter SDK 已经不再维护,Android 及 iOS 的 Twitter 渠道登录不再支持 App 跳转的方式;iOS 的 Twitter 渠道分享功能改为由系统分享实现,支持文本、链接和图片
V1.21.03
发布时间: 2024.1.11
新特性
- AndroidiOS 新增支持对 Google Ads 欧盟地区用户意见征求政策的解决方案
- 新增功能总开关,打开后 Google CMP 功能即生效,支持由游戏自行控制打开时机,配置项详见
ANALYTICS_CONSENT_ENABLE
- 支持自动通过 IP 预判断玩家是否为适用区域(EEA/英国)用户,并设置 Google consent mode
- 新增功能总开关,打开后 Google CMP 功能即生效,支持由游戏自行控制打开时机,配置项详见
版本升级
- AndroidiOS 升级 Firebase Analytics Android SDK 至 21.5.0,Firebase iOS SDK 至 10.17.0
升级指引
- 若游戏已接入 LI PASS,且需要使用 Google CMP 功能时,需要将 LI PASS 版本升级至 V1.13.01
- Android 若游戏已接入 Firebase,请同时升级 Android Gradle 版本至 V6.7.1,Android Gradle Plugin 版本至 V4.2.0
V1.21.02
发布时间: 2023.12.28
功能优化
- AndroidiOSWindows 优化实名认证接口内部逻辑,适用于 LI PASS 合规流程
版本升级
- AndroidiOSWindows 升级支持 LI PASS 至 V1.13.00
V1.21.01
发布时间: 2023.12.04
新特性
- Console 新增支持 Unity 引擎的 Xbox Series X|S 和 PlayStation 5 平台
功能优化
- All 优化跨平台的未成年人状态同步机制,增加多端状态及查询国家地区合规信息的接口,适用于 LI PASS 合规流程
版本升级
- AndroidiOSWindows 升级支持 LI PASS 至 V1.12.00