关于 Harmony Unity SDK

Toon Boom 在 Unity Assets store 提供一个 Unity 资源包，包含导入从 Harmony 导出的数据所需的脚本。 解压到 Unity 新项目后，Toon Boom Harmony Gaming SDK 文件夹结构内含：

  • 程序说明（开发人员为主的 Unity 集成信息）

  • 插件（SDK 文件库）

  • 样本（演示场景、导出器脚本、SDK 源以及一个预览程序）

  • 运行时间（游戏播放时执行的 Harmony 脚本）

  • 编辑器（仅在编辑器运行的 Harmony 脚本，不出现在 build 内）

  • Shader（提供正确渲染 Harmony 特定功能的 shader）

  • 材质（使用 Harmony shader 的预制材质）

这些资源包可通过 Unity 的 Package Manager（包管理器）界面手动管理。 如果更新的 Unity 版本与 Harmony 脚本的包不兼容，开发人员可对资源包升级和降级。

  1. 创建一个空的 Unity 游戏项目。 建议您创建一个空的 2D Unity 游戏项目，这种项目最便于处理 2D 渲染和物理。

    注意 务必使用的 Unity 2020.3.36 或更高版本，此前版本的 Unity 不具备支持导入和渲染 TBG 文件的必要功能。

  2. 在 Unity Asset Store 安装 Harmony Game SDK。 如果 SDK 是手动下载的，可以在 Unity 项目打开时双击 .unitypackage 文件。

    此时会弹出 Additional Packages Requested（已请求附加包）窗口，确保您拥有运行时优化 2D 动画的兼容 Unity 包。

  3. 单击 Download（下载）。

Unity 下载完所需的包并编译完所有脚本后，项目就可以开始导入 Harmony 角色了。

提示 安装 Toon Boom Harmony Game SDK 后，必须将 Harmony SDK 包导入到每个在 Harmony 中新建的项目。

  1. 选择 Window（窗口）> Asset Store，打开 Asset Store。 此时会打开 Asset Store 选项卡。

  2. 在 Asset Store 中选择 Open Package Manager（打开包管理器）。 此时会打开 Package Manager（包管理器）窗口。

  3. 包管理器左上角的包下拉菜单有四个选项：

    • Packages: Unity Registry（包：Unity 注册表）

    • Packages: In Project（包：项目内）

    • Packages: My Assets（包：我的资产）

    • Packages: Built-in（包：内置）

  4. 选择 Packages: My Assets（包：我的资产）。

    下载的资产将显示在下方列表中。 Package Manager（包管理器）选项卡右侧会显示所选资产的信息。

  5. 选定 Harmony 包后，选择包管理器底部的 Import（导入）。 此时会出现显示资产文件的 Import Unity Package（导入 Unity 包）窗口。

  6. 选择 Import（导入）。