> 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/documentation/api-and-sdk-zh/unity/overview.md).

# 概览

这是 Toss Unity SDK 的文档列表。请从你要做的事情开始查找。

### 如果是第一次

| 文档                                                                                                     | 内容                       |
| ------------------------------------------------------------------------------------------------------ | ------------------------ |
| [开始使用](https://developers-apps-in-toss.toss.im/documentation/unity/first-steps/getting-started)        | 安装、安装 ref 管理、设置、首次构建     |
| [API 使用模式](https://developers-apps-in-toss.toss.im/documentation/unity/first-steps/api-usage-patterns) | async/await、错误处理、Mock 桥接 |
| [问题排查](https://developers-apps-in-toss.toss.im/documentation/unity/first-steps/faq)                    | 常见卡点和解决方法                |

### 添加功能

| 文档                                                                                                      | 内容                             |
| ------------------------------------------------------------------------------------------------------- | ------------------------------ |
| [广告集成](https://developers-apps-in-toss.toss.im/documentation/unity/add-features/advertising)            | 插页·横幅·AdMob 广告， `adGroupId` 使用 |
| [SDK事件日志记录](https://developers-apps-in-toss.toss.im/documentation/unity/add-features/metrics)           | SDK 自动记录的事件和参数                 |
| [Sentry集成](https://developers-apps-in-toss.toss.im/documentation/unity/add-features/sentry-integration) | 运行时错误收集，AIT 上下文自动注入            |

### 处理构建

| 文档                                                                                                        | 内容                                                         |
| --------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| [构建配置文件](https://developers-apps-in-toss.toss.im/documentation/unity/build/build-profiles)                | Dev Server、Build & Package、Deploy（Test）、Deploy（Production） |
| [构建自定义](https://developers-apps-in-toss.toss.im/documentation/unity/build/build-customization)            | 修改 Web 入口点、添加外部库、标记区域                                      |
| [加载画面自定义](https://developers-apps-in-toss.toss.im/documentation/unity/build/loading-screen-customization) | 替换加载界面和 `AITLoading` API                                   |
| [构建流水线](https://developers-apps-in-toss.toss.im/documentation/unity/build/build-process)                  | 从 Unity WebGL 构建到打包的内部工作机制                                 |

### API 变更历史

SDK 暴露的 C# 接口层 `@apps-in-toss/web-framework` 是记录其如何随版本变化的报告。 `main`每次推送到时，CI 都会重新生成并 [changelog/index.html](https://toss.github.io/apps-in-toss-unity-sdk/docs/changelog/index.html)会提交到其中。使用相同数据生成的 Markdown 报告（[changelog/api-changelog.md](https://github.com/toss/apps-in-toss-unity-sdk/blob/main/Documentation~/changelog/api-changelog.md)）也会一并生成并提交；如果已配置 GitBook 集成（如 GITBOOK\_TOKEN 等 secrets），还会自动同步到 GitBook 的 changelog 页面。

Unity SDK 包版本是 `SDK 更新` 工作流 `@apps-in-toss/web-framework` 会直接沿用版本号，因此两个编号是相同的（例如：包 `3.0.1` = web-framework `3.0.1` = 标签 `release/v3.0.1`）。发行说明和安装标签列表在 [GitHub Releases](https://github.com/toss/apps-in-toss-unity-sdk/releases)中查看。


---

# 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/documentation/api-and-sdk-zh/unity/overview.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.