<?php
// This file is part of Moodle - http://moodle.org/
//
// Moodle is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// Moodle is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Moodle. If not, see <http://www.gnu.org/licenses/>.
/**
* Main class for plugin 'media_videojs'
*
* @package media_videojs
* @copyright 2016 Marina Glancy
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
defined('MOODLE_INTERNAL') || die();
/**
* Player that creates HTML5 <video> tag.
*
* @package media_videojs
* @copyright 2016 Marina Glancy
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
class media_videojs_plugin extends core_media_player_native {
/** @var array caches last moodle_page used to include AMD modules */
protected $loadedonpage = [];
/** @var string language file to use */
protected $language = 'en';
/** @var array caches supported extensions */
protected $extensions = null;
/** @var bool is this a youtube link */
protected $youtube = false;
/** @var bool Need to use Ogv.JS Tech plugin or not. */
protected $ogvtech = false;
/** @var array Ogv.JS supported extensions */
protected $ogvsupportedextensions = [
'.ogv',
'.webm',
'.oga',
'.ogg'
];
/**
* Generates code required to embed the player.
*
* @param moodle_url[] $urls
* @param string $name
* @param int $width
* @param int $height
* @param array $options
* @return string
*/
public function embed($urls, $name, $width, $height, $options) {
global $CFG;
require_once($CFG->libdir . '/filelib.php');
$sources = array();
$mediamanager = core_media_manager::instance();
$datasetup = [];
$text = null;
$isaudio = null;
$hastracks = false;
$hasposter = false;
if (array_key_exists(core_media_manager::OPTION_ORIGINAL_TEXT, $options) &&
preg_match('/^<(video|audio)\b/i', $options[core_media_manager::OPTION_ORIGINAL_TEXT], $matches)) {
// Original text already had media tag - get some data from it.
$text = $options[core_media_manager::OPTION_ORIGINAL_TEXT];
$isaudio = strtolower($matches[1]) === 'audio';
$hastracks = preg_match('/<track\b/i', $text);
$hasposter = self::get_attribute($text, 'poster') !== null;
}
// Try to guess if HTML5 player will be engaged for the user and then set it to responsive.
$responsive = (!$this->youtube) ? null : true;
// Build list of source tags.
foreach ($urls as $url) {
$extension = $mediamanager->get_extension($url);
$mimetype = $mediamanager->get_mimetype($url);
if ($mimetype === 'video/quicktime' && (core_useragent::is_chrome() || core_useragent::is_edge())) {
// Fix for VideoJS/Chrome bug https://github.com/videojs/video.js/issues/423 .
$mimetype = 'video/mp4';
}
// If this is RTMP stream, adjust mimetype to those VideoJS suggests to use (either flash or mp4).
if ($url->get_scheme() === 'rtmp') {
if ($mimetype === 'video/x-flv') {
$mimetype = 'rtmp/flv';
} else {
$mimetype = 'rtmp/mp4';
}
}
$source = html_writer::empty_tag('source', array('src' => $url, 'type' => $mimetype));
$sources[] = $source;
if ($isaudio === null) {
$isaudio = in_array('.' . $extension, file_get_typegroup('extension', 'audio'));
}
if ($responsive === null) {
$responsive = core_useragent::supports_html5($extension);
}
}
$sources = implode("\n", $sources);
// Find the title, prevent double escaping.
$title = $this->get_name($name, $urls);
$title = preg_replace(['/&/', '/>/', '/</'], ['&', '>', '<'], $title);
if ($this->youtube) {
$datasetup[] = '"techOrder": ["youtube"]';
$datasetup[] = '"sources": [{"type": "video/youtube", "src":"' . $urls[0] . '"}]';
// Check if we have a time parameter.
if ($time = $urls[0]->get_param('t')) {
$datasetup[] = '"youtube": {"start": "' . self::get_start_time($time) . '"}';
}
$sources = ''; // Do not specify <source> tags - it may confuse browser.
$isaudio = false; // Just in case.
}
if ($this->ogvtech) {
$datasetup[] = '"techOrder": ["OgvJS"]';
}
// Add a language.
if ($this->language) {
$datasetup[] = '"language": "' . $this->language . '"';
}
// Set responsive option.
if ($responsive) {
$datasetup[] = '"fluid": true';
}
if ($isaudio && !$hastracks) {
// We don't need a full screen toggle for the audios (except when tracks are present).
$datasetup[] = '"controlBar": {"fullscreenToggle": false}';
}
if ($isaudio && !$height && !$hastracks && !$hasposter) {
// Hide poster area for audios without tracks or poster.
// See discussion on https://github.com/videojs/video.js/issues/2777 .
// Maybe TODO: if there are only chapter tracks we still don't need poster area.
$datasetup[] = '"aspectRatio": "1:0"';
}
// Additional setup for playback rate and user actions.
$datasetup[] = '"playbackRates": [0.5, 0.75, 1, 1.25, 1.5, 1.75, 2]';
$datasetup[] = '"userActions": {"hotkeys": true}';
// Attributes for the video/audio tag.
// We use data-setup-lazy as the attribute name for the config instead of
// data-setup because data-setup will cause video.js to load the player as soon as the library is loaded,
// which is BEFORE we have a chance to load any additional libraries (youtube).
// The data-setup-lazy is just a tag name that video.js does not recognise so we can manually initialise
// it when we are sure the dependencies are loaded.
static $playercounter = 1;
$attributes = [
'data-setup-lazy' => '{' . join(', ', $datasetup) . '}',
'id' => 'id_videojs_' . uniqid() . '_' . $playercounter++,
'class' => get_config('media_videojs', $isaudio ? 'audiocssclass' : 'videocssclass')
];
if (!$responsive) {
// Note we ignore limitsize setting if not responsive.
parent::pick_video_size($width, $height);
$attributes += ['width' => $width] + ($height ? ['height' => $height] : []);
}
if (core_useragent::is_ios(10)) {
// Hides native controls and plays videos inline instead of fullscreen,
// see https://github.com/videojs/video.js/issues/3761 and
// https://github.com/videojs/video.js/issues/3762 .
// iPhone with iOS 9 still displays double controls and plays fullscreen.
// iPhone with iOS before 9 display only native controls.
$attributes += ['playsinline' => 'true'];
}
if ($text !== null) {
// Original text already had media tag - add necessary attributes and replace sources
// with the supported URLs only.
if (($class = self::get_attribute($text, 'class')) !== null) {
$attributes['class'] .= ' ' . $class;
}
$text = self::remove_attributes($text, ['id', 'width', 'height', 'class']);
if (self::get_attribute($text, 'title') === null) {
$attributes['title'] = $title;
}
$text = self::add_attributes($text, $attributes);
$text = self::replace_sources($text, $sources);
} else {
// Create <video> or <audio> tag with necessary attributes and all sources.
// We don't want fallback to another player because list_supported_urls() is already smart.
// Otherwise we could end up with nested <audio> or <video> tags. Fallback to link only.
$attributes += ['preload' => 'auto', 'controls' => 'true', 'title' => $title];
$text = html_writer::tag($isaudio ? 'audio' : 'video', $sources . self::LINKPLACEHOLDER, $attributes);
}
// Limit the width of the video if width is specified.
// We do not do it in the width attributes of the video because it does not work well
// together with responsive behavior.
if ($responsive) {
self::pick_video_size($width, $height);
if ($width) {
$text = html_writer::div($text, null, ['style' => 'max-width:' . $width . 'px;']);
}
}
return html_writer::div($text, 'mediaplugin mediaplugin_videojs d-block');
}
/**
* Utility function that sets width and height to defaults if not specified
* as a parameter to the function (will be specified either if, (a) the calling
* code passed it, or (b) the URL included it).
* @param int $width Width passed to function (updated with final value)
* @param int $height Height passed to function (updated with final value)
*/
protected static function pick_video_size(&$width, &$height) {
if (!get_config('media_videojs', 'limitsize')) {
return;
}
parent::pick_video_size($width, $height);
}
/**
* Method to convert Youtube time parameter string, which can contain human readable time
* intervals such as '1h5m', '1m10s', etc or a numeric seconds value
*
* @param string $timestr
* @return int
*/
protected static function get_start_time(string $timestr): int {
if (is_numeric($timestr)) {
// We can return the time string itself if it's already numeric.
return (int) $timestr;
}
try {
// Parse the time string as an ISO 8601 time interval.
$timeinterval = new DateInterval('PT' . core_text::strtoupper($timestr));
return ($timeinterval->h * HOURSECS) + ($timeinterval->i * MINSECS) + $timeinterval->s;
} catch (Exception $ex) {
// Invalid time interval.
return 0;
}
}
public function get_supported_extensions() {
global $CFG;
require_once($CFG->libdir . '/filelib.php');
if ($this->extensions === null) {
// Get extensions set by user in UI config.
$filetypes = preg_split('/\s*,\s*/',
strtolower(trim(get_config('media_videojs', 'videoextensions') . ',' .
get_config('media_videojs', 'audioextensions'))));
$this->extensions = file_get_typegroup('extension', $filetypes);
if ($this->extensions) {
// Get extensions supported by player.
$supportedextensions = array_merge(file_get_typegroup('extension', 'html_video'),
file_get_typegroup('extension', 'html_audio'), file_get_typegroup('extension', 'media_source'));
$this->extensions = array_intersect($this->extensions, $supportedextensions);
}
}
return $this->extensions;
}
public function list_supported_urls(array $urls, array $options = array()) {
$result = [];
// Youtube.
$this->youtube = false;
if (count($urls) == 1 && get_config('media_videojs', 'youtube')) {
$url = reset($urls);
// Check against regex.
< if (preg_match($this->get_regex_youtube(), $url->out(false), $this->matches)) {
> if (preg_match($this->get_regex_youtube(), $url->out(false), $matches)) {
$this->youtube = true;
return array($url);
}
}
$extensions = $this->get_supported_extensions();
foreach ($urls as $url) {
// Skip the URL that is using RTMP (which might have been picked to the list by its valid extension).
if ($url->get_scheme() === 'rtmp') {
continue;
}
$ext = '.' . core_media_manager::instance()->get_extension($url);
// Handle HLS and MPEG-DASH if supported.
$isstream = in_array($ext, file_get_typegroup('extension', 'media_source'));
if ($isstream && in_array($ext, $extensions) && core_useragent::supports_media_source_extensions($ext)) {
$result[] = $url;
continue;
}
// Ogv.JS Tech.
$this->ogvtech = false;
if (in_array($ext, $this->ogvsupportedextensions) &&
(core_useragent::is_safari() || core_useragent::is_ios())) {
$this->ogvtech = true;
$result[] = $url;
continue;
}
return parent::list_supported_urls($urls, $options);
}
return $result;
}
/**
* Default rank
* @return int
*/
public function get_rank() {
return 2000;
}
/**
* Tries to match the current language to existing language files
*
* Matched language is stored in $this->language
*
* @return string JS code with a setting
*/
protected function find_language() {
global $CFG;
$this->language = current_language();
$basedir = $CFG->dirroot . '/media/player/videojs/videojs/lang/';
$langfiles = get_directory_list($basedir);
$candidates = [];
foreach ($langfiles as $langfile) {
if (strtolower(pathinfo($langfile, PATHINFO_EXTENSION)) !== 'json') {
continue;
}
$lang = basename($langfile, '.json');
if (strtolower($langfile) === $this->language . '.json') {
// Found an exact match for the language. It is stored in $this->language.
return;
}
if (substr($this->language, 0, 2) === strtolower(substr($langfile, 0, 2))) {
// Not an exact match but similar, for example "pt_br" is similar to "pt".
$candidates[$lang] = $langfile;
}
}
if ($candidates) {
// Exact match was not found, take the first candidate.
$this->language = key($candidates);
} else {
// Could not match, use default language of video player (English).
$this->language = 'en';
}
}
/**
* Returns the requested language pack in the json format.
*
* @param string $lang The language code
* @return false|string The read data or false on failure
*/
public static function get_language_content(string $lang) {
global $CFG;
$langfile = "{$CFG->dirroot}/media/player/videojs/videojs/lang/{$lang}.json";
return file_exists($langfile) ? file_get_contents($langfile) : '';
}
public function supports($usedextensions = []) {
$supports = parent::supports($usedextensions);
if (get_config('media_videojs', 'youtube')) {
$supports .= ($supports ? '<br>' : '') . get_string('youtube', 'media_videojs');
}
return $supports;
}
public function get_embeddable_markers() {
$markers = parent::get_embeddable_markers();
// Add YouTube support if enabled.
if (get_config('media_videojs', 'youtube')) {
$markers = array_merge($markers, array('youtube.com', 'youtube-nocookie.com', 'youtu.be', 'y2u.be'));
}
return $markers;
}
/**
* Returns regular expression used to match URLs for single youtube video
* @return string PHP regular expression e.g. '~^https?://example.org/~'
*/
protected function get_regex_youtube() {
// Regex for standard youtube link.
$link = '(youtube(-nocookie)?\.com/(?:watch\?v=|v/))';
// Regex for shortened youtube link.
$shortlink = '((youtu|y2u)\.be/)';
// Initial part of link.
$start = '~^https?://(www\.)?(' . $link . '|' . $shortlink . ')';
// Middle bit: Video key value.
$middle = '([a-z0-9\-_]+)';
return $start . $middle . core_media_player_external::END_LINK_REGEX_PART;
}
/**
* Setup page requirements.
*
* @param moodle_page $page The page we are going to add requirements to.
*/
public function setup($page) {
if (during_initial_install() || is_major_upgrade_required()) {
return;
}
// Load dynamic loader. It will scan page for videojs media and load necessary modules.
// Loader will be loaded on absolutely every page, however the videojs will only be loaded
// when video is present on the page or added later to it in AJAX.
$this->find_language();
$page->requires->js_amd_inline(<<<EOT
require(["media_videojs/loader"], function(loader) {
loader.setUp('$this->language');
});
EOT
);
}
}