ivs_broadcaster 0.0.15

IVS Broadcaster SDK for Flutter

ivs_broadcaster

ivs_broadcaster is a Flutter package designed for broadcasting live video and playing streams using AWS Interactive Video Service (IVS). It supports broadcasting and playing video streams on both Android and iOS platforms.

Table of Contents

• Getting Started
• Setup
  • Android Setup
  • iOS Setup
• Usage
  • Broadcaster
  • Player
• Methods for Broadcasting
• Methods for Player
• Listeners for Player

Getting Started

To use this package, you need an AWS account with an IVS channel set up. Follow the setup instructions for Android and iOS platforms.

Setup

Android Setup

1. Add the following permissions to your AndroidManifest.xml file:

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

2. Initialize the broadcaster with your IVS channel URL and stream key:

   String imgset = 'rtmp://<your channel url>';
   String streamKey = '<your stream key>';
   

iOS Setup

1. Add the following keys to your Info.plist file:

   <key>NSCameraUsageDescription</key>
   <string>To stream video</string>
   <key>NSMicrophoneUsageDescription</key>
   <string>To stream the audio</string>
   

Usage

Broadcaster

To use the broadcaster, initialize it and add BroadcaterPreview to your widget tree:

import 'package:ivs_broadcaster/ivs_broadcaster.dart';

IvsBroadcaster? ivsBroadcaster;

@override
void initState() {
  super.initState();
  ivsBroadcaster = IvsBroadcaster.instance;
}

// In your widget tree
...
child: BroadcaterPreview(),
...

Player

To use the player, initialize it and add IvsPlayerView to your widget tree:

import 'package:ivs_broadcaster/Player/ivs_player.dart';
import 'package:ivs_broadcaster/Player/ivs_player_view.dart';

IvsPlayer? ivsPlayer;

@override
void initState() {
  super.initState();
  ivsPlayer = IvsPlayer();
}

// In your widget tree
...
child: IvsPlayerView(
  controller: ivsPlayer!,
  autoDispose: true,
  aspectRatio: 16 / 9,
),
...

This will provide a preview of the camera.

Methods for Broadcasting

• Future<bool> requestPermissions();
  Request camera and microphone permissions.

• Future<void> startPreview({required String imgset, required String streamKey, CameraType cameraType = CameraType.BACK, void Function(dynamic)? onData, void Function(dynamic)? onError});
  Start the preview for broadcasting. Parameters include:

  • imgset: The URL of the IVS channel.
  • streamKey: The stream key for the broadcast.
  • cameraType: The camera type to use (e.g., BACK or FRONT).
  • onData: Callback for receiving data.
  • onError: Callback for error handling.

• Future<void> startBroadcast();
  Start the live broadcast.

• Future<void> stopBroadcast();
  Stop the live broadcast.

• Future<void> changeCamera(CameraType cameraType);
  Change the camera being used for broadcasting.

• Listening to Broadcast State, Quality, and Network Health:

  ivsBroadcaster!.broadcastState.stream.listen((event) {
      log(event.name.toString());
  });
  
  ivsBroadcaster!.broadcastQuality.stream.listen((event) {
      log(event.name.toString());
  });
  
  ivsBroadcaster!.broadcastHealth.stream.listen((event) {
      log(event.name.toString());
  });
  

Methods for Player

• void startPlayer(String url, {required bool autoPlay, void Function(dynamic)? onData, void Function(dynamic)? onError});
  Start the player with a specified URL and auto-play setting.

• void resume();
  Resume playback.

• void pause();
  Pause playback.

• void muteUnmute();
  Toggle mute/unmute.

• void stopPlayer();
  Stop the player.

• Future<List<String>> getQualities();
  Get a list of available video qualities.

• Future<void> setQuality(String value);
  Set the video quality.

• Future<void> toggleAutoQuality();
  Toggle automatic quality adjustment.

• Future<bool> isAutoQuality();
  Check if automatic quality adjustment is enabled.

• Future<void> seekTo(Duration duration);
  Seek to a specific position in the video.

• Future<Duration> getPosition();
  Get the current playback position.

Listeners for Player

• StreamController<Duration> positionStream = StreamController.broadcast();
  Stream for the current playback position.

• StreamController<Duration> syncTimeStream = StreamController.broadcast();
  Stream for synchronization time.

• StreamController<Duration> durationStream = StreamController.broadcast();
  Stream for the video duration.

• StreamController<String> qualityStream = StreamController.broadcast();
  Stream for video quality changes.

• StreamController<PlayerState> playeStateStream = StreamController.broadcast();
  Stream for player state changes.

• StreamController<String> errorStream = StreamController.broadcast();
  Stream for error messages.

• StreamController<bool> isAutoQualityStream = StreamController.broadcast();
  Stream for automatic quality adjustment status.