动画轨道类型

动画轨道类型

本页面概述了在默认属性轨道之外，Godot动画播放器节点可用的轨道类型。

参见

我们假设你已经阅读了动画功能介绍，其中包括了一些基础知识，包括属性轨道。

属性轨道

最基本的轨道类型。见动画功能介绍。

3D 位置、旋转、缩放轨道

这些 3D 变换轨道控制的是 3D 对象的位置、旋转和缩放。这样为 3D 对象的变换做动画相比于使用普通属性轨道更方便。

它专为从外部3D模型导入的动画而设计，并可以通过压缩来减少资源占用。

混合形状轨道

混合形状轨道针对 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:

键	值
`“method”`	方法的名称，类型为 `String`
`“args”`	传递给该函数的所有参数，类型为 `Array`

GDScriptC#

# 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);
}