Up to date

This page is up to date for Godot 4.3. If you still find outdated information, please open an issue.

動畫軌編輯器

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

也參考

我們假設您已經閱讀了建置系統簡介，其中涵蓋了基礎知識，包括屬性軌道。

屬性軌道

最基本的軌道型別。見建置系統簡介。

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

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

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

混合形狀軌道

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

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

呼叫方法

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

備註

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

To create such a track in the editor, click "Add Track -> Call Method Track." Then, a window opens and lets you select the node to associate with the track. To call one of the node's methods, right-click the timeline and select "Insert Key". A window opens with a list of available methods. Double-click one to finish creating the keyframe.

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

To create such a track through code, pass a dictionary that contains the target method's name and parameters as the Variant for key in Animation.track_insert_key(). The keys and their expected values are as follows:

Key	Value
`"method"`	The name of the method as a `String`
`"args"`	The arguments to pass to the function as an `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);
}

貝茲曲線軌道

貝塞爾曲線軌道與屬性軌道類似，不同之處在於它允許您使用貝塞爾曲線為屬性值設定動畫。

備註

貝塞爾曲線軌跡和屬性軌跡不能在 AnimationPlayer 和 AnimationTree 中混合。

若要建立一個，請按一下「新增軌跡 -> 貝塞爾曲線軌跡」。與屬性軌跡一樣，您需要選擇要設定動畫的節點和屬性。若要開啟貝塞爾曲線編輯器，請點選動畫軌道右側的曲線圖示。

在編輯器中，鍵由實心菱形表示，輪廓菱形透過線控製曲線的形狀連接到它們。

小訣竅

For better precision while manually working with curves, you might want to alter the zoom levels of the editor. The slider on the bottom right of the editor can be used to zoom in and out on the time axis, you can also do that with Ctrl + Shift + Mouse wheel. Using Ctrl + Alt + Mouse wheel will zoom in and out on the Y axis