> For the complete documentation index, see [llms.txt](https://developers-apps-in-toss.toss.im/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers-apps-in-toss.toss.im/landing-page/landing-page-zh/checklist/app-game.md).

# 游戏发布指南

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

如果未遵守以下检查清单，或确认存在 Dark Pattern，则审核不会通过；即使在上线后发现，也可能限制服务曝光或暂停服务。

{% hint style="info" %}
**请参考**

以下上线指南中的条目会持续更新到最新。
{% endhint %}

### 接入与声音

* [ ] 迷你应用可在 10 秒内正常打开到首屏。
* [ ] 已应用背景音、效果音、触觉反馈等必要的声音功能。即使处于静音模式或系统振动关闭，也能保持预期行为。&#x20;
* [ ] 如果有声音，用户可以自行设置 On 或 Off。
* [ ] 当迷你应用切换到后台时，声音会立即停止。
* [ ] 从后台重新返回迷你应用时，声音会正常重新播放。

### UX 及导航栏

* [ ] 右上角的关闭按钮正常显示并可操作。&#x20;
* [ ] 不会侵入 Safe Area 区域。也包括 iOS 的 Dynamic Island 区域。&#x20;
* [ ] 不会在一进入迷你应用时自动弹出底部弹窗（Toss 登录、通知同意文等）。
* [ ] 不会在特定页面切换时使用底部弹窗强制引导用户行为。&#x20;
* [ ] 在所有页面中，用户都有办法退出迷你应用。&#x20;
* [ ] 看到 CTA 按钮时，可以预测点击后会继续发生什么操作。&#x20;
* [ ] 不会通过链接或组件引导跳转到自家服务或安装自家 App。&#x20;
* [ ] 应用内广告不会展示在介绍页/加载页/过场动画/弹窗模态等临时页面中。&#x20;

### 用户识别码发放

* [ ] 确认并保存用户识别符值后，游戏正常开始。
* [ ] 用户的游戏记录（例如：排名、等级、关卡等）会保留。&#x20;
* [ ] 即使退出迷你应用后再次接入，所需数据也会保留。&#x20;

### 安全性与稳定性

* [ ] 不能使用执行从外部传入代码的功能。（例如： `eval` 等）
* [ ] 无论是浏览器历史记录操作还是 WebView 嵌入等任何方式，都不能跳转到自家网站（Toss 域名之外）或渲染其内容。最终展示的内容必须在 Toss 域名内渲染。（例如： `window.location.replace`，以及加载自家域名的 WebView/iframe 嵌套等）
* [ ] 不能使用服务器端渲染（SSR）。只能使用客户端渲染（CSR）或静态站点生成（SSG）方式。
* [ ] 如果使用 WebSocket，只能使用加密的 `wss://` 连接。（例如：Firebase Firestore、Supabase Realtime 等）
* [ ] API 通信仅使用加密的 HTTPS 连接。
* [ ] 用户登录信息、支付（Toss Pay、应用内支付）记录等敏感信息必须加密后存储到数据库中。
* [ ] 建议在从客户端向自家服务器传输个人信息时也进行加密。

### 服务使用行为

* [ ] 按下 Android 系统返回键时，会返回上一页或退出迷你应用。
* [ ] 游戏内画面已实现为全屏。
* [ ] 设置的横屏模式或竖屏模式可按预期正常运行。&#x20;
* [ ] 不包含非法性或色情等可能违反法律的内容。
* [ ] 所有 UI 组件都能按预期正常运行。
* [ ] 滚动、触摸、页面切换等交互响应不会延迟 2 秒以上。&#x20;
* [ ] 位置、通知等设备权限会先取得用户同意。
* [ ] 即使用户不同意权限，其他功能也会继续正常运行。
* [ ] 不会异常地急剧增加网络使用量。
* [ ] 不会异常地急剧增加内存使用量。
* [ ] 退出迷你应用时会显示确认模态框。
* [ ] 游戏内的计分、关卡通关等主要服务流程没有错误。

### 应用内支付

* [ ] 进行应用内支付时，迷你应用中正在播放的音乐会暂停。
* [ ] 应用内支付的订单金额与 Google 或 Apple 支付窗口中显示的金额一致。&#x20;
* [ ] 应用内支付可正常进行。&#x20;
* [ ] 应用内支付完成后返回迷你应用时，支付结果可正常反映。
* [ ] 在应用内支付窗口中选择取消时，会返回订单页面。
* [ ] 因余额不足等原因支付失败时，用户可以识别失败原因。
* [ ] 应用内支付取消可正常处理。
* [ ] 用户可以确认应用内支付商品的支付记录。
* [ ] 即使更换登录到 Toss App 的设备，之前支付的应用内支付数据（道具等）也会保留。&#x20;

### 应用内广告

* [ ] 播放应用内广告时，迷你应用中正在播放的音乐会暂停。
* [ ] 遵守 Toss Ads SSP 政策。（[#](https://developers-apps-in-toss.toss.im/documentation/common/monetization/iaa/interstitial-rewarded-ad#policy))
* [ ] 非测试广告的真实应用内广告能够正常展示，并且不会在中途结束或闪退。
* [ ] 不会在用户难以预期的时刻展示应用内广告。
* [ ] 应用内广告能够正常展示，并且不会在中途结束或闪退。
* [ ] 应用内广告会提前加载。不会在广告播放时实时加载。&#x20;
* [ ] 应用内广告结束后会正常返回迷你应用画面。&#x20;
* [ ] 应用内广告结束后，迷你应用音乐会再次播放。
* [ ] 完整观看奖励广告后，奖励会正常发放。&#x20;
* [ ] 横幅广告只显示在顶部或底部。

### 分享奖励

* [ ] 设置的分享奖励页面会正常显示。&#x20;
* [ ] 关闭分享奖励页面后，会正常返回迷你应用画面。
* [ ] 好友邀请完成后，奖励会正常发放。

### WebBoard 游戏

* [ ] 使用成人认证功能联动。&#x20;
* [ ] 提供用户可咨询的客服咨询渠道。&#x20;
* [ ] 用户可以确认游戏内概率型道具的概率信息。&#x20;


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers-apps-in-toss.toss.im/landing-page/landing-page-zh/checklist/app-game.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
