搜索插件、代码仓与 APP 分类

stories_editor 封面
插件详情v0.2.2

stories_editor

这是一个以 Instagram 故事创作者风格创建的包,可用来创建包含图片、文字、贴纸(GIF)和手指绘画的图像。

近 30 天下载
45
喜欢数
108
Pub 分数
55

安装插件

flutter pub add stories_editor

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

stories_editor 包允许用户在 Flutter 应用中创建类似 Instagram 的故事。它支持添加图片、文字、动画贴纸(GIF)以及通过手指输入进行自由绘制。专为多媒体编辑设计,可实现实时编排、自定义和导出故事。该包非常适合社交功能、内容创作工具或互动叙事应用。注重简洁性和性能,可无缝集成到现有的 Flutter 项目中。

适合场景

  • 社交媒体故事创作
  • 用户生成内容工具
  • 互动叙事应用
  • 带有叠加效果的照片编辑
  • 实时绘图功能
  • 动态贴纸集成

主要特点

  • 图像叠加支持
  • 带样式的文本添加
  • 动画GIF贴纸
  • 手指绘图画布
  • 实时预览
  • 导出和保存功能

适合对象

  • 开发社交应用的开发者
  • 内容创作者需要故事工具
  • 需要多媒体编辑的应用程序
  • Flutter 初学者探索 UI 组件
  • 具有交互式绘图需求的项目

使用建议

  • 有限的平台支持(未指定平台)
  • 需要手动处理图像/GIF资源
  • 性能可能因复杂组合而有所不同
  • 未提及任何内置压缩选项
  • 依赖外部资产管理

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

I won't be giving support or any update for a while beacuse i don't have time to spend in this project.

Flutter version 3.3.6

Previous branches was deleted (4-Nov-2022)

if you want to make a ull request you must be using the new "main" branch, the problems with gallery, overflow design were solved and the function to create Gif / mp4 was removed due to performance issues.

flutter stories editor

This is a package created in the style of the instagram story creator, with which you can create images with images, texts, stickers (Gifs), finger drawing. They can be exported as an image to the gallery or shared directly to social networks.

Features

[✔️] Draggable image

[✔️] Draggable text

[✔️] Draggable Gif/Sticker (giphy API)

[✔️] Gradient container background

[✔️] Finger painting (normal/translucent/neon)

[✔️] Custom colors, gradients and font families

[✔️] Custom gallery picker (own package => gallery_media_picker)

[✔️] Save draft as image

[✔️] Get draft local path uri

[✔️] Text animations => animated_text_kit

Future features

[❌] Save draft as a gif / video

[❌] Color filters

Demo

If you don't see the images go to the github repository and by the way give me a star :D

showcase gif showcase gif

Installation

This package has been tested in Android and ios, some features works on flutter web

Add stories_editor: 0.1.8 to your pubspec.yaml dependencies and then import it.

import 'package:stories_editor/stories_editor.dart';

How to use

  1. Android

    add uses-permission AndroidMAnifest.xml file

     <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
     <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"
         android:maxSdkVersion="31" />
     <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />
     <uses-permission android:name="android.permission.INTERNET" />
     <uses-permission android:name="android.permission.VIBRATE"/>
    
    ios

    add this config to your config.plist

    <key>NSPhotoLibraryUsageDescription</key>
    <string>Privacy - Photo Library Usage Description</string>
    <key>NSMotionUsageDescription</key>
    <string>Motion usage description</string>
    <key>NSPhotoLibraryAddUsageDescription</key>
    <string>NSPhotoLibraryAddUsageDescription</string>
    
  2. Create a StoriesEditor() widget with the follow params:

StoriesEditor(
    giphyKey: '[YOUR GIPHY API KEY]', /// (String) required param
    onDone: (String uri){
      /// uri is the local path of final render Uint8List
      /// here your code
    },
    colorList: [] /// (List<Color>[]) optional param 
    gradientColors: [] /// (List<List<Color>>[]) optional param 
    middleBottomWidget: Container() /// (Widget) optional param, you can add your own logo or text in the bottom tool
    fontFamilyList: [] /// (List<String>) optional param
    isCustomFontList: '' /// (bool) if you use a own font list set value to "true"
    onDoneButtonStyle: Container() /// (Widget) optional param, you can create your own button style
    onBackPress: /// (Future<bool>) optional param, here you can add yor own style dialog
    editorBackgroundColor: /// (Color) optional param, you can define your own background editor color
    galleryThumbnailQuality: /// (int = 200) optional param, you can set the gallery thumbnail quality (higher is better but reduce the performance)
);

Example

import 'package:flutter/material.dart';
import 'package:provider/provider.dart';
import 'package:share_plus/share_plus.dart';
import 'package:stories_editor/stories_editor.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);
  
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter stories editor Demo',
      theme: ThemeData(

        primarySwatch: Colors.blue,
      ),
      home: const Example(),
    );
  }
}

class Example extends StatefulWidget {
  const Example({Key? key}) : super(key: key);



  @override
  State<Example> createState() => _ExampleState();
}

class _ExampleState extends State<Example> {

  @override
  Widget build(BuildContext context) {
    return Scaffold(
        backgroundColor: Colors.black,
        resizeToAvoidBottomInset: false,
        body: Center(
          child: ElevatedButton(
            onPressed: (){
              Navigator.push(context, MaterialPageRoute(builder: (context) => StoriesEditor(
                giphyKey: '[HERE YOUR API KEY]',
                onDone: (uri){
                  debugPrint(uri);
                  Share.shareFiles([uri]);
                },
              ))
              );
            },
            child: const Text('Open Stories Editor'),
          ),
        )
    );
  }
}

Issues
  1. Issue of photo_View: photo_view#499 Issue log => To safely refer to a widget's ancestor in its dispose() method, save a reference to the ancestor by calling dependOnInheritedWidgetOfExactType() in the widget's didChangeDependencies() method.

ScreenShots

initial view

Custom image picker made with Photo_manager package

Gradient background taking image color pixel

Exit Dialog

Custom Gif Picker made with a fork of Giphy_picker package

Custom finger Drawing made with perfect_freehand package

Text Editor

All features together

Share to social networks made with share_plus package

Saved image

所属分类

依赖

依赖清单 12 项

源码仓库

使用此插件的项目