Unity 中的 XML 文件夹工作流

XML 文件夹工作流中，开发人员可以创建一个特殊 Harmony 导入器资产，引用从 Harmony 导出的 XML 文件夹。 然后使用此导入器生成 Harmony 项目资产和新的 Harmony Renderer prefab。

开发人员需要对每个重新导出的 XML 文件手动设置导入和导出路径，并从 Harmony 导入器资产执行导入过程。

该工作流使 XML 数据存放位置灵活。 例如，可存于 Unity 项目内，也可以存于项目外。 但此工作流涉及更多步骤，因此错误的几率更大，这是它的缺点。 例如，移动文件时，TBG 导入器的文件路径必须手动更新。

生成的 Harmony Renderer prefab 在 C++ 插件中生成网格，实现高性能角色渲染。 这种方式适合不需要复杂的自定义服装渲染功能的角色群。

  1. 在 Harmony 的 Game（游戏）工具栏找到 Export to Sprite Sheet（导出至 Sprite Sheet） 按钮。

  2. 选择 Save and Export（保存并导出）。 确认 Export to Sprite Sheet（导出至 Sprite Sheet）对话框中未勾选 Export as TBG（导出为 TBG）选项。

  3. 将 XML 保存到 Unity 项目 Assets（资产）文件夹内的一个文件夹。

  4. 在 Unity，执行下列操作之一新建 Harmony 导入器：

    • 在顶部菜单的 Assets（资产）下拉菜单选择 Create（创建） > Harmony Project Import（Harmony 项目导入）。

    • 右键单击 Project（项目）视图中的 Assets（资产）文件夹，选择 Create（创建） > Harmony Project Import（Harmony 项目导入）。

  5. 命名该 Harmony 导入器，需包含“Importer”后缀，避免以后混淆。

  6. 复制导出的文件夹的相对路径，粘贴到新建的 Harmony 导入器中。

  7. 复制 Harmony 导入器资产的相对路径，粘贴到 Harmony 导入器中，将路径中的“Importer”替换为“Project”。

  8. 单击 Import（导入）。

    这样就创建了一个新的 HarmonyProject 资产以及一个带 Harmony 渲染器（引用 HarmonyProject）的新 Prefab。

    9. 该 Prefab 资产可从“项目”视图拖入“层级”视图和 Scene View 中，使游戏显示角色

导入锚点

Harmony 中，锚点指示哪些定位钉和绘图是 Unity 的游戏脚本感兴趣的位置。 锚点可以分配任意绘图或定位钉。

  1. 在“时间轴”视图中选择一个图层或在“节点”视图中选择一个节点，然后选择 Game（游戏）工具栏中的 Toggle Anchor （切换锚点）按钮。

  2. 将角色导入 Unity。 参见如何将 XML 文件夹导入 Unity

下次执行 XML 导入时，新锚点将位于 Unity 中角色的导入 Prefab 下方，显示为新的 HarmonyAnchor。

此新增 GameObject 将跟随角色当前动画播放的姿态、旋转和缩放。 这样可以将游戏对象作为子对象动态附加到锚点，进行携带、装备和使用。

注意 移动锚点位置不影响 Harmony 渲染器的视觉效果。 若要查看和影响 Unity 中角色的整个结构而不仅仅是锚点，可以考虑使用 TBG 工作流

添加音源

在 Harmony 创建带音频的场景文件时，该音频导出位置是项目文件夹。 Harmony 导入器会自动创建一个 AudioSource 并添加到所生成的 Prefab。 之后，Harmony 渲染器将在动画播放期间某个点触发 AudioClip 文件播放，与 Harmony 中的创作相同。