...
Table of Contents |
---|
Описание
Данный плеер пример демонстрирует возможности WCS по преобразованию опубликованного на сервере потока в HLS и воспроизведению его в браузере при помощи библиотеки VideoJS. Транскодирование Нарезка потока в HLS запускается автоматически, при обращении к потоку, опубликованному на сервере, по HLS URL, например, для потока на рисунке скриншоте ниже `https://test1.flashphoner.com:8445/test/test.m3u8`
Пример также позволяет выбрать версию VideoJS для проигрывания. Версия 8, в отличие от версии 7, поддерживает Low Latency HLS, если сервер отдает поток в этом формате
Начиная со сборки 2.0.244, пример поддерживает следующие параметры:
- version - используемая версия VideoJS:
videojs7
илиvideojs8
- src - полный HLS URL потока для проигрывания, должен быть закодирован при помощи URI encode, например
https%3A%2F%2Ftest1.flashphoner.com%3A8445%2Ftest%2Ftest.m3u8
- autoplay - автоматически запустить проигрывание указанного HLS URL, при этом все поля ввода и кнопки скрываются:
false
(по умолчанию) илиtrue
Пример открытия плеера с параметрами, как на скриншоте выше (ссылка в поле Permalink
)
Code Block | ||
---|---|---|
| ||
https://test1.flashphoner.com:8444/client2/examples/demo/streaming/hls-player/hls-player.html?version=videojs7&src=https%3A%2F%2Ftest1.flashphoner.com%3A8445%2Ftest%2Ftest.m3u8 |
Пример вызова плеера с автозапуском
Code Block | ||
---|---|---|
| ||
https://test1.flashphoner.com: |
...
8444/client2/examples/demo/streaming/hls-player/hls-player.html?version=videojs7&src=https%3A%2F%2Ftest1.flashphoner.com%3A8445%2Ftest%2Ftest.m3u8&autoplay=true |
При этом воспроизведение потока будет запущено автоматически, с отключенным звуком. Для включения звука зритель должен использовать кнопку регулятора громкости в интерфейсе плеера.
Код примера
Код данного примера находится на сервере по следующему пути:
...
hls-player.css - файл стилей страницы с плеером
video-js.css - файл стилей HLS-плеера
hls-player.html - страница с плеером
hls-player.js - скрипт, обеспечивающий запуск плеера
player-page.html - общие элементы страницы плеера для трех примеров воспроизведения HLS
В подкаталогах videojs7 и videojs8 находятся, соответственно, две версии VideoJS:
video.js - скрипт, обеспечивающий работу плеера (http://videojs.com/, Apache License Version 2.0)
videojs-hlsvideo.min.js - скрипт, обеспечивающий работу плеера (минимизированная версия)
video-js.css - файл стилей HLS-плеера
Тестировать данный пример можно по следующему адресу:
https://host:88888444/client2/examples/demo/streaming/hls-player/hls-player.html
Здесь host - адрес вашего WCS-сервера.
Работа с кодом примера
Для разбора кода возьмем версию файла hls-player.js с хешем c306c1bbf49bfcbd8e24be927ae95f63b7dbaaba1703e13, которая находится здесь и доступна для
скачивания в соответствующей сборке 2.0.5.28244.2747.
1. Определение HLS URL сервераgetHLSUrl() кодЗагрузка страницы плеера
Code Block | ||||
---|---|---|---|---|
| ||||
const loadPlayerPage = function initPage(() { if (videojsVersion) { $ hideItem("#urlServervideojsInputForm").val(getHLSUrl()); ; loadVideoJS("videojs" + videojsVersion); } else { var let playervideojsInput = videojs('remoteVideo'document.getElementById("videojsInput"); var applyFn = functionfor (videojsType in VIDEOJS_VERSION_TYPE) { varlet streamNameoption = $document.createElement("#playStream").val(); option"); let videojsFolder = ""; switch (videojsType) { case 'VIDEOJS7': videojsFolder = VIDEOJS_VERSION_TYPE.VIDEOJS7; break; case 'VIDEOJS8': videojsFolder = VIDEOJS_VERSION_TYPE.VIDEOJS8; streamName = encodeURIComponent(streamName); player.src({ break; } option.text = videojsFolder; option.value = videojsFolder; videojsInput.appendChild(option); } setHandler("videojsBtn", "click", onVideojsBtnClick); } } |
2. Загрузка выбранной версии VideoJS
Code Block | ||||
---|---|---|---|---|
| ||||
const loadVideoJS = function (version) { if (version) { let playerPage = document.getElementById("playerPage"); src: $("#urlServer").val() + "/" + streamName + "/" + streamName + ".m3u8", loadFile(version + "/video.js", "text/javascript").then( data => { console.log("HLS library loaded successfully", data); loadFile(version + "/video-js.css", "stylesheet").then ( data => { console.log("HLS library stylesheet loaded successfully", data); hideItem("videojsInputForm"); loadPage("player-page.html", "playerPage", initPage ); }).catch( err => { playerPage.innerHTML = "Can't load VideoJS type:library "application/vnd.apple.mpegurl"stylesheet"; playerPage.setAttribute("class", "text-danger"); console.error(err); }) }).catch( err => { setText("videojsError", "Can't load VideoJS library"); player.play( console.error(err); }); $("#applyBtn").prop('disabled', false).click(applyFn); } |
...
}
} |
3. Инициализация HTML-страницы плеера
Code Block | ||||
---|---|---|---|---|
| ||||
const initPage = function() {
if (playSrc) {
setValue("fullLink", decodeURIComponent(playSrc));
} else if (autoplay) {
console.warn("No HLS URL set, autoplay disabled");
autoplay = false;
}
let remoteVideo = document.getElementById('remoteVideo');
if (autoplay) {
// There should not be any visible item on the page unless player
hideAllToAutoplay();
// The player should use all available page width
setUpPlayerItem(true);
// The player should be muted to automatically start playback
player = initVideoJsPlayer(remoteVideo, true);
playBtnClick();
} else {
// No autoplay, all the forms and buttons should be visible
setText("header", "HLS VideoJS Player Minimal");
displayCommonItems();
setUpButtons();
enablePlaybackStats();
// The player should have a maximum fixed size
setUpPlayerItem(false);
// The player can be unmuted because user should click Play button
player = initVideoJsPlayer(remoteVideo, false);
}
} |
4. Инициализация плеера
Плееру передается имя передаются следующие параметры:
- video - div-
...
- элемент, в котором должен быть проигран поток
- playsinline: true - проигрывать видео на странице, не переключаясь в полноэкранный режим (игнорируется в iOS Safari)
- playbackRates - список скоростей воспроизведения
- liveui: true - включает интерфейс для перемотки (DVR)
- liveTracker - настройка границы проигрывания живого потока
- fill: true - масштабировать плеер под размеры div элемента
Code Block | ||||
---|---|---|---|---|
| ||||
const initVideoJsPlayer = function initPage((video, muted) { let videoJsPlayer = null; if (video) { $("#urlServer").val(getHLSUrl()); var player = videojs('remoteVideo'); var applyFn = function () video.className = "video-js vjs-default-skin"; videoJsPlayer = videojs(video, { playsinline: true, playbackRates: [0.1, 0.25, 0.5, 1, 1.5, 2], liveui: true, liveTracker: { trackingThreshold: LIVE_THRESHOLD, liveTolerance: LIVE_TOLERANCE }, fill: true, muted: muted }); console.log("Using VideoJs " + videojs.VERSION); if (Browser.isSafariWebRTC() && Browser.isiOS()) { // iOS hack when using standard controls to leave fullscreen mode let videoTag = getActualVideoTag(); if(videoTag) { setWebkitFullscreenHandlers(videoTag, false); } } } return videoJsPlayer; } |
5. Формирование URL HLS-потока
encodeURIComponent() code
Если указаны ключ и токен авторизации, они будут включены в URL потока
Code Block | ||||
---|---|---|---|---|
| ||||
const getVideoSrc = function(src) { let videoSrc = src; if (validateForm()) { varlet streamName = $("#playStream").val(getValue('playStream'); streamName = encodeURIComponent(streamName); videoSrc = getValue("urlServer") + '/' + streamName + '/' + streamName + player.src({'.m3u8'; let key = src: $("#urlServer").val() + "/" + streamName + "/" + streamName + ".m3u8"getValue('key'); let token = getValue("token"); if (key.length > 0 && token.length > 0) { videoSrc += "?" + key + "=" + token; } } setValue("fullLink", videoSrc); return videoSrc; } |
6. Запуск плеера
player.on(), player.play() code
Code Block | ||||
---|---|---|---|---|
| ||||
const playBtnClick = function() { let videoSrc = getVideoSrc(getValue("fullLink")); if (videoSrc) { player.on('loadedmetadata', function() { console.log("Play with VideoJs"); player.play(); }); ... player.src({ src: videoSrc, type: "application/vnd.apple.mpegurl" }); player.playonStarted(); }; } |
7. Обработка события playing
player.on() code
Code Block | ||||
---|---|---|---|---|
| ||||
const playBtnClick = function() { $ let videoSrc = getVideoSrc(getValue("#applyBtnfullLink").prop('disabled', false).click(applyFn); } |
3. Определение имени потока (должен быть опубликован на сервере)
...
);
if (videoSrc) {
...
player.on('playing', function() {
console.log("playing event fired");
displayPermalink(videoSrc);
if (player.liveTracker) {
if (!player.liveTracker.isLive()) {
// A cratch to display live UI for the first subscriber
liveUIDisplay();
}
if (player.liveTracker.atLiveEdge()) {
// Unlock backward buttons when seeked to live edge
toggleBackButtons(true);
// Stop live UI startup timer
stopLiveUITimer();
}
}
});
...
}
} |
8. Включение интерфейса перемотки (DVR) для первого подписчика
player.liveTracker.seekToLiveEdge() code
Code Block | ||||
---|---|---|---|---|
| ||||
const liveUIDisplay = function initPage(() { stopLiveUITimer() if (player && player.liveTracker) { $("#urlServer").val(getHLSUrl()); var player = videojs('remoteVideo'); var applyFn = function () { liveUITimer = setInterval(function() { if (!player.liveTracker.isLive() && player.liveTracker.liveWindow() > LIVE_THRESHOLD) { // Live UI is not displayed yet, seek to live edge to display player.liveTracker.seekToLiveEdge(); } }, LIVE_UI_INTERVAL) } } |
9. Действия по нажатию на кнопку перемотки назад
player.seekable(), player.currentTime() code
Code Block | ||||
---|---|---|---|---|
| ||||
const backBtnClick = function(event) { if (player != null && player.liveTracker) { toggleBackButtons(false); let seekable = player.seekable(); varlet streamNamebackTime = $("#playStream").val(); -1; if (event.target.id.indexOf("10") !== -1) { backTime = player.currentTime() - 10; } else if (event.target.id.indexOf("30") !== -1) { streamName backTime = encodeURIComponentplayer.currentTime(streamName) - 30; } player.src( if (backTime < 0) { src: $("#urlServer").val() + "/" + streamName + "/" + streamName + ".m3u8", type: "application/vnd.apple.mpegurl"backTime = seekable ? seekable.start(0) : player.currentTime(); } player.currentTime(backTime); } } |
10. Действия по нажатию на кнопку Live
player.liveTracker.seekToLiveEdge() code
Code Block | ||||
---|---|---|---|---|
| ||||
const liveBtnClick = function() { if (player != null && player.liveTracker) { }player.liveTracker.seekToLiveEdge(); player.play(); };toggleBackButtons(true); } } |
11. Остановка воспроизведения
player.dispose() code
Этот метод удаляет со страницы div элемент, в котором был ранее инициализирован плеер
Code Block | ||||
---|---|---|---|---|
| ||||
const stopBtnClick = function() { if (player != null) { $ console.log("#applyBtn").prop('disabled', false).click(applyFn); } |
4. Формирование URL HLS-потока и запуск плеера
...
Stop VideoJS player");
stopLiveUITimer();
player.dispose();
}
onStopped();
} |
12. Создание нового div элемента и плеера в нем после остановки предыдущего плеера
Code Block | ||||
---|---|---|---|---|
| ||||
function initPage(const createRemoteVideo = function(parent) { $let remoteVideo = document.createElement("#urlServervideo").val(getHLSUrl(); remoteVideo.id = "remoteVideo"; remoteVideo.controls="controls"; remoteVideo.autoplay="autoplay"; remoteVideo.type="application/vnd.apple.mpegurl"; remoteVideo.className = "video-js vjs-default-skin"; remoteVideo.setAttribute("playsinline",""); remoteVideo.setAttribute("webkit-playsinline",""); parent.appendChild(remoteVideo); var player = videojsinitVideoJsPlayer('remoteVideo', autoplay); } |
13. Получение доступной статистики воспроизведения из HTML5 video элемента
HTML5Stats code
Code Block | ||||
---|---|---|---|---|
| ||||
const PlaybackStats = function(interval) { var const applyFnplaybackStats = { interval: interval || STATS_INTERVAL, function timer: null, stats: null, start: function() { varlet streamNamevideo = $getActualVideoTag("#playStream").val); playbackStats.stop(); streamName stats = encodeURIComponentHTML5Stats(streamNamevideo); player.src({ playbackStats.timer = setInterval(playbackStats.displayStats, playbackStats.interval); src: $("#urlServer").val() + "/" + streamName + "/" + streamName + ".m3u8", type: "application/vnd.apple.mpegurl"setText("videoWidth", "N/A"); setText("videoHeight", "N/A"); setText("videoRate", "N/A"); setText("videoFps", "N/A"); showItem("stats"); }, stop: function() { if (playbackStats.timer) { clearInterval(playbackStats.timer); playbackStats.timer = null; } playbackStats.stats = null; hideItem("stats"); }, displayStats: function() { if (stats.collect()) { let width = stats.getWidth(); let height = stats.getHeight(); player.play let bitrate = stats.getBitrate(); let fps = stats.getFps(); }; setText("videoWidth", width); $setText("#applyBtnvideoHeight", height).prop('disabled', false).click(applyFn); ; if (bitrate !== undefined) { setText("videoRate", Math.round(bitrate)); } if (fps !== undefined) { setText("videoFps", fps.toFixed(1)); } } } }; return playbackStats; } |