ivs_broadcaster

Description:

ivs broadcaster

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 #


Add the following permissions to your AndroidManifest.xml file:
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
copied to clipboard


Initialize the broadcaster with your IVS channel URL and stream key:
String imgset = 'rtmp://<your channel url>';
String streamKey = '<your stream key>';
copied to clipboard


iOS Setup #


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>
copied to clipboard


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(),
...
copied to clipboard
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,
),
...
copied to clipboard
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());
});
copied to clipboard


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.