搜尋套件、儲存庫與 APP 分類

snow_fall_animation 封面
套件詳情v0.0.1+3

snow_fall_animation

一個創建美麗雪落動畫和效果的Flutter外掛程式

AndroidiOSWebmacOSWindowsLinux
近 30 天下載
11
喜歡數
64
Pub 分數
150

安裝套件

flutter pub add snow_fall_animation

套件介紹

根據套件公開資料產生的選型評估,僅供參考。

一個 Flutter 插件,可為應用程式產生真實且可自訂的雪片飄落動畫。它讓開發者能在 Android、iOS、Web、macOS、Windows 和 Linux 等多個平台添加動態且視覺上吸引人的雪景效果。該動畫支援多種設定,例如雪片大小、速度、密度與方向,非常適合季節性或冬季主題的使用者介面。以效能為設計核心,使用簡單的 API 可輕鬆整合至現有的 Flutter 專案中。完美適用於節日時段提升使用者體驗,或創造沉浸式背景。

適用情境

  • 冬季主題的應用介面
  • 假期活動促銷
  • 沉浸式背景視覺效果
  • 季節性移動遊戲環境
  • 動畫啟動畫面
  • 互動數位賀卡

主要特色

  • 可自訂的雪花外觀
  • 可調節的下落速度和密度
  • 多平台支援
  • 所有裝置上的順暢效能
  • 與 Flutter widget 的簡單整合
  • 可設定的動畫方向與隨機性

適合對象

  • 開發季節性應用程式的開發者
  • 尋求動畫背景的設計者
  • 建構節日數位體驗的團隊
  • Flutter 初學者探索視覺效果
  • 針對冬季假日的應用

使用建議

  • 可能影響低階裝置的效能
  • 需要仔細調整才能獲得最佳幀率
  • 僅限視覺效果,非互動元件
  • 不適合非季節性或極簡風格的設計
  • 最佳搭配輕量級 UI 元件使用

原始 README

以下為關聯原始碼儲存庫的 README 原文快照,最新內容請造訪原始碼儲存庫。

❄️ Snow Fall Plugin ❄️

Transform your Flutter app into a winter wonderland

pub package likes popularity

• Realistic snow animations • Custom emoji support • Smooth performance • Easy implementation • Full customization

Snow Fall Demo


Table of Contents

Features

  • 🌨️ Realistic snow fall animation
  • 🎄 Support for custom emojis (snowflakes, Christmas-themed, etc.)
  • ⚡ Smooth performance with multiple animation styles
  • 🎮 Customizable controls for speed, density, and wind effects
  • 🏔️ Optional snow accumulation at the bottom
  • 🎯 Easy to implement with minimal setup
  • 📱 Works on all Flutter platforms
Demo Examples
'Default Snow' 'Christmas Magic' 'Winter Wonderland'

Getting Started

Installation

Add snow_fall_animation to your pubspec.yaml:

dependencies:
  snow_fall_animation: ^0.0.1+2

Or install via command line:

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: [
          // Your background
          Container(
            decoration: BoxDecoration(
              gradient: LinearGradient(
                begin: Alignment.topCenter,
                end: Alignment.bottomCenter,
                colors: [
                  Colors.blue[900]!,
                  Colors.blue[700]!,
                ],
              ),
            ),
          ),

          // Snow fall animation
          SnowFallAnimation(
            config: SnowfallConfig(
              numberOfSnowflakes: 200,
              speed: 1.0,
              useEmoji: true,
              customEmojis: ['❄️', '❅', '❆'],
            ),
          ),

          // Your content
          YourContent(),
        ],
      ),
    );
  }
}

Configuration Properties

SnowfallConfig Properties
Property Type Default Range/Values Description
numberOfSnowflakes int 200 50-500 Number of snowflakes displayed on screen
speed double 1.0 0.1-3.0 Base falling speed of the snowflakes
useEmoji bool true true/false Whether to use emojis or basic shapes
customEmojis List<String> ['❄️', '❅', '❆'] Any emoji list List of emojis to use as snowflakes
snowColor Color Colors.white Any Color Color of non-emoji snowflakes
holdSnowAtBottom bool true true/false Whether snow accumulates at bottom
cleanupDuration Duration 3 seconds Any Duration Time taken for cleanup animation
accumulationDuration Duration 10 seconds Any Duration Time between cleanup cycles
minSnowflakeSize double 2.0 1.0-10.0 Minimum size of snowflakes
maxSnowflakeSize double 8.0 1.0-20.0 Maximum size of snowflakes
swingRange double 1.0 0.0-2.0 Horizontal swing amplitude
rotationSpeed double 1.0 0.0-3.0 Rotation speed of snowflakes
maxSnowHeight double 50.0 0.0-100.0 Maximum height of accumulated snow
enableSnowDrift bool true true/false Enable horizontal drifting
windForce double 0.0 -2.0-2.0 Horizontal wind force (negative = left)
enableRandomSize bool true true/false Randomize snowflake sizes
enableRandomOpacity bool true true/false Randomize snowflake opacity
minOpacity double 0.5 0.0-1.0 Minimum snowflake opacity
maxOpacity double 1.0 0.0-1.0 Maximum snowflake opacity

Presets & Effects

Animation Effects
Effect Properties Values Description
Heavy Snow numberOfSnowflakes
speed
300-500
1.5-2.0
Dense, fast-falling snow
Light Snow numberOfSnowflakes
speed
50-100
0.5-0.8
Sparse, gentle snow
Blizzard windForce
speed
1.5-2.0
2.0-3.0
Strong sideways wind
Gentle Drift windForce
swingRange
0.2-0.5
0.5-1.0
Slight drifting motion
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
Category Emojis Purpose
Snow ❄️ ❅ ❆ ✻ ✼ Basic snow effects
Christmas 🎅 🤶 🎄 🎁 ⭐ 🔔 Christmas theme
Winter ⛄ 🧣 🧤 🎿 🦌 Winter activities
Decorations 🎄 ⭐ 🔔 🧦 🕯️ Holiday decorations
Treats 🍪 🥛 🍷 Holiday treats

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

// ... rest of the implementation
}

Performance

Optimization Tips
  1. Keep numberOfSnowflakes between 100-300 for best performance
  2. Disable unnecessary effects (enableRandomOpacity, enableSnowDrift) if not needed
  3. Use basic shapes instead of emojis for better performance
  4. Adjust cleanup cycle timing based on your needs
Platform-Specific Notes
  • Web: Keep number of snowflakes lower for better performance
  • Mobile: Works well with default settings
  • Desktop: Can handle higher numbers of snowflakes

Example App

The plugin includes a complete example app. To run:

  1. Clone the repository
  2. Navigate to example directory:
cd example
  1. Run the app:
flutter run

The example app demonstrates:

  • Different preset configurations
  • Custom emoji selection
  • Animation controls
  • Bottom sheet customization
  • Preset switching

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Development Setup
  1. Fork the repository
  2. Clone your fork
  3. Create a new branch
  4. Make your changes
  5. Submit a pull request

Visitors Count

Loading

所屬分類

依賴

依賴清單 1 項

  • plugin_platform_interface^2.0.2

原始碼儲存庫

使用此套件的專案