Skip to main content

场景组件

每个你想带入 VRChat 的 Unity 场景都需要一个 VRC_SceneDescriptor 组件。VRChat 世界 SDK 包含各种其他组件,允许用户与你的世界交互、拾取物体、在镜子中看到自己等。

请查阅白名单世界组件获取 VRChat SDK 中可用组件的完整列表。

组件描述
TextMesh Pro用于显示高质量文本。
VRC_AvatarPedestal用于展示和/或切换虚拟形象。
VRC_MirrorReflection用于在 VRChat 中创建镜子。
VRC_ObjectSync同步游戏对象的变换与实例中所有玩家。
VRC_Pickup允许物体被玩家拾取、持有和使用。
VRC_PortalMarker创建通往其他 VRChat 世界的传送门。
VRC_SceneDescriptor描述你的 VRChat 世界。每个要用作 VRChat 世界的 Unity 场景都需要它。
VRC_SpatialAudioSource为 Unity AudioSource 添加 3D 空间化效果。通常在编辑器中随 AudioSource 组件自动添加。
VRC_Station允许用户坐下。
VRC_UIShape允许用户与 Unity 的 UI 系统交互。
VRC Camera Dolly允许将相机轨道动画应用于 VRChat 用户相机。
VRC Phys Bone为世界中的对象添加基于物理的二次运动。
VRC Phys Bone Collider定义 PhysBones 可以碰撞的碰撞形状。
VRC Phys Bone Root定义一组 PhysBones 的根变换。
VRC Contact Sender被 Contact Receiver 检测,在碰撞开始和结束时触发世界行为。
VRC Contact Receiver检测 Contact Sender,在碰撞开始和结束时触发世界行为。
VRC Constraints作为 Unity 约束的直接替代品,允许变换以各种方式相对移动。

世界 PhysBone 和 Contact 限制​

出于性能原因,在当前加载的世界中,活跃的 PhysBones 和 PhysBone Colliders 总数限制为 1024 个,同时活跃的 Contacts 也单独限制为 1024 个。具体来说:

  • 如果世界中活跃的 PhysBones 和 PhysBone Colliders 总数达到 1024,则进一步的 PhysBones 和 PhysBone Colliders 将无法工作,直到部分现有组件被禁用或销毁。
  • 如果世界中活跃的 Contact Senders 和 Contact Receivers 总数达到 1024,则进一步的 Contacts 将无法工作,直到部分现有组件被禁用或销毁。

如果这些组件的总数超过任一限制,SDK 将显示警告。但是,只要你确保同一时间活跃的每种组件不超过 1024 个,就可以忽略这些警告。