1.1.5 • Published 6 months ago

@slogvo/react-universal-video v1.1.5

Weekly downloads
-
License
MIT
Repository
github
Last release
6 months ago

@slogvo/react-universal-video

@slogvo/react-universal-video is a React module that allows you to easily play videos from different sources such as HTML5, YouTube, and streaming services (like HLS). Simply provide a video URL, and the module will automatically select the appropriate player to play the video. You can also customize the player’s style as needed.

DEMO

Link demo: https://reaact-universal-app.vercel.app/

Installation

1. You can install it via npm, yarn or pnpm:

pnpm i @slogvo/react-universal-video@1.1.5
yarn add @slogvo/react-universal-video@1.1.5
npm add @slogvo/react-universal-video@1.1.5

2. Install required peer dependencies:

pnpm install react react-dom video.js videojs-contrib-quality-levels videojs-http-source-selector

3. You can import the Video.js CSS into your project wherever you need it. You have the flexibility to include it globally, or only in the specific components or pages where it is required. Here are a couple of options for doing so:

import "video.js/dist/video-js.css";

You can also check out more information at https://videojs.com/guides/react.

Usage

To use the video player, simply import the VideoPlayer component and pass the video URL as a prop.

Example:

import React from "react";
import VideoPlayer from "@slogvo/react-universal-video";

const App = () => {
  return (
    <div>
      // HTML5
      <VideoPlayer
        url="https://videos.pexels.com/video-files/5013307/5013307-hd_1920_1080_30fps.mp4"
        width="800"
        height="450"
      />
      // Yotube
      <VideoPlayer
        url="https://www.youtube.com/watch?v=oA91tf1Udr0"
        width="800"
        height="450"
      />
      // HLS
      <VideoPlayer
        url="https://live-hls-abr-cdn.livepush.io/live/bigbuckbunnyclip/index.m3u8"
        width="800"
        height="450"
      />
    </div>
  );
};

export default App;

VideoPlayer Component Props

PropDescriptionDefault
urlThe video URL to play. This can be a YouTube URL, MP4 file, or streaming URL.-
widthThe width of the player.100%
heightThe height of the player.400px
autoplayWhether the video should autoplay.false
controlsWhether to show video controls (play, pause, volume, etc.).true
classNameCustom CSS class for the player.-

Components

VideoPlayer

The main component of this module. It automatically selects the appropriate player (YouTube, HTML5, or streaming) based on the video URL you provide.

import VideoPlayer from "@slogvo/react-universal-video";

How It Works

The VideoPlayer component automatically determines the type of video based on the provided URL:

Customizing Styles

You can add custom CSS classes to the player using the className prop to style the player as needed.

Utility Functions

You can use utility functions from @slogvo/react-universal-video to interact with video URLs, such as extracting YouTube video IDs:

import { getYoutubeId } from "@slogvo/react-universal-video";

const youtubeId = getYoutubeId("https://www.youtube.com/watch?v=9cklv0qQ8Jw");
console.log(youtubeId); // Output: 9cklv0qQ8Jw

Contributing

If you'd like to contribute to @slogvo/react-universal-video, feel free to fork the repository and submit a pull request. We appreciate your contributions!