react-native-video

What is react-native-video?

The react-native-video package is a versatile video playback library for React Native applications. It allows developers to embed and control video playback within their mobile apps, supporting a wide range of video formats and providing various customization options.

What are react-native-video's main functionalities?

Basic Video Playback

This feature allows you to play a video from a given URI. The video is embedded within a React Native component and can be styled using standard React Native styles.

import Video from 'react-native-video';

const BasicVideoPlayer = () => (
  <Video
    source={{ uri: 'https://www.example.com/video.mp4' }}
    style={{ width: 300, height: 200 }}
  />
);

Custom Controls

This feature enables the default video controls, such as play, pause, and seek, providing a more interactive video playback experience.

import Video from 'react-native-video';

const CustomControlsVideoPlayer = () => (
  <Video
    source={{ uri: 'https://www.example.com/video.mp4' }}
    style={{ width: 300, height: 200 }}
    controls={true}
  />
);

Event Handling

This feature allows you to handle various video playback events, such as when the video ends or if an error occurs during playback.

import Video from 'react-native-video';

const EventHandlingVideoPlayer = () => (
  <Video
    source={{ uri: 'https://www.example.com/video.mp4' }}
    style={{ width: 300, height: 200 }}
    onEnd={() => console.log('Video has ended')}
    onError={(error) => console.log('Error:', error)}
  />
);

Looping Video

This feature enables the video to loop continuously, restarting automatically when it reaches the end.

import Video from 'react-native-video';

const LoopingVideoPlayer = () => (
  <Video
    source={{ uri: 'https://www.example.com/video.mp4' }}
    style={{ width: 300, height: 200 }}
    repeat={true}
  />
);

Other packages similar to react-native-video

react-native-video-controls

The react-native-video-controls package provides a customizable set of video controls for the react-native-video component. It extends the functionality of react-native-video by adding a set of default controls that can be easily customized.

react-native-youtube

The react-native-youtube package allows you to embed YouTube videos in your React Native application. It provides a simple interface for playing YouTube videos and supports various YouTube player features, such as autoplay, fullscreen, and video quality settings.

react-native-vlc-media-player

The react-native-vlc-media-player package is a React Native wrapper for the VLC media player. It supports a wide range of video formats and provides advanced playback features, such as network streaming, subtitles, and hardware acceleration.

README

react-native-video

🎬 <Video> component for React Native

Documentation

documentation is available at thewidlarzgroup.github.io/react-native-video/

Usage

// Load the module

import Video, {VideoRef} from 'react-native-video';

// Within your render function, assuming you have a file called
// "background.mp4" in your project. You can include multiple videos
// on a single screen if you like.

const VideoPlayer = () => {
 const videoRef = useRef<VideoRef>(null);
 const background = require('./background.mp4');

 return (
   <Video 
    // Can be a URL or a local file.
    source={background}
    // Store reference  
    ref={videoRef}
    // Callback when remote video is buffering                                      
    onBuffer={onBuffer}
    // Callback when video cannot be loaded              
    onError={onError}               
    style={styles.backgroundVideo}
   />
 )
}

// Later on in your styles..
var styles = StyleSheet.create({
  backgroundVideo: {
    position: 'absolute',
    top: 0,
    left: 0,
    bottom: 0,
    right: 0,
  },
});

Community support

We have an discord server where you can ask questions and get help. Join the discord server

Enterprise Support

📱 react-native-video is provided as it is. For enterprise support or other business inquiries, please contact us 🤝. We can help you with the integration, customization and maintenance. We are providing both free and commercial support for this project. let's build something awesome together! 🚀

Changelog

6.7.0 (2024-10-17)

Bug Fixes

• android: sideloaded subtitles (#4232) (352dfbb)
• ensure aspect ratio from video is handled in a coherent way (#4219) (a8d5841)
• iOS: pause video on end reached & don't remove listeners (#4218) (2c19a47)
• remove warning and refactor & fix ad workflow (#4235) (7501880)

Features

• add setSource API function fix ads playback (#4185) (9a3fcda)
• android: add settings button to control video playback speed (#4211) (d1883a7)
• exoplayerview: Migrate ExoPlayerView to kotlin (#4038) (78f4f04)