部位で異なるモーション管理を行う
最終更新： 2022年12月8日
このページでは、右手左手で異なるモーション管理を実現するために、
LAppModelのCubismMotionManager保有を増やしてLAppmodel.updateに組み込む場合を例として、
管理やモーション作成上の注意点などを見ていきます。
CubismMotionManagerを増やす理由
CubismMotionManagerはフェードに対応するため一時的な複数のモーションを再生する機能があります。
しかし、再生開始のAPIは再生中のモーションをフェードアウトさせて終了するため、
並列でモーションを再生し続ける機能はありません。
この問題を解決するために、モーションマネージャーのインスタンスを複数用意し、
再生させるモーションマネージャーをすみ分けることによって並列でのモーション再生を実現させます。
CubismMotionManagerを増やす
モーションマネージャーの追加
まずはプログラム側の実装を見ていきます。
最初に行うのはモデルへの管理クラスの追加です。
サンプルのLAppModelへCubismMotionManagerを追加していきます。
また、コンストラクタに生成処理を追加します。
public class LAppModel extends CubismUserModel{
...
private CubismMotionManager rightArmMotionManager; // 追加
private CubismMotionManager leftArmMotionManager; // 追加
}
public LAppModel(){
...
rightArmMotionManager = new CubismMotionManager(); // 追加
leftArmMotionManager = new CubismMotionManager(); // 追加
}
更新処理
updateの処理にも追加して再生されたモーションがパラメータに影響を与えるようにします。
public void update(){
...
// 前回セーブされた状態をロード
_model.loadParameters();
// モーションの再生がない場合、待機モーションの中からランダムで再生する
if(_motionManager.isFinished()){
startRandomMotion(LAppDefine.MotionGroup.IDLE.getId(), LAppDefine.Priority.IDLE.getPriority());
} else{
// モーションを更新
isMotionUpdated = _motionManager.updateMotion(_model, deltaTimeSeconds);
}
isMotionUpdated |= rightArmMotionManager.updateMotion(_model, deltaTimeSeconds); // 追加
isMotionUpdated |= leftArmMotionManager.updateMotion(_model, deltaTimeSeconds); // 追加
// モデルの状態を保存
_model.saveParameters();
}
LAppModel.update内部に追加するときは、_model.loadParameters();と_model.saveParameters(); の間にupdateMotionを設置するようにしてください。
また、updateMotionを複数回実行すると、更新するパラメータが重複することがあります。
この場合、後に実行されたupdataMotionの内容が優先されることに注意してください。
再生開始
そして、startMotion系の関数を複製、改造する形で追加したモーションマネージャーでモーション再生を指示できるようにしておきます。
startHandMotion関数では、引数としてモーションマネージャーを指定することに注意してください。
なお以下の例では、.motion3.jsonで指定されているモーション(preLoad関数でロードされるモーション) のみ再生する実装となっています。
// startMotionより複製して作成
public int startHandMotion(
CubismMotionManager targetManage,
final String group,
int number,
int priority
) {
if (priority == LAppDefine.Priority.FORCE.getPriority()) {
targetManage.setReservationPriority(priority);
} else if (!targetManage.reserveMotion(priority)) {
if (_debugMode) {
LAppPal.logger.print("Cannot start motion.");
return -1;
}
}
final String fileName = _modelSetting.getMotionFileName(group, number);
// ex) idle_0
String name = group + "_" + number;
CubismMotion motion = (CubismMotion) _motions.get(name);
if (motion == null) {
// PreLoadで読まれていない場合は再生しない
return -1;
}
if (_debugMode) {
LAppPal.logger.print("Start motion: [" + group + "_" + number + "]");
}
return targetManage.startMotionPriority(motion, priority);
}
// startRandomMotionより複製して作成
public int startRandomRightHandMotion(final String group, int priority) {
if(_modelSetting.getMotionCount(group) == 0){
return -1;
}
Random random = new Random();
int number = random.nextInt(Integer.MAX_VALUE) % _modelSetting.getMotionCount(group);
return startHandMotion(rightArmMotionManager, group, number, priority);
}
// startRandomMotionより複製して作成
public int startRandomLeftHandMotion(final String group, int priority) {
if(_modelSetting.getMotionCount(group) == 0){
return -1;
}
Random random = new Random();
int number = random.nextInt(Integer.MAX_VALUE) % _modelSetting.getMotionCount(group);
return startHandMotion(leftArmMotionManager,group,number,priority);
}
モーション再生はモデルに当たり判定を追加して、タップによって動作するようにします。
public void onTap(float x, float y) {
if (DEBUG_LOG_ENABLE) {
CubismFramework.coreLogFunction("tap point: {" + x + ", y: " + y);
}
for (LAppModel model : _models) {
// 頭をタップした場合表情をランダムで再生する
if (model.hitTest(HitAreaName.HEAD.getId(), x, y)) {
if (DEBUG_LOG_ENABLE) {
LAppPal.logger.print("hit area: " + HitAreaName.HEAD.getId());
}
model.setRandomExpression();
}
// 体をタップした場合ランダムモーションを開始する
else if (model.hitTest(HitAreaName.BODY.getId(), x, y)) {
if (DEBUG_LOG_ENABLE) {
LAppPal.logger.print("hit area: " + HitAreaName.BODY.getId());
}
model.startRandomMotion(MotionGroup.TAP_BODY.getId(), Priority.NORMAL.getPriority(), _finishedMotion);
}
// ここから追加
else if (model.hitTest("Right", x, y)) {
if (DEBUG_LOG_ENABLE) {
LAppPal.logger.print("hit area: [" + HitAreaName.BODY.getId() + "]");
}
model.startRandomRightHandMotion("Right", Priority.FORCE.getPriority());
} else if (model.hitTest("Left", x, y)) {
if (DEBUG_LOG_ENABLE) {
LAppPal.logger.print("hit area: [" + HitAreaName.BODY.getId() + "]");
}
model.startRandomLeftHandMotion("Left", Priority.FORCE.getPriority());
}
// ここまで追加
}
}
担当パラメータの振り分け
更新処理でも示したように、再生する複数のモーション間でパラメータが重複すると、後の方に実行された更新内容が優先されてパラメータが上書きされます。
このため、モーションマネージャーを複数使用するときには、どのモーションマネージャーがどの部位の動きを担当するのか、ひいてはどのパラメータ操作を担当するのか決めておく必要があります。
上の動画は、優先順位の高いモーションマネージャー（左腕・右腕のモーションを担当）の再生が終了した直後に、優先順位の低いモーションマネージャー（モデル全体のアイドルモーションを担当）によって左腕・右腕のパラメータが更新されてしまった事例です。
優先順位の高いモーションマネージャーによって更新されるパラメータを、モーション再生終了直後の状態に維持しておきたい場合には、望ましい表現とは言えません。
この現象は、優先順位が低いモーションマネージャーで再生するモーションデータ内に更新対象としては意図していないパラメータに基準値が設定されている場合に見られます。
この時、モーションデータごとに更新するパラメータを分離しておくことで、優先順位の高いモーションマネージャーによって更新されるパラメータを、再生終了直後の状態に維持しておくことができます。
パラメータごとに分離しておくのか、上書きを前提とするのか、
膨大な修正をしないためにもモーションの作成前に仕様をはっきりと定めておくことが重要です。