> 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/web-plugins/convai-embody.md).

# Convai Embody

查找 Convai Embody 的安装指南、API 参考和设计说明，它可在网页上为 Convai 角色渲染一个会说话的 3D 身体。

Convai Embody 会将 Convai 角色在网页中渲染为 3D 身体，并在角色说话时驱动其口型同步、视线、呼吸和眨眼。它建立在 [Convai Web SDK](/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk.md) 之上，并对两者共用一条连接，因此页面只需要一个凭证和一个角色 ID，别无其他。当前版本是 <code class="expression">space.vars.embody\_version</code>.

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>在 React 应用中添加 3D 角色</strong><br>安装该包，渲染一个角色，并确认它能进行口型同步说话。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-embody/add-a-3d-character-to-a-react-app.md">将 3D 角色添加到 React 应用</a></td></tr><tr><td><strong>在 three.js 场景中添加 3D 角色</strong><br>在现有的 three.js 渲染器和渲染循环中使用无框架 API。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-embody/add-a-3d-character-to-a-three-js-scene.md">向 three.js 场景添加 3D 角色</a></td></tr><tr><td><strong>为角色添加聊天小部件</strong><br>让用户通过同一条连接向角色输入文字并与其对话。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-embody/add-a-chat-widget-to-a-character.md">向角色添加聊天小部件</a></td></tr><tr><td><strong>React API 参考</strong><br>React 组件和 Hooks 的属性、默认值和返回值。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-embody/react-api-reference.md">React API 参考</a></td></tr><tr><td><strong>createCharacter 参考</strong><br>无框架 API 的选项和返回的角色句柄。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-embody/createcharacter-reference.md">createCharacter 参考</a></td></tr><tr><td><strong>Convai Embody 的工作原理</strong><br>角色 ID 如何变成身体，以及为什么动作按固定顺序运行。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-embody/how-convai-embody-works.md">Convai Embody 的工作原理</a></td></tr></tbody></table>


---

# 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/web-plugins/convai-embody.md?ask=<question>&goal=<user_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.