官方 Animator 例子解析 Animator.MatchTarget

一、官方的解释

Animator.MatchTargetSwitch to Manual
void MatchTarget(Vector3 matchPosition, Quaternion matchRotation, AvatarTarget targetBodyPart, MatchTargetWeightMask weightMask, float startNormalizedTime, float targetNormalizedTime = 1);
Parameters

matchPosition    The position we want the body part to reach.
matchRotation    The rotation in which we want the body part to be.
targetBodyPart    The body part that is involved in the match.
weightMask    Structure that contains weights for matching position and rotation.
startNormalizedTime    Start time within the animation clip (0 - beginning of clip, 1 - end of clip).
targetNormalizedTime    End time within the animation clip (0 - beginning of clip, 1 - end of clip), values greater than 1 can be set to trigger a match after a certain number of loops. Ex: 2.3 means at 30% of 2nd loop.
Description

Automatically adjust the gameobject position and rotation so that the AvatarTarget reaches the matchPosition when the current state is at the specified progress.

Target matching only works on the base layer (index 0).

二、理解

这个 一般 用于 根运动 动画。 可以用在 人物攀爬 或者 掉落 的动画 时候 进行一些 位置的调整。具体在于理解。上一段官方的例子教程。

using UnityEngine;
using System.Collections;

public class TargetMatching : MonoBehaviour
{

    private Animator animator;
    /// <summary>
    /// 匹配 目标
    /// </summary>
    public Transform RightHand;
    bool hasJumped = false;


    // Use this for initialization
    void Start () {

        animator = GetComponent<Animator>();
    
    }

    void OnGUI()
    {
        GUILayout.Label("Make your character grab any edge!");
        GUILayout.Label("Press Fire1 to trigger Jump animation");
        GUILayout.Label("Added *MatchStart* and *MatchEnd* parameters to the Animator Controller");
        GUILayout.Label("Added *MatchStart* and *MatchEnd* additionnal curves to the Idle_ToJumpUpHigh animation");
        GUILayout.Label("*MatchStart* and *MatchEnd* tell the system when to start cheating the root using MatchTarget API");
        GUILayout.Label("Added a RightHand model child of the MoveThis container, to tell where the right hand should go");
        GUILayout.Label("On the update function, we call MatchTarget");
        GUILayout.Label("Translate the MoveThis object and see how character's hand always reach it");        
    }
    
    // Update is called once per frame
    void Update () 
    {

        if (animator)
        {
            AnimatorStateInfo state = animator.GetCurrentAnimatorStateInfo(0);

            if (Input.GetButton("Fire1")) animator.SetBool("Jump", true);

            if (state.IsName("Base Layer.JumpUp") || state.IsName("Base Layer.FullJump")) 
            {
                animator.SetBool("Jump", false);
                                                    
                animator.MatchTarget(
                    RightHand.position, 
                    RightHand.rotation, 
                    AvatarTarget.RightHand, 
                    new MatchTargetWeightMask(new Vector3(1, 1, 1), 0), 
                    /// 动画 曲线 获取
                    animator.GetFloat("MatchStart"), 
                    animator.GetFloat("MatchEnd"));
                hasJumped = true;
            }

            if (hasJumped && state.normalizedTime > 1.2)
            {
                hasJumped = false;
                
                Application.LoadLevel(0);
            }

            Debug.Log(" animator.GetFloat MatchStart " + animator.GetFloat("MatchStart") + " state.normalizedTime " + state.normalizedTime);
        }
    
    }
}