モデルのパラメータ更新について

lateUpdate(deltaTime: number)
{
  parameter = model.parameters[index];
  parameter.value = value;
}

import { _decorator, Component } from 'cc';
import ComponentExtensionMethods from '../extensions/live2d_cubismsdk_cocoscreator/static/assets/Core/ComponentExtensionMethods';
import CubismModel from '../extensions/live2d_cubismsdk_cocoscreator/static/assets/Core/CubismModel';
const { ccclass, property } = _decorator;

@ccclass('ParameterUpdateSample')
export class ParameterUpdateSample extends Component {
    _model: CubismModel | null = null;
    _t: number = 0.0;

    start() {
        this._model = ComponentExtensionMethods.findCubismModel(this, true);
    }

    lateUpdate(deltaTime: number) {
        this._t += deltaTime * 4;
        let value = Math.sin(this._t) * 30;

        let parameter = this._model.parameters[1];
        parameter.value = value;
    }
}

TIPS1

例に上げている GIF ですが、これはアニメーションのパラメータを上書きして設定を行っています。
そのため、スクリプトから更新をしているパラメータはアニメーションの動きが適用されていない状態になっています。

もし、アニメーションと掛け合わせてパラメータを使いたい場合には Live2D.Cubism.Framework に含まれている CubismParameterBlendMode でブレンドモードを変更する必要があります。ブレンドモードは 3 種類あります。

• Override…パラメータを上書きして更新します
• Additive…パラメータを加算して更新します
• Multiply…パラメータを乗算して更新します

ぜひ、用途に合わせたブレンドモードをご利用ください。
以下はコード例になっています。

{
  parameter = model.paramters[index];

  // 上書き
  CubismParameterExtensionMethods.blendToValue(parameter, CubismParameterBlendMode.Override, 値);

  // 加算
  CubismParameterExtensionMethods.blendToValue(parameter, CubismParameterBlendMode.Additive, 値);

  // 乗算
  CubismParameterExtensionMethods.blendToValue(parameter, CubismParameterBlendMode.Multiply, 値);
}

TIPS2

Cubism SDK for Cocos Creator での更新方法で記述した方法でもモデルのパラメータは取得できますが、以下の方法でも特定のパラメータを取得することができます。

これは Live2D.Cubism.Core に含まれている findByIdFromParameters() を用いることで CubismParameter を取得するコードです。

import { _decorator, Component } from 'cc';
import ArrayExtensionMethods from '../extensions/live2d_cubismsdk_cocoscreator/static/assets/Core/ArrayExtensionMethods';
import ComponentExtensionMethods from '../extensions/live2d_cubismsdk_cocoscreator/static/assets/Core/ComponentExtensionMethods';
import CubismModel from '../extensions/live2d_cubismsdk_cocoscreator/static/assets/Core/CubismModel';
import CubismParameter from '../extensions/live2d_cubismsdk_cocoscreator/static/assets/Core/CubismParameter';
const { ccclass, property } = _decorator;

@ccclass('ParameterUpdateSample')
export class ParameterUpdateSample extends Component {
  private _model: CubismModel | null = null;
  private _paramAngleZ: CubismParameter | null = null;

  @property({serializable: true})
  public parameterID: string = "ParamAngleZ";

  protected start() {
    this._model = ComponentExtensionMethods.findCubismModel(this, true);

    this._paramAngleZ ??= ArrayExtensionMethods.findByIdFromParameters(
        this._model?.parameters,
        this.parameterID ?? ''
      );
  }
}

このコードが書かれたスクリプトを、モデルのルートにアタッチすることで指定したパラメータ(ParameterID)を取得することができます。

TIPS3

その他注意点として、 CubismUpdateExecutionOrder でスクリプトの実行順を変えている場合も注意が必要になります。 スクリプトの実行順によっては、パラメータの更新タイミングが変わり、パラメータの更新がうまくいかない場合があります。