Table of Contents

Описание

Данный плеер пример демонстрирует возможности WCS по преобразованию опубликованного на сервере потока в HLS и воспроизведению его в браузере при помощи библиотеки HLS.js. Нарезка потока в HLS запускается автоматически, при обращении к потоку, опубликованному на сервере, по HLS URL, например, для потока на рисунке ниже http`https://localhost:8082test1.flashphoner.com:8445/test/test.m3u8`

Image Added

Начиная со сборки 2.0.244, пример поддерживает следующие параметры:

llhls - включает поддержку Low Latency HLS: false или true
src - полный HLS URL потока для проигрывания, должен быть закодирован при помощи URI encode, например https%3A%2F%2Ftest1.flashphoner.com%3A8445%2Ftest%2Ftest.m3u8

...

autoplay - автоматически запустить проигрывание указанного HLS URL, при этом все поля ввода и кнопки скрываются: false (по умолчанию) или true

Пример открытия плеера с параметрами, как на скриншоте выше (ссылка в поле Permalink )

Code Block

theme	RDark

https://test1.flashphoner.com:8444/client2/examples/demo/streaming/hls-js-player/hls-js-player.html?llhls=false&src=https%3A%2F%2Ftest1.flashphoner.com%3A8445%2Ftest%2Ftest.m3u8

Пример вызова плеера с автозапуском

Code Block

theme	RDark

https://test1.flashphoner.com:8444/client2/examples/demo/streaming/hls-js-player/hls-js-player.html?llhls=false&src=https%3A%2F%2Ftest1.flashphoner.com%3A8445%2Ftest%2Ftest.m3u8&autoplay=true

При этом воспроизведение потока будет запущено автоматически, с отключенным звуком. Для включения звука зритель должен использовать кнопку регулятора громкости в интерфейсе плеера.

Код примера

Код данного примера находится на сервере по следующему пути:

...

hls-js-player.css - файл стилей страницы с плеером
hls-js-player.html - страница с плеером
hls.js - скрипт, обеспечивающий работу плеера (https://github.com/video-dev/hls.js/, Apache License Version 2.0)
hls-js-player.js - скрипт, обеспечивающий запуск плеера
hls.min.js - скрипт, обеспечивающий работу плеера (минимизированная версия)
../hls-player/player-page.html - общая страница плеера для трех HLS примеров

Тестировать данный пример можно по следующему адресу:

...

Для разбора кода возьмем версию файла hls-js-player.js с хешем ecbadc3 1703e13, которая находится здесь и доступна для скачивания в соответствующей сборке 2.0.212244.

1. Определение HLS URL сервераgetHLSUrl() Загрузка страницы плеера

code

Code Block

language	js
theme	RDark

function initPageconst loadPlayerPage = function() {
    $loadPage("#header").text("HLS.JS Player Minimal");
    $("#urlServer").val(getHLSUrl());
    ...
}

2. Настройка div элемента для передачи плееру

code

...

../hls-player/player-page.html", "playerPage", initPage );
}

2. Инициализация HTML-страницы плеера

code

Если браузер не поддерживает технологию MSE, плеер не будет инициализирован, и будет выведено предупреждение

Code Block

language	js
theme	RDark

const initPage =  function initPage(() {
    if (playSrc) {
        setValue("fullLink", decodeURIComponent(playSrc));
    } else if (autoplay) {
       ... console.warn("No HLS URL set, autoplay disabled");
        autoplay = false;
    }
    if (llHlsEnabled) {
        setCheckbox("llHlsEnabled", llHlsEnabled);
    }
    remoteVideo = document.getElementById('remoteVideo');
    if  remoteVideo.style ="background-color: lightgrey;";
}

3. Определение имени потока (должен быть опубликован на сервере)

encodeURIComponent() code

Code Block

language	js
theme	RDark

function playBtnClick() {
    if (validateForm()) (Hls.isSupported()) {
        console.log("Using HLS.JS " + Hls.version);
        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
            initVideoPlayer(remoteVideo, true);
            playBtnClick();
        } else {
            setText("header", "HLS.JS Player Minimal");
            showItem("llHlsMode");
            displayCommonItems();
            setUpButtons();
            enablePlaybackStats();
            // The player should have a maximum fixed size
            setUpPlayerItem(false);
            // The player can be unmuted because user should click Play button
            initVideoPlayer(remoteVideo, false);
        }
    } else {
        var streamName = $('#playStream').val(setText("notifyFlash", "Your browser doesn't support MSE technology required to play video");
        disableItem("applyBtn");
        toggleInputs(false);
     streamName = encodeURIComponent(streamName);}
}

3. Инициализация видео элемента для проигрывания

code

Code Block

language	js
theme	RDark

const initVideoPlayer = function(video, muted) {
    if (video) {
        video.style.backgroundColor = "black";
        video.muted = muted;
    }
}

4. Формирование URL HLS-потока

code

Если указаны ключ и токен авторизации, они будут включены в URL потока

Code Block

language	js
theme	RDark

function playBtnClick(const getVideoSrc = function(src) {
    let videoSrc = src;
    if (validateForm()) {
         ...
 let streamName = getValue('playStream');
        streamName = encodeURIComponent(streamName);
       var videoSrc = $getValue("#urlServerurlServer").val() + '/' + streamName + '/' + streamName + '.m3u8';
        varlet key = $getValue('#keykey').val();
        varlet token = $getValue("#tokentoken").val();
        if (key.length > 0 && token.length > 0) {
            videoSrc += "?" + key + "=" + token;
        }
    }
     ...setValue("fullLink", videoSrc);
    return }videoSrc;
}

5. Настройка HLS. Запуск js плеера

code

Если браузер не поддерживает технологию MSE, плеер не запустится, будет выведено предупреждение

Code Block

language	js
theme	RDark

function playBtnClick(const getHlsConfig = function(llHlsEnabled) {
    if (validateForm())let config = {
        ...lowLatencyMode: false,
        if (Hls.isSupported()) {enableWorker: true,
        backBufferLength: 90,
        manifestLoadingTimeOut: 15000
    };
    console.log("Low Latency HLS: "+llHlsEnabled)
    if(llHlsEnabled) {
        // Here we configure HLS.JS for  hlsPlayerlower latency
        config = new Hls(getHlsConfig(llHlsEnabled)){
           lowLatencyMode: llHlsEnabled,
           enableWorker: true,
           backBufferLength: 90,
           liveBackBufferLength: 0,
           liveSyncDuration: 0.5,
           liveMaxLatencyDuration: 5,
           liveDurationInfinity: true,
           highBufferWatchdogPeriod: 1,
           manifestLoadingTimeOut: 15000
        };
    }
    return config;
}

6. Запуск плеера

code

Code Block

language	js
theme	RDark

const playBtnClick = hlsPlayer.loadSource(videoSrc)function() {
    let videoSrc = getVideoSrc(getValue("fullLink"));
    if (videoSrc) {
       hlsPlayer.attachMedia(remoteVideo llHlsEnabled = getCheckbox("llHlsEnabled");
        hlsPlayer = new Hls(getHlsConfig(llHlsEnabled));
        hlsPlayer.on(Hls.Events.MANIFEST_PARSED, function() {
                console.log("Play with HLS.js");
                remoteVideo.play();
        });
        onStartedremoteVideo.onplaying = (); => {
            console.log("playing event fired");
            }displayPermalink(videoSrc);
        }
        else {hlsPlayer.loadSource(videoSrc);
        hlsPlayer.attachMedia(remoteVideo);
    $("#notifyFlash").text("Your browser doesn't support MSEonStarted(); technology required to play video");
       
 }
    }
}

67. Остановка воспроизведения

code

Code Block

language	js
theme	RDark

functionconst stopBtnClick = function() {
    if (hlsPlayer != null) {
        console.log("Stop HLS segments loading");
        hlsPlayer.stopLoad();
        hlsPlayer = null;
    }
    if (remoteVideo != null) {
        console.log("Stop HTML5 player");
        remoteVideo.pause();
        remoteVideo.currentTime = 0;
        remoteVideo.removeAttribute('src');
        remoteVideo.load();
    }
    onStopped();
}

7. Настройка HLS.js плеера

8. Получение доступной статистики воспроизведения из HTML5 video элемента

HTML5Stats code

Code Block

language	js
theme	RDark

function getHlsConfig(llHlsEnabledconst PlaybackStats = function(interval) {
    varconst configplaybackStats = {
        lowLatencyModeinterval: false interval || STATS_INTERVAL,
        enableWorkertimer: truenull,
        backBufferLengthstats: 90null,
    };
    start: iffunction(llHlsEnabled) {
            let video = remoteVideo;

        // Here we configure HLS.JS for lower latency
playbackStats.stop();
            stats = HTML5Stats(video);
          config  playbackStats.timer = { setInterval(playbackStats.displayStats, playbackStats.interval);
           lowLatencyMode: llHlsEnabled, setText("videoWidth", "N/A");
           enableWorker: true, setText("videoHeight", "N/A");
           backBufferLength: 90, setText("videoRate", "N/A");
           liveBackBufferLength: 0,
 setText("videoFps", "N/A");
            liveSyncDuration: 0.5,
 showItem("stats");
        },
        stop: function() {
            if (playbackStats.timer) {
                clearInterval(playbackStats.timer);
                playbackStats.timer = null;
            }
            playbackStats.stats = null;
            hideItem("stats");
        },
        displayStats: function() {
            if (stats.collect())    liveMaxLatencyDuration: 5,
{
                let width = stats.getWidth();
                let height = stats.getHeight();
                let bitrate = stats.getBitrate();
                let fps = stats.getFps();

                setText("videoWidth", width);
            liveDurationInfinity: true,
    setText("videoHeight", height);

                if (bitrate !== undefined) {
              highBufferWatchdogPeriod: 1,
      setText("videoRate", Math.round(bitrate));
                }
                if (fps !== undefined) {
                    setText("videoFps", fps.toFixed(1));
                }
            }
        }
    };
    return configplaybackStats;
}

Space shortcuts

Page tree

Versions Compared

Old Version 2

New Version Current

Key

Описание

Код примера

Space shortcuts

Page tree

Page History

Versions Compared

Old Version 2

New Version Current

Key

Описание

Код примера