@gcorevideo/player 2.19.14 → 2.19.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (77) hide show
  1. package/assets/level-selector/list.ejs +2 -2
  2. package/dist/core.js +1 -1
  3. package/dist/index.css +1054 -1054
  4. package/dist/index.js +1232 -1154
  5. package/dist/player.d.ts +157 -22
  6. package/dist/plugins/index.css +634 -634
  7. package/dist/plugins/index.js +1024 -944
  8. package/docs/api/player.bottomgear.getelement.md +56 -0
  9. package/docs/api/player.bottomgear.md +51 -0
  10. package/docs/api/player.bottomgear.setcontent.md +56 -0
  11. package/docs/api/{player.subtitles.levelelement.md → player.gearevents.md} +11 -13
  12. package/docs/api/{player.sourcecontroller.name.md → player.gearitemelement.md} +5 -3
  13. package/docs/api/player.levelselector.md +9 -1
  14. package/docs/api/player.md +37 -0
  15. package/docs/api/{player.sourcecontroller.supportedversion.md → player.mediacontrol.getrightpanel.md} +11 -5
  16. package/docs/api/player.mediacontrol.md +14 -0
  17. package/docs/api/player.mediacontrolelement.md +1 -1
  18. package/docs/api/player.sourcecontroller.md +0 -90
  19. package/docs/api/player.spinnerevents.md +49 -0
  20. package/docs/api/player.spinnerthreebounce._constructor_.md +3 -0
  21. package/docs/api/player.spinnerthreebounce.hide.md +5 -0
  22. package/docs/api/player.spinnerthreebounce.md +14 -95
  23. package/docs/api/player.spinnerthreebounce.show.md +6 -37
  24. package/docs/api/player.subtitles.hide.md +5 -0
  25. package/docs/api/player.subtitles.md +23 -275
  26. package/docs/api/player.subtitles.show.md +5 -0
  27. package/lib/plugins/bottom-gear/BottomGear.d.ts +20 -1
  28. package/lib/plugins/bottom-gear/BottomGear.d.ts.map +1 -1
  29. package/lib/plugins/bottom-gear/BottomGear.js +28 -7
  30. package/lib/plugins/clappr-nerd-stats/ClapprNerdStats.js +4 -4
  31. package/lib/plugins/level-selector/LevelSelector.d.ts +10 -3
  32. package/lib/plugins/level-selector/LevelSelector.d.ts.map +1 -1
  33. package/lib/plugins/level-selector/LevelSelector.js +20 -19
  34. package/lib/plugins/media-control/MediaControl.d.ts +6 -2
  35. package/lib/plugins/media-control/MediaControl.d.ts.map +1 -1
  36. package/lib/plugins/media-control/MediaControl.js +40 -39
  37. package/lib/plugins/source-controller/SourceController.d.ts +9 -0
  38. package/lib/plugins/source-controller/SourceController.d.ts.map +1 -1
  39. package/lib/plugins/source-controller/SourceController.js +11 -1
  40. package/lib/plugins/spinner-three-bounce/SpinnerThreeBounce.d.ts +35 -1
  41. package/lib/plugins/spinner-three-bounce/SpinnerThreeBounce.d.ts.map +1 -1
  42. package/lib/plugins/spinner-three-bounce/SpinnerThreeBounce.js +46 -23
  43. package/lib/plugins/subtitles/Subtitles.d.ts +65 -16
  44. package/lib/plugins/subtitles/Subtitles.d.ts.map +1 -1
  45. package/lib/plugins/subtitles/Subtitles.js +131 -109
  46. package/package.json +1 -1
  47. package/src/plugins/bottom-gear/BottomGear.ts +26 -4
  48. package/src/plugins/clappr-nerd-stats/ClapprNerdStats.ts +4 -4
  49. package/src/plugins/level-selector/LevelSelector.ts +22 -19
  50. package/src/plugins/media-control/MediaControl.ts +43 -41
  51. package/src/plugins/source-controller/SourceController.ts +11 -1
  52. package/src/plugins/source-controller/__tests__/SourceController.test.ts +1 -1
  53. package/src/plugins/spinner-three-bounce/SpinnerThreeBounce.ts +46 -22
  54. package/src/plugins/subtitles/Subtitles.ts +146 -155
  55. package/temp/player.api.json +293 -822
  56. package/tsconfig.tsbuildinfo +1 -1
  57. package/docs/api/player.sourcecontroller.version.md +0 -14
  58. package/docs/api/player.spinnerthreebounce.attributes.md +0 -14
  59. package/docs/api/player.spinnerthreebounce.name.md +0 -11
  60. package/docs/api/player.spinnerthreebounce.render.md +0 -15
  61. package/docs/api/player.spinnerthreebounce.supportedversion.md +0 -13
  62. package/docs/api/player.subtitles.attributes.md +0 -14
  63. package/docs/api/player.subtitles.bindevents.md +0 -15
  64. package/docs/api/player.subtitles.buttonelement.md +0 -15
  65. package/docs/api/player.subtitles.events.md +0 -14
  66. package/docs/api/player.subtitles.name.md +0 -11
  67. package/docs/api/player.subtitles.preselectedlanguage.md +0 -11
  68. package/docs/api/player.subtitles.reload.md +0 -15
  69. package/docs/api/player.subtitles.render.md +0 -15
  70. package/docs/api/player.subtitles.selectsubtitles.md +0 -15
  71. package/docs/api/player.subtitles.startlevelswitch.md +0 -15
  72. package/docs/api/player.subtitles.stoplevelswitch.md +0 -15
  73. package/docs/api/player.subtitles.supportedversion.md +0 -13
  74. package/docs/api/player.subtitles.template.md +0 -11
  75. package/docs/api/player.subtitles.templatestring.md +0 -11
  76. package/docs/api/player.subtitles.unbindevents.md +0 -15
  77. package/docs/api/player.subtitles.version.md +0 -11
@@ -0,0 +1,56 @@
1
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
+
3
+ [Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [BottomGear](./player.bottomgear.md) &gt; [getElement](./player.bottomgear.getelement.md)
4
+
5
+ ## BottomGear.getElement() method
6
+
7
+ > This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
8
+ >
9
+
10
+ **Signature:**
11
+
12
+ ```typescript
13
+ getElement(name: GearItemElement): ZeptoResult | null;
14
+ ```
15
+
16
+ ## Parameters
17
+
18
+ <table><thead><tr><th>
19
+
20
+ Parameter
21
+
22
+
23
+ </th><th>
24
+
25
+ Type
26
+
27
+
28
+ </th><th>
29
+
30
+ Description
31
+
32
+
33
+ </th></tr></thead>
34
+ <tbody><tr><td>
35
+
36
+ name
37
+
38
+
39
+ </td><td>
40
+
41
+ [GearItemElement](./player.gearitemelement.md)
42
+
43
+
44
+ </td><td>
45
+
46
+ Name of a gear menu placeholder item to attach custom UI
47
+
48
+
49
+ </td></tr>
50
+ </tbody></table>
51
+ **Returns:**
52
+
53
+ [ZeptoResult](./player.zeptoresult.md) \| null
54
+
55
+ Zepto result of the element
56
+
@@ -20,3 +20,54 @@ export declare class BottomGear extends UICorePlugin
20
20
 
21
21
  The plugins provides a base for attaching custom settings UI in the gear menu
22
22
 
23
+ Depends on:
24
+
25
+ - [media\_control](./player.mediacontrol.md)
26
+
27
+ ## Methods
28
+
29
+ <table><thead><tr><th>
30
+
31
+ Method
32
+
33
+
34
+ </th><th>
35
+
36
+ Modifiers
37
+
38
+
39
+ </th><th>
40
+
41
+ Description
42
+
43
+
44
+ </th></tr></thead>
45
+ <tbody><tr><td>
46
+
47
+ [getElement(name)](./player.bottomgear.getelement.md)
48
+
49
+
50
+ </td><td>
51
+
52
+
53
+ </td><td>
54
+
55
+ **_(BETA)_**
56
+
57
+
58
+ </td></tr>
59
+ <tr><td>
60
+
61
+ [setContent(content)](./player.bottomgear.setcontent.md)
62
+
63
+
64
+ </td><td>
65
+
66
+
67
+ </td><td>
68
+
69
+ **_(BETA)_** Replaces the content of the gear menu
70
+
71
+
72
+ </td></tr>
73
+ </tbody></table>
@@ -0,0 +1,56 @@
1
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
+
3
+ [Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [BottomGear](./player.bottomgear.md) &gt; [setContent](./player.bottomgear.setcontent.md)
4
+
5
+ ## BottomGear.setContent() method
6
+
7
+ > This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
8
+ >
9
+
10
+ Replaces the content of the gear menu
11
+
12
+ **Signature:**
13
+
14
+ ```typescript
15
+ setContent(content: ZeptoResult): void;
16
+ ```
17
+
18
+ ## Parameters
19
+
20
+ <table><thead><tr><th>
21
+
22
+ Parameter
23
+
24
+
25
+ </th><th>
26
+
27
+ Type
28
+
29
+
30
+ </th><th>
31
+
32
+ Description
33
+
34
+
35
+ </th></tr></thead>
36
+ <tbody><tr><td>
37
+
38
+ content
39
+
40
+
41
+ </td><td>
42
+
43
+ [ZeptoResult](./player.zeptoresult.md)
44
+
45
+
46
+ </td><td>
47
+
48
+ Zepto result of the element
49
+
50
+
51
+ </td></tr>
52
+ </tbody></table>
53
+ **Returns:**
54
+
55
+ void
56
+
@@ -1,25 +1,27 @@
1
1
  <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
2
 
3
- [Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [Subtitles](./player.subtitles.md) &gt; [levelElement](./player.subtitles.levelelement.md)
3
+ [Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [GearEvents](./player.gearevents.md)
4
4
 
5
- ## Subtitles.levelElement() method
5
+ ## GearEvents enum
6
+
7
+ Custom events emitted by the plugin
6
8
 
7
9
  **Signature:**
8
10
 
9
11
  ```typescript
10
- levelElement(id?: string): ZeptoResult;
12
+ export declare enum GearEvents
11
13
  ```
12
14
 
13
- ## Parameters
15
+ ## Enumeration Members
14
16
 
15
17
  <table><thead><tr><th>
16
18
 
17
- Parameter
19
+ Member
18
20
 
19
21
 
20
22
  </th><th>
21
23
 
22
- Type
24
+ Value
23
25
 
24
26
 
25
27
  </th><th>
@@ -30,22 +32,18 @@ Description
30
32
  </th></tr></thead>
31
33
  <tbody><tr><td>
32
34
 
33
- id
35
+ MEDIACONTROL\_GEAR\_RENDERED
34
36
 
35
37
 
36
38
  </td><td>
37
39
 
38
- string
40
+ `"mediacontrol:gear:rendered"`
39
41
 
40
42
 
41
43
  </td><td>
42
44
 
43
- _(Optional)_
45
+ Emitted when the gear menu is rendered
44
46
 
45
47
 
46
48
  </td></tr>
47
49
  </tbody></table>
48
- **Returns:**
49
-
50
- [ZeptoResult](./player.zeptoresult.md)
51
-
@@ -1,14 +1,16 @@
1
1
  <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
2
 
3
- [Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [SourceController](./player.sourcecontroller.md) &gt; [name](./player.sourcecontroller.name.md)
3
+ [Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [GearItemElement](./player.gearitemelement.md)
4
4
 
5
- ## SourceController.name property
5
+ ## GearItemElement type
6
6
 
7
7
  > This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
8
8
  >
9
9
 
10
+ An element inside the gear menu
11
+
10
12
  **Signature:**
11
13
 
12
14
  ```typescript
13
- get name(): string;
15
+ export type GearItemElement = 'quality' | 'rate' | 'nerd';
14
16
  ```
@@ -18,7 +18,15 @@ export declare class LevelSelector extends UICorePlugin
18
18
 
19
19
  ## Remarks
20
20
 
21
- The plugin is rendered as a button in the [gear menu](./player.bottomgear.md)<!-- -->. When clicked, it shows a list of quality levels to choose from.
21
+ Depends on:
22
+
23
+ - [MediaControl](./player.mediacontrol.md)
24
+
25
+ - [BottomGear](./player.bottomgear.md)
26
+
27
+ The plugin is rendered as an item in the gear menu.
28
+
29
+ When clicked, it shows a list of quality levels to choose from.
22
30
 
23
31
  Configuration options:
24
32
 
@@ -277,6 +277,8 @@ Description
277
277
 
278
278
  </td><td>
279
279
 
280
+ **_(BETA)_** Shows a pending operation indicator when playback is buffering or in other appropriate cases
281
+
280
282
 
281
283
  </td></tr>
282
284
  <tr><td>
@@ -295,6 +297,8 @@ Description
295
297
 
296
298
  </td><td>
297
299
 
300
+ **_(BETA)_** A [media control](./player.mediacontrol.md) plugin that provides a UI to select the subtitles when available.
301
+
298
302
 
299
303
  </td></tr>
300
304
  <tr><td>
@@ -334,6 +338,17 @@ Description
334
338
  </th></tr></thead>
335
339
  <tbody><tr><td>
336
340
 
341
+ [GearEvents](./player.gearevents.md)
342
+
343
+
344
+ </td><td>
345
+
346
+ Custom events emitted by the plugin
347
+
348
+
349
+ </td></tr>
350
+ <tr><td>
351
+
337
352
  [PlaybackErrorCode](./player.playbackerrorcode.md)
338
353
 
339
354
 
@@ -353,6 +368,17 @@ Description
353
368
  **_(BETA)_** A top-level event on the player object
354
369
 
355
370
 
371
+ </td></tr>
372
+ <tr><td>
373
+
374
+ [SpinnerEvents](./player.spinnerevents.md)
375
+
376
+
377
+ </td><td>
378
+
379
+ Custom events emitted by the plugin
380
+
381
+
356
382
  </td></tr>
357
383
  <tr><td>
358
384
 
@@ -508,6 +534,17 @@ Description
508
534
  **_(BETA)_** Levels of severity of errors. Non-fatal errors usually can be ignored.
509
535
 
510
536
 
537
+ </td></tr>
538
+ <tr><td>
539
+
540
+ [GearItemElement](./player.gearitemelement.md)
541
+
542
+
543
+ </td><td>
544
+
545
+ **_(BETA)_** An element inside the gear menu
546
+
547
+
511
548
  </td></tr>
512
549
  <tr><td>
513
550
 
@@ -1,16 +1,22 @@
1
1
  <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
2
 
3
- [Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [SourceController](./player.sourcecontroller.md) &gt; [supportedVersion](./player.sourcecontroller.supportedversion.md)
3
+ [Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [MediaControl](./player.mediacontrol.md) &gt; [getRightPanel](./player.mediacontrol.getrightpanel.md)
4
4
 
5
- ## SourceController.supportedVersion property
5
+ ## MediaControl.getRightPanel() method
6
6
 
7
7
  > This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
8
8
  >
9
9
 
10
+ Get the right panel area to append custom elements to
11
+
10
12
  **Signature:**
11
13
 
12
14
  ```typescript
13
- get supportedVersion(): {
14
- min: string;
15
- };
15
+ getRightPanel(): any;
16
16
  ```
17
+ **Returns:**
18
+
19
+ any
20
+
21
+ ZeptoSelector of the right panel element
22
+
@@ -217,6 +217,20 @@ Description
217
217
  **_(BETA)_** Get a media control element DOM node
218
218
 
219
219
 
220
+ </td></tr>
221
+ <tr><td>
222
+
223
+ [getRightPanel()](./player.mediacontrol.getrightpanel.md)
224
+
225
+
226
+ </td><td>
227
+
228
+
229
+ </td><td>
230
+
231
+ **_(BETA)_** Get the right panel area to append custom elements to
232
+
233
+
220
234
  </td></tr>
221
235
  <tr><td>
222
236
 
@@ -12,5 +12,5 @@ Media control elements, mount points for additional plugins
12
12
  **Signature:**
13
13
 
14
14
  ```typescript
15
- export type MediaControlElement = 'bottomGear' | 'clipText' | 'pip' | 'playbackRate' | 'seekBarContainer';
15
+ export type MediaControlElement = 'bottomGear' | 'clipText' | 'gear' | 'pip' | 'playbackRate' | 'seekBarContainer' | 'subtitlesSelector';
16
16
  ```
@@ -62,95 +62,5 @@ Description
62
62
  **_(BETA)_** Constructs a new instance of the `SourceController` class
63
63
 
64
64
 
65
- </td></tr>
66
- </tbody></table>
67
-
68
- ## Properties
69
-
70
- <table><thead><tr><th>
71
-
72
- Property
73
-
74
-
75
- </th><th>
76
-
77
- Modifiers
78
-
79
-
80
- </th><th>
81
-
82
- Type
83
-
84
-
85
- </th><th>
86
-
87
- Description
88
-
89
-
90
- </th></tr></thead>
91
- <tbody><tr><td>
92
-
93
- [name](./player.sourcecontroller.name.md)
94
-
95
-
96
- </td><td>
97
-
98
- `readonly`
99
-
100
-
101
- </td><td>
102
-
103
- string
104
-
105
-
106
- </td><td>
107
-
108
- **_(BETA)_**
109
-
110
-
111
- </td></tr>
112
- <tr><td>
113
-
114
- [supportedVersion](./player.sourcecontroller.supportedversion.md)
115
-
116
-
117
- </td><td>
118
-
119
- `readonly`
120
-
121
-
122
- </td><td>
123
-
124
- { min: string; }
125
-
126
-
127
- </td><td>
128
-
129
- **_(BETA)_**
130
-
131
-
132
- </td></tr>
133
- <tr><td>
134
-
135
- [version](./player.sourcecontroller.version.md)
136
-
137
-
138
- </td><td>
139
-
140
- `static`
141
-
142
- `readonly`
143
-
144
-
145
- </td><td>
146
-
147
- string
148
-
149
-
150
- </td><td>
151
-
152
- **_(BETA)_**
153
-
154
-
155
65
  </td></tr>
156
66
  </tbody></table>
@@ -0,0 +1,49 @@
1
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
+
3
+ [Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [SpinnerEvents](./player.spinnerevents.md)
4
+
5
+ ## SpinnerEvents enum
6
+
7
+ Custom events emitted by the plugin
8
+
9
+ **Signature:**
10
+
11
+ ```typescript
12
+ export declare enum SpinnerEvents
13
+ ```
14
+
15
+ ## Enumeration Members
16
+
17
+ <table><thead><tr><th>
18
+
19
+ Member
20
+
21
+
22
+ </th><th>
23
+
24
+ Value
25
+
26
+
27
+ </th><th>
28
+
29
+ Description
30
+
31
+
32
+ </th></tr></thead>
33
+ <tbody><tr><td>
34
+
35
+ SYNC
36
+
37
+
38
+ </td><td>
39
+
40
+ `"plugins:spinner:sync"`
41
+
42
+
43
+ </td><td>
44
+
45
+ Emitted at the end of the spinner animation cycle to facilitate smooth UI updates, e.g. [SourceController](./player.sourcecontroller.md) listens to this event to reload the source when the spinner is hidden
46
+
47
+
48
+ </td></tr>
49
+ </tbody></table>
@@ -4,6 +4,9 @@
4
4
 
5
5
  ## SpinnerThreeBounce.(constructor)
6
6
 
7
+ > This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
8
+ >
9
+
7
10
  Constructs a new instance of the `SpinnerThreeBounce` class
8
11
 
9
12
  **Signature:**
@@ -4,6 +4,11 @@
4
4
 
5
5
  ## SpinnerThreeBounce.hide() method
6
6
 
7
+ > This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
8
+ >
9
+
10
+ Hides the spinner
11
+
7
12
  **Signature:**
8
13
 
9
14
  ```typescript
@@ -4,6 +4,11 @@
4
4
 
5
5
  ## SpinnerThreeBounce class
6
6
 
7
+ > This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
8
+ >
9
+
10
+ Shows a pending operation indicator when playback is buffering or in other appropriate cases
11
+
7
12
  **Signature:**
8
13
 
9
14
  ```typescript
@@ -11,6 +16,10 @@ export declare class SpinnerThreeBounce extends UIContainerPlugin
11
16
  ```
12
17
  **Extends:** UIContainerPlugin
13
18
 
19
+ ## Remarks
20
+
21
+ The plugin emits
22
+
14
23
  ## Constructors
15
24
 
16
25
  <table><thead><tr><th>
@@ -39,89 +48,7 @@ Description
39
48
 
40
49
  </td><td>
41
50
 
42
- Constructs a new instance of the `SpinnerThreeBounce` class
43
-
44
-
45
- </td></tr>
46
- </tbody></table>
47
-
48
- ## Properties
49
-
50
- <table><thead><tr><th>
51
-
52
- Property
53
-
54
-
55
- </th><th>
56
-
57
- Modifiers
58
-
59
-
60
- </th><th>
61
-
62
- Type
63
-
64
-
65
- </th><th>
66
-
67
- Description
68
-
69
-
70
- </th></tr></thead>
71
- <tbody><tr><td>
72
-
73
- [attributes](./player.spinnerthreebounce.attributes.md)
74
-
75
-
76
- </td><td>
77
-
78
- `readonly`
79
-
80
-
81
- </td><td>
82
-
83
- { 'data-spinner': string; class: string; }
84
-
85
-
86
- </td><td>
87
-
88
-
89
- </td></tr>
90
- <tr><td>
91
-
92
- [name](./player.spinnerthreebounce.name.md)
93
-
94
-
95
- </td><td>
96
-
97
- `readonly`
98
-
99
-
100
- </td><td>
101
-
102
- string
103
-
104
-
105
- </td><td>
106
-
107
-
108
- </td></tr>
109
- <tr><td>
110
-
111
- [supportedVersion](./player.spinnerthreebounce.supportedversion.md)
112
-
113
-
114
- </td><td>
115
-
116
- `readonly`
117
-
118
-
119
- </td><td>
120
-
121
- { min: string; }
122
-
123
-
124
- </td><td>
51
+ **_(BETA)_** Constructs a new instance of the `SpinnerThreeBounce` class
125
52
 
126
53
 
127
54
  </td></tr>
@@ -155,23 +82,13 @@ Description
155
82
 
156
83
  </td><td>
157
84
 
158
-
159
- </td></tr>
160
- <tr><td>
161
-
162
- [render()](./player.spinnerthreebounce.render.md)
163
-
164
-
165
- </td><td>
166
-
167
-
168
- </td><td>
85
+ **_(BETA)_** Hides the spinner
169
86
 
170
87
 
171
88
  </td></tr>
172
89
  <tr><td>
173
90
 
174
- [show(immediate)](./player.spinnerthreebounce.show.md)
91
+ [show()](./player.spinnerthreebounce.show.md)
175
92
 
176
93
 
177
94
  </td><td>
@@ -179,6 +96,8 @@ Description
179
96
 
180
97
  </td><td>
181
98
 
99
+ **_(BETA)_** Shows the spinner
100
+
182
101
 
183
102
  </td></tr>
184
103
  </tbody></table>