egroupware/api/js/etemplate/et2_widget_video.ts

697 lines
19 KiB
TypeScript

/**
* EGroupware eTemplate2 - JS Description object
*
* @license http://opensource.org/licenses/gpl-license.php GPL - GNU General Public License
* @package etemplate
* @subpackage api
* @link http://www.egroupware.org
* @author Hadi Nategh <hn[at]stylite.de>
* @copyright Stylite AG
* @version $Id$
*/
/*egw:uses
/vendor/bower-asset/jquery/dist/jquery.js;
et2_core_interfaces;
et2_core_baseWidget;
/api/js/etemplate/CustomHtmlElements/multi-video.js;
/api/js/etemplate/CustomHtmlElements/pdf-player.js;
*/
import { et2_baseWidget } from './et2_core_baseWidget'
import {ClassWithAttributes} from "./et2_core_inheritance";
import {WidgetConfig, et2_register_widget} from "./et2_core_widget";
/**
* This widget represents the HTML5 video tag with all its optional attributes
*
* The widget can be created in the following ways:
* <code>
* var videoTag = et2_createWidget("video", {
* video_src: "../../test.mp4",
* src_type: "video/mp4",
* muted: true,
* autoplay: true,
* controls: true,
* poster: "../../poster.jpg",
* loop: true,
* height: 100,
* width: 200,
* });
* </code>
* Or by adding XET-tag in your template (.xet) file:
* <code>
* <video [attributes...]/>
* </code>
*/
/**
* Class which implements the "video" XET-Tag
*
* @augments et2_baseWidget
*/
export class et2_video extends et2_baseWidget implements et2_IDOMNode
{
static readonly _attributes: any = {
"video_src": {
"name": "Video",
"type": "string",
"description": "Source of video to display"
},
"src_type": {
"name": "Source type",
"type": "string",
"description": "Defines the type the stream source provided"
},
"multi_src": {
"name": "Multi Video source",
"type": "boolean",
"default": false,
"description": "creates a multi-video tag in order to render all provided video sources"
},
"muted": {
"name": "Audio control",
"type": "boolean",
"default": false,
"description": "Defines that the audio output of the video should be muted"
},
"autoplay": {
"name": "Autoplay",
"type": "boolean",
"default": false,
"description": "Defines if Video will start playing as soon as it is ready"
},
starttime: {
"name": "Inital position of video",
"type": "float",
"default": 0,
"description": "Set initial position of video"
},
"controls": {
"name": "Control buttons",
"type": "boolean",
"default": false,
"description": "Defines if Video controls, play/pause buttons should be displayed"
},
"poster": {
"name": "Video Poster",
"type": "string",
"default": "",
"description": "Specifies an image to be shown while video is loading or before user play it"
},
"loop": {
"name": "Video loop",
"type": "boolean",
"default": false,
"description": "Defines if the video should be played repeatedly"
},
"volume": {
"name": "Video volume",
"type": "float",
"default": 0,
"description": "Set video's volume"
},
"playbackrate": {
"name": "Video playBackRate",
"type": "float",
"default": 1,
"description": "Set video's playBackRate"
}
};
video: JQuery<HTMLVideoElement|HTMLIFrameElement|HTMLElement> = null;
youtube: any;
private static youtube_player_states = {
unstarted: -1,
ended: 0,
playing: 1,
paused: 2,
buffering: 3,
video_cued: 5
};
/**
* keeps internal state of previousTime video played
* @private
*/
private _previousTime: number = 0;
/**
* keeps the currentTime
* @private
*/
private _currentTime : number;
/**
* interval defined for youtube type to simulate ontimeupdate html5 event
* @private
*/
private _youtubeOntimeUpdateIntrv : number;
/**
* youtube iframe api will replace it with iframe
* @protected
*/
protected youtubeFrame : JQuery;
/**
* prefix id used for addressing youtube player dom
* @private
*/
private static youtubePrefixId : string = "frame-";
private static youtubeRegexp: RegExp = new RegExp(/^https:\/\/((www\.|m\.)?youtube(-nocookie)?\.com|youtu\.be)\/.*(?:\/|%3D|v=|vi=)([0-9A-z-_]{11})(?:[%#?&]|$)/m);
constructor(_parent, _attrs? : WidgetConfig, _child? : object)
{
super(_parent, _attrs, ClassWithAttributes.extendAttributes(et2_video._attributes, _child || {}));
this.set_src_type(this.options.src_type);
this.options.starttime = isNaN(this.options.starttime) ? 0 : this.options.starttime;
}
set_src_type(_type)
{
this.options.src_type = _type;
if (this.video && this._isYoutube() === (this.video[0].tagName === 'DIV'))
{
return;
}
//Create Video tag
this.video = jQuery(document.createElement(this._isYoutube() ? "div" :
(_type.match('pdf') ? "pdf-player" : (this.options.multi_src ? 'multi-video' : 'video' ))))
.addClass('et2_video')
.attr('id', this.dom_id);
if (this._isYoutube())
{
// this div will be replaced by youtube iframe api when youtube gets ready
this.youtubeFrame = jQuery(document.createElement('div'))
.appendTo(this.video)
.attr('id', et2_video.youtubePrefixId+this.id);
if (!document.getElementById('youtube-api-script'))
{
//Load youtube iframe api
let tag = document.createElement('script');
tag.id = 'youtube-api-script';
tag.src = "https://www.youtube.com/iframe_api";
let firstScriptTag = document.getElementsByTagName('script')[0];
firstScriptTag.parentNode.insertBefore(tag, firstScriptTag);
}
}
if (!this._isYoutube() && this.options.controls)
{
this.video.attr("controls", 1);
}
if (!this._isYoutube() && this.options.autoplay)
{
this.video.attr("autoplay", 1);
}
if (this.options.muted)
{
this.video.attr("muted", 1);
}
if (this.options.video_src)
{
this.set_src(this.options.video_src);
}
if (this.options.loop)
{
this.video.attr("loop", 1);
}
this.setDOMNode(this.video[0]);
this.set_width(this.options.width || 'auto');
this.set_height(this.options.height || 'auto');
}
/**
* Set video src
*
* @param {string} _value url
*/
set_src(_value: string) {
let self = this;
this.options.video_src = _value;
if (_value && !this._isYoutube())
{
this.video.attr('src',_value);
if (this.options.src_type)
{
this.video.attr('type', this.options.src_type);
}
}
else if(_value)
{
if (typeof YT == 'undefined')
{
//initiate youtube Api object, it gets called automatically by iframe_api script from the api
window.onYouTubeIframeAPIReady = this._onYoutubeIframeAPIReady;
window.addEventListener('et2_video.onYoutubeIframeAPIReady', function(){
self._createYoutubePlayer(self.options.video_src);
});
}
else
{
self._createYoutubePlayer(self.options.video_src);
}
}
}
/**
* Set autoplay option for video
* -If autoplay is set, video would be played automatically after the page is loaded
*
* @param {string} _value true set the autoplay and false not to set
*/
set_autoplay(_value: string)
{
if (_value && !this._isYoutube())
{
this.video.attr("autoplay", _value);
}
}
/**
* Set controls option for video
*
* @param {string} _value true set the autoplay and false not to set
*/
set_controls(_value: string)
{
if (_value && !this._isYoutube())
{
this.video.attr("controls", _value);
}
}
/**
* Method to set volume
* @param _value
*/
set_volume(_value: number)
{
let value = _value>100?100:_value;
if (value>= 0)
{
if (this._isYoutube() && this.youtube && typeof this.youtube.setVolume === 'function')
{
this.youtube.setVolume(value);
}
else if(!this._isYoutube())
{
this.video[0].volume = value/100;
}
}
}
/**
* get volume
*/
get_volume()
{
if (this._isYoutube() && this.youtube)
{
return this.youtube.getVolume();
}
else
{
return this.video[0].volume * 100;
}
}
/**
* method to set playBackRate
* @param _value
*/
set_playBackRate(_value: number)
{
let value = _value>16?16:_value;
if (value>= 0)
{
if (this._isYoutube() && this.youtube)
{
this.youtube.setPlaybackRate(value);
}
else
{
this.video[0].playbackRate = value;
}
}
}
/**
* get playBackRate
*/
get_playBackRate()
{
if (this._isYoutube() && this.youtube)
{
return this.youtube.getPlaybackRate();
}
else
{
return this.video[0].playbackRate;
}
}
set_mute(_value)
{
if (this._isYoutube() && this.youtube) {
if (_value)
{
this.youtube.mute();
}
else
{
this.youtube.unMute();
}
}
else
{
this.video[0].muted = _value;
}
}
get_mute()
{
if (this._isYoutube() && this.youtube)
{
return this.youtube.isMuted();
}
else
{
return this.video[0].muted;
}
}
/**
* Set poster attribute in order to specify
* an image to be shown while video is loading or before user play it
*
* @param {string} _url url or image spec like "api/mime128_video"
*/
set_poster(_url: string)
{
if (_url)
{
if (_url[0] !== '/' && !_url.match(/^https?:\/\//))
{
_url = this.egw().image(_url);
}
this.video.attr("poster", _url);
}
}
/**
* Seek to a time / position
*
* @param _vtime in seconds
*/
public seek_video(_vtime : number)
{
if (this._isYoutube())
{
if (this.youtube.seekTo)
{
this.youtube.seekTo(_vtime, true);
this._currentTime = _vtime;
}
}
else
{
(<HTMLVideoElement>this.video[0]).currentTime = _vtime;
}
}
/**
* Play video
*/
public play_video() : Promise<void>
{
if (this._isYoutube())
{
let self = this;
return new Promise<void>(function(resolve){
if (self.youtube.playVideo)
{
self.youtube.playVideo();
resolve();
}
});
}
return (<HTMLVideoElement>this.video[0]).play();
}
/**
* Pause video
*/
public pause_video()
{
if (this._isYoutube())
{
if (this.youtube.pauseVideo)
{
this.youtube.pauseVideo();
if (this.youtube.getCurrentTime() != this._currentTime)
{
// give it a chance to get actual current time ready otherwise we would still get the previous time
// unfortunately we need to rely on a timeout as the youtube seekTo not returning any promise to wait for.
setTimeout(_=>{this.currentTime(this.youtube.getCurrentTime());},500);
}
else
{
this.currentTime(this.youtube.getCurrentTime());
}
}
}
else
{
(<HTMLVideoElement>this.video[0]).pause();
}
}
/**
* play video
* ***Internal use and should not be overriden in its extended class***
*/
public play() : Promise<void>
{
return this._isYoutube() && this.youtube?.playVideo ?this.youtube.playVideo():(<HTMLVideoElement>this.video[0]).play();
}
/**
* Get/set current video time / position in seconds
* @return returns currentTime
*/
public currentTime(_time?) : number
{
if (_time)
{
if (this._isYoutube())
{
this.youtube.seekTo(_time);
}
else
{
(<HTMLVideoElement>this.video[0]).currentTime = _time;
}
return this._currentTime = _time;
}
if (this._isYoutube())
{
if (typeof this._currentTime != 'undefined')
{
return this._currentTime;
}
return this.youtube?.getCurrentTime ? this.youtube.getCurrentTime() : 0;
}
else
{
return (<HTMLVideoElement>this.video[0]).currentTime;
}
}
/**
* get duration time
* @return returns duration time
*/
public duration() : number
{
if (this._isYoutube())
{
return this.youtube?.getDuration ? this.youtube.getDuration() : 0;
}
else
{
return (<HTMLVideoElement>this.video[0]).duration;
}
}
/**
* get pasued
* @return returns paused flag
*/
public paused() : boolean
{
if (this._isYoutube())
{
return this.youtube.getPlayerState() == et2_video.youtube_player_states.paused;
}
return (<HTMLVideoElement>this.video[0]).paused;
}
/**
* get ended
* @return returns ended flag
*/
public ended() : boolean
{
if (this._isYoutube())
{
return this.youtube.getPlayerState() == et2_video.youtube_player_states.ended;
}
return (<HTMLVideoElement>this.video[0]).ended;
}
/**
* get/set priviousTime
* @param _time
* @return returns time
*/
public previousTime(_time?) : number
{
if (_time) this._previousTime = _time;
return this._previousTime;
}
doLoadingFinished(): boolean
{
super.doLoadingFinished();
let self = this;
if (!this._isYoutube())
{
this.video[0].addEventListener("loadedmetadata", function(){
self._onReady();
});
this.video[0].addEventListener("timeupdate", function(){
self._onTimeUpdate();
});
}
else
{
// need to create the player after the DOM is ready otherwise player won't show up
if (window.YT) this._createYoutubePlayer(this.options.video_src);
}
return false;
}
public videoLoadnigIsFinished()
{
if (this.options.starttime >= 0)
{
this.seek_video(this.options.starttime);
// unfortunately, youtube api autoplays the video after seekTo on initiation
// and there's no way to stop that therefore we need to trick it by manually
// pausing the video (this would bring up the spinner with the black screen,
// in order to avoid that we let the video plays for a second then we pause).
// since the youtube timeline is one second advanced we need to seek back to
// the original stattime although this time because it was manually paused
// we won't have the spinner and black screen instead we get the preview.
if (this._isYoutube()) window.setTimeout(function(){
this.youtube.pauseVideo();
this.youtube.seekTo(this.options.starttime);
;}.bind(this), 1000);
}
}
private _onReady()
{
// need to set the video dom to transformed iframe
if (this._isYoutube() && this.youtube.getIframe) this.youtubeFrame = jQuery(this.youtube.getIframe());
let event = document.createEvent("Event");
event.initEvent('et2_video.onReady.'+this.id, true, true);
this.video[0].dispatchEvent(event);
}
private _onTimeUpdate()
{
// update currentTime manually since youtube currentTime might be updated due to the loading
if (this._isYoutube() && this.youtube.getCurrentTime) this._currentTime = this.youtube.getCurrentTime();
let event = document.createEvent("Event");
event.initEvent('et2_video.onTimeUpdate.'+this.id, true, true);
this.video[0].dispatchEvent(event);
}
/**
* check if the video is a youtube type
* @return return true if it's a youtube type video
* @private
*/
private _isYoutube() : boolean
{
return !!this.options.src_type.match('youtube');
}
private _onStateChangeYoutube(_data)
{
switch (_data.data)
{
case et2_video.youtube_player_states.unstarted:
// do nothing
break;
case et2_video.youtube_player_states.playing:
this._youtubeOntimeUpdateIntrv = window.setInterval(jQuery.proxy(this._onTimeUpdate, this), 100);
break;
default:
window.clearInterval(this._youtubeOntimeUpdateIntrv);
}
console.log(_data)
}
/**
* youtube on IframeAPI ready event
*/
private _onYoutubeIframeAPIReady()
{
let event = document.createEvent("Event");
event.initEvent('et2_video.onYoutubeIframeAPIReady', true, true);
window.dispatchEvent(event);
}
/**
* create youtube player
*
* @param _value
*/
private _createYoutubePlayer(_value:string)
{
const matches = _value?.match(et2_video.youtubeRegexp);
if (matches && typeof YT != 'undefined')
{
this.youtube = new YT.Player( et2_video.youtubePrefixId+this.id, {
height: this.options.height || '400',
width: '100%',
playerVars: {
'autoplay': 0,
'controls': 0,
'modestbranding': 1,
'fs':0,
'disablekb': 1,
'rel': 0,
'iv_load_policy': 0,
'cc_load_policy': 0
},
videoId: matches[4],
events: {
'onReady': jQuery.proxy(this._onReady, this),
'onStateChange': jQuery.proxy(this._onStateChangeYoutube, this)
}
});
}
}
}
et2_register_widget(et2_video, ["video"]);