> 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 Update` 工作流会 `@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.