维基
Bevy 完整教程
Animation（动画系统）
UI 动画

UI 动画

概述

学习目标：

  • 理解 UI 动画的基本概念
  • 掌握 UI 属性动画的创建和使用
  • 学会对文本进行动画处理
  • 了解颜色动画的使用

前置知识要求：

  • 动画基础
  • UI 基础
  • ECS 基础

核心概念

什么是 UI 动画？

UI 动画是对用户界面元素进行动画处理的功能。Bevy 支持对 UI 属性（如字体大小、颜色等）进行动画处理。

为什么需要 UI 动画？

  1. 用户体验：动画可以改善用户体验
  2. 视觉反馈：动画可以提供视觉反馈
  3. 交互性：动画可以增强交互性
  4. 艺术表现：动画可以增强艺术表现力

UI 动画的核心组件

Bevy UI 动画包含以下核心组件：

  • AnimationClip：动画片段，包含 UI 属性动画数据
  • AnimationGraph：动画图，用于组织和管理 UI 动画
  • AnimationPlayer：动画播放器，用于播放 UI 动画
  • AnimationTarget：动画目标，用于指定动画作用的 UI 元素

基础用法

UI 属性动画

对 UI 属性（如字体大小）进行动画处理。

源代码文件：bevy/examples/animation/animated_ui.rs

代码示例：

use bevy::prelude::*;

fn setup(
    mut commands: Commands,
    mut animation_graphs: ResMut<Assets<AnimationGraph>>,
    mut animation_clips: ResMut<Assets<AnimationClip>>,
) {
    // 创建动画目标 ID
    let animation_target_name = Name::new("Text");
    let animation_target_id = AnimationTargetId::from_name(&animation_target_name);
    
    // 创建动画片段
    let mut animation_clip = AnimationClip::default();
    
    // 创建字体大小动画曲线
    animation_clip.add_curve_to_target(
        animation_target_id,
        AnimatableCurve::new(
            animated_field!(TextFont::font_size),
            AnimatableKeyframeCurve::new(
                [0.0, 0.5, 1.0, 1.5, 2.0, 2.5, 3.0]
                    .into_iter()
                    .zip([24.0, 80.0, 24.0, 80.0, 24.0, 80.0, 24.0]),
            )
            .expect("valid curve"),
        ),
    );
    
    // 保存动画片段
    let animation_clip_handle = animation_clips.add(animation_clip);
    
    // 创建动画图
    let (animation_graph, animation_node_index) =
        AnimationGraph::from_clip(animation_clip_handle);
    let animation_graph_handle = animation_graphs.add(animation_graph);
    
    // 创建文本实体
    commands.spawn((
        Text::default(),
        TextFont {
            font_size: 24.0,
            ..default()
        },
        animation_target_name,
        AnimationGraphHandle(animation_graph_handle),
        AnimationPlayer::default().play(animation_node_index).repeat(),
    ));
}

关键要点：

  • 可以使用 animated_field! 宏来指定要动画的属性
  • 需要为 UI 元素设置名称以作为动画目标
  • 动画曲线定义属性值随时间的变化
  • 可以设置动画的重复模式

说明： UI 属性动画是创建动态用户界面的重要工具。通过对 UI 属性进行动画处理，可以创建各种视觉效果，如字体大小的变化、颜色的渐变等。

文本动画

对文本进行动画处理。

源代码文件：bevy/examples/animation/animated_ui.rs

代码示例：

use bevy::prelude::*;

fn setup_text_animation(
    mut commands: Commands,
    mut animation_graphs: ResMut<Assets<AnimationGraph>>,
    mut animation_clips: ResMut<Assets<AnimationClip>>,
) {
    let animation_target_name = Name::new("Text");
    let animation_target_id = AnimationTargetId::from_name(&animation_target_name);
    
    let mut animation_clip = AnimationClip::default();
    
    // 创建字体大小动画
    animation_clip.add_curve_to_target(
        animation_target_id,
        AnimatableCurve::new(
            animated_field!(TextFont::font_size),
            AnimatableKeyframeCurve::new(
                [0.0, 1.0, 2.0].into_iter().zip([24.0, 48.0, 24.0]),
            )
            .expect("valid curve"),
        ),
    );
    
    // 创建文本颜色动画
    animation_clip.add_curve_to_target(
        animation_target_id,
        AnimatableCurve::new(
            TextColorProperty,
            AnimatableKeyframeCurve::new(
                [0.0, 1.0, 2.0].into_iter().zip([
                    Srgba::RED,
                    Srgba::GREEN,
                    Srgba::BLUE,
                ]),
            )
            .expect("valid curve"),
        ),
    );
    
    let animation_clip_handle = animation_clips.add(animation_clip);
    let (animation_graph, animation_node_index) =
        AnimationGraph::from_clip(animation_clip_handle);
    let animation_graph_handle = animation_graphs.add(animation_graph);
    
    commands.spawn((
        Text::default(),
        TextFont {
            font_size: 24.0,
            ..default()
        },
        TextColor(Srgba::RED),
        animation_target_name,
        AnimationGraphHandle(animation_graph_handle),
        AnimationPlayer::default().play(animation_node_index).repeat(),
    ));
}

关键要点：

  • 可以对文本的多个属性进行动画处理
  • 可以使用 TextColorProperty 来动画文本颜色
  • 所有动画曲线应该有相同的时间范围
  • 可以组合多个属性动画

说明： 文本动画是创建动态文本效果的重要工具。通过对文本的字体大小、颜色等属性进行动画处理，可以创建各种视觉效果，如闪烁、渐变、缩放等。

颜色动画

对 UI 元素的颜色进行动画处理。

源代码文件：bevy/examples/animation/animated_ui.rs

代码示例：

use bevy::prelude::*;

fn setup_color_animation(
    mut commands: Commands,
    mut animation_graphs: ResMut<Assets<AnimationGraph>>,
    mut animation_clips: ResMut<Assets<AnimationClip>>,
) {
    let animation_target_name = Name::new("Button");
    let animation_target_id = AnimationTargetId::from_name(&animation_target_name);
    
    let mut animation_clip = AnimationClip::default();
    
    // 创建背景颜色动画
    animation_clip.add_curve_to_target(
        animation_target_id,
        AnimatableCurve::new(
            BackgroundColorProperty,
            AnimatableKeyframeCurve::new(
                [0.0, 1.0, 2.0].into_iter().zip([
                    Srgba::RED,
                    Srgba::GREEN,
                    Srgba::BLUE,
                ]),
            )
            .expect("valid curve"),
        ),
    );
    
    let animation_clip_handle = animation_clips.add(animation_clip);
    let (animation_graph, animation_node_index) =
        AnimationGraph::from_clip(animation_clip_handle);
    let animation_graph_handle = animation_graphs.add(animation_graph);
    
    commands.spawn((
        Node::default(),
        BackgroundColor(Srgba::RED),
        animation_target_name,
        AnimationGraphHandle(animation_graph_handle),
        AnimationPlayer::default().play(animation_node_index).repeat(),
    ));
}

关键要点：

  • 可以对 UI 元素的背景颜色进行动画处理
  • 可以使用 BackgroundColorProperty 来动画背景颜色
  • 颜色值使用 Srgba 类型
  • 可以创建平滑的颜色过渡

说明： 颜色动画是创建动态 UI 效果的重要工具。通过对 UI 元素的颜色进行动画处理，可以创建各种视觉效果，如颜色渐变、闪烁、脉冲等。

进阶用法

组合多个 UI 动画

可以组合多个 UI 属性动画来创建复杂的动画效果。

源代码文件：bevy/examples/animation/animated_ui.rs

关键信息：

  • 可以在同一个动画片段中添加多个属性动画
  • 所有动画曲线应该有相同的时间范围
  • 可以同时动画多个 UI 元素
  • 可以使用动画图来组织复杂的动画

说明： 组合多个 UI 动画是创建复杂动画效果的关键。通过组合多个属性动画，可以创建各种视觉效果，如同时改变字体大小和颜色、同时动画多个 UI 元素等。

响应式 UI 动画

可以根据用户交互触发 UI 动画。

源代码文件：bevy/examples/animation/animated_ui.rs

关键信息：

  • 可以在用户交互时触发动画
  • 可以使用动画事件来同步动画和交互
  • 可以根据游戏状态调整动画
  • 可以动态创建和销毁动画

说明： 响应式 UI 动画是创建交互式用户界面的关键。通过根据用户交互触发动画，可以创建更加动态和交互的用户界面。

实际应用

在游戏开发中的应用场景

UI 动画在游戏开发中有广泛的应用：

  1. 按钮动画：对按钮进行悬停、点击等动画处理
  2. 文本动画：对文本进行闪烁、渐变等动画处理
  3. 菜单动画：对菜单进行展开、收起等动画处理
  4. 提示动画：对提示信息进行出现、消失等动画处理

常见问题

问题 1：如何创建平滑的 UI 动画？

解决方案：使用缓动函数。通过应用缓动函数，可以创建平滑的 UI 动画过渡。

问题 2：如何同时动画多个 UI 属性？

解决方案：在同一个动画片段中添加多个属性动画曲线。所有曲线应该有相同的时间范围。

问题 3：如何根据用户交互触发动画？

解决方案：在交互系统中触发动画播放。可以使用 AnimationPlayer 的 play() 方法来播放动画。

性能考虑

  1. 动画数量：尽量减少同时播放的动画数量
  2. 属性选择：只对需要的属性进行动画处理
  3. 缓动函数：选择简单的缓动函数以提高性能
  4. 动画图优化：使用动画图来组织和管理动画

相关资源

相关源代码文件：

  • bevy/examples/animation/animated_ui.rs - UI 动画示例

官方文档链接：

进一步学习建议：

  • 学习动画进阶，了解动画图和动画混合
  • 学习 UI 基础，了解 UI 系统的使用
  • 学习动画事件，了解如何在动画中触发事件

索引：返回上级目录

动画基础