▶️ Watch example video

Installation

First you have to follow installation instructions of:

• react-native-reanimated v2
• react-native-gesture-handler v2
• expo-screen-orientation
• react-native-safe-area-context
• expo-av
• lottie-react-native no support web
  • react-native-web-lottie

1yarn add expo-reanimated-av-player

Example usage

1import VideoPlayer from 'expo-reanimated-av-player';
2import { useSharedValue } from 'react-native-reanimated';
3export const Example = () => {
4  const videoHeight = useSharedValue(0);
5  const isFullScreen = useSharedValue(false);
6
7  return (
8    <VideoPlayer
9      source={videoInfo.source}
10      headerBarTitle={`fullscreen title`}
11      onToggleAutoPlay={(state: boolean) => {
12        console.log(`onToggleAutoPlay state: ${state}`);
13      }}
14      videoDefaultHeight={VIDEO_DEFAULT_HEIGHT}
15      videoHeight={videoHeight}
16      resizeMode="cover"
17      isFullScreen={isFullScreen}
18      onTapBack={() => {
19        console.log('onTapBack');
20      }}
21      onTapMore={() => {
22        console.log('onTapMore');
23      }}
24    />
25  );
26};

Features

• 100% written in TypeScript.
• 100% built upon react-native-reanimated and react-native-gusture-handler.
• Support gestures switch full screen.
• Support double tap seek to back or ahead.
• ...

Configuration

The <VideoPlayer/> component has the following configuration properties:

Name	Type	Description	Required	Default Value
theme	object	The slider theme color	❌	{ // Color to fill the progress in the seekbar minimumTrackTintColor: string, // Color to fill the background in the seekbar maximumTrackTintColor: string, // Color to fill the cache in the seekbar cacheTrackTintColor: string, // Color to fill the bubble backgroundColor disableMinTrackTintColor: string, // Disabled color to fill the progress in the seekbar bubbleBackgroundColor: string }
showOnStart	boolean	control view init show	❌	false
onEnterFullscreen	function	on enter fullscreen callback	❌	undefined
onExitFullscreen	function	on exit fullscreen callback	❌	undefined
controlTimeout	nubmer	How long to hide the control view after showing	❌	2000
videoDefaultHeight	number	video default height	❌	screenWidth * (9 / 16)
headerBarTitle	string	header bar title on fullscreen mode	❌	undefined
onTapBack	function	tap header bar Icon-'Back' callback	❌	undefined
navigation	any	navigation	❌	undefined
autoPlay	boolean	auto play	❌	false
onToggleAutoPlay	function	on toggle auto play	❌	undefined
onTapMore	function	tap headerbar Icon-'More' callback	❌	undefined
doubleTapInterval	number	double tap interval	❌	undefined
paused	boolean	video paused	✅	undefined
onPausedChange	boolean	on change video paused	❌	undefined
onTapPause	function	on tap video paused	❌	undefined
sliderProps	object	react-native-awesome-slider props	❌	undefined
videoHeight	Animated.SharedValue	video height	✅	width * (9 / 16);
customAnimationStyle	Animated Viewstyle	video height	❌	width * (9 / 16);
onCustomPanGesture	PanGesture	custom pan gesture	❌	width * (9 / 16);
isFullScreen	Animated ShareValue	fullScreen status	✅	undefined
disableControl	boolean	control view status	❌	undefined
renderBackIcon	JSX	custom back icon	❌	undefined
renderFullScreenBackIcon	JSX	custom full's fullscreen icon	❌	undefined
renderMore	JSX	custom more icon	❌	undefined
renderFullScreen	JSX	custom fullscreen icon	❌	undefined