> 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](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-web-sdk.md) 构建，并通过同一个连接处理这两者，因此页面只需要凭据和角色 ID。当前版本为 <code class="expression">space.vars.embody\_version</code>.

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2Fgit-blob-4c03e6bbbd731630c93e714844291966f7c15b69%2Fsample-avatars-busts.jpg?alt=media" alt="Four Convai sample avatars rendered by Convai Embody in a dark studio: two women in patterned head wraps and two men, one in a cap and tunic and one in scrubs with a stethoscope, lit by one key light with soft shadows"><figcaption><p>Convai Embody 在单一主光源下渲染的示例头像：皮肤、头发、眼睛和衣物会呈现出场景光照效果。</p></figcaption></figure>

<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>开始使用 Convai Embody</strong><br>创建一个新的 React 应用，渲染角色，并通过聊天小组件与其对话。</td><td><a href="https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-embody/get-started.md">开始使用 Convai Embody</a></td></tr><tr><td><strong>在 React 应用中添加 3D 角色</strong><br>安装软件包，渲染角色，并确认其说话时口型同步。</td><td><a href="https://docs.convai.com/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="https://docs.convai.com/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="https://docs.convai.com/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>为角色添加自定义动画</strong><br>加载自己的动画片段，在片段之间交叉淡化，并在角色说话时播放说话动画片段。</td><td><a href="https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-embody/add-your-own-animations.md">为角色添加你自己的动画</a></td></tr><tr><td><strong>使用自己的 3D 模型</strong><br>使用托管的 MetaHuman GLB 文件（Full 和 Lite 版本）渲染角色。</td><td><a href="https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/web-plugins/convai-embody/use-your-own-3d-model.md">使用你自己的 3D 模型</a></td></tr><tr><td><strong>React API 参考</strong><br>React 组件和钩子的属性、默认值及返回值。</td><td><a href="https://docs.convai.com/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="https://docs.convai.com/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 如何变成 3D 身体，以及动作为何按固定顺序运行。</td><td><a href="https://docs.convai.com/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.
