游戏上线指南

这是适用于迷你应用的通用标准和按功能划分的上线指南。上线前请务必确认内容并遵守指南。

如果未遵守以下检查清单或确认存在黑暗模式，审核将不会通过；即使在上线后被发现，服务展示也可能受到限制或中止。

请参考

以下上线指南条目会持续更新。

接入与声音

• 迷你应用可在10秒内正常打开至首屏。
• 背景音乐、音效、触感反馈等所需的声音功能已应用。即使处于静音模式或系统震动关闭，也能保持预期行为。
• 如果有声音，用户可以自行设置为开或关。
• 迷你应用切换到后台时，声音会立即停止。
• 从后台状态返回迷你应用时，声音会正常重新播放。

UX与导航栏

• 右上角的关闭按钮会正常显示并运行。
• 不会侵入 Safe Area 区域。也包括 iOS 的 Dynamic Island 区域。
• 进入迷你应用后，底部弹窗不会自动出现。
• 在特定页面切换时，不会使用底部弹窗强制引导用户行为。
• 在所有页面都要有让用户退出迷你应用的方法。
• 看到 CTA 按钮时，能够预判点击后会继续执行什么操作。
• 不会通过链接或组件引导跳转到自家服务或安装自家应用。
• 应用内广告不会显示在开场/加载/过场动画/弹窗模态等临时页面上。

用户标识键发放

• 确认并保存用户标识符值，游戏会正常开始。
• 用户的游戏记录（如排名、等级、关卡等）会被保留。
• 即使退出迷你应用后再次进入，所需数据也会被保留。

安全与稳定性

• 不能使用执行从外部传入代码的功能。（例如： eval 等）
• 不能使用通过操纵浏览器历史记录跳转到自家网站的方式。（例如： window.location.replace 等）
• 不能使用服务器端渲染（SSR）。只能使用客户端渲染（CSR）或静态站点生成（SSG）方式。
• 使用 WebSocket 时，请仅使用加密的 wss:// 连接。（例如：Firebase Firestore、Supabase Realtime 等）
• API 通信仅使用加密的 HTTPS 连接。
• 用户登录信息、支付（Toss Pay、应用内购买）记录等敏感信息必须加密后存储到数据库中。
• 建议在从客户端向自有服务器传输个人信息时也进行加密。

服务使用行为

• 按下 Android 系统返回键后，会返回上一页或退出迷你应用。
• 游戏内画面以全屏形式实现。
• 设置的横屏模式或竖屏模式会按预期正常运行。
• 不包含可能涉及违法的内容，如非法性或色情性等。
• 所有 UI 组件都按预期正常运行。
• 滚动、触控、页面切换等交互响应不会延迟超过2秒。
• 位置、通知等设备权限需先获得用户同意。
• 即使用户不同意权限，其余功能也会继续正常运行。
• 网络使用量不会异常激增。
• 内存使用量不会异常激增。
• 退出迷你应用时会显示确认模态框。
• 游戏内计分、关卡通关等主要服务流程没有错误。

应用内购买

• 进行应用内购买时，迷你应用中正在播放的音乐会暂停。
• 应用内购买订单金额与 Google 或 Apple 支付窗口中显示的金额一致。
• 应用内购买会正常进行。
• 应用内购买完成后返回迷你应用时，支付结果会正常反映。
• 在应用内购买窗口选择取消后，会返回订单页面。
• 因余额不足等原因支付失败时，用户能够了解失败原因。
• 应用内购买取消会正常处理。
• 用户可以查看应用内购买商品的支付记录。
• 即使更换了登录 Toss 应用的设备，之前购买的应用内购买数据（如道具等）也会保留。

应用内广告

• 应用内广告播放时，迷你应用中正在播放的音乐会暂停。
• 遵守 Toss Ads SSP 政策。（#)
• 非测试广告的真实应用内广告会正常展示，不会中途结束或闪退。
• 不会在用户难以预料的时机展示应用内广告。
• 应用内广告会正常展示，不会中途结束或闪退。
• 应用内广告会提前加载，不会在播放时实时加载。
• 应用内广告结束后会正常返回迷你应用页面。
• 应用内广告结束后，迷你应用音乐会再次播放。
• 将奖励广告完整观看到底后，奖励会正常发放。
• 横幅广告仅位于顶部或底部。

分享奖励

• 设置的分享奖励页面会正常显示。
• 关闭分享奖励页面后，会正常返回迷你应用页面。
• 好友邀请完成后，奖励会正常发放。

Web Board 游戏

• 使用成人认证功能联动。
• 提供用户可进行咨询的客服渠道。
• 用户可以查看游戏内概率型道具的概率信息。