接入概览

星途 SDK 把游戏账号、平台钱包、订单与玩家运营能力连接到游戏。游戏方需要集成客户端 SDK，并由自己的游戏服务器完成可信身份交换。它适用于能够修改客户端和服务端的 H5、Android、iOS、Windows 游戏。

先体验，再创建自己的应用

以上地址是本机开发入口。部署到其他环境时使用平台提供的实际 HTTPS 地址，不能让远端玩家访问自己的 127.0.0.1。

交付	实际能力	需要游戏方完成
H5 SDK 安装包	无界面 JavaScript 核心、TypeScript 声明、认证、业务接口及事件	登录/悬浮球/面板 UI，游戏服务器交换回调及页面适配
H5 参考界面	可操作的 React 玩家演示	复用或改造参考界面，对接自己的游戏
Android AAR	原生登录、游戏内浮球、平台面板及业务入口	宿主 Activity 生命周期、可信交换回调、APK 与设备验收
iOS Swift Package 源码	无界面 Swift 账号、会话与业务接口，可选 Keychain	原生 UI、可信交换、Apple 编译与设备验收
开发者控制台	应用创建、维护、扩端、密钥轮换、所属订单查询与导出	应用资料、密钥保管、游戏接入及验收
可信业务服务	账号交换、演示支付、钱包分账、礼包与优惠、可信区服角色和持久化履约	真实供应商、游戏资产消费器对接和正式运营要求

H5 SDK 不会自动渲染演示中的所有界面。Android 的原生 UI 和 H5 的 UI 交付方式也不同，不能用一端的截图判断另一端已拥有完全相同的页面。

text

游戏客户端 → SDK 登录 → 一次性授权码
       ↓
游戏服务器（保存密钥）→ 平台服务器兑换身份
       ↓
游戏建立自己的玩家会话 → 进入角色与存档流程

客户端不保存服务端密钥，游戏服务器不相信客户端自行传入的“登录成功”或用户标识。平台会话与游戏业务会话分别管理，具体字段见核心概念。

当前交付用于本地接入与业务验证。短信和现金支付使用演示实现；内置角色与外部履约两种模式均有协议实现，游戏服仍需对接真实资产消费器。真实收款、短信、实名、防沉迷和厂商清结算尚需工程接入。生产模式有显式启动门禁，不是修改一个环境变量即可上线。

Android AAR 和宿主 Java 编译已验证，真机、模拟器、渠道及 Unity/Cocos 引擎实包仍需验收。iOS 为新增原生源码，Apple 编译、Keychain、设备及 StoreKit 尚未验收；不提供自动 UI。兼容要求见兼容性。