For the complete documentation index, see llms.txt. This page is also available as Markdown.

情绪快速入门

将 Convai Emotion 组件添加到角色,运行其设置清单,并在 Play 模式中看到面部随对话作出反应。

添加 ConvaiEmotionController 将其应用到现有的 Convai 角色,为其指定一个角色类型,并确认其面部在 Play 模式下会对对话做出反应。等你已经有一个可用的 ConvaiCharacter 已放入场景中,并希望在调整任何设置之前先查看 Emotion 是否运行。


前提条件

  • 某个 ConvaiCharacter 在你的场景中,已经可以连接并响应——先完成 验证你的设置 如果你还没有的话,请先完成。

  • 一个带骨骼绑定的面部网格,其 blendshape 遵循受支持的命名约定(ARKit、Reallusion CC3、Reallusion CC4 Extended 或 MetaHuman)。对于其他任何命名约定,请指定一个 CustomRigConventionMap 先——参见 角色骨骼设置.

Emotion 不需要 ConvaiEmotionProfile 资源即可运行。仅添加该组件就会以 SDK 内置默认值运行——执行下面的设置会为角色赋予一个初始人格,而不是让每个设置都保持默认。


添加并设置 Emotion 组件

1

选择角色

在 Hierarchy 中,选择 GameObject 携带 ConvaiCharacter 组件。

2

添加 Emotion 组件

在 Inspector 中,选择 Add Component,然后 Convai > 具身化 > Emotion。这会添加 ConvaiEmotionController 到角色上。

Convai 还会添加该模块所需的基础结构——一个 EmbodimentContext、一个 StandardRigBinding,以及内部的 MoodCommandHandlerAdapter 它可让 Convai 的回复自动设置此角色的心情——你无需自行添加其中任何一个。

3

阅读设置清单

ConvaiEmotionController 检查器会打开一个清单: Character, 面部, 面部骨骼绑定,以及 人格。每一行都会报告它找到的内容;无法解析的行会指出修复方法。

4

选择一种角色类型并运行设置

选择四个中的一种 角色类型 按钮——Composed、Warm、Energetic 或 Reserved——然后选择 设置情绪。这会在角色的预制体旁创建一个人格资源,并将其分配给 人格 字段,并报告它找到的内容。无需其他操作。


验证设置

进入 Play 模式并与角色对话。随着 Convai 的回复到来,检查器的 Live 部分会更新: 感受 显示当前激活的情绪,而 强度 显示其强度,而 心情 显示回合之间角色的静息心情。

若要在不与角色对话的情况下预览表情,请使用检查器的 Live 部分:选择一种情绪,设置强度,然后选择 试试;选择 停止 以释放它。


工作原理

与角色对话会随回复向 Convai 发送一个情绪信号。 ConvaiEmotionController 通过情绪分类体系解析该信号,平滑其强度,并通过共享面部合成器将其合成到角色面部上。完整流程请参见 情绪系统的工作原理.


故障排除

如果清单报告 面部骨骼绑定 为未解析,或者设置完成后面部没有任何动作,请参见 情绪故障排查.


下一步

情绪系统如何工作情绪状态情绪配置文件

最后更新于

这有帮助吗?