Skip to Content
1. 快速开始

简介:统一协议

欢迎使用 Playsout Hybrid SDK!该 SDK 使得游戏工作室 (Game Studios) 能够编写一套代码库,同时允许宿主应用 (App Hosts) (如钱包、超级应用、Web 游戏平台) 无缝提供连接原生应用和 Web 视图的各项能力 (例如登录、支付)。

1. 架构总览

SDK 实现了统一协议 (Unified Protocol) v1.0。它作为一个智能运行时,可自动探测其所处的环境,并将您的调用路由到能力最匹配的适配器。

2. 协议分层

为了保持集成的简便性,协议被划分为基础 (Core) (必须实现) 和高级 (Advanced) (可选增强) 模块。如果宿主环境不支持高级模块,SDK 会妥善处理优雅降级。

层级模块说明宿主支持范围
基础协议runtime基础 SDK 配置及能力检测原生, 钱包, Web
基础协议identity.get被动身份获取 (匿名或已认证)原生, 钱包, Web
基础协议storage持久化键值存储 (若在原生环境中则为安全存储)原生, 钱包, Web
基础协议ui基础交互 (Toast 提示, 打开链接)原生, 钱包, Web
高级协议identity.signIn主动认证 (SIWE / OAuth / Token)原生, 钱包
高级协议pay购买流程和商品目录同步原生, 钱包
高级协议account网络/区块链管理钱包

3. 下一步去哪里?

根据您的角色,请前往对应的指南:

  • 🎮 游戏工作室指南: 如何在您的 Web 游戏中安装 SDK、初始化以并使用各个模块。
  • 📱 宿主接入指南: 如何将所需的 Bridge 注入您的 WebView 或扩展中,从而为游戏提供更强的能力。
  • 📖 API 参考: 一览所有接口、返回类型与错误码细节。