rendition-mixin.js
2.94 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
/**
* Enable/disable playlist function. It is intended to have the first two
* arguments partially-applied in order to create the final per-playlist
* function.
*
* @param {PlaylistLoader} playlist - The rendition or media-playlist
* @param {Function} changePlaylistFn - A function to be called after a
* playlist's enabled-state has been changed. Will NOT be called if a
* playlist's enabled-state is unchanged
* @param {Boolean=} enable - Value to set the playlist enabled-state to
* or if undefined returns the current enabled-state for the playlist
* @return {Boolean} The current enabled-state of the playlist
*/
let enableFunction = (playlist, changePlaylistFn, enable) => {
let currentlyEnabled = typeof playlist.excludeUntil === 'undefined' ||
playlist.excludeUntil <= Date.now();
if (typeof enable === 'undefined') {
return currentlyEnabled;
}
if (enable !== currentlyEnabled) {
if (enable) {
delete playlist.excludeUntil;
} else {
playlist.excludeUntil = Infinity;
}
// Ensure the outside world knows about our changes
changePlaylistFn();
}
return enable;
};
/**
* The representation object encapsulates the publicly visible information
* in a media playlist along with a setter/getter-type function (enabled)
* for changing the enabled-state of a particular playlist entry
*
* @class Representation
*/
class Representation {
constructor(hlsHandler, playlist, id) {
// Get a reference to a bound version of fastQualityChange_
let fastChangeFunction = hlsHandler
.masterPlaylistController_
.fastQualityChange_
.bind(hlsHandler.masterPlaylistController_);
// Carefully descend into the playlist's attributes since most
// properties are optional
if (playlist.attributes) {
let attributes = playlist.attributes;
if (attributes.RESOLUTION) {
let resolution = attributes.RESOLUTION;
this.width = resolution.width;
this.height = resolution.height;
}
this.bandwidth = attributes.BANDWIDTH;
}
// The id is simply the ordinality of the media playlist
// within the master playlist
this.id = id;
// Partially-apply the enableFunction to create a playlist-
// specific variant
this.enabled = enableFunction.bind(this, playlist, fastChangeFunction);
}
}
/**
* A mixin function that adds the `representations` api to an instance
* of the HlsHandler class
* @param {HlsHandler} hlsHandler - An instance of HlsHandler to add the
* representation API into
*/
let renditionSelectionMixin = function(hlsHandler) {
let playlists = hlsHandler.playlists;
// Add a single API-specific function to the HlsHandler instance
hlsHandler.representations = () => {
return playlists
.master
.playlists
.map((e, i) => new Representation(hlsHandler, e, i));
};
};
export default renditionSelectionMixin;