react-player

A react component for playing media from YouTube, SoundCloud or Vimeo.

Usage

npm install react-player --save

import React, { Component } from 'react'
import ReactPlayer from 'react-player'

class App extends Component {
  render () {
    <ReactPlayer
      url='https://www.youtube.com/watch?v=ysz5S6PUM-U'
      playing={true}
      volume={0.8}
    />
  }
}

See App.js for a full example

Demo

The quickest way to see it in action is to checkout the repo and run the demo:

git clone http://github.com/cookpete/react-player
cd react-player
npm install
npm start
open http://localhost:3000

Props

Prop	Description
url	The url of a video or song to play
playing	Set to true or false to pause or play the media
volume	Sets the volume of the appropriate player
onProgress	Callback containing played and loaded progress as a fraction eg { played: 0.12, loaded: 0.34 }
onPlay	Called when media starts or resumes playing after pausing or buffering
onPause	Called when media is paused
onBuffer	Called when media starts buffering
onEnded	Called when media finishes playing
onError	Called when an error occurs whilst attempting to play media

Methods

There is a static method ReactPlayer.canPlay(url) to determine if a URL can be played by the media player. Note that this does not detect media that is unplayable due to streaming permissions etc. In that case, onError will occur after attemping to play.

To seek to a certain part of the media, there is a seekTo(fraction) instance method that will seek to the appropriate place in the media. See App.js for an example of this using refs.

Linting

This project uses standard code style.

npm run lint

Thanks

• Big thanks to gaearon for his react-hot-boilerplate, which this repo is roughly based on.