Combo SDK for Unity
若项目导出目标平台为 Windows,请联系世游技术团队获取 WebView 插件,并将其导入至工程中。
1.22.0 (2025-03-20)
FEATURES:
IMPROVEMENTS:
- Windows: 优化 本地服务 实现机制,采用动态分配端口方式,避免出现端口冲突,提升服务稳定性
- Windows: 游戏公告 WebView 增加透明背景,以适配异形边框样式
- Windows: 添加
Microsoft.Win32.Registry.dll
,以兼容.Net Standard API
- iOS: 通过 PostBuild 脚本移除了
OTHER_CFLAGS
中的-mno-thumb
选项以解决 Xcode 16 构建错误
BUG FIXES:
- Windows: WebView 补充正确的 User-Agent
- 若游戏计划发布 Windows 平台,接入该版本或更高版本时请联系世游技术团队获取最新版本 WebView 插件,否则 Windows 平台将编译报错。
- 为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 1.22.0 和 iOS 1.22.0 的发布说明。
1.20.6 (2025-03-07)
IMPROVEMENTS:
- Windows: 游戏内举报、礼包码兑换及短链接页面加载过程中添加 Loading 弹窗
1.20.5 (2025-03-06)
IMPROVEMENTS:
- Windows: 优化通过 WebView 方式打开短链接时的闪烁问题
BUG FIXES:
- Windows: 为每个游戏实例设置不同的 Chromium 缓存路径,修复多个游戏实例同时运行时打开 WebView 卡死的问题
1.20.4 (2025-03-04)
BUG FIXES:
- iOS: 通过 PostBuild 脚本在
Info.plist
文件中配置以下键,修复在联系客服时进行拍照或录像应用崩溃问题
1.20.3 (2025-03-03)
BUG FIXES:
- iOS: 通过 PostBuild 脚本在
Info.plist
文件LSApplicationQueriesSchemes
键中声明weixin
,修复发行版本未配置微信领域时无法跳转微信的问题
1.21.0 (2025-02-28)
FEATURES:
- Windows: 构建时通过包管理器获取 SDK 文件路径,以支持游戏在
Packages
目录下自定义 SDK 文件路径
IMPROVEMENTS:
- iOS: 通过 PostBuild 脚本在
Info.plist
文件中添加以下键值对,确保应用运行时状态栏始终保持隐藏
若游戏需要自行控制状态栏的显示与隐藏,可在 Xcode 工程 Info.plist
文件中手动修改该键值。
BUG FIXES:
- 修复在网络状态不佳时,世游通行证登录流程中可能连续出现两次 Loading 弹窗的问题
1.20.2 (2025-02-27)
BUG FIXES:
- Windows: 修复联想渠道登录窗口关闭后无法再次打开问题
- Windows: 修复在特定分辨率下世游通行证欢迎页面显示不全问题
1.20.1 (2025-02-25)
FEATURES:
- Windows: 支持 自定义配置
ComboSDK.json
文件路径
这是一项自定义配置,若游戏对 ComboSDK.json 文件路径没有自定义要求,则无需进行设置。
BUG FIXES:
- Windows: 游戏使用 NGUI 时在所有程序集查找
UICamera
,修复在 SDK 界面显示过程中依然能够点击游戏 UI 问题 - Windows: 修复游戏使用 NGUI 时,支付界面无法点击问题
1.20.0 (2025-02-21)
FEATURES:
- Windows: 集成 联想端游联运 SDK,支持联想 PC 联运发行版本
- Windows: 世游通行证增加人机验证安全防护机制
IMPROVEMENTS:
- Windows: 改进打开短链接机制,以支持直接跳转至微信小程序
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 1.20.0 、 iOS 1.20.0 和 CLI 1.20.0 的发布说明。
1.19.1 (2025-02-18)
BUG FIXES:
- Windows: 修复构建期间重命名目录时
.meta
文件未删除,Unity 自动重建目录引发的构建失败问题
1.19.0 (2025-02-13)
FEATURES:
ShareTarget
增加QQ
,以支持分享至 QQ 平台ShareScene
增加QQ
、QZONE
,以支持分享至 QQ 好友与 QQ 空间
IMPROVEMENTS:
- Windows: 根据
ComboSDK.json
文件自动化装配第三方渠道库,以减少游戏包体的无关组件
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 1.19.0 、 iOS 1.19.0 和 CLI 1.19.0 的发布说明。
1.18.0 (2025-01-16)
FEATURES:
RedeemGiftCodeOptions
增加GiftCode
属性,支持游戏客户端自行实现礼包码兑换 UI 的应用场景- Windows: UI 适配竖屏
IMPROVEMENTS:
- Windows: 支付发生错误时 Sentry Context 中增加订单详情以便排查问题
- WIndows: 礼包码兑换 API 添加登录状态检查
- iOS: PostBuild 根据
ComboSDK.json
文件配置自动化装配 iOS SDK 产物,且此功能已默认启用
BUG FIXES:
- Windows: 修复游戏客户端使用 NGUI 时,SDK 界面显示过程中依然能够点击游戏 UI 问题
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 1.18.0 、 iOS 1.18.0 和 CLI 1.17.0 的发布说明。
1.15.0 (2024-12-19)
FEATURES:
- 新增 API
RedeemGiftCode
,支持 礼包码 功能 - Windows: 短链接支持通过系统浏览器打开
IMPROVEMENTS:
- Windows: 未成年用户登录世游通行证后,即使能进入游戏,也会显示防沉迷提示弹窗
- iOS: PostBuild 使用一个目录装配参数文件及 iOS SDK 产物
BUG FIXES:
- 世游通行证: 修复成年用户可能被防沉迷系统强制下线问题
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 1.15.0 、 iOS 1.15.0 和 CLI 1.15.0 的发布说明。
1.14.9 (2024-12-09)
IMPROVEMENTS:
- iOS: PostBuild 支持装配百度联盟广告源资源文件
1.14.6 (2024-12-04)
FEATURES:
- Windows: 世游游戏商城支持选择商品数量
1.14.5 (2024-11-28)
FEATURES:
- 新增 本地服务,支持 WebView 网页从本地服务中加载静态资源
IMPROVEMENTS:
- Windows: 完善错误提示信息,进一步细分常见错误类型,以便排查、定位问题
- Windows: 删除世游通行证账号记录时增加二次确认弹窗
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 1.14.5 和 iOS 1.14.5。
1.14.0 (2024-11-19)
FEATURES:
- Windows: 世游游戏商城支持沙盒支付
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 1.14.0 、 iOS 1.13.0 和 CLI 1.13.0 的发布说明。
1.13.0 (2024-11-13)
FEATURES:
- 新增 API
LanguagePreference
,用于设置或获取 SDK 当前使用的语言偏好 - 新增 API
LanguageCode
,用于获取 SDK 当前使用的语言代码 - 新增 API
ResetGuest
,用于抹除当前设备存储的游客账号数据 - Windows: 支持多语言
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 1.13.0 、 iOS 1.13.0 和 CLI 1.13.0 的发布说明。
1.12.0 (2024-10-30)
IMPROVEMENTS:
- Windows: 优化世游通行证删除账号记录时弹窗中文案
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 1.12.0 和 iOS 1.12.0 的发布说明。
1.11.0 (2024-10-17)
FEATURES:
IMPROVEMENTS:
- Windows: 优化世游通行证 UI 表现
- Windows: 优化世游通行证网络请求错误处理,不再使用 StatusCode 进行业务错误判断
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 1.11.0 和 iOS 1.11.0 的发布说明。
1.10.0 (2024-09-29)
FEATURES:
- Windows: 支持 防沉迷踢出用户功能
- Windows: 支持游戏更新 获取下载链接功能
- Sentry: 支持配置
- 是否自动捕获 Unity Log Error
- 采集 BreadCrumbs 最大数量
- 采集 BreadCrumbs 日志类型
IMPROVEMENTS:
- Windows: 内置 Loading 弹窗增加显示时长阈值,解决部分场景 Loading 弹窗显示后极短时间内又快速关闭造成的闪现问题
- Windows: 优化 Purchase 方法未配置支付方式时回调的错误信息
BUG FIXES:
- Windows: 修复验证码登录页面倒计时显示异常问题
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 1.10.0 、 iOS 1.10.0 和 CLI 1.10.0 的发布说明。
1.9.0 (2024-09-12)
FEATURES:
PreloadAdOptions
和ShowAdOptions
新增scenarioId
参数- Windows: TapTap 登录新增年龄限制
IMPROVEMENTS:
- Windows: WebView 支持在浏览器中打开超链接
- Windows: 初始化流程优化
- Windows: 优化世游通行证登录页面 UI 表现
- Windows: 内部提示弹窗体验优化
- Windows: 优化 Sentry 错误上报内容
BUG FIXES:
- Windows: 修复打开短链接发生错误时回调不正确问题
- Windows: 修复打开游戏公告成功回调时机不正确问题
- Windows: 修复支付失败时无回调问题
- Windows: 修复没有配置支付方式依旧会执行支付流程问题
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 1.9.0 、 iOS 1.9.0 和 CLI 1.9.0 的发布说明。
1.8.1 (2024-08-30)
BUG FIXES:
- Windows: 修复竖屏时 WebView 显示异常问题
1.8.0 (2024-08-27)
BREAKING CHANGES:
ImageShareOptions
、VideoShareOptions
、LinkShareOptions
中移除Contents
属性,请使用Text
FEATURES:
- 支持
Unity 2022.3.x
IMPROVEMENTS:
- Windows: 优化错误处理
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 1.8.0 和 iOS 1.8.0、CLI 1.8.0 的发布说明。
1.7.0 (2024-08-14)
FEATURES:
- 新增
PromoPseudoPurchase
接口
BUG FIXES:
- Windows: 修复打开 WebView 导致输入法异常问题
DEPRECATED:
ImageShareOptions
、VideoShareOptions
、LinkShareOptions
中Contents
属性将在 v1.8.0 版本中弃用,请使用Text
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 1.7.0 和 iOS 1.7.0、CLI 1.7.0 的发布说明。
1.6.4 (2024-07-31)
FEATURES:
- Windows: 世游通行证增加匿名能力
1.6.3 (2024-07-29)
IMPROVEMENTS:
- Windows: 获取验证码增加 Loading UI
BUG FIXES:
- Windows: 修复 HttpRequest 内存泄露问题
1.6.2 (2024-07-25)
IMPROVEMENTS:
- Windows: 实名认证页面输入框增加清除内容按钮
BUG FIXES:
- Windows: 修复超链接点击位置不准确问题
1.6.1 (2024-07-23)
BUG FIXES:
- Windows: 修复无法打开游戏公告中链接问题
1.6.0 (2024-07-16)
FEATURES:
- Windows: 支持 TapTap 账号登录
- Windows: TapTap 账号强制关联世游通行证
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 1.6.1 和 iOS 1.6.0、CLI 1.6.0 的发布说明。
1.5.2 (2024-07-16)
IMPROVEMENTS:
- iOS: PostBuild 支持装配 ComboSDKBDASignal 组件
1.5.1 (2024-07-10)
BUG FIXES:
- Windows: 修复在使用 NGUI 时无法响应输入事件的问题
1.5.0 (2024-07-04)
FEATURES:
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 1.5.0 和 iOS 1.5.0 的发布说明。
1.4.0 (2024-06-27)
FEATURES:
- Windows: 支持 短链接功能
- Windows: 支持 联系客服功能
- Windows: 支持 世游通行证相关功能
- Windows: 支持 游戏 Web 页面功能
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 1.4.0 和 iOS 1.4.0、CLI 1.4.0 的发布说明。
1.3.2 (2024-06-17)
IMPROVEMENTS:
- Android: Wizard 增加
Enable Keep Rendering On Pause
,勾选时,弹出 Combo SDK 界面 Unity 将不再停止渲染
1.3.1 (2024-06-14)
FEATURES:
IMPROVEMENTS:
- iOS: 当集成
ComboSDKAgora
或ComboSDKDouyinOpen
组件时,通过 PostBuild 为 Xcode 工程添加访问相册权限
DEPRECATED:
SystemShareOptions
、TapTapShareOptions
将在 Combo SDK v1.4.0 版本中弃用,请使用全新 游戏内分享 API
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 1.3.0 和 iOS 1.3.0、CLI 1.3.1 的发布说明。
1.2.0 (2024-06-06)
FEATURES:
- 新增 短链接功能
BUG FIXES:
- ThinkingData: 修复分包信息使用缓存数据的异常问题
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 1.2.0 和 iOS 1.2.0、CLI 1.2.0 的发布说明。
1.1.0 (2024-05-30)
FEATURES:
- iOS: PostBuild 支持集成
ComboSDKBDASignal
组件
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 1.1.0 和 iOS 1.1.0 的发布说明。
1.0.0 (2024-05-23)
FEATURES:
- 新增 推送通知功能
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 1.0.0 和 iOS 1.0.0、CLI 1.0.0 的发布说明。
0.9.1 (2024-05-16)
BUG FIXES:
- 修复 iOS 平台调用
GetDownloadUrl()
无回调问题
为了更方便的集成 iOS 平台相关的新功能和改进,请参见 iOS 0.9.1的发布说明。
0.9.0 (2024-05-10)
FEATURES:
- Windows: 增加世游游戏商城
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 0.9.0 和 iOS 0.9.0、CLI 0.8.0 的发布说明。
0.8.0 (2024-04-29)
FEATURES:
- 新增
OpenGameUrl()
方法,用于使用 SDK 内置 WebView 展现特定功能的 Web 页面 - Windows: 新增密码登录与新设备验证
- Windows: 支持隐藏欢迎进入/切换账号 UI
- ThinkingData: 新增 iOS PrivacyInfo.xcprivacy 隐私清单文件
BUG FIXES:
- Android: 修复
Kickout()
无法调用的问题
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 0.8.0 和 iOS 0.8.0、CLI 0.8.0 的发布说明。
0.6.4 (2024-04-23)
IMPROVEMENTS:
- 支持设置 Native SDK 的 ThinkingData SuperProperties
0.6.3 (2024-04-19)
BUG FIXES:
- iOS: 修复 PrePostBuild 时没有勾选
EnableIOSPostBuild
仍旧会执行的问题
IMPROVEMENTS:
- Windows: 增加
Configuration
错误追踪
0.6.2 (2024-04-15)
IMPROVEMENTS:
- iOS: 当集成
ComboSDKTopOn
或ComboSDKTrackingIO
组件时,PostBuild 在Info.plist
文件中添加跟踪权限请求描述文字 —NSUserTrackingUsageDescription
- iOS: PostBuild 检查 XCFrameworks 文件夹是否包含
ComboSDK.json
中定义的组件
0.6.1 (2024-04-12)
BUG FIXES:
- iOS: 修复 iOS PostBuild 没有配置
Framework Search Paths
0.6.0 (2024-04-11)
FEATURES:
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 0.6.0 和 iOS 0.6.0、CLI 0.6.0 的发布说明。
0.5.5 (2024-04-03)
FEATURES:
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 0.5.5 和 iOS 0.5.5、CLI 0.5.5 的发布说明。
0.5.0 (2024-03-28)
BREAKING CHANGES:
- 移除
SocialShare()
,请使用Share()
FEATURES:
- 用户隐私保护指引 支持 iOS 平台
IMPROVEMENTS:
- Sentry: 关闭对 ANR 事件的捕获和报告
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 0.5.0 和 iOS 0.5.0、CLI 0.5.0 的发布说明。
0.4.1 (2024-03-20)
DEPRECATED:
SocialShare()
将在 v0.5.0 版本中移除,请使用Share()
FEATURES:
IMPROVEMENTS:
Plugins/Android
增加ComboSDKApplication.java
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 0.4.1 和 iOS 0.4.2、CLI 0.4.1 的发布说明。
0.4.0 (2024-03-14)
BREAKING CHANGES:
移动 Combo SDK 资源路径 Assets/Resources/ComboSDK
至 Assets/ComboSDK/Resources
IMPROVEMENTS:
- AndroidPostBuild: 支持自定义的 Application
BUG FIXES:
- Windows: 修复登录失败后执行登录依然触发快速登录问题
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 0.4.0 和 iOS 0.4.0、CLI 0.4.0 的发布说明。
0.3.1 (2024-03-06)
IMPROVEMENTS:
- Sentry: 关闭自动采集 Unity LogError
0.3.0 (2024-02-28)
FEATURES:
IMPROVEMENTS:
- Windows: 弹出 SDK 界面自动屏蔽 NGUI 输入事件,解决点击穿透问题
为了更方便的集成 Android 和 iOS 平台相关的新功能和改进,请参见 Android 0.3.0 和 iOS 0.3.0、CLI 0.3.0 的发布说明。
0.2.1 (2024-02-19)
BUG FIXES:
- iOS: 修复
Unity 2021.3 or later
版本中初始化失败问题
0.2.0 (2024-02-02)
BREAKING CHANGES:
Setup
不需要主动调用,改为由 Combo SDK 自行初始化。详情见- Windows:不再支持
x86
架构
BUG FIXES:
- Windows: 修复快速登录失败时无响应问题
FEATURES:
- 集成 Sentry
- 集成以下功能
- 新增
GetDeviceId()
接口 - 新增
GetGameId()
接口 - Windows: 欢迎页面新增 切换账号 入口
- Windows: 新增防沉迷限制与封禁账号登录时的提示弹窗
0.1.4 (2024-01-19)
IMPROVEMENTS:
- Windows: 优化欢迎页面实现方式
FEATURES:
- Windows: 适配
ThinkingDataSDK
0.1.3 (2024-01-16)
BREAKING CHANGES:
- Android: 使用
PostProcessBuild
替换Unity Plugin Templates
注意
- 需要移除
Assets/Plugins/Android
由 Combo SDK 生成的模板文件或者移除根据文档增量添加的Unity Templates
内容 - 确保 Combo CLI 升级至 0.1.2 or later
0.1.2 (2024-01-15)
BREAKING CHANGES:
- 最低支持
Unity 2019.4 or later
FEATURES:
- 集成
ThinkingDataSDK v3.0.1
- TopOn 支持自动关联 ThinkingData
0.1.1 (2024-01-05)
BREAKING CHANGES
- API Model 删除
ComboSDK
前缀
FEATURES
新增以下接口
GetVersion()
GetVersionNative()
GetDistro()
0.1.0 (2023-12-31)
FEATURES:
Combo SDK for Unity 功能首次提交 (支持 iOS、Android、Windows)