rtmpstreamer 0.1.1

Flutter Android RTMP streaming plugin with camera preview and on-the-fly screen sharing via MediaProjection.

rtmpstreamer

Flutter Android RTMP streaming with camera preview and on-the-fly screen sharing.

rtmpstreamer is built for Flutter apps that need RTMP live streaming with runtime switching between the camera and Android screen sharing. You can start a camera RTMP stream, keep the same RTMP session running, and switch to screen sharing through MediaProjection when the user needs to share the device screen.

Use it when people search for:

• Flutter RTMP streaming with screen sharing
• RTMP screen share Flutter
• Android MediaProjection RTMP streaming
• Flutter live streaming camera to screen share
• on-the-fly camera to screen sharing RTMP

Current platform support:

Android only

Install

From Git:

dependencies:
  rtmpstreamer:
    git:
      url: https://github.com/gitlad11/flutter_rtmp_screensharing.git
      path: packages/rtmpstreamer
      ref: v0.1.1

After publishing on pub.dev:

dependencies:
  rtmpstreamer: ^0.1.1

Features

• RTMP publishing from Flutter on Android.
• Native camera preview widget.
• Microphone audio capture.
• On-the-fly switching from camera stream to screen sharing.
• Android MediaProjection screen capture support.
• Camera switching.
• Mute/unmute microphone.
• Stream orientation and rotation control.
• Native stream events: connecting, connected, started, failed, bitrate, stopped.
• Android raw encoded H264/AAC frame access.
• Android chunked encoded frame capture for recording/upload pipelines.

Android Permissions

The plugin manifest declares the required permissions and foreground service. Your app still needs to request runtime permissions when Android asks for them.

Required capabilities:

CAMERA
RECORD_AUDIO
INTERNET
FOREGROUND_SERVICE
FOREGROUND_SERVICE_MEDIA_PROJECTION
POST_NOTIFICATIONS

Usage

Import:

import 'package:rtmpstreamer/rtmpstreamer.dart';

Add preview:

const AspectRatio(
  aspectRatio: 16 / 9,
  child: RtmpCameraPreview(),
)

Configure and start:

await RtmpStreamer.updateStreamSettings(
  const RtmpStreamSettings(
    width: 1280,
    height: 720,
    fps: 30,
    bitrate: 2500000,
    orientation: RtmpOrientation.landscape,
  ),
);

await RtmpStreamer.startPreviewCamera();
await RtmpStreamer.startStream('rtmp://<host-ip>:1935/live/test');

Listen to events:

RtmpStreamer.events.listen((event) {
  print('${event.type}: ${event.message}');
});

Stop:

await RtmpStreamer.stopStream();
await RtmpStreamer.release();

Switch camera:

await RtmpStreamer.switchCamera();

Mute:

final muted = await RtmpStreamer.toggleMute();

On-the-fly screen sharing:

await RtmpStreamer.switchSource(RtmpSource.screen);

Android will show the MediaProjection consent dialog. After approval, the native Android layer switches the active stream source from camera to screen sharing.

Switch back to camera:

await RtmpStreamer.switchSource(RtmpSource.camera);

Orientation:

await RtmpStreamer.setCameraOrientation(
  RtmpOrientation.portrait,
  rotationDegrees: 90,
);

MediaMTX Test

Publish URL:

rtmp://<host-ip>:1935/live/test

Watch URL:

http://<host-ip>:8888/live/test/

For Android Emulator:

rtmp://10.0.2.2:1935/live/test

For a physical device, use the computer LAN IP.

Native Android API

The plugin contains the Android core under:

com.gitlad.rtmpstreamer

Main classes:

RtmpStreamingClient
StreamSettings
StreamEvent
RawFrameListener
RawFrameChunker
ScreenShareForegroundService
PreviewSurfaceHolder

Limitations

• Android only.
• RTMP protocol internals are currently handled by PedroSG94 RootEncoder.
• Raw/chunk APIs are available in the Android layer; Dart-facing raw frame streaming is not exposed yet.
• Chunked capture returns encoded frame chunks, not muxed .flv/.mp4 files yet.