> 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/unreal-engine/guides-v2-under-development/getting-started/simple-talking-cube.md).

# 简单对话立方体

1. 创建一个新的第一人称项目。<br>

   <div align="left"><figure><img src="/files/9138bf0b21c746e785f69f86c0c762370bc36298" alt="" width="563"><figcaption></figcaption></figure></div>
2. 启用 Convai 插件，并按 [此处所述](/api-docs/zh/cha-jian-yu-ji-cheng/unreal-engine/guides-v2-under-development/getting-started/download-and-setup.md#set-up-your-project).<br>
3. 创建一个新的 Actor 蓝图，我们将其用作 AI 角色。\
   \
   ![](/files/fa10785777eb3a8cb86c2851393bebcb64ab908b)![](/files/6d955f685fec34b3297e42f04de69d95f5fbdabe)
4. 打开创建好的蓝图，然后在组件列表中搜索并添加 `Convai 聊天机器人` 组件。\
   \
   注意：如果你没有找到该组件，请确保你已按照以下 [安装指南](/api-docs/zh/cha-jian-yu-ji-cheng/unreal-engine/guides-v2-under-development/getting-started/download-and-setup.md#installing-the-plugin).<br>

   <div align="left"><figure><img src="/files/00f067ecd7873f7be33c1ee1668315336c94563f" alt="" width="563"><figcaption></figcaption></figure></div>
5. 选择已创建的组件，然后在详情面板中找到 Character ID 字段，并粘贴你的角色 ID；你可以通过创建一个新角色或使用现有角色从 [Convai Playground](broken://pages/35a85ab8078743525dfb21372f6c08398990e426).<br>

   <div align="left"><figure><img src="/files/301defe7bc1405cb504ec09d1f5f9e6470298b53" alt="" width="563"><figcaption></figcaption></figure></div>
6. 添加一个盒体组件，这样当蓝图放置在场景中时你就能看到它。<br>

   <div align="left" data-full-width="false"><figure><img src="/files/0ba30fbe53c0f63194d0ceb0403bd151efe766fc" alt="" width="563"><figcaption></figcaption></figure></div>
7. 将蓝图放置到场景中。<br>

   <div align="left"><figure><img src="/files/d01b5f47447ab65c61209c3017de2b12a04d1346" alt="" width="563"><figcaption></figcaption></figure></div>
8. 打开玩家蓝图，其默认位于 `First Person/Blueprints/BP_FirstPersonCharacter` ，用于第一人称模板。<br>

   <div align="left"><figure><img src="/files/7356e917f4e70610de64099295db3e63677b4e06" alt="" width="563"><figcaption></figcaption></figure></div>
9. 搜索并添加 `Convai 玩家` 组件到组件列表中。<br>

   <div align="left"><figure><img src="/files/d7b43ab2385eceb669d409efeed06b79e24f2e95" alt="" width="563"><figcaption></figcaption></figure></div>
10. 添加以下蓝图示意图，以便玩家可以通过 V 键与 AI 角色对话：

    1. 添加一个键盘按键事件，用作按住说话按钮（即本示例中的 \`V\` 键）。
    2. 使用 `Convai Get Looked At Character` 以获取玩家当前正在查看的角色的聊天机器人组件。
    3. 设置 `半径` 设置为一个合理的距离；如果你希望玩家可以与角色进行无限距离对话，则设为 0。
    4. 设置 `平面视图` 设置为 true 以仅考虑平面轴（X 和 Y）并忽略高度轴（Z）。这样可以避免必须直接看向角色的枢轴点，而只需看向角色所在方向即可。
    5. 使用 `开始说话` 中的节点 `Convai 玩家` 组件会启动与该角色的对话会话，请确保你已启用 `语音回复` 以让角色进行语音回应。
    6. 在 `Released` 事件，请使用 `结束对话` 在 `Convai 玩家` 组件上的节点，让 AI 角色知道我们已经结束对话，现在正在等待回复。<br>

    <div align="left"><figure><img src="/files/b1035d698fa25abf4305639703c0409d6cbafea1" alt="" width="563"><figcaption></figcaption></figure></div>
11. 点击运行，接近 AI 角色并按住 T 通过麦克风说话，然后松开 T 键后角色应会作出回应。<br>

    <div align="left"><figure><img src="/files/e112cf65449ae9f2130dae3c54da19bc6bba9a27" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
如果角色没有回应，请确保在操作系统设置中将你的麦克风正确设为默认麦克风。
{% endhint %}

## 发送文本而不是语音

使用以下 `发送文本` 节点代替，如果你想与角色进行文字聊天而不是语音聊天。

注意，这里我们使用硬编码字符串作为输入传递给角色；你需要创建所需的 UI，以从用户获取文本输入并将其发送给 AI 角色。

<figure><img src="/files/031239b00b17349babaa564bac11159c86547bd6" alt=""><figcaption></figcaption></figure>


---

# 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:

```
GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/unreal-engine/guides-v2-under-development/getting-started/simple-talking-cube.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.