UnityのAnimationをスクリプトから上書きしたい（例：腰をひねる）

Question

前提・実現したいこと

アセットストアにてアニメーションを購入しました。
銃を構えているアニメーションです。

腰を左右に捻ることで、銃口の向きを制御したいと考えています。
IK等いろいろな方法を検討しましたが、Animationウィンドウの「Animator.Chest Twist Left-Right」の値を変更するのが、最も綺麗に実現できそうだと考えました。

しかし、Animatorのパラメーターにアクセスする方法がわかりません。

どのようなスクリプトを書けば、ここを上書きできますか？
ご存じの方ご教示ください。

該当のソースコード

// ※実際には動かなかったのですが、下記のように指定できる関数があればなぁと思ってます

// 左を向く
animator.SetFloat("Animator.Chest Twist Left-Right", -1f);

// 右を向く
animator.SetFloat("Animator.Chest Twist Left-Right", 1f);

試したこと

• 該当のソースコードは実行してみました。
• ちょっと書き換えたバージョンもいくつか試しました。

// Animator.を消してみる
animator.SetFloat("Chest Twist Left-Right", -1f);
// スペースを消してみる
animator.SetFloat("Animator.ChestTwistLeft-Right", 1f);
// Animator.とスペースを消してみる
animator.SetFloat("ChestTwistLeft-Right", 1f);

補足情報（FW/ツールのバージョンなど）

Unity 2020.3.20f1

Answer 1

AnimatorのSet系メソッドはAnimator Controller上で定義したパラメーターを設定するためのものでしょうから、さらにその中で再生されているAnimationClipのプロパティにまでアクセスすることはできないんじゃないでしょうかね...

私がそのような銃口のコントロールをやるとしたら、おそらくbboydaisukeさんがおっしゃるようにIK機能を利用するように思います。ですがキャラクターのマッスルを直接操作した方が好都合な場合があるかもしれません。
代替案として、HumanPoseHandlerで姿勢を修正するのはどうでしょうか?
試しに下記スクリプトをキャラクターにアタッチしたところ...

using UnityEngine;

[RequireComponent(typeof(Animator))]
public class PoseModifier : MonoBehaviour
{
    [SerializeField][Range(-1.0f, 1.0f)] private float spineFrontBack;
    [SerializeField][Range(-1.0f, 1.0f)] private float chestTwistLeftRight;
    [SerializeField][Range(-1.0f, 1.0f)] private float headNodDownUp;
    private HumanPoseHandler poseHandler;

    // あらかじめHumanPoseHandlerを取得しておく
    private void OnEnable()
    {
        this.poseHandler = new HumanPoseHandler(this.GetComponent<Animator>().avatar, this.transform);
    }

    // HumanPoseHandlerが不要になったら破棄する
    private void OnDisable()
    {
        this.poseHandler.Dispose();
    }

    private void LateUpdate()
    {
        // ポーズを取得して...
        var t = this.transform;
        var rootPosition = t.position;
        var rootRotation = t.rotation;
        t.SetPositionAndRotation(Vector3.zero, Quaternion.identity);
        var pose = new HumanPose();
        this.poseHandler.GetHumanPose(ref pose);
        t.SetPositionAndRotation(rootPosition, rootRotation);

        // マッスル値を修正する
        pose.muscles[0] += this.spineFrontBack;
        pose.muscles[5] += this.chestTwistLeftRight;
        pose.muscles[12] += this.headNodDownUp;

        // 修正したポーズを設定する
        this.poseHandler.SetHumanPose(ref pose);
    }

    // 各マッスルが何番なのかは、HumanTraitを見てみるのがいいかと思います
    private void Start()
    {
        var muscleNames = HumanTrait.MuscleName;
        for (var i = 0; i < HumanTrait.MuscleCount; i++)
        {
            Debug.Log($"Muscle {i}:[{muscleNames[i]}]");
        }
    }
}

下図のような結果になりました。

##上半身・下半身同時ひねり問題への対策

using UnityEngine;

[RequireComponent(typeof(Animator))]
public class PoseModifier : MonoBehaviour
{
    [SerializeField][Range(-1.0f, 1.0f)] private float spineFrontBack;
    [SerializeField][Range(-1.0f, 1.0f)] private float chestTwistLeftRight;
    [SerializeField][Range(-1.0f, 1.0f)] private float headNodDownUp;
    private HumanPoseHandler poseHandler;
    private Transform hips;
    
    private void OnEnable()
    {
        var animator = this.GetComponent<Animator>();
        this.poseHandler = new HumanPoseHandler(animator.avatar, this.transform);

        // Hipsに相当するボーンを取得しておく
        this.hips = animator.GetBoneTransform(HumanBodyBones.Hips);
    }
    
    private void OnDisable()
    {
        this.poseHandler.Dispose();
    }

    private void LateUpdate()
    {
        // ポーズ修正を加える前に、あらかじめHipsの回転を覚えておく
        var hipsRotation = this.hips.rotation;

        // ポーズ修正部分は変更なし
        var t = this.transform;
        var rootPosition = t.position;
        var rootRotation = t.rotation;
        t.SetPositionAndRotation(Vector3.zero, Quaternion.identity);
        var pose = new HumanPose();
        this.poseHandler.GetHumanPose(ref pose);
        t.SetPositionAndRotation(rootPosition, rootRotation);
        pose.muscles[0] += this.spineFrontBack;
        pose.muscles[5] += this.chestTwistLeftRight;
        pose.muscles[12] += this.headNodDownUp;
        this.poseHandler.SetHumanPose(ref pose);

        // マッスル値設定によるポーズ修正を加えた後、
        // Hipsの回転を元に戻す
        this.hips.rotation = hipsRotation;
    }
    
    private void Start()
    {
        var muscleNames = HumanTrait.MuscleName;
        for (var i = 0; i < HumanTrait.MuscleCount; i++)
        {
            Debug.Log($"Muscle {i}:[{muscleNames[i]}]");
        }
    }
}

Comments

[moyashi1]

まさしく探していた情報です、ありがとうございます！

添付いただいたgifでもそうですが、上半身をひねると下半身も同じだけ逆方向に捻られてしまうようです。
これを上半身だけに適用する方法はありますか？

今から今回教えていただいたマッスル制御を勉強してみるので自己解決目指しますが
もしご存知でしたらご教示いただけますと幸いですm(__)m

※上半身だけ捻って狙いをつけるイメージだったので、足から下は動かしたくない

[Bongo]

Hipsの姿勢を元のまま維持させる...というのはどうでしょうかね?回答欄に追記しました。
すみませんが即興の思いつきですので、不具合を見落としているかもしれません。変な挙動を見つけましたらコメントいただければ、可能であれば直してみようと思います。

[moyashi1]

たったいま帰宅して動かしてみました。
めちゃいい感じです！！

おかげさまでイメージ通りの処理を実装できました。
また質問させていただいた際は是非回答お願いします。

※ 腰をひねると、ごくわずかに位置がずれる問題が発生していたのですが、
HipsのRotation同様Positionも維持するように修正したところ解消しました。

Answer 2

アニメーション クリップ（.anim ファイル）はアセットなので実行中に上書きはできません。IK を使いましょう。

Comments

[moyashi1]

ご回答ありがとうございます！

animファイル自体は編集しないにしても、
Animator側の、実行時の値だけ変更することはできませんか？

[bboydaisuke]

もしくはアバターマスク＋レイヤーでもいいでしょう。アバターマスク レイヤー とか、 Unity 上半身だけ動かす とかでググればいろいろ出てきます。

[bboydaisuke]

> Animator側の、実行時の値だけ変更することはできませんか？

何を表現しているかよくわかりませんが、そういうことはしません。

[moyashi1]

ありがとうございます。
IKやアバターマスクの方法は認識しています。

>> Animator側の、実行時の値だけ変更することはできませんか？

>何を表現しているかよくわかりませんが、そういうことはしません。

パラメータであれば
animator.SetFloat("パラメータ名", 0.5f);
といった形で設定できますよね。

同じように
animator.関数("Chest Twistt Left-Right", -1f);
とすると、左を向いてくれると嬉しいのですが。