動畫軌編輯器

本頁概述了預設屬性軌道之上的 Godot 動畫播放器節點可用的軌道型別。

也參考

我們假設您已經閱讀了動畫功能介紹，其中涵蓋了基礎知識，包括屬性軌道。

屬性軌道

最基本的軌道型別。見動畫功能介紹。

3D 位置、旋轉、縮放軌道

這些 3D 變換軌道控制的是 3D 物件的位置、旋轉和縮放。這樣為 3D 物件的變換做動畫相比於使用普通屬性軌道更方便。

它專為從外部3D模型匯入的動畫而設計，可以透過壓縮來減少資源容量。

混合形狀軌道

混合形狀軌跡針對 MeshInstance3D 中的混合形狀動畫進行了最佳化。

它專為從外部3D模型匯入的動畫而設計，可以透過壓縮來減少資源容量。

呼叫方法

呼叫方法軌道允許您在動畫中的精確時間呼叫函式。例如，您可以呼叫“queue_free()”在死亡動畫結束時刪除節點。

備註

為了安全起見，在編輯器中預覽動畫時，不會執行放置在呼叫方法軌道上的事件。

若要在編輯器中建立這樣的軌道，請點擊「新增軌道 -> 呼叫方法軌道」。然後，一個視窗會開啟並讓您選取要與軌道關聯的節點。若要呼叫節點的其中一個方法，請在時間軸上按下滑鼠右鍵並選取「插入 Key」。一個視窗會開啟並顯示可用方法的清單。滑鼠連按兩下其中一個以完成建立關鍵影格。

若要變更方法呼叫或其參數，請按一下該鍵並前往屬性檢視器停靠列。在那裡，您可以更改要呼叫的方法。如果展開「Args」部分，您將看到可以編輯的參數列表。

若要透過程式碼建立此類軌道，請在 Animation.track_insert_key() 的 key 參數傳入一個包含目標方法名稱與參數的字典。各鍵與預期值如下：

鍵名	值
`"method"`	方法名稱，型別為 `String`
`"args"`	傳遞給方法的參數，型別為 `Array`

# Create a call method track.
func create_method_animation_track():
    # Get or create the animation the target method will be called from.
    var animation = $AnimationPlayer.get_animation("idle")
    # Get or create the target method's animation track.
    var track_index = animation.add_track(Animation.TYPE_METHOD)
    # Make the arguments for the target method jump().
    var jump_velocity = -400.0
    var multiplier = randf_range(.8, 1.2)
    # Get or create a dictionary with the target method's name and arguments.
    var method_dictionary = {
        "method": "jump",
        "args": [jump_velocity, multiplier],
    }

    # Set scene-tree path to node with target method.
    animation.track_set_path(track_index, ".")
    # Add the dictionary as the animation method track's key.
    animation.track_insert_key(track_index, 0.6, method_dictionary, 0)


# The target method that will be called from the animation.
func jump(jump_velocity, multiplier):
    velocity.y = jump_velocity * multiplier

// Create a call method track.
public void CreateAnimationTrack()
{
    // Get reference to the AnimationPlayer.
    var animationPlayer = GetNode<AnimationPlayer>("AnimationPlayer");
    // Get or create the animation the target method will be called from.
    var animation = animationPlayer.GetAnimation("idle");
    // Get or create the target method's animation track.
    var trackIndex = animation.AddTrack(Animation.TrackType.Method);
    // Make the arguments for the target method Jump().
    var jumpVelocity = -400.0;
    var multiplier = GD.RandRange(.8, 1.2);
    // Get or create a dictionary with the target method's name and arguments.
    var methodDictionary = new Godot.Collections.Dictionary
    {
        { "method", MethodName.Jump },
        { "args", new Godot.Collections.Array { jumpVelocity, multiplier } }
    };

    // Set scene-tree path to node with target method.
    animation.TrackSetPath(trackIndex, ".");
    // Add the dictionary as the animation method track's key.
    animation.TrackInsertKey(trackIndex, 0.6, methodDictionary, 0);
}


// The target method that will be called from the animation.
private void Jump(float jumpVelocity, float multiplier)
{
    Velocity = new Vector2(Velocity.X, jumpVelocity * multiplier);
}