开发者 SDK
Playzly 提供两套 SDK，覆盖 Web 平台与 App 平台的 H5 游戏开发场景。直接引入单文件即可使用，无需构建工具。推荐用相对路径 /sdk/...，不绑定具体域名。
选择你的平台
根据 H5 游戏运行环境选择对应的 SDK。
Playzly Game SDK
H5 游戏（运行于 Playzly Web iframe）
v0.2.5稳定版
适用于在 Playzly Web 平台运行的 H5 游戏。通过 postMessage 与宿主页面通信，实现广告、生命周期上报等功能。
直接引入（推荐 · 相对路径）
<script src="/sdk/playnova-game-sdk-0.2.5.js"></script>当前站点完整 URL
<script src="https://playzly.lemo-ai.com/sdk/playnova-game-sdk-0.2.5.js"></script>NPM 安装
npm install @playnova/game-sdk全局变量: window.PlayNova · 游戏包在独立 CDN 时，将 public/sdk/ 同步到 CDN 同路径，或配置环境变量 NEXT_PUBLIC_SDK_BASE_URL。
快速上手
<!-- 在 index.html 中引入（相对路径，不绑定域名） -->
<script src="/sdk/playnova-game-sdk-0.2.0.js"></script>
<script>
const { pn, Placement } = PlayNova;
pn.ready({ gameId: 'my-game' });
// 预加载广告
pn.ads.preload({
types: ['rewarded', 'interstitial'],
onReady: (loaded) => console.log('preloaded', loaded),
});
// 激励广告
pn.ads.showRewarded({
placement: Placement.REVIVE,
reward: { type: 'life', amount: 1 },
onCompleted: () => revivePlayer(),
onDismissed: () => showRetryButton(),
onFailed: (reason) => console.warn('ad failed:', reason),
});
// 分享战绩
pn.share({
title: 'I just scored on PlayNova!',
score: 1200,
onDone: () => console.log('shared'),
});
// Banner 高度适配
const h = pn.ads.getBannerHeight();
pn.score({ gameId: 'my-game', score: 1200, result: 'win' });
</script>版本历史
v0.2.5stable2026-10-21
- pn.ads.preload() — 预加载激励/插屏/Banner，减少展示延迟
- pn.share() — 游戏内分享（支持 score 战绩文案，宿主 Web Share / 剪贴板）
- pn.ads.getBannerHeight() — 获取 Banner 高度以适配布局
v0.2.4stable2026-08-18
- pn.ready() — 通知宿主游戏初始化完成
- pn.score() — 单局分数上报
- pn.achievement() — 成就进度上报
- pn.pause() / pn.resume() — 游戏主动暂停/恢复
- pn.listenHost() — 监听宿主 pause/resume 事件
- pn.ads.showRewarded() — 激励视频（自动 load→show，带超时/回调）
- pn.ads.showInterstitial() — 插屏广告
- pn.ads.showBanner() / hideBanner() — Banner 展示/隐藏
v0.2.0stable2026-08-12
v0.1.0stable2026-08-11
