Resonite虚拟形象系统概述

虚拟形象系统概述 (Avatar System Overview)

Resonite 本身并没有预设的“用户虚拟形象”及其相关行为的概念。然而，它提供了一系列 组件 (Components)，构成了一个常规且高度灵活的虚拟形象系统，能够涵盖大多数场景。与 Resonite 中的其他功能一样，你可以根据需求完全构建属于自己的系统，或者如果不需要虚拟形象，也可以完全忽略它。

本页面描述了在 Resonite 中构建虚拟形象系统背后的思路与概念，以及如何处理各种行为（如语音和移动）。

基本概念 (Basic Concepts)

Resonite 中的所有 世界 (Worlds) 都由对象层级结构（即 插槽/Slots）及其附加的组件组成。任何虚拟形象系统都是这个层级结构的一部分，用户的虚拟形象与场景中的其他对象之间没有本质区别。这正是该系统具有极高灵活性的原因。

Resonite 世界提供了 User Joined (用户加入) 和 User Left (用户离开) 事件。每当有新 用户 加入或离开 会话 (Session) 时（包括启动会话时隐式加入的本地用户），这些事件就会被调用。

注意： 用户加入会话本身不会触发任何动作。既不会生成虚拟形象，也没有语音或控制权。刚加入的用户无法与世界进行任何交互。

为了提供这些行为，你需要向世界添加一个监听这些事件的组件，例如将 SimpleUserSpawn 与 CommonAvatarBuilder 配合使用。这些组件会：

• 在世界层级结构中为新加入的用户创建新对象。
• 附加适当的组件来读取用户的输入和麦克风采样，并将其应用到场景对象中。
• 附加提供视觉效果的组件（如 3D 模型或 粒子系统）。

这一过程的所有部分完全取决于你的需求。无论你构建了什么，Resonite 都会自动将其同步给所有已加入（及未来加入）的客户端。你也可以决定是在主机 (Host)、加入的客户端还是其他客户端（如 Headless/无头客户端）上进行构建。例如，客户端可以使用其本地数据在本地构建自己的虚拟形象。

通用虚拟形象系统 (Common Avatar System)

由于虚拟形象是大多数应用的核心，Resonite 自带了一个功能强大的虚拟形象子系统，称为“通用虚拟形象系统 (Common Avatar System)”或简称 “Common Avatar”（官方世界会自动利用该系统）。该系统可以：

• 自动构建带有工具槽的 典型虚拟形象。
• 允许从云端加载用户当前活跃的虚拟形象对象。

它还包含一套 组件，可以直接在系统内从任意对象轻松构建新虚拟形象。用户可以使用导入的模型、绘图或使用 Resonite 工具制作的形状来创建虚拟形象，并使用 ProtoFlux 添加交互行为。