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

套件詳情v0.2.9+1

smart_flare

一個有助於處理大型 Flare 動畫和互動的套件。

近 30 天下載
53
喜歡數
53
Pub 分數
40

安裝套件

flutter pub add smart_flare

套件介紹

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

Smart Flare 是一個 Flutter 套件,專為簡化應用程式中整合與管理大型複雜 Flare 動畫及互動元件而設計。它透過優化資源載入、處理狀態轉換,以及實現響應式互動來提升效能與開發者體驗。適用於遊戲與豐富的使用者介面,此套件以直覺的 API 簡化 Flare 動畫功能的使用。該套件支援動態內容更新,並可在不同螢幕尺寸上實現順暢播放。

適用情境

  • 互動遊戲介面
  • 複雜的動畫引導流程
  • 應用程式中的動態UI元素
  • 豐富的敘事體驗
  • 效能優化的動畫
  • 即時角色互動

主要特色

  • 大型 Flare 檔案的優化載入
  • 內建互動處理
  • 動畫的狀態管理
  • 響應式設計支援
  • 與 Flutter 小部件輕鬆整合
  • 支援動態動畫變更

適合對象

  • 使用 Flare 的遊戲開發者
  • UI設計師創造動畫體驗
  • 需要高性能量動畫的應用
  • 開發人員在處理複雜的 Flare 資產時
  • 專注於順暢的使用者互動

使用建議

  • 需要正確匯出火焰資產
  • 最適合已經使用 Flare 的專案
  • 僅限支援 Flare 渲染的平台
  • 使用大型動畫可能會增加應用大小
  • 依賴 FilledStacks 的 Flare 生態系統

原始 README

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

Smart Flare - Customizable Interactable Flare actors

Interactive capabilities for larger Flare animations.

Installation

Add smart_flare as dependency to your pubspec file.

smart_flare: any

Example

Here is an example of how to use the functionality within this project.

Usage

If you want to just play a normal animation I would recommend using Flare's Flutter Package. This is for animations that you want some interaction on.

This is used the same as a Flare Actor is used with some additional properties. To use this actor at a minimum level you have to supply width, heigh and the filename to the animation. This will draw the animation on screen without playing anything.

import 'package:flutter/material.dart';
import 'package:smart_flare/smart_flare.dart';

class FlareDemo extends StatefulWidget {
  @override
  _FlareDemoState createState() => _FlareDemoState();
}

class _FlareDemoState extends State<FlareDemo> {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      backgroundColor: Colors.black,
        body: SmartFlareActor(
            width: 295.0,
            height: 251.0,
            filename: 'assets/button-animation.flr'));
  }
}

Additionally you can then give it a starting animation for it to play something.

SmartFlareActor(
    width: 295.0,
    height: 251.0,
    filename: 'assets/button-animation.flr',
    startingAnimation: 'deactivate')
Interactive Areas

The main feature of this package is to provide it's interactive nature. You can supply the actor with ActiveArea's which looks as follows.

class ActiveArea {
  final Rect area;
  final String animationName;
  final List<String> animationsToCycle;
  final Function onAreaTapped;
  final List<String> guardComingFrom;
  final bool debugArea;
  ...
}

Each active area requires an area and either an animationName to play when tapped, or a list of animationsToCycle through when tapped. You can also set debugArea to true and the touch area will display over the animation so you can see if your calculations are correct.

ActiveArea(
    debugArea: true,
    area: Rect.fromLTWH(thirdOfWidth*2, 0, thirdOfWidth, animationHeight / 2),
    animationName: 'image_tapped',
   ),

Areas can also be defined using relative placements.

 RelativeActiveArea(
    // from (0,0) with a width 35% of animation width and 50% of height
    area: Rect.fromLTRB(0, 0, 0.35, 0.5),
    animationName: 'camera_tapped'
),
Area Callbacks

If you want to perform an action when something is tapped, which you probably do you can supply a function to onAreaTapped and run your code in there.

ActiveArea(
    debugArea: true,
    area: Rect.fromLTWH(thirdOfWidth*2, 0, thirdOfWidth, animationHeight / 2),
    animationName: 'image_tapped',
    onAreaTapped: () {
      print('Area Tapped!');
    }
   )
Guarding against animation

If you want to make sure that an animation does not play after another you can supply it with a list of animations to guard against. This means that, the area animation you want to play, WILL NOT PLAY of the last played animation is contained in the guardComingFrom list. GuardGoingTo coming in next release.

ActiveArea(
          debugArea: true,
          area: Rect.fromLTWH(thirdOfWidth*2, 0, thirdOfWidth, animationHeight / 2),
          guardComingFrom: ['deactivate'],
          animationName: 'image_tapped',
          onAreaTapped: () {
            print('Image tapped!');
          }),

And that's it!

Specialized Actors
CycleFlareActor

Given a list of animations this actor will play one after the other as it is tapped.

CycleFlareActor(
    width: animationWidth,
    height: animationHeight,
    filename: 'assets/button-animation.flr',
    animations: ['deactivate', 'activate'],
  )
PanFlareActor

Given an open and close animation this actor will play those animations when panned across it. It plays the open animation in the direction supplied. If no close animation is provided the open animation will be reversed when swiping in the "closing" direction.

Currently only supports horizontal panning. Vertical panning on the way.

PanFlareActor(
    width: 135.0,
    height: screenSize.height,
    filename: "assets/tutorial-transition.flr",
    openAnimation: 'drawer-open',
    closeAnimation: 'drawer-close',
    direction: ActorAdvancingDirection.RightToLeft,
    threshold: 60.0,
    reverseOnRelease: true,
    activeAreas: [
      RelativePanArea(
        area: Rect.fromLTWH(0, 0.7, 1.0, 0.3),
        debugArea: true
      )
    ],
  )

threshold (optional): Total number of pixels to swipe to play the animation until the end when released.

reverseOnRelease (optional. Default true): Tells the actor to reverse the animation when the user stops interacting with the actor and the threshold is not reached.

activeAreas (required): You have to supply at least one relative pan area

Contribution

  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request.

所屬分類

依賴

依賴清單 1 項

原始碼儲存庫

使用此套件的專案