A set of GUI controls for the react-native-video component
npm install react-native-video-controls[![ci][1]][2]
Controls for the React Native component at react-native-video. For support with RN 0.45 or lower use version 1.3.1 or lower.
This package contains a simple set of GUI controls that work with the react-native-video component. This includes a back button, volume bar, fullscreen toggle, play/pause toggle, seekbar, title, error handling and timer toggle that can switch between time remaining and current time when tapped.
By default the
By default, tapping the screen anywhere will show the player controls. After 10s the controls disappear. Double tapping will toggle fullscreen.
Run npm install --save react-native-video react-native-video-controls
Then run react-native link react-native-video
If you're using RN < 39 run npm install --save react-native-video-controls@1.0.1. Note this version includes react-native-video as a normal dependency instead of a peer-dependency.
The component at react-native-video. It also takes a number of additional props which are outlined in the API section.
For basic operation the
``javascript
// At the top where our imports are...
import VideoPlayer from 'react-native-video-controls';
// in the component's render() function
navigator={this.props.navigator}
/>;
`
To play a local file, use require syntax like so:
`js`
The component can take a number of inputs to customize it as needed. They are outlined below:
You can pass any of the props that the component at react-native-video takes. Simply add them onto the and it will pass them through to the component.
In addition, the also takes these props:
| Prop | Type | Default | Description |
| ---------------------------- | ------------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| toggleResizeModeOnFullscreen | Boolean | true | If true, clicking the fullscreen button will toggle the component between cover/contain, set to false if you want to customize fullscreen behaviour |
| controlAnimationTiming | Integer | 500 | The amountof time (in milliseconds) to animate the controls in and out. |
| doubleTapTime | Integer | 130 | Tapping twice within this amount of time in milliseconds is considered a double tap. Single taps will not be actioned until this time has expired. |
| controlTimeout | Integer | 15000 | Hide controls after X amount of time in milliseconds |
| scrubbing | Integer | 0 | If > 0, enable live scrubbing when moving the seek bar. The provided value is the minimum time step of the scrubbing in milliseconds. |
| showOnStart | Boolean | true | Show or hide the controls on first render |
| videoStyle | StyleSheet | null | React Native StyleSheet object that is appended to the
These are various events that you can hook into and fire functions on in the component:
| Callback | Description |
| ----------------- | ------------------------------------------------------------------------------- |
| onEnterFullscreen | Fired when the video enters fullscreen after the fullscreen button is pressed |
| onExitFullscreen | Fired when the video exits fullscreen after the fullscreen button is pressed |
| onHideControls | Fired when the controls disappear |
| onShowControls | Fired when the controls appear |
| onError | Fired when an error is encountered when loading the video |
| onPause | Fired when the video is paused after the play/pause button is pressed |
| onPlay | Fired when the video begins playing after the play/pause button is pressed |
| onBack | Function fired when back button is pressed, override if using custom navigation |
| onEnd | Fired when the video is complete |
These are the various controls that you can turn on/off as needed. All of these props default to false, override them to disable any controls
| Control | Description |
| ----------------- | -------------------------- |
| disableFullscreen | Hide the fullscreen button |
| disablePlayPause | Hide the play/pause toggle |
| disableSeekbar | Hide the seekbar |
| disableVolume | Hide the Volume control |
| disableTimer | Hide the timer |
| disableBack | Hide the back button |
[1]: https://github.com/itsnubix/react-native-video-controls/workflows/ci/badge.svg
[2]: https://github.com/itsnubix/react-native-video-controls/actions