mirror of https://bitbucket.org/ausocean/av.git
Merged in m3u-reduc (pull request #340)
mjpeg-player: reduce and simplify hlsjs code Approved-by: Scott Barnard
This commit is contained in:
Trek Hopton
commit
4a64dee7d9
File diff suppressed because it is too large
Load Diff
|
|
@ -1,674 +1,50 @@
|
||||||
import * as URLToolkit from 'url-toolkit';
|
/*
|
||||||
|
AUTHOR
|
||||||
|
Trek Hopton <trek@ausocean.org>
|
||||||
|
|
||||||
import {
|
LICENSE
|
||||||
ErrorTypes,
|
This file is Copyright (C) 2020 the Australian Ocean Lab (AusOcean)
|
||||||
ErrorDetails
|
|
||||||
} from './errors';
|
|
||||||
|
|
||||||
import PlaylistLoader from './loader/playlist-loader';
|
It is free software: you can redistribute it and/or modify them
|
||||||
import FragmentLoader from './loader/fragment-loader';
|
under the terms of the GNU General Public License as published by the
|
||||||
import KeyLoader from './loader/key-loader';
|
Free Software Foundation, either version 3 of the License, or (at your
|
||||||
|
option) any later version.
|
||||||
|
|
||||||
import { FragmentTracker } from './controller/fragment-tracker';
|
It is distributed in the hope that it will be useful, but WITHOUT
|
||||||
import StreamController from './controller/stream-controller';
|
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
||||||
import LevelController from './controller/level-controller';
|
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
||||||
import ID3TrackController from './controller/id3-track-controller';
|
for more details.
|
||||||
|
|
||||||
import { isSupported } from './is-supported';
|
You should have received a copy of the GNU General Public License in gpl.txt.
|
||||||
import { logger, enableLogs } from './utils/logger';
|
If not, see http://www.gnu.org/licenses.
|
||||||
import { hlsDefaultConfig, HlsConfig } from './config';
|
|
||||||
|
|
||||||
import HlsEvents from './events';
|
For hls.js Copyright notice and license, see LICENSE file.
|
||||||
|
*/
|
||||||
|
|
||||||
import { Observer } from './observer';
|
import URLToolkit from '../url-toolkit/url-toolkit.js';
|
||||||
|
import HlsEvents from './events.js';
|
||||||
|
import PlaylistLoader from './loader/playlist-loader.js';
|
||||||
|
import FragmentLoader from './loader/fragment-loader.js';
|
||||||
|
import StreamController from './controller/stream-controller.js';
|
||||||
|
import { hlsDefaultConfig } from './config.js';
|
||||||
|
import { Observer } from './observer.js';
|
||||||
|
|
||||||
/**
|
class Hls extends Observer {
|
||||||
* @module Hls
|
constructor() {
|
||||||
* @class
|
|
||||||
* @constructor
|
|
||||||
*/
|
|
||||||
export default class Hls extends Observer {
|
|
||||||
public static defaultConfig?: HlsConfig;
|
|
||||||
public config: HlsConfig;
|
|
||||||
|
|
||||||
private _autoLevelCapping: number;
|
|
||||||
private abrController: any;
|
|
||||||
private capLevelController: any;
|
|
||||||
private levelController: any;
|
|
||||||
private streamController: any;
|
|
||||||
private networkControllers: any[];
|
|
||||||
private audioTrackController: any;
|
|
||||||
private subtitleTrackController: any;
|
|
||||||
private emeController: any;
|
|
||||||
private coreComponents: any[];
|
|
||||||
private media: HTMLMediaElement | null = null;
|
|
||||||
private url: string | null = null;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @type {string}
|
|
||||||
*/
|
|
||||||
static get version (): string {
|
|
||||||
return __VERSION__;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @type {boolean}
|
|
||||||
*/
|
|
||||||
static isSupported (): boolean {
|
|
||||||
return isSupported();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @type {HlsEvents}
|
|
||||||
*/
|
|
||||||
static get Events () {
|
|
||||||
return HlsEvents;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @type {HlsErrorTypes}
|
|
||||||
*/
|
|
||||||
static get ErrorTypes () {
|
|
||||||
return ErrorTypes;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @type {HlsErrorDetails}
|
|
||||||
*/
|
|
||||||
static get ErrorDetails () {
|
|
||||||
return ErrorDetails;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @type {HlsConfig}
|
|
||||||
*/
|
|
||||||
static get DefaultConfig (): HlsConfig {
|
|
||||||
if (!Hls.defaultConfig) {
|
|
||||||
return hlsDefaultConfig;
|
|
||||||
}
|
|
||||||
|
|
||||||
return Hls.defaultConfig;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @type {HlsConfig}
|
|
||||||
*/
|
|
||||||
static set DefaultConfig (defaultConfig: HlsConfig) {
|
|
||||||
Hls.defaultConfig = defaultConfig;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Creates an instance of an HLS client that can attach to exactly one `HTMLMediaElement`.
|
|
||||||
*
|
|
||||||
* @constructs Hls
|
|
||||||
* @param {HlsConfig} config
|
|
||||||
*/
|
|
||||||
constructor (userConfig: Partial<HlsConfig> = {}) {
|
|
||||||
super();
|
super();
|
||||||
|
this.pLoader = new PlaylistLoader(this);
|
||||||
|
this.streamController = new StreamController(this);
|
||||||
|
this.fragmentLoader = new FragmentLoader(this);
|
||||||
|
|
||||||
const defaultConfig = Hls.DefaultConfig;
|
this.config = hlsDefaultConfig;
|
||||||
|
|
||||||
if ((userConfig.liveSyncDurationCount || userConfig.liveMaxLatencyDurationCount) && (userConfig.liveSyncDuration || userConfig.liveMaxLatencyDuration)) {
|
|
||||||
throw new Error('Illegal hls.js config: don\'t mix up liveSyncDurationCount/liveMaxLatencyDurationCount and liveSyncDuration/liveMaxLatencyDuration');
|
|
||||||
}
|
|
||||||
|
|
||||||
// Shallow clone
|
|
||||||
this.config = {
|
|
||||||
...defaultConfig,
|
|
||||||
...userConfig
|
|
||||||
};
|
|
||||||
|
|
||||||
const { config } = this;
|
|
||||||
|
|
||||||
if (config.liveMaxLatencyDurationCount !== void 0 && config.liveMaxLatencyDurationCount <= config.liveSyncDurationCount) {
|
|
||||||
throw new Error('Illegal hls.js config: "liveMaxLatencyDurationCount" must be gt "liveSyncDurationCount"');
|
|
||||||
}
|
|
||||||
|
|
||||||
if (config.liveMaxLatencyDuration !== void 0 && (config.liveSyncDuration === void 0 || config.liveMaxLatencyDuration <= config.liveSyncDuration)) {
|
|
||||||
throw new Error('Illegal hls.js config: "liveMaxLatencyDuration" must be gt "liveSyncDuration"');
|
|
||||||
}
|
|
||||||
|
|
||||||
enableLogs(config.debug);
|
|
||||||
|
|
||||||
this._autoLevelCapping = -1;
|
|
||||||
|
|
||||||
// core controllers and network loaders
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @member {AbrController} abrController
|
|
||||||
*/
|
|
||||||
const abrController = this.abrController = new config.abrController(this); // eslint-disable-line new-cap
|
|
||||||
const bufferController = new config.bufferController(this); // eslint-disable-line new-cap
|
|
||||||
const capLevelController = this.capLevelController = new config.capLevelController(this); // eslint-disable-line new-cap
|
|
||||||
const fpsController = new config.fpsController(this); // eslint-disable-line new-cap
|
|
||||||
const playListLoader = new PlaylistLoader(this);
|
|
||||||
const fragmentLoader = new FragmentLoader(this);
|
|
||||||
const keyLoader = new KeyLoader(this);
|
|
||||||
const id3TrackController = new ID3TrackController(this);
|
|
||||||
|
|
||||||
// network controllers
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @member {LevelController} levelController
|
|
||||||
*/
|
|
||||||
const levelController = this.levelController = new LevelController(this);
|
|
||||||
|
|
||||||
// FIXME: FragmentTracker must be defined before StreamController because the order of event handling is important
|
|
||||||
const fragmentTracker = new FragmentTracker(this);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @member {StreamController} streamController
|
|
||||||
*/
|
|
||||||
const streamController = this.streamController = new StreamController(this, fragmentTracker);
|
|
||||||
|
|
||||||
let networkControllers = [levelController, streamController];
|
|
||||||
|
|
||||||
// optional audio stream controller
|
|
||||||
/**
|
|
||||||
* @var {ICoreComponent | Controller}
|
|
||||||
*/
|
|
||||||
let Controller = config.audioStreamController;
|
|
||||||
if (Controller) {
|
|
||||||
networkControllers.push(new Controller(this, fragmentTracker));
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @member {INetworkController[]} networkControllers
|
|
||||||
*/
|
|
||||||
this.networkControllers = networkControllers;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @var {ICoreComponent[]}
|
|
||||||
*/
|
|
||||||
const coreComponents = [
|
|
||||||
playListLoader,
|
|
||||||
fragmentLoader,
|
|
||||||
keyLoader,
|
|
||||||
abrController,
|
|
||||||
bufferController,
|
|
||||||
capLevelController,
|
|
||||||
fpsController,
|
|
||||||
id3TrackController,
|
|
||||||
fragmentTracker
|
|
||||||
];
|
|
||||||
|
|
||||||
// optional audio track and subtitle controller
|
|
||||||
Controller = config.audioTrackController;
|
|
||||||
if (Controller) {
|
|
||||||
const audioTrackController = new Controller(this);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @member {AudioTrackController} audioTrackController
|
|
||||||
*/
|
|
||||||
this.audioTrackController = audioTrackController;
|
|
||||||
coreComponents.push(audioTrackController);
|
|
||||||
}
|
|
||||||
|
|
||||||
Controller = config.subtitleTrackController;
|
|
||||||
if (Controller) {
|
|
||||||
const subtitleTrackController = new Controller(this);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @member {SubtitleTrackController} subtitleTrackController
|
|
||||||
*/
|
|
||||||
this.subtitleTrackController = subtitleTrackController;
|
|
||||||
networkControllers.push(subtitleTrackController);
|
|
||||||
}
|
|
||||||
|
|
||||||
Controller = config.emeController;
|
|
||||||
if (Controller) {
|
|
||||||
const emeController = new Controller(this);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @member {EMEController} emeController
|
|
||||||
*/
|
|
||||||
this.emeController = emeController;
|
|
||||||
coreComponents.push(emeController);
|
|
||||||
}
|
|
||||||
|
|
||||||
// optional subtitle controllers
|
|
||||||
Controller = config.subtitleStreamController;
|
|
||||||
if (Controller) {
|
|
||||||
networkControllers.push(new Controller(this, fragmentTracker));
|
|
||||||
}
|
|
||||||
Controller = config.timelineController;
|
|
||||||
if (Controller) {
|
|
||||||
coreComponents.push(new Controller(this));
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @member {ICoreComponent[]}
|
|
||||||
*/
|
|
||||||
this.coreComponents = coreComponents;
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
// url is the source URL. Can be relative or absolute.
|
||||||
* Dispose of the instance
|
loadSource(url, callback) {
|
||||||
*/
|
this.loadSuccess = callback;
|
||||||
destroy () {
|
|
||||||
logger.log('destroy');
|
|
||||||
this.trigger(HlsEvents.DESTROYING);
|
|
||||||
this.detachMedia();
|
|
||||||
this.coreComponents.concat(this.networkControllers).forEach(component => {
|
|
||||||
component.destroy();
|
|
||||||
});
|
|
||||||
this.url = null;
|
|
||||||
this.removeAllListeners();
|
|
||||||
this._autoLevelCapping = -1;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Attach a media element
|
|
||||||
* @param {HTMLMediaElement} media
|
|
||||||
*/
|
|
||||||
attachMedia (media: HTMLMediaElement) {
|
|
||||||
logger.log('attachMedia');
|
|
||||||
this.media = media;
|
|
||||||
this.trigger(HlsEvents.MEDIA_ATTACHING, { media: media });
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Detach from the media
|
|
||||||
*/
|
|
||||||
detachMedia () {
|
|
||||||
logger.log('detachMedia');
|
|
||||||
this.trigger(HlsEvents.MEDIA_DETACHING);
|
|
||||||
this.media = null;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Set the source URL. Can be relative or absolute.
|
|
||||||
* @param {string} url
|
|
||||||
*/
|
|
||||||
loadSource (url: string) {
|
|
||||||
url = URLToolkit.buildAbsoluteURL(window.location.href, url, { alwaysNormalize: true });
|
url = URLToolkit.buildAbsoluteURL(window.location.href, url, { alwaysNormalize: true });
|
||||||
logger.log(`loadSource:${url}`);
|
|
||||||
this.url = url;
|
|
||||||
// when attaching to a source URL, trigger a playlist load
|
|
||||||
this.trigger(HlsEvents.MANIFEST_LOADING, { url: url });
|
this.trigger(HlsEvents.MANIFEST_LOADING, { url: url });
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
|
||||||
* Start loading data from the stream source.
|
|
||||||
* Depending on default config, client starts loading automatically when a source is set.
|
|
||||||
*
|
|
||||||
* @param {number} startPosition Set the start position to stream from
|
|
||||||
* @default -1 None (from earliest point)
|
|
||||||
*/
|
|
||||||
startLoad (startPosition: number = -1) {
|
|
||||||
logger.log(`startLoad(${startPosition})`);
|
|
||||||
this.networkControllers.forEach(controller => {
|
|
||||||
controller.startLoad(startPosition);
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Stop loading of any stream data.
|
|
||||||
*/
|
|
||||||
stopLoad () {
|
|
||||||
logger.log('stopLoad');
|
|
||||||
this.networkControllers.forEach(controller => {
|
|
||||||
controller.stopLoad();
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Swap through possible audio codecs in the stream (for example to switch from stereo to 5.1)
|
|
||||||
*/
|
|
||||||
swapAudioCodec () {
|
|
||||||
logger.log('swapAudioCodec');
|
|
||||||
this.streamController.swapAudioCodec();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* When the media-element fails, this allows to detach and then re-attach it
|
|
||||||
* as one call (convenience method).
|
|
||||||
*
|
|
||||||
* Automatic recovery of media-errors by this process is configurable.
|
|
||||||
*/
|
|
||||||
recoverMediaError () {
|
|
||||||
logger.log('recoverMediaError');
|
|
||||||
let media = this.media;
|
|
||||||
this.detachMedia();
|
|
||||||
if (media) {
|
|
||||||
this.attachMedia(media);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @type {QualityLevel[]}
|
|
||||||
*/
|
|
||||||
// todo(typescript-levelController)
|
|
||||||
get levels (): any[] {
|
|
||||||
return this.levelController.levels;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Index of quality level currently played
|
|
||||||
* @type {number}
|
|
||||||
*/
|
|
||||||
get currentLevel (): number {
|
|
||||||
return this.streamController.currentLevel;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Set quality level index immediately .
|
|
||||||
* This will flush the current buffer to replace the quality asap.
|
|
||||||
* That means playback will interrupt at least shortly to re-buffer and re-sync eventually.
|
|
||||||
* @type {number} -1 for automatic level selection
|
|
||||||
*/
|
|
||||||
set currentLevel (newLevel: number) {
|
|
||||||
logger.log(`set currentLevel:${newLevel}`);
|
|
||||||
this.loadLevel = newLevel;
|
|
||||||
this.streamController.immediateLevelSwitch();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Index of next quality level loaded as scheduled by stream controller.
|
|
||||||
* @type {number}
|
|
||||||
*/
|
|
||||||
get nextLevel (): number {
|
|
||||||
return this.streamController.nextLevel;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Set quality level index for next loaded data.
|
|
||||||
* This will switch the video quality asap, without interrupting playback.
|
|
||||||
* May abort current loading of data, and flush parts of buffer (outside currently played fragment region).
|
|
||||||
* @type {number} -1 for automatic level selection
|
|
||||||
*/
|
|
||||||
set nextLevel (newLevel: number) {
|
|
||||||
logger.log(`set nextLevel:${newLevel}`);
|
|
||||||
this.levelController.manualLevel = newLevel;
|
|
||||||
this.streamController.nextLevelSwitch();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Return the quality level of the currently or last (of none is loaded currently) segment
|
|
||||||
* @type {number}
|
|
||||||
*/
|
|
||||||
get loadLevel (): number {
|
|
||||||
return this.levelController.level;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Set quality level index for next loaded data in a conservative way.
|
|
||||||
* This will switch the quality without flushing, but interrupt current loading.
|
|
||||||
* Thus the moment when the quality switch will appear in effect will only be after the already existing buffer.
|
|
||||||
* @type {number} newLevel -1 for automatic level selection
|
|
||||||
*/
|
|
||||||
set loadLevel (newLevel: number) {
|
|
||||||
logger.log(`set loadLevel:${newLevel}`);
|
|
||||||
this.levelController.manualLevel = newLevel;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* get next quality level loaded
|
|
||||||
* @type {number}
|
|
||||||
*/
|
|
||||||
get nextLoadLevel (): number {
|
|
||||||
return this.levelController.nextLoadLevel;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Set quality level of next loaded segment in a fully "non-destructive" way.
|
|
||||||
* Same as `loadLevel` but will wait for next switch (until current loading is done).
|
|
||||||
* @type {number} level
|
|
||||||
*/
|
|
||||||
set nextLoadLevel (level: number) {
|
|
||||||
this.levelController.nextLoadLevel = level;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Return "first level": like a default level, if not set,
|
|
||||||
* falls back to index of first level referenced in manifest
|
|
||||||
* @type {number}
|
|
||||||
*/
|
|
||||||
get firstLevel (): number {
|
|
||||||
return Math.max(this.levelController.firstLevel, this.minAutoLevel);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Sets "first-level", see getter.
|
|
||||||
* @type {number}
|
|
||||||
*/
|
|
||||||
set firstLevel (newLevel: number) {
|
|
||||||
logger.log(`set firstLevel:${newLevel}`);
|
|
||||||
this.levelController.firstLevel = newLevel;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Return start level (level of first fragment that will be played back)
|
|
||||||
* if not overrided by user, first level appearing in manifest will be used as start level
|
|
||||||
* if -1 : automatic start level selection, playback will start from level matching download bandwidth
|
|
||||||
* (determined from download of first segment)
|
|
||||||
* @type {number}
|
|
||||||
*/
|
|
||||||
get startLevel (): number {
|
|
||||||
return this.levelController.startLevel;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* set start level (level of first fragment that will be played back)
|
|
||||||
* if not overrided by user, first level appearing in manifest will be used as start level
|
|
||||||
* if -1 : automatic start level selection, playback will start from level matching download bandwidth
|
|
||||||
* (determined from download of first segment)
|
|
||||||
* @type {number} newLevel
|
|
||||||
*/
|
|
||||||
set startLevel (newLevel: number) {
|
|
||||||
logger.log(`set startLevel:${newLevel}`);
|
|
||||||
// if not in automatic start level detection, ensure startLevel is greater than minAutoLevel
|
|
||||||
if (newLevel !== -1) {
|
|
||||||
newLevel = Math.max(newLevel, this.minAutoLevel);
|
|
||||||
}
|
|
||||||
|
|
||||||
this.levelController.startLevel = newLevel;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* set dynamically set capLevelToPlayerSize against (`CapLevelController`)
|
|
||||||
*
|
|
||||||
* @type {boolean}
|
|
||||||
*/
|
|
||||||
set capLevelToPlayerSize (shouldStartCapping: boolean) {
|
|
||||||
const newCapLevelToPlayerSize = !!shouldStartCapping;
|
|
||||||
|
|
||||||
if (newCapLevelToPlayerSize !== this.config.capLevelToPlayerSize) {
|
|
||||||
if (newCapLevelToPlayerSize) {
|
|
||||||
this.capLevelController.startCapping(); // If capping occurs, nextLevelSwitch will happen based on size.
|
|
||||||
} else {
|
|
||||||
this.capLevelController.stopCapping();
|
|
||||||
this.autoLevelCapping = -1;
|
|
||||||
this.streamController.nextLevelSwitch(); // Now we're uncapped, get the next level asap.
|
|
||||||
}
|
|
||||||
|
|
||||||
this.config.capLevelToPlayerSize = newCapLevelToPlayerSize;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Capping/max level value that should be used by automatic level selection algorithm (`ABRController`)
|
|
||||||
* @type {number}
|
|
||||||
*/
|
|
||||||
get autoLevelCapping (): number {
|
|
||||||
return this._autoLevelCapping;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* get bandwidth estimate
|
|
||||||
* @type {number}
|
|
||||||
*/
|
|
||||||
get bandwidthEstimate (): number {
|
|
||||||
const bwEstimator = this.abrController._bwEstimator;
|
|
||||||
return bwEstimator ? bwEstimator.getEstimate() : NaN;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Capping/max level value that should be used by automatic level selection algorithm (`ABRController`)
|
|
||||||
* @type {number}
|
|
||||||
*/
|
|
||||||
set autoLevelCapping (newLevel: number) {
|
|
||||||
logger.log(`set autoLevelCapping:${newLevel}`);
|
|
||||||
this._autoLevelCapping = newLevel;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* True when automatic level selection enabled
|
|
||||||
* @type {boolean}
|
|
||||||
*/
|
|
||||||
get autoLevelEnabled (): boolean {
|
|
||||||
return (this.levelController.manualLevel === -1);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Level set manually (if any)
|
|
||||||
* @type {number}
|
|
||||||
*/
|
|
||||||
get manualLevel (): number {
|
|
||||||
return this.levelController.manualLevel;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* min level selectable in auto mode according to config.minAutoBitrate
|
|
||||||
* @type {number}
|
|
||||||
*/
|
|
||||||
get minAutoLevel (): number {
|
|
||||||
const { levels, config: { minAutoBitrate } } = this;
|
|
||||||
const len = levels ? levels.length : 0;
|
|
||||||
|
|
||||||
for (let i = 0; i < len; i++) {
|
|
||||||
const levelNextBitrate = levels[i].realBitrate
|
|
||||||
? Math.max(levels[i].realBitrate, levels[i].bitrate)
|
|
||||||
: levels[i].bitrate;
|
|
||||||
|
|
||||||
if (levelNextBitrate > minAutoBitrate) {
|
|
||||||
return i;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* max level selectable in auto mode according to autoLevelCapping
|
|
||||||
* @type {number}
|
|
||||||
*/
|
|
||||||
get maxAutoLevel (): number {
|
|
||||||
const { levels, autoLevelCapping } = this;
|
|
||||||
|
|
||||||
let maxAutoLevel;
|
|
||||||
if (autoLevelCapping === -1 && levels && levels.length) {
|
|
||||||
maxAutoLevel = levels.length - 1;
|
|
||||||
} else {
|
|
||||||
maxAutoLevel = autoLevelCapping;
|
|
||||||
}
|
|
||||||
|
|
||||||
return maxAutoLevel;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* next automatically selected quality level
|
|
||||||
* @type {number}
|
|
||||||
*/
|
|
||||||
get nextAutoLevel (): number {
|
|
||||||
// ensure next auto level is between min and max auto level
|
|
||||||
return Math.min(Math.max(this.abrController.nextAutoLevel, this.minAutoLevel), this.maxAutoLevel);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* this setter is used to force next auto level.
|
|
||||||
* this is useful to force a switch down in auto mode:
|
|
||||||
* in case of load error on level N, hls.js can set nextAutoLevel to N-1 for example)
|
|
||||||
* forced value is valid for one fragment. upon succesful frag loading at forced level,
|
|
||||||
* this value will be resetted to -1 by ABR controller.
|
|
||||||
* @type {number}
|
|
||||||
*/
|
|
||||||
set nextAutoLevel (nextLevel: number) {
|
|
||||||
this.abrController.nextAutoLevel = Math.max(this.minAutoLevel, nextLevel);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @type {AudioTrack[]}
|
|
||||||
*/
|
|
||||||
// todo(typescript-audioTrackController)
|
|
||||||
get audioTracks (): any[] {
|
|
||||||
const audioTrackController = this.audioTrackController;
|
|
||||||
return audioTrackController ? audioTrackController.audioTracks : [];
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* index of the selected audio track (index in audio track lists)
|
|
||||||
* @type {number}
|
|
||||||
*/
|
|
||||||
get audioTrack (): number {
|
|
||||||
const audioTrackController = this.audioTrackController;
|
|
||||||
return audioTrackController ? audioTrackController.audioTrack : -1;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* selects an audio track, based on its index in audio track lists
|
|
||||||
* @type {number}
|
|
||||||
*/
|
|
||||||
set audioTrack (audioTrackId: number) {
|
|
||||||
const audioTrackController = this.audioTrackController;
|
|
||||||
if (audioTrackController) {
|
|
||||||
audioTrackController.audioTrack = audioTrackId;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @type {Seconds}
|
|
||||||
*/
|
|
||||||
get liveSyncPosition (): number {
|
|
||||||
return this.streamController.liveSyncPosition;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* get alternate subtitle tracks list from playlist
|
|
||||||
* @type {SubtitleTrack[]}
|
|
||||||
*/
|
|
||||||
// todo(typescript-subtitleTrackController)
|
|
||||||
get subtitleTracks (): any[] {
|
|
||||||
const subtitleTrackController = this.subtitleTrackController;
|
|
||||||
return subtitleTrackController ? subtitleTrackController.subtitleTracks : [];
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* index of the selected subtitle track (index in subtitle track lists)
|
|
||||||
* @type {number}
|
|
||||||
*/
|
|
||||||
get subtitleTrack (): number {
|
|
||||||
const subtitleTrackController = this.subtitleTrackController;
|
|
||||||
return subtitleTrackController ? subtitleTrackController.subtitleTrack : -1;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* select an subtitle track, based on its index in subtitle track lists
|
|
||||||
* @type {number}
|
|
||||||
*/
|
|
||||||
set subtitleTrack (subtitleTrackId: number) {
|
|
||||||
const subtitleTrackController = this.subtitleTrackController;
|
|
||||||
if (subtitleTrackController) {
|
|
||||||
subtitleTrackController.subtitleTrack = subtitleTrackId;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @type {boolean}
|
|
||||||
*/
|
|
||||||
get subtitleDisplay (): boolean {
|
|
||||||
const subtitleTrackController = this.subtitleTrackController;
|
|
||||||
return subtitleTrackController ? subtitleTrackController.subtitleDisplay : false;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Enable/disable subtitle display rendering
|
|
||||||
* @type {boolean}
|
|
||||||
*/
|
|
||||||
set subtitleDisplay (value: boolean) {
|
|
||||||
const subtitleTrackController = this.subtitleTrackController;
|
|
||||||
if (subtitleTrackController) {
|
|
||||||
subtitleTrackController.subtitleDisplay = value;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
||||||
|
export default Hls
|
||||||
Loading…
Reference in New Issue