搜索插件、代码仓与 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 项

源码仓库

使用此插件的项目