UNPKG

rx-player

Version:

Canal+ HTML5 Video Player

github.com/canalplus/rx-player

canalplus/rx-player

57 lines (38 loc) • 2.27 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
# The Stream | Consideration | Status | | ----------------------- | --------------------------------- | | Preferred import style | Directory-only _[1]_ | | Multithread environment | Should be runnable in a WebWorker | _[1]_ Only the `stream` directory itself should be imported and relied on by the rest of the code, not its inner files (thus `./index.ts` should export everything that may be imported by outside code). ## Overview The `Stream` is the part of the RxPlayer choosing the right segments to download, to then push them to the corresponding media buffers (called `SegmentSinks`) so they can later be decoded. To do so, they receive inputs on both what the chosen track should be and on the estimated optimal quality for those tracks. By then monitoring what has already been buffered and the current playback conditions, they can make an educated guess on what segments should be loaded and pushed at any given time. ## The StreamOrchestrator The `StreamOrchestrator` is the main entry point to interact with the `Stream`. It completely takes care of segment downloading and pushing for a whole content. To do so, it creates the right `PeriodStream`s depending on the current playback conditions. ## The PeriodStream The `PeriodStream` creates and destroys `AdaptationStream`s for a single Manifest's Period and a single type of buffer (e.g. "audio", "video", "text" etc.). It does so after asking through a callback which Adaptation has to be chosen for that Period and type. It also takes care of creating the right "`SegmentSink`" for its associated type, if none was already created for it. ## The AdaptationStream The `AdaptationStream` creates and destroys `RepresentationStream`s for a single manifest's Adaptation (such as a particular audio language, a video track etc.) based on the current conditions (network bandwidth, browser conditions...). The `RepresentationStream` will then have the task to do the segment downloading and pushing itself. ## The RepresentationStream The `RepresentationStream` is the part that actually monitors the buffer to deduce which segments should be downloaded, ask to download them and then give the order to push them to the `SegmentSink`.