关于 cdi3.json

[最近更新时间:2020/01/30]

 

概述

从 Cubism Editor3.3.02(2019 年 4 月 23日发布)开始,您可以在从 Cubism Editor导出模型时导出 .cdi3.json。
.cdi3.json 是一个文件,其中包含将参数、参数组和部件 ID 与名称相关联的信息。

Editor上设定的参数名称、参数组名称和部件名称不写入moc3,因为它们在SDK上处理模型时是不必要的项目。
但是,如果您想像应用程序那样显示参数的名称,允许用户直接操作模型的参数,则可以使用 .cdi3.json 获取名称。

 

.cdi3.json 中描述的内容

・参数
 ・参数ID,参数名称(编辑器中显示的名称),所属参数组的ID
・参数组
 ・Group ID、组名(编辑器中显示的名称)、所属参数组的ID
・部分
 ・部件ID,部件名称(编辑器中显示的名称)

* 您所属的参数组ID:
 参数组在编辑器中表示为树形结构,但cdi中的结构是List结构,存储数据。
 在 SDK 上处理参数组树形结构时,需要使用此信息来恢复放置。
 如果没有它所属的参数组(编辑器中的树结构根),此项将为空。

有关 cdi3.json 规范的更多信息,请参阅 GitHub 上的 CubismSpecs

要解析 cdi3.json,请使用 Cubism SDK for Native 中的 CubismCdiJson
由于 Cubism SDK for Web 有自己的 Json 解析器,如果你想实现 .cdi3.json,你可以在你身边使用它。

 

CubismCdiJson

实例生成

 

 

参数

获取参数相关信息的API如下。

・参数数量:CubismCdiJson::GetParametersCount()
・参数ID:CubismCdiJson::GetParametersId()
・所属参数组的ID:CubismCdiJson::GetParametersGroupId()
・参数名称:csmChar * CubismCdiJson::GetParametersName()

 

 

参数组

获取参数组相关信息的API如下。

・参数组数:CubismCdiJson::GetParameterGroupsCount()
・参数组ID:CubismCdiJson::GetParameterGroupsId()
・参数组的父参数组ID:CubismCdiJson::GetParameterGroupsGroupId()
・参数组名称:CubismCdiJson::GetParameterGroupsName()

 

 

部件

获取部件相关信息的API如下。

・部件数量:CubismCdiJson::GetPartsCount()
・部件编号:CubismCdiJson::GetPartsId()
・部件名称:CubismCdiJson::GetPartsName()

© 2010 - 2022 Live2D Inc.