/vesdk-flutter

Flutter plugin for VideoEditor SDK

Primary LanguageSwiftOtherNOASSERTION

VideoEditor SDK Logo

pub.dev version Platform support Twitter

Flutter plugin for VideoEditor SDK

Getting started

Add the plugin package to the pubspec.yaml file in your project:

dependencies:
  video_editor_sdk: ^2.3.0

Install the new dependency:

flutter pub get

Android

  1. Because VideoEditor SDK for Android is quite large, there is a high chance that you will need to enable Multidex for your project as follows:

    Open the android/app/build.gradle file (not android/build.gradle) and add these lines at the end:

    android {
      defaultConfig {
          multiDexEnabled true
      }
    }
    dependencies {
        implementation 'androidx.multidex:multidex:2.0.1'
    }
  2. Add the img.ly repository and plugin by opening the android/build.gradle file (not android/app/build.gradle) and adding these lines at the top:

    buildscript {
        repositories {
            mavenCentral()
            maven { url "https://artifactory.img.ly/artifactory/imgly" }
        }
        dependencies {
            classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.4.10"
            classpath 'ly.img.android.sdk:plugin:9.2.0'
        }
    }

    In order to update VideoEditor SDK for Android replace the version string 9.2.0 with a newer release.

  3. Still in the android/build.gradle file (not android/app/build.gradle), add these lines at the bottom:

    allprojects {
        repositories {
            maven { url 'https://artifactory.img.ly/artifactory/imgly' }
        }
    }
  4. Configure VideoEditor SDK for Android by opening the android/app/build.gradle file (not android/build.gradle) and adding the following lines under apply plugin: "com.android.application":

    apply plugin: 'ly.img.android.sdk'
    apply plugin: 'kotlin-android'
    
    // Comment out the modules you don't need, to save size.
    imglyConfig {
        modules {
            include 'ui:text'
            include 'ui:focus'
            include 'ui:frame'
            include 'ui:brush'
            include 'ui:filter'
            include 'ui:sticker'
            include 'ui:overlay'
            include 'ui:transform'
            include 'ui:adjustment'
            include 'ui:text-design'
            include 'ui:video-trim'
            include 'ui:video-library'
            include 'ui:video-composition'
            include 'ui:audio-composition'
    
            // This module is big, remove the serializer if you don't need that feature.
            include 'backend:serializer'
    
            // Remove the asset packs you don't need, these are also big in size.
            include 'assets:font-basic'
            include 'assets:frame-basic'
            include 'assets:filter-basic'
            include 'assets:overlay-basic'
            include 'assets:sticker-shapes'
            include 'assets:sticker-emoticons'
            include 'assets:sticker-animated'
    
            include 'backend:sticker-animated'
            include 'backend:sticker-smart'
        }
    }

Usage

Import the packages in your main.dart:

import 'package:video_editor_sdk/video_editor_sdk.dart';
import 'package:imgly_sdk/imgly_sdk.dart';

Each platform requires a separate license file. Unlock VideoEditor SDK with a single line of code for both platforms via platform-specific file extensions.

Rename your license files:

  • Android license: vesdk_license.android
  • iOS license: vesdk_license.ios

Pass the file path without the extension to the unlockWithLicense function to unlock both iOS and Android:

VESDK.unlockWithLicense("assets/vesdk_license");

Open the editor with a video:

VESDK.openEditor(Video("assets/video.mp4"));

Please see the API documentation for more details and additional customization and configuration options.

Example

Please see our example project which demonstrates how to use the Flutter plugin for VideoEditor SDK.

License Terms

Make sure you have a commercial license for VideoEditor SDK before releasing your app. A commercial license is required for any app or service that has any form of monetization: This includes free apps with in-app purchases or ad supported applications. Please contact us if you want to purchase the commercial license.

Support and License

Use our service desk for bug reports or support requests. To request a commercial license, please use the license request form on our website.