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

概述

在此页面上，我们将在发布Cubism 4 SDK 时向您展示从Cubism 3 SDK和Cubism 2.1 SDK等Cubism SDK之前版本迁移的优缺点，以及简单流程图。

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

• 新下载已停止，以后不会更新
• 将来不会支持任何新功能
• 以单独故障为对象，只有在有故障报告时才会修复

从3 SDK迁移到4 SDK

当Cubism 3 SDK的用户迁移到Cubism 4 SDK时，有以下优点和缺点。

优点

• 可以使用新功能（反转蒙版） *的跳帧功能和扩展插值也可以使用Cubism3等效输出的嵌入数据。
• 使用Cubism 3 Editor创建的模型可以按原样使用（向后兼容）

缺点

• 无

流程图

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

从2.1 SDK迁移到4 SDK

当Cubism 2.1 SDK的用户迁移到Cubism 4 SDK时，有以下优点和缺点。

优点

• 通过扩大SDK源的公开范围提高了可维护性
• 由于实装了很多2.1中没有实装的功能，因此可以实现更丰富的表达
• 由于Core以外的部分都是开源，所以包括渲染器部分在内的几乎所有自定义都可以自由完成。
  * 请注意，在这种情况下，您需要同意Live2D Opensoftware License。

缺点

• 迁移成本高
  • 需要更换完整的SDK
  • 模型嵌入数据需要重新输出为最新格式
    根据模型不同，在重新输出嵌入数据之前，可能需要进行修复作业。内容将在流程图中列出。

流程图

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

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

　

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

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

　

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

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

　

关于物理模拟的应对

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

　

关于参数ID

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