Expression

最終更新： 2020年1月30日

概述

Expression是处理Cubism表情动态的功能，可以通过将表情参数的值与当前参数的值进行加算或正片叠底来设置。
在Unity标准动态播放功能Animator中，由于可设置为层的混合模式中没有正片叠底，所以无法表达。

表情功能设置文件以.exp3.json格式输出。
请参考此处 了解表情的机制。

使用Expression需要提前在Prefab中设置UpdateController和ParameterStore。    

请参考此处查看相关教程文章。

按照以下步骤播放表情动态。

1. 创建[.exp3.asset]
2. 创建[.expressionList.asset]并追加[.exp3.asset]
3. 播放表情动态
4. 表情动态的计算及应用

创建[.exp3.asset]

[.exp3.asset]是从[exp3.json]转换而来的ScriptableObject资产。
如果变更[.exp3.asset]，则无法保证正常运行。

要将[exp.json]转换为[.exp3.asset]，请执行以下处理：

1. 解析[exp.json]
2. 创建CubismExpressionData
3. 创建[.exp3.asset]

解析[exp.json]

要[exp3.json]的解析，使用CubismExp3Json.LoadFrom(string exp3Json)或CubismExp3Json.LoadFrom(TextAsset exp3JsonAsset)。

创建CubismExpressionData

CubismExpressionData是一个记录解析后的.exp3.json信息的类，保存以下数据。

场地	型	说明
Type	string	json文件类型。.exp3.json时，设置“Live2D Expression”。
FadeInTime	float	直到表情淡入所需的时间。值的单位是秒。
FadeOutTime	float	直到表情淡出所需的时间。值的单位是秒。
Parameters	SerializableExpressionParameter[]	应用表情的参数的ID、要应用的值、计算方法。

使用CubismExpressionData.CreateInstance(CubismExp3Json json)创建一个新的[.exp3.asset]。
使用CubismExpressionData.CreateInstance(CubismExpressionData expressionData, CubismExp3Json json)覆盖[.exp3.asset]。

• CubismExp3Json json：CubismExp3Json是解析[exp3.json]后的数据。
• CubismExpressionData expressionData：覆盖对象CubismExpressionData。

创建[.exp3.asset]

使用AssetDatabase.CreateAsset创建[.exp3.asset]，如下所示。

// 创建时
expressionData = CubismExpressionData.CreateInstance(ExpressionJson);
AssetDatabase.CreateAsset(expressionData, AssetPath.Replace(".exp3.json", ".exp3.asset"));
 
// 更新已创建的资产时
expressionData = CubismExpressionData.CreateInstance(oldExpressionData, ExpressionJson);
EditorUtility.CopySerialized(expressionData, oldExpressionData);
expressionData = oldExpressionData;
 
// 更新Unity数据库
EditorUtility.SetDirty(expressionData);

这个处理是通过CubismExpression3JsonImporter.Import()完成的。

* 运行时，无需将CubismExpressionData转换为.asset。

创建[.expressionList.asset]并追加[.exp3.asset]

[.expressionList.asset]是列出各模型的[.exp3.asset]参考的资产。
使用CubismExpressionController来获取从CurrentExpressionIndex播放的表情动态。
[.exp3.asset]列表的顺序是按照[exp3.json]的载入顺序追加的。

* 此项目由CubismExpression3JsonImporter.Import()处理。

创建[.expressionList.asset]

[.expressionList.asset]在与模型预制件相同的层次结构中创建。

// 获取已有的expressionList
var expressionList = AssetDatabase.LoadAssetAtPath<CubismExpressionList>(expressionListPath);
 
// 创建资产
AssetDatabase.CreateAsset(expressionList, expressionListPath);

* 运行时，无需将CubismExpressionList转换为.asset。

追加[.exp3.asset]

要将[.exp3.asset]追加到[.expressionList.asset]，请执行以下操作：

// 新追加时
expressionIndex = expressionList.CubismExpressionObjects.Length;
Array.Resize(ref expressionList.CubismExpressionObjects, expressionIndex + 1);
expressionList.CubismExpressionObjects[expressionIndex] = expressionData;
 
// 更新已经设置的元素
expressionList.CubismExpressionObjects[expressionIndex] = expressionData; 

// 更新Unity数据库 
EditorUtility.SetDirty(expressionList);

播放表情动态

您可以通过在CubismExpressionController.CurrentExpressionIndex中设置要播放的表情动态的索引，以播放/变更表情动态。

执行以下处理以播放表情动态。

1. 设置播放过程中表情动态的退出时间
2. 原始化一个新的表情动态，并将其追加到表情动态播放列表中

设置播放过程中表情动态的退出时间

播放期间的表情动态存在时，请设置退出时间，以便退出正在播放的表情动态。

// Set last expression end time
if(_playingExpressions.Count > 0)
{
    var playingExpression = _playingExpressions[_playingExpressions.Count - 1];
    playingExpression.ExpressionEndTime = playingExpression.ExpressionUserTime + playingExpression.FadeOutTime;
    _playingExpressions[_playingExpressions.Count - 1] = playingExpression; 
}

这个处理由CubismExpressionController.StartExpression()完成。

原始化一个新的表情动态，并将其追加到表情动态播放列表中

创建拥有表情动态播放信息的CubismPlayingExpression。

CubismPlayingExpression保留以下信息：

场地	型	说明
Type	string	json文件类型。.exp3.json时，设置“Live2D Expression”。
FadeInTime	float	直到表情淡入所需的时间。值的单位是秒。
FadeOutTime	float	直到表情淡出所需的时间。值的单位是秒。
Weight	float	表情权重。值的范围为0到1。
ExpressionUserTime	float	自表情播放开始以来经过的时间。值的单位是秒。
ExpressionEndTime	float	退出表情播放的时间。值的单位是秒。
Destinations	CubismParameter[]	表情适用的参数数组。
Value	float[]	表情应用于参数的值。元素的数量和顺序与Destinations相同。
Blend	CubismParameterBlendMode[]	表情应用于参数的计算方法。元素的数量和顺序与Destinations相同。要设置的计算方法是Override、Additive、Multiply。

CubismPlayingExpression可以使用CubismPlayingExpression.Create(CubismModel model, CubismExpressionData expressionData)创建。

• CubismModel model：播放表情动态的模型。
• CubismExpressionData expressionData：要播放的表情动态的[exp3.asset]数据。

将创建的表情动态追加到播放列表中，如下所示。

// 创建播放表情
var palyingExpression = CubismPlayingExpression.Create(_model, ExpressionsList.CubismExpressionObjects[CurrentExpressionIndex]); 

// 追加到表情播放列表 
_playingExpressions.Add(palyingExpression);

这个处理由CubismExpressionController.StartExpression()完成。

表情动态的计算及应用

表情计算和应用是从CubismExpressionController.OnLateUpdate()调用的。

* 必须在ParameterStore.SaveParameters()之后应用表情。
Expression是针对当前值，于每帧新应用表情值的功能。
如果在ParameterStore.SaveParameters()之前应用，将会保存表情应用的结果，所以表情的参数值会无限加算或正片叠底。