> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin/utilities/convai-ui-prefabs.md).
# 预构建 UI 预制体
Convai UI 预制体——利用可直接使用的 UI 元素来进行 Convai 集成。
我们提供多种开箱即用的 UI 选项，用于显示角色和用户的转录文本，玩家可以与 Convai 插件一起使用。你可以使用并自定义这些预制体。
ConvaiNPC 和 ConvaiGRPCAPI 脚本会查找带有 Convai Chat UI Handler 组件的 GameObject，并将任何转录文本发送到该脚本，以便显示在屏幕上。
## UI 类型
### 聊天框
**预制体名称**：Convai Transcript Canvas - 聊天
用户和角色的转录文本会依次显示在一个可滚动的聊天框中。
### 字幕
**预制体名称**：Convai Transcript Canvas - 字幕
用户和角色的转录文本会像字幕一样显示在底部。
### 问答
**预制体名称**：Convai Transcript Canvas - 问答
用户的转录文本显示在顶部，而角色的转录文本显示在底部。
### 移动端优化的 UI 样式
**预制体名称**：Convai Transcript Canvas - 移动端字幕
与 [#subtitle](#subtitle "mention") UI 相同。包含一个可按住的按钮，供用户说话。非常适合屏幕纵向模式。
**预制体名称**：Convai Transcript Canvas - 移动端问答
**预制体名称**：Convai Transcript Canvas - 移动端聊天
## [Convai Chat UI Handler 组件](/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin/utilities/transcript-ui-system.md)
### 需要了解的函数
发送角色文本
一个公共函数，用于发送一段文本，以显示为角色转录文本，并附带说出该文本的角色名称。
发送用户文本
一个公共函数，用于发送一段文本，以显示为用户转录文本。
---
# 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin/utilities/convai-ui-prefabs.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
