apivideo_live_stream 1.2.0 copy "apivideo_live_stream: ^1.2.0" to clipboard
apivideo_live_stream: ^1.2.0 copied to clipboard

Flutter RTMP live stream client for your audio/video application. Made with ♥ by api.video.

badge   badge   badge

Flutter RTMP live stream client

api.video is the video infrastructure for product builders. Lightning fast video APIs for integrating, scaling, and managing on-demand & low latency live streaming features in your app.

Table of contents #

Project description #

This module is made for broadcasting RTMP live stream from smartphone camera.

Getting started #

Installation #

Run the following command at the root of your project:

flutter pub add apivideo_live_stream

In your dart file, import the package:

import 'package:apivideo_live_stream/apivideo_live_stream.dart';

Permissions #

To be able to broadcast, you must:

  1. On Android: ask for internet, camera and microphone permissions:

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.RECORD_AUDIO" />
    <uses-permission android:name="android.permission.CAMERA" />

The library will require android.permission.CAMERA and android.permission.RECORD_AUDIO at runtime. You don't need to request them.

  1. On iOS: update the Info.plist with a usage description for camera and microphone

<string>Your own description of the purpose</string>
<string>Your own description of the purpose</string>

Code sample #

  1. Creates a live stream controller

final ApiVideoLiveStreamController _controller = ApiVideoLiveStreamController(
    initialAudioConfig: AudioConfig(), initialVideoConfig: VideoConfig.withDefaultBitrate());
  1. Initializes the live stream controller
await _controller.initialize();
  1. Adds a CameraPreview widget as a child of your view
Widget build(BuildContext context) {
  return SizedBox(
      width: 300.0,
      height: 300.0,
      child: ApiVideoCameraPreview(controller: _controller));

ApiVideoCameraPreview parameters:

  • controller: the live stream controller
  • fit: the fit of the preview (default is BoxFit.contain, see BoxFit for more information)
  • child: a child widget to overlay on top of the preview (optional)
  1. Starts a live stream
  1. Stops streaming and preview

Manage application lifecycle

On the application side, you must manage application lifecycle:

void didChangeAppLifecycleState(AppLifecycleState state) {
  if (state == AppLifecycleState.inactive) {
  } else if (state == AppLifecycleState.resumed) {

Example App #

You can try our example app, feel free to test it.

Setup #

Be sure to follow the Flutter installation steps before anything.

  1. Open Android Studio
  2. File > New > Project from Version Control

In URL field, type:


Wait for the indexation to finish.


Connect an Android device to your computer and click on the Run main.dart button.


  1. Connect an iOS device to your computer and click on the Run main.dart button.

  2. The build will fail because you haven't set your development profile, sign your application:

Open Xcode, click on "Open a project or file" and open the YOUR_PROJECT_NAME/example/ios/Runner.xcworkspace file.
Click on Example, go in Signin & Capabilities tab, add your team and create a unique bundle identifier.

Plugins #

api.video Flutter live stream library is using external native libraries:

StreamPack StreamPack
HaishinKit HaishinKit


If you have any questions, ask us in the community or use issues.

pub points


verified publisherapi.video

Flutter RTMP live stream client for your audio/video application. Made with ♥ by api.video.

Repository (GitHub)
View/report issues


API reference


MIT (license)


flutter, json_annotation, meta, native_device_orientation, plugin_platform_interface


Packages that depend on apivideo_live_stream