SuperAPI AI 工具集

godot-animation-player

设计与创作

查看项目

更新于 10-15 21:06

技能介绍

用途:为 Godot 的 AnimationPlayer 提供基于时间轴的关键帧动画专家模式,覆盖轨道选择、RESET、根运动与动画库,脚本负责具体配方。触发关键词包括 AnimationPlayer、Animation、track_insert_key、root_motion、animation_finished、RESET_track、call_mode、animation_set_next、queue、blend_times。

主要能力:轨道决策矩阵区分 Value(属性动画)、Method(命中框、音效钩子、状态翻转)、Audio(脚步/配音锁帧)、Bezier(自定义缓动采样);根运动通过 get_root_motion_position()/rotation 在物理帧提取;序列与混合支持 animation_set_next、queue、blend_times、反向播放;RESET 轨道保证属性不跨场景残留;提供多个脚本模板,如 method_track_logic.gd、runtime_anim_lib_swapper.gd、dynamic_shader_animation.gd、procedural_track_modifier.gd、reset_track_orchestrator.gd、bezier_curve_extraction.gd、active_animation_culler.gd、root_motion_physics_sync.gd、character_part_swapper_tracks.gd、precise_audio_sync.gd、animation_sequencer.gd、programmatic_anim.gd、audio_sync_tracks.gd。

使用方式:实现对应模式前先打开匹配脚本;深度配方见 references/track-authoring.md、root-motion-and-sequences.md、edge-cases.md。

限制与禁忌:不要忘记 RESET 轨道;一次性逻辑不要用 CALL_MODE_CONTINUOUS,应使用 CALL_MODE_DISCRETE;不要直接动画内嵌资源属性;循环片段不要依赖 animation_finished;大规模场景不要硬编码动画名字符串;同帧读取时 seek() 需 update=true;离屏纯视觉播放器应停用 active;不要修改正在播放的 AnimationLibrary;长同步不要依赖 speed_scale,优先对共享时钟 seek()。AnimationPlayer 适合时间轴/多属性/可复用场景,一次性运行时可中断动效优先用 Tween。