将旧版本的项目迁移到Cubism 5 SDK

最終更新： 2023年8月17日

此页面包含有关Beta版的描述。

概述

发布Cubism 5 SDK时，我们将在这个页面中为您介绍从旧版本迁移的优点和缺点、以及简单的流程图。

在说明之前，Cubism 5 SDK发布后对Cubism 4.2 SDK、Cubism 4 SDK、Cubism 3 SDK、Cubism 2.1 SDK的处理如下。

• 停止新下载，且今后不再更新
• 将来不会支持任何新功能
• 单独以错误为对象，仅在有错误报告时修复

从3 SDK、4 SDK、4.2 SDK迁移到5 SDK

Cubism 3 SDK、Cubism 4 SDK、Cubism 4.2 SDK的用户迁移到Cubism 5 SDK时的优点和缺点如下所示。

优点

• 可以使用新功能（反转蒙版） * 对于跳帧功能和扩展插值，Cubism 3、Cubism 4、Cubism 4.2等效项也可用于输出的嵌入数据。
• 您可以继续使用通过Cubism 3 Editor、Cubism 4 Editor、Cubism 4.2 Editor创建的模型。（向下兼容）

缺点

• 由于增强了 blendshape 功能，Cubism Core 的处理速度比 Cubism 4.2 略慢。
• 该框架的渲染功能已进行了重大重构，因此如果你使用的是定制版的 Cubism SDK，则应小心谨慎。

流程图

Cubism 5 SDK的结构相比Cubism 3 SDK基本没有变更。SDK迁移时进行更换后，如有需要可通过重新构建使用。
在SDK迁移时直接使用范例代码并检查运行情况时，可能范例代码中使用的第三方工具库已更新或目录结构已变更。
有关详细信息，请参考Cubism 5 SDK各平台的README和CHANGELOG。

从2.1 SDK迁移到5 SDK

Cubism 2.1 SDK的用户迁移到Cubism 5 SDK时的优点和缺点如下所示。

优点

• 通过扩大SDK源的公开范围提高了可维护性。
• 由于实现了许多2.1中未实现的功能，因此可以进行更丰富的表达。

• 由于Core以外的部分都是开源，所以包括渲染器部分在内的几乎所有自定义都可以自由完成。
  * 请注意，在这种情况下，您需要同意Live2D Opensoftware License。

缺点

• 迁移成本更高。
  • 需要更换SDK集。

  • 模型嵌入数据必须重新输出为最新格式。
    根据模型不同，在重新输出嵌入数据之前，可能需要进行修复作业。内容将在流程图中列出。

流程图

从Cubism 2.1 SDK迁移到Cubism 5 SDK时，请务必使用Cubism 5 Editor导入.cmox或.canx，并将其输出到Cubism 5 SDK嵌入数据。

除了更换SDK和模型数据之外，还可能会进行使形状和动作兼容的作业。
下面介绍可能的作业内容和应对措施。

当迁移模型的变换/绘制结果不同时

模型需要调整。
请使用Cubism 5 Editor导入要迁移的.cmox并调整变换结果。
调整完成后，请输出.moc3文件，在搭载Cubism 5 SDK的实机上查看显示。

关于Cubism 2.1 SDK中使用的mtn文件（动态文件）

Cubism 5 SDK不支持.mtn。 但是，由于Cubism 5 Editor可以导入.canx文件，因此可以通过将导入的.canx输出到motion3.json来应对。
但是无法完全再现动态的曲线，需要对时间线上数值的变化进行处理，制作出具有近似数值的曲线。

关于物理模拟的应对

Cubism 2.1中使用的物理模拟不能在Cubism 5 SDK中直接使用。
对于使用Cubism 2.1创建物理模拟的模型，请在Editor上重新设置物理模拟。

关于参数ID

Cubism SDK指定的呼吸和视线跟踪等指定参数的ID已变更为Cubism 5的规格。
迁移Cubism 2.1中使用的模型时，请在输出时按照Cubism 5的规格进行转变。