Flutter雪花飘落动画插件snow_fall_animation的使用

❄️ Snow Fall Plugin ❄️

将您的Flutter应用变成一个冬季仙境。

• 真实的雪花飘落动画
• 支持自定义表情符号（雪花、圣诞节主题等）
• 多种动画样式下的平滑性能
• 轻松实现且完全可定制
• 在所有Flutter平台上运行

Table of Contents

• Features
• Demo Examples
• Getting Started
  • Installation
  • Basic Usage
• Configuration Properties
• Presets & Effects
• Emoji Groups
• Advanced Usage
• Performance
• Example App
• Contributing
• License

Features

• 🌨️ 真实的雪花飘落动画
• 🎄 支持自定义表情符号（雪花、圣诞主题等）
• ⚡ 多种动画样式下的平滑性能
• 🎮 可定制的速度、密度和风效控制
• 🏔️ 可选的底部积雪
• 🎯 实现简单，设置最少
• 📱 在所有Flutter平台上运行

Demo Examples

Default Snow	Christmas Magic	Winter Wonderland

Getting Started

Installation

在 pubspec.yaml 文件中添加 snow_fall_animation：

dependencies:
  snow_fall_animation: ^0.0.1+2

或者通过命令行安装：

flutter pub add snow_fall_animation

Basic Usage

import 'package:snow_fall_animation/snow_fall_animation.dart';

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Stack(
        children: [
          // 背景
          Container(
            decoration: BoxDecoration(
              gradient: LinearGradient(
                begin: Alignment.topCenter,
                end: Alignment.bottomCenter,
                colors: [
                  Colors.blue[900]!,
                  Colors.blue[700]!,
                ],
              ),
            ),
          ),

          // 雪花飘落动画
          SnowFallAnimation(
            config: SnowfallConfig(
              numberOfSnowflakes: 200,
              speed: 1.0,
              useEmoji: true,
              customEmojis: ['❄️', '❅', '❆'],
            ),
          ),

          // 您的内容
          YourContent(),
        ],
      ),
    );
  }
}

Configuration Properties

SnowfallConfig Properties

Presets & Effects

Animation Effects

Preset Configurations

// Christmas Magic
SnowfallConfig(
  numberOfSnowflakes: 200,
  speed: 1.0,
  customEmojis: ['❄️', '🎅', '🎄', '🎁', '⭐'],
  windForce: 0.5,
)

// Winter Wonderland
SnowfallConfig(
  numberOfSnowflakes: 250,
  speed: 1.2,
  customEmojis: ['❄️', '⛄', '🦌', '✨', '⭐'],
  windForce: 1.0,
)

// Cozy Christmas
SnowfallConfig(
  numberOfSnowflakes: 120,
  speed: 0.5,
  customEmojis: ['❄️', '🕯️', '🧦', '🍪', '🥛'],
  windForce: 0.2,
)

Emoji Groups

Available Emojis

Advanced Usage

Customization Bottom Sheet

showCustomizationBottomSheet(
  context: context,
  config: currentConfig,
  onConfigChanged: (newConfig) {
    setState(() {
      config = newConfig;
    });
  },
);

Dynamic Configuration

class _MyHomePageState extends State<MyHomePage> {
  late SnowfallConfig _config;

  @override
  void initState() {
    super.initState();
    _config = const SnowfallConfig(
      numberOfSnowflakes: 200,
      speed: 1.0,
      customEmojis: ['❄️', '🎅', '🎄'],
    );
  }

  void _updateConfig(SnowfallConfig newConfig) {
    setState(() {
      _config = newConfig;
    });
  }

  // ... 其余实现
}

Performance

Optimization Tips

1. 将 numberOfSnowflakes 保持在 100-300 之间以获得最佳性能。
2. 如果不需要，禁用不必要的效果（如 enableRandomOpacity, enableSnowDrift）。
3. 使用基本形状而不是表情符号以获得更好的性能。
4. 根据需要调整清理周期的时间。

Platform-Specific Notes

• Web: 为了更好的性能，请降低雪花的数量。
• Mobile: 默认设置下表现良好。
• Desktop: 可以处理更高的雪花数量。

Example App

该插件包含一个完整的示例应用。要运行：

1. 克隆仓库
2. 进入示例目录：

   cd example
   

3. 运行应用：

   flutter run