接入概览

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

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

官网构建会将导航链接映射到实际部署地址；代码块内的本机地址仍是本地示例。正式入口、域名职责及开户限制见正式环境与演示环境。

交付	实际能力	需要游戏方完成
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 登录 → 一次性授权码
       ↓
游戏服务器（保存密钥）→ 平台服务器兑换身份
       ↓
游戏建立自己的玩家会话 → 进入角色与存档流程

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

正式基础控制台与 SDK 服务已经部署，演示环境独立保留。正式模式禁用演示短信、支付和钱包变动，外部角色履约默认为 external；本地模式仍可验证模拟交易。真实收款、短信、实名、防沉迷和厂商清结算尚需工程接入，真实游戏服资产消费者及设备仍须验收。生产启动需要独立数据库和显式安全配置。

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