@kissmybutton/motorcortex-youtube
v1.2.0
Published
Your plugin description here
Downloads
5
Keywords
Readme
MotorCortex-Youtube
Table of Contents
- MotorCortex-Youtube
- Intro / Features
- Getting Started
- Creating Incidents
- Adding Incidents in your clip
- Contributing
- License
- Sponsored by
Demo
Intro / Features
Using MotorCortex-Youtube you can easily add a youtube video in your clip.
The Plugin exposes two Incidents in total:
- the video Clip
- the Playback incident
Getting Started
Installation
$ npm install --save @kissmybutton/motorcortex-youtube
# OR
$ yarn add @kissmybutton/motorcortex-youtube
Importing and loading
import { loadPlugin } from "@kissmybutton/motorcortex";
import MCVideo from "@kissmybutton/motorcortex-youtube";
const VideoPlugin = loadPlugin(MCVideo);
Creating Incidents
Clip
The Clip is used to create a new video clip and you can pass to it all of the core video information such as the video id from youtube and the size:
const VideoClip = new VideoPlugin.Clip(
{
startFrom: 5000,
width: 1280,
height: 720,
videoId: "RUpDslHSLbU",
volume: 0.3,
},
{
selector: "#video-container",
id: "videoClip",
}
);
Clip Attrs
As shown on the example the supported attributes that the "Clip" Incident accepts are:
- videoId: an string id from the viedeo that you would like to use from utube
- width: (optional). The desired width of the video in pixels. You only need to define it by an integer
- height (optional). The desired height of the video in pixels. You only need to define it by an integer
- startFrom (optional / defaluts to 0). If passed the video will be loaded directly with start on the specified millisecond
Playback
The Playback Incident is used to define the execution of the video. The only thing to set is the duration.
const Playback = new VideoPlugin.Playback({
selector: "!#video", // that's mandatory, it should always have the value "!#video" and it targets the video of the VideoPlugin.Clip
duration: 20000, // the duration of the playback in milliseconds
});
IMPORTANT
All Playback Incidents
should have as a selector
: !#video
Adding Incidents in your clip
clipName.addIncident(incidentName,startTime);
Contributing
In general, we follow the "fork-and-pull" Git workflow, so if you want to submit patches and additions you should follow the next steps:
- Fork the repo on GitHub
- Clone the project to your own machine
- Commit changes to your own branch
- Push your work back up to your fork
- Submit a Pull request so that we can review your changes