Unity 设计师专用资料

本节帮助 Unity 开发者高效快速熟悉如何使用 YAHAHA 项目。以恐怖项目为例，比较 Unity 与 YAHAHA Studio 的关键工作流及功能实现。

系统要求

• 操作系统：Windows x64 / macOS（Intel/ARM）
• Unity：2020.3.42f1（必需，高版本不支持）
  • 下载：Unity 2020.3.42 Release 1
• 插件：v1.7.27-preview.1（私有分发）

打开项目

在压缩包内找到 Plugin 项目：Unity project\yahahaunityplugintemplateproject

Kit包含两类场景：主场景和子场景，均与 Studio 结构对应。

主场景

主场景为持久入口点，类似 Unity 默认场景。用于存储全局配置预制件，每个预制件含 YaLuaContainer 组件，内含 Lua 脚本（如输入控制、UI 规则），与 Studio 的 游戏设置 对应但可深度定制。

Unity	Studio

创建主场景步骤：

1. 在 Assets/YahahaResources/Scenes 新建空场景。
2. 删除默认对象（Light、Camera）。
3. 使用菜单（Tools > Yahaha）中的 Prepare Scene Settings 自动配置必要预制件。

子场景

子场景包含游戏内容，运行时动态加载/卸载。每次仅激活一个子场景。例如，玩家进入谜题房间时加载子场景，离开时卸载。

场景打包流程

1. 在 Unity Build Settings 中将主场景设为首项。
2. 按游戏流程顺序添加子场景（如 Level 1、Level 2）。
3. 在主场景的 YaSubSceneConfig 组件（挂载于 Game Contents 对象）点击 Refresh Build Settings 同步场景列表。

使用预设组件

插件提供与 Studio 逻辑组件等价的预制件，如交互触发器、敌人 AI。Studio 的 行为 组件在 Unity 中对应带有 YaLuaContainer 的预制件。可对比两环境的工作流。

Unity	Studio

快捷菜单添加对象

Studio 的快捷菜单（如添加出生点、传送门）在 Unity 通过 Assets/YahahaResources/Prefabs 下的预制件实现。拖入场景即可快速搭建常用玩法元素。

Unity	Studio

绑定 Lua 组件

为对象添加逻辑：

1. 给目标对象挂载 YaLuaContainer 组件。

2. 使用 Add Lua Component 下拉菜单选择预设脚本（如 AudioPlayer）。

   

3. 在 Inspector 配置属性。如未及时显示可点击 Refresh 刷新。

示例：配置音频播放器

1. 场景中放置 Audio 预制件并禁用其 Event Trigger。

   

2. 导入音频文件（如 .mp3 或 .wav）。

   

3. 将音频添加到 Resource Items（Project 面板 > YahahaResources > ResourceItems）。

   

4. 在 AudioPlayer 组件中下拉选择音频。

   

5. 使用 Trigger Zone 预制件实现玩家进入时播放。

   

多场景设置

步骤 1：创建主场景

• 按上述主场景步骤操作。

步骤 2：构建子场景

• 子场景 A：

  • 新建场景并添加简单平台（如 Cube）。

  • 添加 Spawn Point 和 Scene Teleport Point 预制件（默认设置）。

    

• 子场景 B：

  • 复制子场景 A 并修改传送点目标场景。

步骤 3：配置打包顺序

1. 在 Build Settings 中排列场景顺序：主场景 > 子场景 A > 子场景 B。

   

2. 在主场景的 YaSubSceneConfig 组件点击 Refresh Build Settings 更新列表。

   

3. 通过 First Scene 下拉框指定初始子场景（如子场景 A）。

   

测试

打开主场景，点击 Unity 的 Play 按钮测试场景切换。