react-native-gstreamer

React native GStreamer is an audio/video player built for react-native using GStreamer framework. It handles everything GStreamer can natively handle. For more information, you can go here : https://gstreamer.freedesktop.org/

Features

• Plays anything a GStreamer playbin can play
• Hardware accelerated decoding for better performances and extended battery life
• Great with any kind of media, it was initially though for low latency streaming (RTSP)
• Working for both Android and IOS

Work left to do

• Volume control
• Add a default graphical control bar (You can create your own one using control methods if needed)
• Allow seeking in media (Nothing is done about this yet)
• Allow multichannel audio level inspection (only mono analysis yet)

Installation

npm install --save react-native-gstreamer

How to link to your project

/!\ Be sure to read everything carefully : GStreamer is a C Library. It will be necessary to finalize the linking manually.

• Linking for Android
• Linking for iOS

Basic usage

1import React, { Component } from 'react'
2import { StyleSheet, View, Button } from 'react-native'
3import GstPlayer, { GstState } from 'react-native-gstreamer'
4
5export default class App extends Component {
6
7    uri1 = "http://mirrors.standaloneinstaller.com/video-sample/jellyfish-25-mbps-hd-hevc.mp4"
8    uri2 = "http://mirrors.standaloneinstaller.com/video-sample/Panasonic_HDC_TM_700_P_50i.mp4"
9
10    constructor(props, context) {
11        super(props, context)
12        this.state = { uri: this.uri1 }
13    }
14
15    render() {
16        return (
17            <View style={styles.container}>
18                <GstPlayer
19                    style={styles.videoPlayer}
20                    uri={this.state.uri}
21                    ref="GstPlayer"
22                    autoPlay={true}
23                />
24                <View style={styles.controlBar}>
25                    <Button title="uri1" onPress={() => this.setState({ uri: this.uri1 })}></Button>
26                    <Button title="uri2" onPress={() => this.setState({ uri: this.uri2 })}></Button>
27                    <Button title="Stop" onPress={() => this.refs.GstPlayer.stop()}></Button>
28                    <Button title="Pause" onPress={() => this.refs.GstPlayer.pause()}></Button>
29                    <Button title="Play" onPress={() => this.refs.GstPlayer.play()}></Button>
30                </View>
31            </View>
32        )
33    }
34}
35
36const styles = StyleSheet.create({
37    container: { flex: 1 },
38    controlBar: {
39        flexDirection: "row",
40        justifyContent: "space-between"
41    },
42    videoPlayer: { flex: 1 }
43})

Available properties

Parameters

Parameter	Type	Default	Description
uri	String	undefined	Path to the desired media to play
autoPlay	Boolean	false	Will automatically start playing a media when the player is ready, or when you change a media uri
audioLevelRefreshRate	Integer	100	Defines the frequency of audio volume analysis in milliseconds. Helpful to design a vumeter
isDebugging	Boolean	false	When set to true, it will show a videotestsrc instead of a default playbin. Helpful to check if an issue is coming from playbin or not. Please note that for now, you need to restart the player in order to apply this change

Callbacks

Method	Description
onPlayerInit()	Called when the player is ready. Could be useful to display/hide a loading notification
onStateChanged(GstState old_state, GstState new_state)	Called when GStreamer engine is done switching state. You should use GstState enum import to switch on values
onVolumeChanged(Double rms, Double peak, Double decay)	Contains audio volume between 0 and 1. It is called as often as defined in audioLevelRefreshRate parameter
onUriChanged(String new_uri)	Called when GStreamer engine is done changing an uri. Helpful to display a loading notification
onEOS()	Called when a media stream is ended
onElementError(String source, String message, String debug_info)	Called when an internal component of GStreamer playbin's pipeline has met an error. It can be helpful to debug any media playing issue

Methods

Method	Description
setGstState(GstState state)	Call this if you want to call GStreamer states yourself. You should use GstState enum import to select a state
play()	Plays the current media (Alias for setGstState to GstState.PLAYING)
pause()	Pauses the current media (Alias for setGstState to GstState.PAUSED)
stop()	Stops the current media (Alias for setGstState to GstState.READY)