lion-plyr
    TypeScript icon, indicating that this package has built-in type declarations

    1.0.3 • Public • Published

    lion-plyr

    A simple Lion-themed HTML5, YouTube and Vimeo player (Plyr) for ReactJS

    NPM npm bundle size (scoped) npm bundle size (scoped version) Libraries.io dependency status for latest release, scoped npm package NPM

    Table of Contents

    Installation

    This library is available through the npm registry.

    NPM

    $ npm -i lion-plyr

    Yarn

    $ yarn add lion-plyr

    Setup

    Start using it by importing the library first.

    CommonJS

    const LionPlyr = require('lion-plyr');

    or

    ES6

    import { LionPlyr } from 'lion-plyr';

    The LionPlyr component requires the following CSS for styling:

    Using link tags

    <link href="https://unpkg.com/lion-plyr@1.0.0/dist/lion-skin.min.css" rel="stylesheet">

    Using import

    import 'lion-plyr/dist/lion-skin.min.css';

    Usage

    Video playback using Solid Plyr Player

    import { LionPlyr } from 'lion-plyr';
    
    const SOURCE = {
      type: 'video',
      sources: [
        {
          src: 'https://cdn.plyr.io/static/demo/View_From_A_Blue_Moon_Trailer-720p.mp4',
          type: 'video/mp4',
          size: 720,
        },
        {
          src: 'https://cdn.plyr.io/static/demo/View_From_A_Blue_Moon_Trailer-1080p.mp4',
          type: 'video/mp4',
          size: 1080,
        }
      ]
    }
    
    const OPTIONS = {
      autoplay: true,
      muted: true,
    }
    
    export default function Player() {
      return (
        <LionPlyr source={SOURCE} options={OPTIONS} />
      );
    }

    Uncontrolled Solid Plyr Player

    import { UncontrolledLionPlyr, usePlyr } from 'lion-plyr';
    import { useEffect } from 'react';
    
    const SOURCE = {
      // ...
    }
    
    const OPTIONS = {
      // ...
    }
    
    export default function Player() {
      const [ref, setRef] = usePlyr({ 
        source: SOURCE,
        options: OPTIONS,
      });
    
      useEffect(() => {
        const player = ref()?.plyr;
    
        if (player) {
          player.on('timeupdate', event => {
            // Log current time while playing the playback
            console.log(event.detail.plyr.currentTime);
          });
        }
      })
    
      return (
        <UncontrolledLionPlyr ref={setRef} />
      );
    }

    Play YouTube Videos using Solid Plyr

    import { LionPlyr } from 'lion-plyr';
    
    const SOURCE = {
      type: 'video',
      sources: [
        {
          src: 'yWtFb9LJs3o',
          provider: 'youtube'
        }
      ]
    }
    
    const OPTIONS = {
      // ...
    }
    
    export default function Player() {
      return (
        <LionPlyr source={SOURCE} options={OPTIONS} />
      );
    }

    Play Vimeo Videos using Solid Plyr

    import { LionPlyr } from 'lion-plyr';
    
    const SOURCE = {
      type: 'video',
      sources: [
        {
          src: 'https://vimeo.com/533559247',
          provider: 'vimeo'
        }
      ]
    }
    
    const OPTIONS = {
      // ...
    }
    
    export default function Player() {
      return (
        <LionPlyr source={SOURCE} options={OPTIONS} />
      );
    }

    Video Playback with HLS using Solid Plyr

    import { SolidHlsPlyr } from 'lion-plyr';
    
    const SOURCE = {
      type: 'video',
      sources: [
        {
          src:
            'https://bitmovin-a.akamaihd.net/content/playhouse-vr/m3u8s/105560.m3u8',
          type: 'application/x-mpegURL'
        }
      ]
    }
    
    const OPTIONS = {
      // ...
    }
    
    export default function Player() {
      return (
        <SolidHlsPlyr source={SOURCE} options={OPTIONS} />
      );
    }

    Uncontrolled Video Playback with HLS using Solid Plyr

    import { UncontrolledLionPlyr, useHlsPlyr } from 'lion-plyr';
    import { useEffect } from 'react';
    
    const SOURCE = {
      // ...
    }
    
    const OPTIONS = {
      // ...
    }
    
    export default function Player() {
      const [ref, setRef] = useHlsPlyr({ 
        source: SOURCE,
        options: OPTIONS,
      });
    
      useEffect(() => {
        const player = ref()?.plyr;
    
        if (player) {
          player.on('timeupdate', event => {
            // Log current time while playing the playback
            console.log(event.detail.plyr.currentTime);
          });
        }
      })
    
      return (
        <UncontrolledLionPlyr ref={setRef} />
      );
    }

    Video Playback with Dash using Solid Plyr

    import { SolidDashPlyr } from 'lion-plyr';
    
    const SOURCE = {
      type: 'video',
      sources: [
        {
          src: 'https://bitmovin-a.akamaihd.net/content/MI201109210084_1/mpds/f08e80da-bf1d-4e3d-8899-f0f6155f6efa.mpd',
          type: 'application/dash+xml',
        }
      ]
    }
    
    const OPTIONS = {
      // ...
    }
    
    export default function Player() {
      return (
        <SolidDashPlyr source={SOURCE} options={OPTIONS} />
      );
    }

    Uncontrolled Video Playback with Dash using Solid Plyr

    import { UncontrolledLionPlyr, useDashPlyr } from 'lion-plyr';
    import { useEffect } from 'react';
    
    const SOURCE = {
      // ...
    }
    
    const OPTIONS = {
      // ...
    }
    
    export default function Player() {
      const [ref, setRef] = useDashPlyr({ 
        source: SOURCE,
        options: OPTIONS,
      });
    
      useEffect(() => {
        const player = ref()?.plyr;
    
        if (player) {
          player.on('timeupdate', event => {
            // Log current time while playing the playback
            console.log(event.detail.plyr.currentTime);
          });
        }
      })
    
      return (
        <UncontrolledLionPlyr ref={setRef} />
      );
    }

    Authors

    See also the list of contributors who participated in this project.

    Changelog

    Changelog

    License

    MIT

    Install

    npm i lion-plyr

    DownloadsWeekly Downloads

    28

    Version

    1.0.3

    License

    MIT

    Unpacked Size

    167 kB

    Total Files

    41

    Last publish

    Collaborators

    • princedev