@gcorevideo/player 2.8.2 → 2.10.0

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 (103) hide show
  1. package/README.md +39 -0
  2. package/api-extractor.json +454 -0
  3. package/dist/index.js +1032 -182
  4. package/dist/player.d.ts +407 -0
  5. package/docs/api/index.md +31 -0
  6. package/docs/api/player.dashsettings.md +16 -0
  7. package/docs/api/player.langtag.md +15 -0
  8. package/docs/api/player.md +295 -0
  9. package/docs/api/player.mediatransport.md +15 -0
  10. package/docs/api/player.playbackmodule.md +15 -0
  11. package/docs/api/player.playbacktype.md +16 -0
  12. package/docs/api/player.player._constructor_.md +50 -0
  13. package/docs/api/player.player.attachto.md +56 -0
  14. package/docs/api/player.player.configure.md +58 -0
  15. package/docs/api/player.player.destroy.md +20 -0
  16. package/docs/api/player.player.getcurrenttime.md +22 -0
  17. package/docs/api/player.player.getduration.md +22 -0
  18. package/docs/api/player.player.md +304 -0
  19. package/docs/api/player.player.mute.md +20 -0
  20. package/docs/api/player.player.off.md +72 -0
  21. package/docs/api/player.player.on.md +72 -0
  22. package/docs/api/player.player.pause.md +20 -0
  23. package/docs/api/player.player.play.md +20 -0
  24. package/docs/api/player.player.registerplugin.md +56 -0
  25. package/docs/api/player.player.resize.md +59 -0
  26. package/docs/api/player.player.seek.md +56 -0
  27. package/docs/api/player.player.stop.md +20 -0
  28. package/docs/api/player.player.unmute.md +20 -0
  29. package/docs/api/player.player.unregisterplugin.md +56 -0
  30. package/docs/api/player.playerconfig.autoplay.md +16 -0
  31. package/docs/api/player.playerconfig.dash.md +16 -0
  32. package/docs/api/player.playerconfig.debug.md +16 -0
  33. package/docs/api/player.playerconfig.language.md +16 -0
  34. package/docs/api/player.playerconfig.loop.md +16 -0
  35. package/docs/api/player.playerconfig.md +266 -0
  36. package/docs/api/player.playerconfig.mute.md +16 -0
  37. package/docs/api/player.playerconfig.playbacktype.md +16 -0
  38. package/docs/api/player.playerconfig.prioritytransport.md +16 -0
  39. package/docs/api/player.playerconfig.sources.md +16 -0
  40. package/docs/api/player.playerconfig.strings.md +16 -0
  41. package/docs/api/player.playerdebugsettings.md +20 -0
  42. package/docs/api/player.playerdebugtag.md +15 -0
  43. package/docs/api/player.playerevent.md +116 -0
  44. package/docs/api/player.playereventhandler.md +17 -0
  45. package/docs/api/player.playermediasource.md +18 -0
  46. package/docs/api/player.playermediasourcedesc.md +83 -0
  47. package/docs/api/player.playermediasourcedesc.mimetype.md +16 -0
  48. package/docs/api/player.playermediasourcedesc.source.md +16 -0
  49. package/docs/api/player.playerplugin.md +17 -0
  50. package/docs/api/player.qualitylevel.md +20 -0
  51. package/docs/api/player.translationkey.md +15 -0
  52. package/docs/api/player.translationsettings.md +35 -0
  53. package/docs/api/player.transportpreference.md +17 -0
  54. package/docs/api/player.version.md +27 -0
  55. package/lib/Player.d.ts +83 -5
  56. package/lib/Player.d.ts.map +1 -1
  57. package/lib/Player.js +99 -25
  58. package/lib/constants.d.ts +0 -18
  59. package/lib/constants.d.ts.map +1 -1
  60. package/lib/constants.js +1 -18
  61. package/lib/gcore.types.d.ts +84 -0
  62. package/lib/gcore.types.d.ts.map +1 -0
  63. package/lib/gcore.types.js +9 -0
  64. package/lib/index.d.ts +10 -5
  65. package/lib/index.d.ts.map +1 -1
  66. package/lib/index.js +10 -5
  67. package/lib/internal.types.d.ts +28 -11
  68. package/lib/internal.types.d.ts.map +1 -1
  69. package/lib/playback.types.d.ts +19 -5
  70. package/lib/playback.types.d.ts.map +1 -1
  71. package/lib/plugins/dash-playback/DashPlayback.js +1 -1
  72. package/lib/plugins/hls-playback/HlsPlayback.js +1 -1
  73. package/lib/tsdoc-metadata.json +11 -0
  74. package/lib/types.d.ts +179 -62
  75. package/lib/types.d.ts.map +1 -1
  76. package/lib/types.js +19 -0
  77. package/lib/utils/mediaSources.d.ts +1 -3
  78. package/lib/utils/mediaSources.d.ts.map +1 -1
  79. package/lib/utils/mediaSources.js +0 -9
  80. package/lib/version.d.ts +5 -0
  81. package/lib/version.d.ts.map +1 -1
  82. package/lib/version.js +5 -0
  83. package/package.json +6 -1
  84. package/src/Player.ts +113 -32
  85. package/src/index.ts +11 -5
  86. package/src/internal.types.ts +28 -15
  87. package/src/playback.types.ts +20 -6
  88. package/src/plugins/dash-playback/DashPlayback.ts +1 -1
  89. package/src/plugins/hls-playback/HlsPlayback.ts +1 -1
  90. package/src/types.ts +196 -74
  91. package/src/utils/mediaSources.ts +1 -15
  92. package/src/version.ts +5 -0
  93. package/temp/player.api.json +1950 -0
  94. package/tsconfig.tsbuildinfo +1 -1
  95. package/src/constants.ts +0 -17
  96. package/src/plugins/dash-playback/_DashPlayback.js +0 -688
  97. package/src/trace/LogTracer.ts +0 -23
  98. package/src/trace/SentryTracer.ts +0 -21
  99. package/src/trace/Tracer.ts +0 -27
  100. package/src/trace/index.ts +0 -32
  101. package/src/trace/types.ts +0 -7
  102. package/src/typings/@clappr/plugins.d.ts +0 -23
  103. package/src/utils/Logger.ts +0 -107
@@ -0,0 +1,304 @@
1
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
+
3
+ [Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [Player](./player.player.md)
4
+
5
+ ## Player class
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
+ The main component to use in the application code.
11
+
12
+ **Signature:**
13
+
14
+ ```typescript
15
+ export declare class Player
16
+ ```
17
+
18
+ ## Remarks
19
+
20
+ The Player object provides very basic API to control playback. To build a sophisticated UI, use the plugins framework to tap into the Clappr core. [https://github.com/clappr/clappr/wiki/Architecture](https://github.com/clappr/clappr/wiki/Architecture)
21
+
22
+ ## Constructors
23
+
24
+ <table><thead><tr><th>
25
+
26
+ Constructor
27
+
28
+
29
+ </th><th>
30
+
31
+ Modifiers
32
+
33
+
34
+ </th><th>
35
+
36
+ Description
37
+
38
+
39
+ </th></tr></thead>
40
+ <tbody><tr><td>
41
+
42
+ [(constructor)(config)](./player.player._constructor_.md)
43
+
44
+
45
+ </td><td>
46
+
47
+
48
+ </td><td>
49
+
50
+ **_(BETA)_** Constructs a new instance of the `Player` class
51
+
52
+
53
+ </td></tr>
54
+ </tbody></table>
55
+
56
+ ## Methods
57
+
58
+ <table><thead><tr><th>
59
+
60
+ Method
61
+
62
+
63
+ </th><th>
64
+
65
+ Modifiers
66
+
67
+
68
+ </th><th>
69
+
70
+ Description
71
+
72
+
73
+ </th></tr></thead>
74
+ <tbody><tr><td>
75
+
76
+ [attachTo(playerElement)](./player.player.attachto.md)
77
+
78
+
79
+ </td><td>
80
+
81
+
82
+ </td><td>
83
+
84
+ **_(BETA)_** Initializes the player at the given container element.
85
+
86
+
87
+ </td></tr>
88
+ <tr><td>
89
+
90
+ [configure(config)](./player.player.configure.md)
91
+
92
+
93
+ </td><td>
94
+
95
+
96
+ </td><td>
97
+
98
+ **_(BETA)_** Configures the player.
99
+
100
+ Can be called multiple times. Each consequent call extends the previous configuration. After a reconfiguration, if something significant has changed, the must be reinitialized (i.e, a `.destroy()` followed by an `.init()` call).
101
+
102
+
103
+ </td></tr>
104
+ <tr><td>
105
+
106
+ [destroy()](./player.player.destroy.md)
107
+
108
+
109
+ </td><td>
110
+
111
+
112
+ </td><td>
113
+
114
+ **_(BETA)_** Destroys the player, releasing all resources and removing any DOM elements added.
115
+
116
+
117
+ </td></tr>
118
+ <tr><td>
119
+
120
+ [getCurrentTime()](./player.player.getcurrenttime.md)
121
+
122
+
123
+ </td><td>
124
+
125
+
126
+ </td><td>
127
+
128
+ **_(BETA)_** Current playback time in seconds, if appropriate.
129
+
130
+
131
+ </td></tr>
132
+ <tr><td>
133
+
134
+ [getDuration()](./player.player.getduration.md)
135
+
136
+
137
+ </td><td>
138
+
139
+
140
+ </td><td>
141
+
142
+ **_(BETA)_** Duration of the current media in seconds, if appropriate.
143
+
144
+
145
+ </td></tr>
146
+ <tr><td>
147
+
148
+ [mute()](./player.player.mute.md)
149
+
150
+
151
+ </td><td>
152
+
153
+
154
+ </td><td>
155
+
156
+ **_(BETA)_** Mutes the player.
157
+
158
+
159
+ </td></tr>
160
+ <tr><td>
161
+
162
+ [off(event, handler)](./player.player.off.md)
163
+
164
+
165
+ </td><td>
166
+
167
+
168
+ </td><td>
169
+
170
+ **_(BETA)_** Removes a listener from a player event
171
+
172
+
173
+ </td></tr>
174
+ <tr><td>
175
+
176
+ [on(event, handler)](./player.player.on.md)
177
+
178
+
179
+ </td><td>
180
+
181
+
182
+ </td><td>
183
+
184
+ **_(BETA)_** Adds a listener to a player event
185
+
186
+
187
+ </td></tr>
188
+ <tr><td>
189
+
190
+ [pause()](./player.player.pause.md)
191
+
192
+
193
+ </td><td>
194
+
195
+
196
+ </td><td>
197
+
198
+ **_(BETA)_** Pauses playback.
199
+
200
+
201
+ </td></tr>
202
+ <tr><td>
203
+
204
+ [play()](./player.player.play.md)
205
+
206
+
207
+ </td><td>
208
+
209
+
210
+ </td><td>
211
+
212
+ **_(BETA)_** Starts playback.
213
+
214
+
215
+ </td></tr>
216
+ <tr><td>
217
+
218
+ [registerPlugin(plugin)](./player.player.registerplugin.md)
219
+
220
+
221
+ </td><td>
222
+
223
+ `static`
224
+
225
+
226
+ </td><td>
227
+
228
+ **_(BETA)_** Registers a plugin.
229
+
230
+
231
+ </td></tr>
232
+ <tr><td>
233
+
234
+ [resize(newSize)](./player.player.resize.md)
235
+
236
+
237
+ </td><td>
238
+
239
+
240
+ </td><td>
241
+
242
+ **_(BETA)_** Resizes the player container element and everything within it.
243
+
244
+
245
+ </td></tr>
246
+ <tr><td>
247
+
248
+ [seek(time)](./player.player.seek.md)
249
+
250
+
251
+ </td><td>
252
+
253
+
254
+ </td><td>
255
+
256
+ **_(BETA)_** Seeks to the given time.
257
+
258
+
259
+ </td></tr>
260
+ <tr><td>
261
+
262
+ [stop()](./player.player.stop.md)
263
+
264
+
265
+ </td><td>
266
+
267
+
268
+ </td><td>
269
+
270
+ **_(BETA)_** Stops playback.
271
+
272
+
273
+ </td></tr>
274
+ <tr><td>
275
+
276
+ [unmute()](./player.player.unmute.md)
277
+
278
+
279
+ </td><td>
280
+
281
+
282
+ </td><td>
283
+
284
+ **_(BETA)_** Unmutes the player.
285
+
286
+
287
+ </td></tr>
288
+ <tr><td>
289
+
290
+ [unregisterPlugin(plugin)](./player.player.unregisterplugin.md)
291
+
292
+
293
+ </td><td>
294
+
295
+ `static`
296
+
297
+
298
+ </td><td>
299
+
300
+ **_(BETA)_** Unregisters a plugin.
301
+
302
+
303
+ </td></tr>
304
+ </tbody></table>
@@ -0,0 +1,20 @@
1
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
+
3
+ [Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [Player](./player.player.md) &gt; [mute](./player.player.mute.md)
4
+
5
+ ## Player.mute() 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
+ Mutes the player.
11
+
12
+ **Signature:**
13
+
14
+ ```typescript
15
+ mute(): void;
16
+ ```
17
+ **Returns:**
18
+
19
+ void
20
+
@@ -0,0 +1,72 @@
1
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
+
3
+ [Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [Player](./player.player.md) &gt; [off](./player.player.off.md)
4
+
5
+ ## Player.off() 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
+ Removes a listener from a player event
11
+
12
+ **Signature:**
13
+
14
+ ```typescript
15
+ off<T extends PlayerEvent>(event: T, handler: PlayerEventHandler<T>): 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
+ event
39
+
40
+
41
+ </td><td>
42
+
43
+ T
44
+
45
+
46
+ </td><td>
47
+
48
+ See [PlayerEvent](./player.playerevent.md)
49
+
50
+
51
+ </td></tr>
52
+ <tr><td>
53
+
54
+ handler
55
+
56
+
57
+ </td><td>
58
+
59
+ [PlayerEventHandler](./player.playereventhandler.md)<!-- -->&lt;T&gt;
60
+
61
+
62
+ </td><td>
63
+
64
+ See [PlayerEventHandler](./player.playereventhandler.md)
65
+
66
+
67
+ </td></tr>
68
+ </tbody></table>
69
+ **Returns:**
70
+
71
+ void
72
+
@@ -0,0 +1,72 @@
1
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
+
3
+ [Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [Player](./player.player.md) &gt; [on](./player.player.on.md)
4
+
5
+ ## Player.on() 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
+ Adds a listener to a player event
11
+
12
+ **Signature:**
13
+
14
+ ```typescript
15
+ on<T extends PlayerEvent>(event: T, handler: PlayerEventHandler<T>): 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
+ event
39
+
40
+
41
+ </td><td>
42
+
43
+ T
44
+
45
+
46
+ </td><td>
47
+
48
+ See [PlayerEvent](./player.playerevent.md)
49
+
50
+
51
+ </td></tr>
52
+ <tr><td>
53
+
54
+ handler
55
+
56
+
57
+ </td><td>
58
+
59
+ [PlayerEventHandler](./player.playereventhandler.md)<!-- -->&lt;T&gt;
60
+
61
+
62
+ </td><td>
63
+
64
+ See [PlayerEventHandler](./player.playereventhandler.md)
65
+
66
+
67
+ </td></tr>
68
+ </tbody></table>
69
+ **Returns:**
70
+
71
+ void
72
+
@@ -0,0 +1,20 @@
1
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
+
3
+ [Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [Player](./player.player.md) &gt; [pause](./player.player.pause.md)
4
+
5
+ ## Player.pause() 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
+ Pauses playback.
11
+
12
+ **Signature:**
13
+
14
+ ```typescript
15
+ pause(): void;
16
+ ```
17
+ **Returns:**
18
+
19
+ void
20
+
@@ -0,0 +1,20 @@
1
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
+
3
+ [Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [Player](./player.player.md) &gt; [play](./player.player.play.md)
4
+
5
+ ## Player.play() 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
+ Starts playback.
11
+
12
+ **Signature:**
13
+
14
+ ```typescript
15
+ play(): void;
16
+ ```
17
+ **Returns:**
18
+
19
+ void
20
+
@@ -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; [Player](./player.player.md) &gt; [registerPlugin](./player.player.registerplugin.md)
4
+
5
+ ## Player.registerPlugin() 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
+ Registers a plugin.
11
+
12
+ **Signature:**
13
+
14
+ ```typescript
15
+ static registerPlugin(plugin: PlayerPlugin): 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
+ plugin
39
+
40
+
41
+ </td><td>
42
+
43
+ [PlayerPlugin](./player.playerplugin.md)
44
+
45
+
46
+ </td><td>
47
+
48
+ plugin to register
49
+
50
+
51
+ </td></tr>
52
+ </tbody></table>
53
+ **Returns:**
54
+
55
+ void
56
+
@@ -0,0 +1,59 @@
1
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
+
3
+ [Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [Player](./player.player.md) &gt; [resize](./player.player.resize.md)
4
+
5
+ ## Player.resize() 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
+ Resizes the player container element and everything within it.
11
+
12
+ **Signature:**
13
+
14
+ ```typescript
15
+ resize(newSize: {
16
+ width: number;
17
+ height: number;
18
+ }): void;
19
+ ```
20
+
21
+ ## Parameters
22
+
23
+ <table><thead><tr><th>
24
+
25
+ Parameter
26
+
27
+
28
+ </th><th>
29
+
30
+ Type
31
+
32
+
33
+ </th><th>
34
+
35
+ Description
36
+
37
+
38
+ </th></tr></thead>
39
+ <tbody><tr><td>
40
+
41
+ newSize
42
+
43
+
44
+ </td><td>
45
+
46
+ { width: number; height: number; }
47
+
48
+
49
+ </td><td>
50
+
51
+ new size of the player
52
+
53
+
54
+ </td></tr>
55
+ </tbody></table>
56
+ **Returns:**
57
+
58
+ void
59
+
@@ -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; [Player](./player.player.md) &gt; [seek](./player.player.seek.md)
4
+
5
+ ## Player.seek() 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
+ Seeks to the given time.
11
+
12
+ **Signature:**
13
+
14
+ ```typescript
15
+ seek(time: number): 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
+ time
39
+
40
+
41
+ </td><td>
42
+
43
+ number
44
+
45
+
46
+ </td><td>
47
+
48
+ time to seek to in seconds
49
+
50
+
51
+ </td></tr>
52
+ </tbody></table>
53
+ **Returns:**
54
+
55
+ void
56
+
@@ -0,0 +1,20 @@
1
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
+
3
+ [Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [Player](./player.player.md) &gt; [stop](./player.player.stop.md)
4
+
5
+ ## Player.stop() 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
+ Stops playback.
11
+
12
+ **Signature:**
13
+
14
+ ```typescript
15
+ stop(): void;
16
+ ```
17
+ **Returns:**
18
+
19
+ void
20
+