@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,295 @@
1
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
+
3
+ [Home](./index.md) &gt; [@gcorevideo/player](./player.md)
4
+
5
+ ## player package
6
+
7
+ Video player for the GCore streaming platform
8
+
9
+ ## Remarks
10
+
11
+ This package provides a video player for the GCore streaming platform. It is built on top of the Clappr library and provides a framework for building custom integrations.
12
+
13
+ ## Classes
14
+
15
+ <table><thead><tr><th>
16
+
17
+ Class
18
+
19
+
20
+ </th><th>
21
+
22
+ Description
23
+
24
+
25
+ </th></tr></thead>
26
+ <tbody><tr><td>
27
+
28
+ [Player](./player.player.md)
29
+
30
+
31
+ </td><td>
32
+
33
+ **_(BETA)_** The main component to use in the application code.
34
+
35
+
36
+ </td></tr>
37
+ </tbody></table>
38
+
39
+ ## Enumerations
40
+
41
+ <table><thead><tr><th>
42
+
43
+ Enumeration
44
+
45
+
46
+ </th><th>
47
+
48
+ Description
49
+
50
+
51
+ </th></tr></thead>
52
+ <tbody><tr><td>
53
+
54
+ [PlayerEvent](./player.playerevent.md)
55
+
56
+
57
+ </td><td>
58
+
59
+ **_(BETA)_** A top-level event on the player object
60
+
61
+
62
+ </td></tr>
63
+ </tbody></table>
64
+
65
+ ## Functions
66
+
67
+ <table><thead><tr><th>
68
+
69
+ Function
70
+
71
+
72
+ </th><th>
73
+
74
+ Description
75
+
76
+
77
+ </th></tr></thead>
78
+ <tbody><tr><td>
79
+
80
+ [version()](./player.version.md)
81
+
82
+
83
+ </td><td>
84
+
85
+ **_(BETA)_** Version information about the gplayer and its main dependencies
86
+
87
+
88
+ </td></tr>
89
+ </tbody></table>
90
+
91
+ ## Interfaces
92
+
93
+ <table><thead><tr><th>
94
+
95
+ Interface
96
+
97
+
98
+ </th><th>
99
+
100
+ Description
101
+
102
+
103
+ </th></tr></thead>
104
+ <tbody><tr><td>
105
+
106
+ [PlayerConfig](./player.playerconfig.md)
107
+
108
+
109
+ </td><td>
110
+
111
+ **_(BETA)_** Configuration options for the player
112
+
113
+
114
+ </td></tr>
115
+ <tr><td>
116
+
117
+ [PlayerMediaSourceDesc](./player.playermediasourcedesc.md)
118
+
119
+
120
+ </td><td>
121
+
122
+ **_(BETA)_** Describes a media source with its MIME type and URL.
123
+
124
+
125
+ </td></tr>
126
+ </tbody></table>
127
+
128
+ ## Type Aliases
129
+
130
+ <table><thead><tr><th>
131
+
132
+ Type Alias
133
+
134
+
135
+ </th><th>
136
+
137
+ Description
138
+
139
+
140
+ </th></tr></thead>
141
+ <tbody><tr><td>
142
+
143
+ [DashSettings](./player.dashsettings.md)
144
+
145
+
146
+ </td><td>
147
+
148
+ **_(BETA)_** [DASH.js settings](https://cdn.dashjs.org/latest/jsdoc/module-Settings.html)
149
+
150
+
151
+ </td></tr>
152
+ <tr><td>
153
+
154
+ [LangTag](./player.langtag.md)
155
+
156
+
157
+ </td><td>
158
+
159
+ **_(BETA)_**
160
+
161
+
162
+ </td></tr>
163
+ <tr><td>
164
+
165
+ [MediaTransport](./player.mediatransport.md)
166
+
167
+
168
+ </td><td>
169
+
170
+ **_(BETA)_**
171
+
172
+
173
+ </td></tr>
174
+ <tr><td>
175
+
176
+ [PlaybackModule](./player.playbackmodule.md)
177
+
178
+
179
+ </td><td>
180
+
181
+ **_(BETA)_**
182
+
183
+
184
+ </td></tr>
185
+ <tr><td>
186
+
187
+ [PlaybackType](./player.playbacktype.md)
188
+
189
+
190
+ </td><td>
191
+
192
+ **_(BETA)_** Type of a stream playback
193
+
194
+
195
+ </td></tr>
196
+ <tr><td>
197
+
198
+ [PlayerDebugSettings](./player.playerdebugsettings.md)
199
+
200
+
201
+ </td><td>
202
+
203
+ **_(BETA)_**
204
+
205
+
206
+ </td></tr>
207
+ <tr><td>
208
+
209
+ [PlayerDebugTag](./player.playerdebugtag.md)
210
+
211
+
212
+ </td><td>
213
+
214
+ **_(BETA)_**
215
+
216
+
217
+ </td></tr>
218
+ <tr><td>
219
+
220
+ [PlayerEventHandler](./player.playereventhandler.md)
221
+
222
+
223
+ </td><td>
224
+
225
+ **_(BETA)_**
226
+
227
+
228
+ </td></tr>
229
+ <tr><td>
230
+
231
+ [PlayerMediaSource](./player.playermediasource.md)
232
+
233
+
234
+ </td><td>
235
+
236
+ **_(BETA)_** A media source to fetch the media data from
237
+
238
+
239
+ </td></tr>
240
+ <tr><td>
241
+
242
+ [PlayerPlugin](./player.playerplugin.md)
243
+
244
+
245
+ </td><td>
246
+
247
+ **_(BETA)_**
248
+
249
+
250
+ </td></tr>
251
+ <tr><td>
252
+
253
+ [QualityLevel](./player.qualitylevel.md)
254
+
255
+
256
+ </td><td>
257
+
258
+ **_(BETA)_**
259
+
260
+
261
+ </td></tr>
262
+ <tr><td>
263
+
264
+ [TranslationKey](./player.translationkey.md)
265
+
266
+
267
+ </td><td>
268
+
269
+ **_(BETA)_**
270
+
271
+
272
+ </td></tr>
273
+ <tr><td>
274
+
275
+ [TranslationSettings](./player.translationsettings.md)
276
+
277
+
278
+ </td><td>
279
+
280
+ **_(BETA)_** \[language\]\[key\] =<!-- -->&gt; string
281
+
282
+
283
+ </td></tr>
284
+ <tr><td>
285
+
286
+ [TransportPreference](./player.transportpreference.md)
287
+
288
+
289
+ </td><td>
290
+
291
+ **_(BETA)_**
292
+
293
+
294
+ </td></tr>
295
+ </tbody></table>
@@ -0,0 +1,15 @@
1
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
+
3
+ [Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [MediaTransport](./player.mediatransport.md)
4
+
5
+ ## MediaTransport type
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
+
11
+ **Signature:**
12
+
13
+ ```typescript
14
+ export type MediaTransport = 'dash' | 'hls' | 'mpegts';
15
+ ```
@@ -0,0 +1,15 @@
1
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
+
3
+ [Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [PlaybackModule](./player.playbackmodule.md)
4
+
5
+ ## PlaybackModule type
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
+
11
+ **Signature:**
12
+
13
+ ```typescript
14
+ export type PlaybackModule = 'dash' | 'hls' | 'native';
15
+ ```
@@ -0,0 +1,16 @@
1
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
+
3
+ [Home](./index.md) &gt; [@gcorevideo/player](./player.md) &gt; [PlaybackType](./player.playbacktype.md)
4
+
5
+ ## PlaybackType type
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
+ Type of a stream playback
11
+
12
+ **Signature:**
13
+
14
+ ```typescript
15
+ export type PlaybackType = 'live' | 'vod';
16
+ ```
@@ -0,0 +1,50 @@
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; [(constructor)](./player.player._constructor_.md)
4
+
5
+ ## Player.(constructor)
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
+ Constructs a new instance of the `Player` class
11
+
12
+ **Signature:**
13
+
14
+ ```typescript
15
+ constructor(config: PlayerConfig);
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
+ config
39
+
40
+
41
+ </td><td>
42
+
43
+ [PlayerConfig](./player.playerconfig.md)
44
+
45
+
46
+ </td><td>
47
+
48
+
49
+ </td></tr>
50
+ </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; [Player](./player.player.md) &gt; [attachTo](./player.player.attachto.md)
4
+
5
+ ## Player.attachTo() 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
+ Initializes the player at the given container element.
11
+
12
+ **Signature:**
13
+
14
+ ```typescript
15
+ attachTo(playerElement: HTMLElement): 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
+ playerElement
39
+
40
+
41
+ </td><td>
42
+
43
+ HTMLElement
44
+
45
+
46
+ </td><td>
47
+
48
+ DOM element to host the player
49
+
50
+
51
+ </td></tr>
52
+ </tbody></table>
53
+ **Returns:**
54
+
55
+ void
56
+
@@ -0,0 +1,58 @@
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; [configure](./player.player.configure.md)
4
+
5
+ ## Player.configure() 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
+ Configures the player.
11
+
12
+ 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).
13
+
14
+ **Signature:**
15
+
16
+ ```typescript
17
+ configure(config: Partial<PlayerConfig>): void;
18
+ ```
19
+
20
+ ## Parameters
21
+
22
+ <table><thead><tr><th>
23
+
24
+ Parameter
25
+
26
+
27
+ </th><th>
28
+
29
+ Type
30
+
31
+
32
+ </th><th>
33
+
34
+ Description
35
+
36
+
37
+ </th></tr></thead>
38
+ <tbody><tr><td>
39
+
40
+ config
41
+
42
+
43
+ </td><td>
44
+
45
+ Partial&lt;[PlayerConfig](./player.playerconfig.md)<!-- -->&gt;
46
+
47
+
48
+ </td><td>
49
+
50
+ complete or partial configuration
51
+
52
+
53
+ </td></tr>
54
+ </tbody></table>
55
+ **Returns:**
56
+
57
+ void
58
+
@@ -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; [destroy](./player.player.destroy.md)
4
+
5
+ ## Player.destroy() 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
+ Destroys the player, releasing all resources and removing any DOM elements added.
11
+
12
+ **Signature:**
13
+
14
+ ```typescript
15
+ destroy(): void;
16
+ ```
17
+ **Returns:**
18
+
19
+ void
20
+
@@ -0,0 +1,22 @@
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; [getCurrentTime](./player.player.getcurrenttime.md)
4
+
5
+ ## Player.getCurrentTime() 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
+ Current playback time in seconds, if appropriate.
11
+
12
+ **Signature:**
13
+
14
+ ```typescript
15
+ getCurrentTime(): number;
16
+ ```
17
+ **Returns:**
18
+
19
+ number
20
+
21
+ For live streams, it returns the current time of the current segment.
22
+
@@ -0,0 +1,22 @@
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; [getDuration](./player.player.getduration.md)
4
+
5
+ ## Player.getDuration() 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
+ Duration of the current media in seconds, if appropriate.
11
+
12
+ **Signature:**
13
+
14
+ ```typescript
15
+ getDuration(): number;
16
+ ```
17
+ **Returns:**
18
+
19
+ number
20
+
21
+ For live streams, it returns the duration of the current segment.
22
+