阅读主题
四端与引擎支持矩阵
本版本交付 H5、Android、iOS、Windows 与 Unity / Cocos 接入代码。以下区分已执行验证和需要外部工具链的验收,版本号不是正式上线认证。
| 接入方式 | 交付物 | 已执行验证 / 限制 |
|---|---|---|
| H5 | npm TGZ,ESM/CJS/IIFE 与类型声明 | Node 协议测试、包消费与本地浏览器流程 |
| Android | Java AAR、宿主与引擎门面 | Java 编译、真实 HTTP 的 JVM 协议测试;设备与 Release/R8 待验收 |
| iOS / iPadOS | Swift Package 源码与引擎门面 | Swift 语法检查;本机无 Xcode,未编译或运行 Apple 测试 |
| Windows | C# 双目标程序集、源码、示例 | .NET 8 / netstandard2.1 编译和本机协议测试;游戏宿主全屏/DPI/发行包另测 |
| Unity | UPM 包,Android/iOS/Windows 桥接 | C# 核心与协议编译测试;Unity Editor、IL2CPP、目标设备待验收 |
| Cocos | TypeScript Web/native 适配器及桥接源码 | TypeScript 编译、Web/native 协议;Creator 导出与设备待验收 |
Windows 本次选择可编译、可复用的托管 C# 程序集,没有将托管 DLL 冒充任意 C/C++ 都能调用的原生 C ABI。C++ 自研引擎要另做明确的 ABI 包装;Unity 使用对应 C# 适配器。
首发渠道和商户沙箱未确定;真实支付、Apple / Steam 身份、Google Play / 国内厂商渠道、微信/抖音小游戏尚未完成接入。macOS、Linux、HarmonyOS NEXT、Unreal、Godot与主机不是本次已支持平台。
一次接入需要两部分
客户端负责 PKCE 授权、会话恢复与业务调用。可信游戏服务器保存密钥并交换授权、绑定角色、执行持久化幂等发货和回收。不能给已有 APK、IPA 或 EXE 简单加配置就完成集成。
平台已提供区服管理、可信多角色绑定及 external 模式发货/回收队列,实际游戏服仍需接入和验收。客户端使用本人绑定 id 作为发货目标;默认 local 演示角色不等于真实游戏角色。外部礼包的领取成功、订单 paid 与游戏到账是不同状态,应按 orderId 查询到 fulfilled 后展示确认发放。
v0.2.1 修复 iOS Order 的履约/角色/礼包来源字段丢失,并保持旧本地订单兼容。Windows/Unity 的 47 项本地集成断言与 Cocos 的 8 项协议测试通过;Swift 仅做语法检查,源码中的 17 个 XCTest 尚未在 Mac 执行。