Unity_StageLightManeuver 的安装和配置教程

项目基础介绍

Unity_StageLightManeuver 是一个开源项目，旨在为 Unity 的 Timeline 提供一种直观的照明设计工具。它允许用户在 Unity 的 Timeline 上设计照明演出，支持 DMX 和 Artnet 照明控制系统的特性，使得创建接近实际现场照明的演出成为可能。该项目的编程语言主要是 C#。

项目使用的关键技术和框架

此项目主要利用了 Unity 的 Timeline 系统，并且与 Volumetric Light Beam (VLB) 技术相兼容。它使用了 Unity Render Pipelines (URP 或 HDRP)，这些是 Unity 提供的高性能渲染管线，用于优化图形渲染。

项目安装和配置的准备工作

在开始安装 Unity_StageLightManeuver 之前，请确保您的开发环境满足以下要求：

• Unity 版本：2021.3.6f1 或更高版本
• 渲染管线：URP (Unity Render Pipeline) 或 HDRP (High Definition Render Pipeline)
• （可选）Volumetric Light Beam 插件

安装步骤

1. 安装 Unity 插件

   • 打开 Unity 编辑器。
   • 转到 Window > Package Manager。
   • 选择 Add package from git URL...。
   • 输入以下 Git URL 并点击 Add：https://github.com/murasaqi/Unity_StageLightManeuver.git?path=/jp.iridescenet.stagelightmaneuver

2. 配置 Unity 项目

   • 确保你的 Unity 项目设置为使用 URP 或 HDRP。

   • 如果你的项目需要使用 Volumetric Light Beam，你需要按照以下步骤进行额外的配置：

     a. 从 Unity Asset Store 下载并安装 Volumetric Light Beam 插件。

     b. 在 VLB 的文件夹中创建一个名为 com.saladgamer.volumetriclightbeam 的 Assembly Definition 文件，并将平台设置为 Any。

     c. 如果你的项目使用 URP，将 Unity.RenderPipelines.Universal.Runtime 添加到 Assembly Definition References 中。

     d. 将 VLB 文件夹移动到项目的 Packages 文件夹下。

     e. 如果你遇到任何问题，你可能需要检查 Edit > Project Settings > Player > Other Settings > Scripting Define Symbols，确保其中没有 USE_VLB。

3. 使用预设灯体

   • 将预设灯体从 Resources/SLSAssets/Lights/ 文件夹拖拽到场景中。
   • 根据需要调整 LightFixture 和 LightChannel 的设置。

4. 初始化 Stage Light Universe

   • 将所有灯体作为拥有 Stage Light Universe 组件的游戏对象的孩子。
   • 在 Stage Light Universe 组件上使用上下文菜单执行 Find Stage Light Fixtures 和 Initialize。

5. 创建 Timeline 轨道

   • 在 Timeline 中创建一个新的 Stage Light Timeline Track。
   • 将 Stage Light Universe 绑定到该轨道。
   • 添加剪辑到轨道，系统会根据灯体的对应通道自动添加属性。
   • 调整剪辑中的属性，灯体会根据设置进行相应的控制。

按照以上步骤操作后，Unity_StageLightManeuver 应该就可以在你的 Unity 项目中正常工作了。