Resolution switcher for video.js 5
npm install videojs-resolution-switcherResolution switcher for video.js v5
Working examples of the plugin you can check out if you're having trouble. Or check out this demo.
Install plugin with
npm
```
npm i videojs-resolution-switcher
or bower
``
bower install videojs-resolution-switcher
`html`
`html
`
YouTube tech form https://github.com/eXon/videojs-youtube
`html
`
When using flash tech preload="auto" is required.
Sources can passed to player using updateSrc method or tag as shown above. Avalible options for each source are:String
* label - (required) is shown in menu (ex. 'SD' or '360p')Number
* res - is resolution of video used for sorting (ex. 360 or 1080)
You can pass options to plugin like this:
`javascript
videojs('video', {
controls: true,
muted: true,
width: 1000,
plugins: {
videoJsResolutionSwitcher: {
default: 'low'
}
}
}, function(){
// this is player
})
`{Number}|'low'|'high'$3
* default - - default resolution. If any Number is passed plugin will try to choose source based on res parameter. If low or high is passed, plugin will choose respectively worse or best resolution (if res parameter is specified). If res parameter is not specified plugin assumes that sources array is sorted from best to worse.{Boolean}
* dynamicLabel - - if true current label will be displayed in control bar. By default gear icon is displayed.{Function}
* customSourcePicker - - custom function for selecting source.
is not passed it acts like player.src()
`javascript// Update video sources
player.updateSrc([
{ type: "video/mp4", src: "http://www.example.com/path/to/video.mp4", label: 'SD' },
{ type: "video/mp4", src: "http://www.example.com/path/to/video.mp4", label: 'HD' },
{ type: "video/mp4", src: "http://www.example.com/path/to/video.mp4", label: '4k' }
])
`
#### PARAMETERS:
| name | type | required | description |
|:----:|:----:|:--------:|:-----------:|
| source| array| no | array of sources |$3
If used as getter returns current resolution object:
`javascript
{
label: 'SD', // current label
sources: [
{ type: "video/webm", src: "http://www.example.com/path/to/video.webm", label: 'SD' },
{ type: "video/mp4", src: "http://www.example.com/path/to/video.mp4", label: 'SD' }
] // array of sources with current label
}
`If used as setter returns video.js player object.
`javascript// Get current resolution
player.currentResolution(); // returns object {label '', sources: []}
// Set resolution
player.currentResolution('SD'); // returns videojs player object
`
#### PARAMETERS:
| name | type | required | description |
|:----:|:----:|:--------:|:-----------:|
| label| string| no | label name |
| customSourcePicker | function | no | cutom function to choose source |#### customSourcePicker
If there is more than one source with the same label, player will choose source automatically. This behavior can be changed if
customSourcePicker is passed.customSourcePicker must return player object.
`javascript
player.currentResolution('SD', function(_player, _sources, _label){
return _player.src(_sources[0]); \\ Always select first source in array
});
`
customSourcePicker accepst 3 arguments.| name | type | required | description |
|:----:|:----:|:--------:|:-----------:|
| player| Object | yes | videojs player object |
| sources | Array | no | array of sources |
| label | String | no | name of label |
customSourcePicker may be passed in options when player is initialized:
`javascriptvar myCustomSrcPicker = function(_p, _s, _l){
// select any source you want
return _p.src(selectedSource);
}
videojs('video', {
controls: true,
muted: true,
width: 1000,
plugins: {
videoJsResolutionSwitcher: {
default: 'low',
customSourcePicker: myCustomSrcPicker
}
}
}, function(){
// this is player
})
``> Fired when resolution is changed