本文翻译自:https://docs.live2d.com/cubism-sdk-tutorials/use-cubismdiyviewer/
译者注:注意!这并不是一篇严谨的翻译,本人并不是翻译行业从业者,也根本不会日文。官网的中文翻译会连带代码一起翻译,而且还不如机翻日文,官网的英语翻译版本有的语法很奇怪,看起来也是机翻。本文主要来自日文机翻,然后再结合实际开发经验调整到通顺,修改不该翻译的东西并润色。
[最后更新日期: 2017/09/19] 译者注:这是这个日文原文的更新日期
by Traitam
在 Live2D 的 GitHub 上,您可以自己编译 Cubism DIY Viewer。
本节介绍如何创建该立体主义DIY查看器。
流程是在 Unity 上创建一个项目,对其进行构建,自定义,最后将其输出为应用程序。
为 Cubism DIY Viewer 创建 Unity 项目
首先,创建一个新的 Unity 项目,并将 SDK 的 unitypackage 添加到您的项目中。
有关导入 SDK 的信息,请参阅文章:导入SDK-放置模型中的 "将SDK导入项目"。
此外,需要最新版本的 SDK 组件才能处理此 Cubism DIY Viewer。
从下面的链接下载最新的 SDK 组件。
https://github.com/Live2D/CubismUnityComponents/tree/develop
在上一页中,在红色框中按 “Clone or download”,然后按 “Download ZIP” 来下载Zip压缩包。
下载并解压缩最新版本的 Cubism Unity Components。
把解压缩出来的 Assets 在资源管理器中覆盖上面创建的 Unity 项目的 Assets 文件夹
如果您在 Unity 中覆盖,那样文件夹名称将被重命名,因此请在资源管理器覆盖。
覆盖后,从下面的链接下载DIY Viewer。
https://github.com/Live2D/CubismViewer
就像下载最新的 SDK 一样,单击绿色按钮 “Clone or download”,然后单击 “Download ZIP” 开始下载。
下载后,解压缩并添加到 Unity。
将解压缩后文件夹中的 Assets 文件夹复制到与 Unity 中 Assets 文件夹相同的位置。
接下来是 Unity Editor 设置。 Unity Editor 中只有一项设置。
在 Unity 中选择 “Edit”→“Project Settings”→“Player”来打开 Player Settings 。
之后,打开 “Other Settings”,并将 “Configuration” 中的 “Api Compatibility Level“ 的 “.NET 2.0 Subset” 更改为 “ .NET 2.0”。
这样就完成了 Unity Editor 的设置。
添加所需的 DLL
添加 Viewer 时,我在 Unity 上遇到错误消息。可以复制并添加一个名为 System.Windows.Forms.dll 的文件来解决此错误。
如果 Unity 使用默认安装位置的话,这个文件位于 C:/ProgramFiles/UnityEditor/Data/Mono/lib/mono2.0/System.Windows.Forms.dll
在 Unity 上粘贴的位置是 “Assets/Live2D/Cubism/Viewer/Plugins/” 。
查看器场景创建
在当前项目中为 Viewer 创建一个场景。
右击 “Hierarchy” 窗口打开上下文菜单。
在菜单中单击 “Create Empty” 以创建一个空白的 Game Object。
将您创建的空 Game Object 对象重命名为 “CubismViewer”。
选择 "CubismViewer",然后单击 'Inspector”>“Add Component”>“Cubism Viewer.cs”。之后,将添加的 CubismViewer 组件的 Camera 设置为 Main Camera 对象。
译注:先在 CubismViewer 上面附加 Cubism Viewer.cs,然后把 Main Camera 拖到 Camera 参数上
设置 Game Object 后,创建并设置按钮以调用场景中的进程。
右键单击 “Hierarchy” 窗口,然后选择 “UI”→“Button” 来创建按钮。
选择创建的按钮并设置 OnClick()
。
在 OnClick()
上按 "+" 后,添加一个 CubismViewer
对象。
选择 CubismViewer.ShowFileDialog
。
这样就完成了 "Cubism DIY Viewer" 项目的创建。
要显示模型,请按照以下步骤操作。
运行场景并按按钮来打开文件选择窗口。
然后选择 .model3.json
。
定制 Gems
使用 model3.json 的动作时,将 Gems/Animation/SimpleAnimator.cs
添加到 CubismViewer
对象。
在加载 .model3.json 后,可以以相同方式加载 .motion3.json,这样运动将应用于显示的模型。
请参阅 GitHub 上关于 Built-in Gems,User Gems 的链接。
https://github.com/Live2D/CubismViewer#built-in-gems
导出为 exe 文件
最后,将此项目导出为 standalone(独立)的应用程序。
导出之前,请先保存上面创建的场景。
按 “File”→“Build Settings” 以配置构建设置。
按 “Add Open Scenes” 将刚刚保存的场景添加到 “Scenes In Build” 中。
最后,按 'Build' 或 “Build And Run”,然后输入要创建的 exe 的名称。
如果单击“生成并运行”,则在生成完成后,exe 将自动启动。
如果配置没有错误,则可以像在 Unity 上一样加载和显示模型。