端到端集成流程
在保障宿主环境控制力的同时，最大化研发效率。
01
统一登录
Web2 OAuth 与 Web3 钱包，统一登录流程。
02
支付流程
Web2 与 Web3 的无缝支付体验。
03
权益同步
本地恢复起步，支持服务端升级。
04
链/账户事件
链/账户变更统一回调。
面向宿主环境的企业级保障
合规友好、可审计、可演进的集成边界。
01
策略治理
价格与链规则由配置控制，而非客户端参数。
02
审计能力
确定性购买日志与事件回放。
03
版本纪律
SDK 版本化与迁移指南。
04
风控能力
环境开关、商品白名单、可选服务端校验。
游戏团队的开发效率
一次接入，多宿主环境复用，SDK 表面保持最小。
Web2/Web3 宿主统一 SDK
保持一致的宿主 WebView 接入方式。
仅 productId 参数
无需前端传金额或 token 计算。
示例工程 + 测试流程
配套参考项目与 QA 清单。
最小购买流程
安装
npm install @playsout/hybrid-sdkimport { PHSDK } from "@playsout/hybrid-sdk";
const sdk = await PHSDK.init({
pay: { productMapping }
});
const result = await sdk.pay.purchase({
productId: "coin_pack_1"
});常见问题
宿主 App 需要原生改动吗？
v0.1 仅需 WebView JS（EIP-1193），后续可选原生增强。
定价如何控制？
productMapping 统一定义 token / 链 / 收款方 / 金额，客户端仅传 productId。
权益可以接服务端吗？
可以，支持升级到服务端权益或原生安全存储。