Skip to content

aminimalanimal/cloudinary-video-player

 
 

Repository files navigation

cloudinary-video-player

The Cloudinary Video Player is a JavaScript-based HTML5 video player bundled with many valuable customization and integration capabilities, and is monetization and analytics-ready. The player is fully responsive for use in any device or screen size, and is integrated with Cloudinary's video delivery and manipulation solution.

This README includes basic information for installation and getting started. View the documentation for comprehensive guidance on integration and all the available features.

Installation

NPM

  1. Install the files using:

    npm install lodash cloudinary-core cloudinary-video-player
  2. Include the javascript file in your HTML. For Example:

    <link href="node_modules/cloudinary-video-player/dist/cld-video-player.min.css" rel="stylesheet">
    
    <script src="node_modules/lodash/lodash.js" type="text/javascript"></script>
    <script src="node_modules/cloudinary-core/cloudinary-core.js" type="text/javascript"></script>
    <script src="node_modules/cloudinary-video-player/dist/cld-video-player.min.js" type="text/javascript"></script>

CDN

Cloudinary Video Player can also be included directly from the Unpkg CDN:

<link href="https://unpkg.com/cloudinary-video-player/dist/cld-video-player.min.css" rel="stylesheet">

<script src="https://unpkg.com/cloudinary-core/cloudinary-core-shrinkwrap.min.js" type="text/javascript"></script>
<script src="https://unpkg.com/cloudinary-video-player/dist/cld-video-player.min.js" type="text/javascript"></script>

Packages

The Cloudinary video player offers standard and light package variations, available in either minified or non-minified formats.

  • Standard package: Includes all functionality described in this video player documentation.
  • Light package: Excludes the following optional functionality: Adaptive bitrate streaming (HLS and MPEG-DASH), Video ads, Shoppable videos (alpha)
  • cld-video-player.js - Non minified version which includes all optional modules.
  • cld-video-player.min.js - Minified version which includes all optional modules.
  • cld-video-player.light.js - Non minified version which does not include any optional modules.
  • cld-video-player.light.min.js - Minified version which does not include any optional modules. (for smaller bundle size)

Cloudinary JavaScript library

The Core Cloudinary JavaScript library provides several classes, defined under the "cloudinary" domain. The reference documentation is located at https://cloudinary.github.io/pkg-cloudinary-core

Getting started

Create a video tag containing cld-video-player class and a supported skin class:

<video
  id="example-player"
  controls
  autoplay
  data-cld-public-id="dog"
  class="cld-video-player cld-video-player-skin-dark">
</video>

Instantiate a new cloudinary.Cloudinary instance containing your cloudinary configuration:

var cld = cloudinary.Cloudinary.new({ cloud_name: "demo"});

Instantiate a new cloudinary Video Player:

cld.videoPlayer('example-player')

Documentation

Development

In order to run this project locally:

  1. Install yarn
  2. Clone this repository
  3. yarn install
  4. yarn start

About

Cloudinary Video Player

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 86.4%
  • CSS 13.5%
  • TypeScript 0.1%