@byteplus/veplayer 1.8.0 → 2.3.0-rc.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 (53) hide show
  1. package/LICENSE +18 -0
  2. package/README.md +6 -39
  3. package/esm/index.d.ts +3167 -0
  4. package/esm/veplayer.biz.live.development.css +41 -0
  5. package/esm/veplayer.biz.live.development.js +3400 -0
  6. package/esm/veplayer.biz.live.production.css +1 -0
  7. package/esm/veplayer.biz.live.production.js +2 -0
  8. package/esm/veplayer.biz.vod.development.js +13 -0
  9. package/esm/veplayer.biz.vod.production.js +2 -0
  10. package/esm/veplayer.d.ts +6921 -0
  11. package/esm/veplayer.development.css +743 -0
  12. package/esm/veplayer.development.js +22032 -0
  13. package/esm/veplayer.live.d.ts +6923 -0
  14. package/esm/veplayer.live.development.css +743 -0
  15. package/esm/veplayer.live.development.js +22031 -0
  16. package/esm/veplayer.live.production.css +1 -0
  17. package/esm/veplayer.live.production.js +11 -0
  18. package/esm/veplayer.production.css +1 -0
  19. package/esm/veplayer.production.js +11 -0
  20. package/esm/veplayer.vod.d.ts +3167 -0
  21. package/esm/veplayer.vod.development.css +702 -0
  22. package/esm/veplayer.vod.development.js +13861 -0
  23. package/esm/veplayer.vod.production.css +1 -0
  24. package/esm/veplayer.vod.production.js +11 -0
  25. package/package.json +78 -8
  26. package/umd/index.d.ts +3167 -0
  27. package/umd/veplayer.biz.live.development.css +41 -0
  28. package/umd/veplayer.biz.live.development.js +3412 -0
  29. package/umd/veplayer.biz.live.production.css +1 -0
  30. package/umd/veplayer.biz.live.production.js +1 -0
  31. package/umd/veplayer.biz.vod.development.js +30 -0
  32. package/umd/veplayer.biz.vod.production.js +1 -0
  33. package/umd/veplayer.d.ts +6921 -0
  34. package/umd/veplayer.development.css +743 -0
  35. package/umd/veplayer.development.js +22035 -0
  36. package/umd/veplayer.live.d.ts +6923 -0
  37. package/umd/veplayer.live.development.css +743 -0
  38. package/umd/veplayer.live.development.js +22043 -0
  39. package/umd/veplayer.live.production.css +1 -0
  40. package/umd/veplayer.live.production.js +1 -0
  41. package/umd/veplayer.production.css +1 -0
  42. package/umd/veplayer.production.js +1 -0
  43. package/umd/veplayer.vod.d.ts +3167 -0
  44. package/umd/veplayer.vod.development.css +702 -0
  45. package/umd/veplayer.vod.development.js +13876 -0
  46. package/umd/veplayer.vod.production.css +1 -0
  47. package/umd/veplayer.vod.production.js +1 -0
  48. package/veplayer.d.ts +6921 -0
  49. package/veplayer.live.d.ts +6923 -0
  50. package/veplayer.vod.d.ts +3167 -0
  51. package/index.d.ts +0 -3974
  52. package/index.min.css +0 -1
  53. package/index.min.js +0 -2
package/esm/index.d.ts ADDED
@@ -0,0 +1,3167 @@
1
+ import Player from "xgplayer";
2
+ import { IXGI18nText, Plugin, IPluginOptions } from "xgplayer";
3
+ import { IPlayerOptions as PlayerOptions } from "xgplayer";
4
+ import { IDefinition as XGDefinition } from "xgplayer";
5
+ import { default as Player$0 } from "xgplayer";
6
+ import { IError as XGError } from "xgplayer";
7
+ import { IBasePluginOptions as XGPluginOptions } from "xgplayer";
8
+ import { IXGI18n } from "xgplayer/es/lang/i18n";
9
+ import XG_EN from "xgplayer/es/lang/en";
10
+ import XG_ZH_CN from "xgplayer/es/lang/zh-cn";
11
+ import OptionList from "xgplayer/es/plugins/common/optionList";
12
+ import { default as XGPlayer } from "xgplayer/es/player";
13
+ declare const EN: {
14
+ DEFINITION_FALLBACK_TOAST: string;
15
+ DEFINITION_SWITCHING: string;
16
+ ERROR_REFRESH: string;
17
+ UNMUTE: string;
18
+ MANIFEST: string;
19
+ NETWORK: string;
20
+ NETWORK_TIMEOUT: string;
21
+ NETWORK_FORBIDDEN: string;
22
+ NETWORK_NOTFOUND: string;
23
+ DEMUX: string;
24
+ REMUX: string;
25
+ MEDIA: string;
26
+ MEDIA_ERR_CODEC_NOT_SUPPORTED: string;
27
+ MEDIA_ERR_URL_EMPTY: string;
28
+ DRM: string;
29
+ DRM_LICENSE: string;
30
+ OTHER: string;
31
+ RUNTIME: string;
32
+ MODULE_LOAD_ERROR: string;
33
+ UNKNOWN: string;
34
+ ERROR_TYPES: typeof XG_EN.TEXT.ERROR_TYPES;
35
+ HAVE_NOTHING: string;
36
+ HAVE_METADATA: string;
37
+ HAVE_CURRENT_DATA: string;
38
+ HAVE_FUTURE_DATA: string;
39
+ HAVE_ENOUGH_DATA: string;
40
+ NETWORK_EMPTY: string;
41
+ NETWORK_IDLE: string;
42
+ NETWORK_LOADING: string;
43
+ NETWORK_NO_SOURCE: string;
44
+ MEDIA_ERR_ABORTED: string;
45
+ MEDIA_ERR_NETWORK: string;
46
+ MEDIA_ERR_DECODE: string;
47
+ MEDIA_ERR_SRC_NOT_SUPPORTED: string;
48
+ REPLAY: string;
49
+ ERROR: string;
50
+ PLAY_TIPS: string;
51
+ PAUSE_TIPS: string;
52
+ PLAYNEXT_TIPS: string;
53
+ DOWNLOAD_TIPS: string;
54
+ ROTATE_TIPS: string;
55
+ RELOAD_TIPS: string;
56
+ FULLSCREEN_TIPS: string;
57
+ EXITFULLSCREEN_TIPS: string;
58
+ CSSFULLSCREEN_TIPS: string;
59
+ EXITCSSFULLSCREEN_TIPS: string;
60
+ TEXTTRACK: string;
61
+ PIP: string;
62
+ SCREENSHOT: string;
63
+ LIVE: string;
64
+ OFF: string;
65
+ OPEN: string;
66
+ MINI_DRAG: string;
67
+ MINISCREEN: string;
68
+ REFRESH_TIPS: string;
69
+ REFRESH: string;
70
+ FORWARD: string;
71
+ LIVE_TIP: string;
72
+ };
73
+ type TextKey = keyof typeof EN;
74
+ type Lang = "zh-cn" | "zh-hk" | "en" | "jp" | string;
75
+ declare class VeI18n<T extends string = TextKey> {
76
+ private _lang;
77
+ constructor(config?: {
78
+ lang?: Lang;
79
+ i18n?: {
80
+ texts?: Record<Lang, Record<string, string>>;
81
+ };
82
+ });
83
+ static get langKeys(): string[];
84
+ static isLangValid(lang: Lang): boolean;
85
+ static extend(i18nTextList: Array<IXGI18nText>, i18nLangs?: IXGI18n): void;
86
+ setLang(lang: string): void;
87
+ getLang(): string;
88
+ normalize(text?: string | Record<Lang, string>): string;
89
+ getText(textKey?: T | string): Record<string | T, string>[string | T] | undefined;
90
+ }
91
+ interface DefinitionUrl {
92
+ url: string;
93
+ next: DefinitionUrl | null;
94
+ }
95
+ declare class Definition implements XGDefinition {
96
+ readonly definition: string;
97
+ readonly source: Source;
98
+ readonly text?: Record<Lang, string> | string;
99
+ readonly fallbackUrl: DefinitionUrl;
100
+ readonly urls: string[];
101
+ private _currentUrlRef;
102
+ constructor(definitionSetting: {
103
+ url: string;
104
+ definition: string;
105
+ source: Source;
106
+ text?: Record<Lang, string> | string;
107
+ fallbackUrls?: string[];
108
+ });
109
+ get url(): string;
110
+ set url(url: string);
111
+ next(): DefinitionUrl;
112
+ }
113
+ /**
114
+ * @list option
115
+ * @kind property
116
+ * @id Definition
117
+ * @alias Definition
118
+ *
119
+ */
120
+ interface ExposedDefinition {
121
+ /** {zh}
122
+ * @brief 播放地址。
123
+ * @default 无
124
+ */
125
+ url: string;
126
+ /** {zh}
127
+ * @brief 清晰度标识(唯一值)。
128
+ * @default 无
129
+ *
130
+ */
131
+ definition: string;
132
+ /** {zh}
133
+ * @brief 清晰度展示名称。可设置多语言 `{text: {'zh-cn': '高清', 'en': 'HD'}}`。
134
+ * @default 无
135
+ */
136
+ text?: Record<Lang, string> | string;
137
+ /** {zh}
138
+ * @brief 为当前清晰度地址设置备路拉流地址,支持设置多个备路拉流地址。当前清晰度地址拉流失败时,会在当前清晰度地址和备路直播地址之间循环拉流,直到拉流成功。
139
+ * @default 无
140
+ *
141
+ */
142
+ fallbackUrls?: string[];
143
+ }
144
+ /**
145
+ * @list option
146
+ * @kind property
147
+ * @id Source
148
+ * @alias Source
149
+ */
150
+ interface ExposedSource {
151
+ /** {zh}
152
+ * @brief 线路标识(唯一值)。
153
+ * @default 无
154
+ */
155
+ name?: string;
156
+ /** {zh}
157
+ * @brief 线路展示名称。可设置多语言 `{text: {'zh-cn': '线路一', 'en': 'LineOne'}}`。
158
+ * @default 无
159
+ *
160
+ */
161
+ text?: Record<Lang, string> | string;
162
+ /** {zh}
163
+ * @brief 该线路下清晰度列表。
164
+ * @default 无
165
+ *
166
+ */
167
+ definitions: Array<ExposedDefinition | string>;
168
+ }
169
+ interface CompoundSources {
170
+ sources?: ExposedSource[];
171
+ url?: string;
172
+ fallbackUrls?: string[];
173
+ }
174
+ declare class Source {
175
+ readonly name?: string;
176
+ readonly text?: Record<Lang, string> | string;
177
+ readonly definitions: Array<Definition & {
178
+ source: Source;
179
+ }>;
180
+ private constructor();
181
+ get defaultDefinition(): Definition & {
182
+ source: Source;
183
+ };
184
+ static normalize(input: CompoundSources | ExposedSource[] | string): Source[];
185
+ private static normalizeUrl;
186
+ add(definition: Definition): void;
187
+ }
188
+ interface Config {
189
+ listType: ListType;
190
+ isAutoChange?: boolean;
191
+ onItemClick?: (e: Event, data: CallbackData) => void;
192
+ onOptionClick?: (e: Event, data: CallbackData) => void;
193
+ hide?: () => void;
194
+ list?: ListItem[];
195
+ panel?: {
196
+ className?: string;
197
+ title?: string | Record<Lang, string>;
198
+ };
199
+ }
200
+ interface Options {
201
+ config: Config;
202
+ root: HTMLElement | null;
203
+ player: Player;
204
+ }
205
+ declare class MobilePlayerPanel {
206
+ private _root?;
207
+ private _config;
208
+ private _parent;
209
+ private _listDom?;
210
+ private _container?;
211
+ private _titleDom?;
212
+ private _player;
213
+ private _delegates?;
214
+ private _listType?;
215
+ constructor(args: Options);
216
+ changeMode(listType: ListType): void;
217
+ // 渲染选择列表
218
+ renderItemList(data?: ListItem[]): HTMLElement;
219
+ // 渲染panel的标题
220
+ renderTitle(): HTMLElement | undefined;
221
+ updatePanel(listType: ListType): void;
222
+ // 渲染panel
223
+ renderPanel(): void;
224
+ show(): void;
225
+ hide(): void;
226
+ destroy(): void;
227
+ private _bind;
228
+ private _unbind;
229
+ private _initEvents;
230
+ private _unbindEvents;
231
+ private _handleOrientationChange;
232
+ private _bindDomEvent;
233
+ private _unbindDomEvent;
234
+ private _stopPropagation;
235
+ private _onItemClick;
236
+ private _handleHide;
237
+ }
238
+ declare module MobilePlayerPanelWrapper {
239
+ export { MobilePlayerPanel };
240
+ }
241
+ import MobilePanel = MobilePlayerPanelWrapper.MobilePlayerPanel;
242
+ /**
243
+ * @detail option
244
+ * @brief **清晰度选择**或**线路选择**时的**选择面板样式**,仅在移动端有效。
245
+ */
246
+ declare enum ListType {
247
+ /** {zh}
248
+ * @brief 全屏布局
249
+ * @hidden
250
+ */
251
+ Middle = "middle",
252
+ /** {zh}
253
+ * @brief 底部抽屉
254
+ */
255
+ Bottom = "bottom",
256
+ /** {zh}
257
+ * @brief 右侧抽屉,常用于全屏时展示
258
+ */
259
+ Fullscreen = "fullscreen",
260
+ /** {zh}
261
+ * @brief 窗口蒙层展示
262
+ */
263
+ Inner = "inner"
264
+ }
265
+ interface ListItem {
266
+ [key: string]: any;
267
+ selected?: boolean;
268
+ className?: string;
269
+ showText?: string | HTMLElement;
270
+ text?: string | Record<Lang, string>;
271
+ iconText?: string | Record<Lang, string>;
272
+ }
273
+ type CallbackData = {
274
+ to?: ListItem;
275
+ from?: ListItem;
276
+ };
277
+ declare const enum RenderType {
278
+ Icon = "Icon",
279
+ Text = "Text"
280
+ }
281
+ type Config$0<T> = {
282
+ [key: string]: any;
283
+ // 【xg】顺序
284
+ index?: number;
285
+ // 【xg】展示的选择列表
286
+ list?: Array<T>;
287
+ // 【xg】竖屏
288
+ hidePortrait?: boolean;
289
+ // 【xg】列表点击之后是否隐藏列表
290
+ isItemClickHide?: boolean;
291
+ className?: string;
292
+ // 【xg】是否展示已选择的
293
+ isShowIcon?: boolean;
294
+ // 【xg 扩展】列表渲染样式类型
295
+ listType?: ListType;
296
+ // 已选择的展示类型(文案 or icon)
297
+ renderType?: RenderType;
298
+ // 列表数据只有一个是否展示
299
+ hideOnSingleOption?: boolean;
300
+ // 横屏的时候是否切换mode
301
+ isAutoChange?: boolean;
302
+ // 自定义组件 mobilePanel的配置
303
+ panel?: {
304
+ className?: string;
305
+ // panel 的标题
306
+ title?: string | Record<Lang, string>;
307
+ };
308
+ };
309
+ // 源自packages/xgplayer/src/plugins/common/optionsIcon.js
310
+ // 自定义了几种选择类型
311
+ declare class OptionsIcon extends Plugin {
312
+ icons: Record<string, any>;
313
+ config: Config$0<ListItem>;
314
+ optionsList?: MobilePanel | OptionList;
315
+ private _isIcon?;
316
+ private _isActive?;
317
+ private _curIndex;
318
+ private activeEvent?;
319
+ constructor(args: IPluginOptions);
320
+ static get pluginName(): string;
321
+ static get defaultConfig(): Config$0<ListItem>;
322
+ updateLang(): void;
323
+ afterCreate(): void;
324
+ initIcons(): void;
325
+ // eslint-disable-next-line @typescript-eslint/ban-ts-comment
326
+ // @ts-ignore
327
+ show(): void;
328
+ hide(): void;
329
+ onEnter: (e: Event) => void;
330
+ onLeave: (e: Event) => void;
331
+ // 状态切换
332
+ toggle(isActive: boolean): void;
333
+ // 列表选择回调
334
+ onItemClick(e: Event, data: CallbackData): void;
335
+ // 列表点击回调
336
+ onOptionClick(e: Event, _data: CallbackData): void;
337
+ // 已选择 option 的文案
338
+ changeCurrentText(): void;
339
+ renderItemList(itemList: ListItem[], curIndex?: number): void;
340
+ destroy(): void;
341
+ render(): string;
342
+ private _getListType;
343
+ }
344
+ /**
345
+ * @detail error
346
+ */
347
+ declare enum Level {
348
+ /**
349
+ * @brief 严重
350
+ *
351
+ */
352
+ Fatal = "Fatal",
353
+ /**
354
+ * @brief 报错
355
+ */
356
+ Error = "Error"
357
+ }
358
+ declare enum ErrorCode {
359
+ /**
360
+ * @brief 视频解析错误
361
+ * @solution 请联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
362
+ */
363
+ MANIFEST_HLS_ERROR = 1100,
364
+ /**
365
+ * @brief 视频解析错误
366
+ * @solution 请联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
367
+ */
368
+ MANIFEST_DASH_ERROR = 1200,
369
+ /**
370
+ * @brief 网络错误
371
+ * @solution 请检查当前网络环境或播放地址是否合法。
372
+ */
373
+ NETWORK = 2100,
374
+ /**
375
+ * @brief 网络请求超时
376
+ * @solution 请检查拉流地址是否合法。
377
+ */
378
+ NETWORK_TIMEOUT = 2101,
379
+ /**
380
+ * @brief 网络请求 403
381
+ * @solution 请检查拉流地址鉴权信息。
382
+ */
383
+ NETWORK_FORBIDDEN = 2103,
384
+ /**
385
+ * @brief 网络请求 404
386
+ * @solution 请检查拉流地址是否合法。
387
+ */
388
+ NETWORK_NOTFOUND = 2104,
389
+ /**
390
+ * @brief 网络请求 206
391
+ * @solution 请检查拉流地址是否合法。
392
+ */
393
+ NETWORK_RANGE_NOT_SATISFIABLE = 2116,
394
+ /**
395
+ * @brief 视频解析错误
396
+ * @solution 请检查拉流地址是否合法或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
397
+ */
398
+ DEMUX_FLV_ERROR = 3100,
399
+ /**
400
+ * @brief 视频解析错误
401
+ * @solution 请检查拉流地址是否合法或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
402
+ */
403
+ DEMUX_HLS_ERROR = 3200,
404
+ /**
405
+ * @brief 视频解析错误
406
+ * @solution 请检查拉流地址是否合法或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
407
+ *
408
+ */
409
+ DEMUX_MP4_ERROR = 3300,
410
+ /**
411
+ * @brief 视频解析错误
412
+ * @solution 请检查拉流地址是否合法或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
413
+ *
414
+ */
415
+ DEMUX_FMP4_ERROR = 3400,
416
+ /**
417
+ * @brief 视频解析错误
418
+ * @solution 请检查拉流地址是否合法或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
419
+ *
420
+ */
421
+ DEMUX_SIDX_ERROR = 3410,
422
+ /**
423
+ * @brief 视频解析错误
424
+ * @solution 请检查拉流地址是否合法或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
425
+ *
426
+ */
427
+ REMUX_FMP4_ERROR = 4100,
428
+ /**
429
+ * @brief 视频解析错误
430
+ * @solution 请检查拉流地址是否合法或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
431
+ *
432
+ */
433
+ REMUX_MP4_ERROR = 4200,
434
+ /**
435
+ * @brief 获取数据过程被中止
436
+ * @solution 请检查浏览器网络请求是否正常,再尝试重新拉流。
437
+ */
438
+ MEDIA_ERR_ABORTED = 5101,
439
+ /**
440
+ * @brief 网络发生错误,无法成功获取媒体文件
441
+ * @solution 请检查浏览器网络请求是否正常,再尝试重新拉流。
442
+ */
443
+ MEDIA_ERR_NETWORK = 5102,
444
+ /**
445
+ * @brief 浏览器在解码媒体资源时发生错误
446
+ * @solution
447
+ * 1. 请检查原始视频是否正常;
448
+ * 2. 重新进行转码和播放;
449
+ * 3. 如仍未解决请联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
450
+ */
451
+ MEDIA_ERR_DECODE = 5103,
452
+ /**
453
+ * @brief 因视频格式不支持、服务器或网络的问题造成视频无法加载
454
+ * @solution
455
+ * 1. 检查浏览器视频数据请求是否正常;
456
+ * 2. 检查浏览器和页面环境是否支持要播放的视频格式;
457
+ * 3. 如仍未解决请联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
458
+ */
459
+ MEDIA_ERR_SRC_NOT_SUPPORTED = 5104,
460
+ /**
461
+ * @brief 当前浏览器不支持视频解码
462
+ * @solution
463
+ * 1. 检查浏览器视频数据请求是否正常;
464
+ * 2. 检查浏览器和页面环境是否支持要播放的视频格式;
465
+ * 3. 如仍未解决请联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
466
+ */
467
+ MEDIA_ERR_CODEC_NOT_SUPPORTED = 5105,
468
+ /**
469
+ * @brief 当前播放地址为空
470
+ * @solution 请检查必要参数 `url` 或 `playlist` 是否传入。
471
+ */
472
+ MEDIA_ERR_URL_EMPTY = 5106,
473
+ /**
474
+ * @brief 播放异常
475
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
476
+ */
477
+ MEDIA_MSE_ADD_SB = 5200,
478
+ /**
479
+ * @brief 播放异常
480
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
481
+ */
482
+ MEDIA_MSE_APPEND_BUFFER = 5201,
483
+ /**
484
+ * @brief 播放异常
485
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
486
+ */
487
+ MEDIA_MSE_OTHER = 5202,
488
+ /**
489
+ * @brief 播放异常
490
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
491
+ */
492
+ MEDIA_MSE_FULL = 5203,
493
+ /**
494
+ * @brief 播放异常
495
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
496
+ */
497
+ MEDIA_MSE_HIJACK = 5204,
498
+ /**
499
+ * @brief 播放异常
500
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
501
+ */
502
+ MEDIA_EME_HIJACK = 5301,
503
+ /**
504
+ * @brief DRM 权限校验失败
505
+ * @hidden
506
+ */
507
+ DRM_LICENSE = 7100,
508
+ /**
509
+ * @brief DRM 权限校验失败
510
+ * @hidden
511
+ */
512
+ DRM_CUSTOM_LICENSE = 7200,
513
+ /**
514
+ * @brief 播放异常
515
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
516
+ */
517
+ OTHER = 8000,
518
+ /**
519
+ * @brief 播放异常
520
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
521
+ */
522
+ RUNTIME_NO_CANPLAY_ERROR = 9001,
523
+ /**
524
+ * @brief 播放异常
525
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
526
+ */
527
+ RUNTIME_BUFFERBREAK_ERROR = 9002,
528
+ /**
529
+ * @brief 播放异常
530
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
531
+ */
532
+ RUNTIME_BWAITING_TIMEOUT_ERROR = 9002,
533
+ // veplayer 报错
534
+ /**
535
+ * @brief CDN 异步获取失败
536
+ * @solution 请刷新重试或者检查网络环境。
537
+ *
538
+ */
539
+ MODULE_LOAD_ERROR = 110,
540
+ /**
541
+ * @hidden
542
+ */
543
+ UNKNOWN = "UNKNOWN"
544
+ }
545
+ declare enum ErrorType {
546
+ MANIFEST = "manifest",
547
+ NETWORK = "network",
548
+ DEMUX = "demux",
549
+ REMUX = "remux",
550
+ MEDIA = "media",
551
+ DRM = "drm",
552
+ OTHER = "other",
553
+ RUNTIME = "runtime"
554
+ }
555
+ interface ErrorInfo<T = TextKey> {
556
+ errorCode?: ErrorCode;
557
+ message?: string;
558
+ messageTextKey?: T;
559
+ level?: Level;
560
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
561
+ ext?: any;
562
+ error?: Error;
563
+ }
564
+ /**
565
+ * @list error
566
+ * @detail error
567
+ * @brief 错误对象
568
+ * @name VeError
569
+ * @id VeError
570
+ */
571
+ declare class VeError<T extends string = TextKey> extends Error {
572
+ /**
573
+ * @brief 错误码,对应[错误码字典](#ErrorCode)。
574
+ */
575
+ readonly errorCode: ErrorCode;
576
+ /**
577
+ * @brief 错误等级。
578
+ */
579
+ readonly level?: Level;
580
+ /**
581
+ * @brief 错误信息。
582
+ */
583
+ message: string;
584
+ /**
585
+ * @brief 其他错误信息。
586
+ */
587
+ readonly ext?: any;
588
+ /**
589
+ * @hidden
590
+ * @param error
591
+ * @param i18n
592
+ */
593
+ constructor(error?: string | ErrorInfo<T>, i18n?: VeI18n<T>);
594
+ }
595
+ /**
596
+ * @list option
597
+ * @kind property
598
+ */
599
+ type ErrorConfig = {
600
+ /** {zh}
601
+ * @brief 是否展示报错图片。
602
+ * @default true
603
+ */
604
+ showErrorImg?: boolean;
605
+ /** {zh}
606
+ * @brief 是否展示报错提示。
607
+ * @default true
608
+ */
609
+ showErrorTip?: boolean;
610
+ /** {zh}
611
+ * @brief 是否展示刷新按钮。
612
+ * @default true
613
+ */
614
+ showRefresh?: boolean;
615
+ /** {zh}
616
+ * @brief 自定义报错显示。
617
+ * @default 无
618
+ */
619
+ errorTipsText?: string | Record<Lang, string>;
620
+ /** {zh}
621
+ * @brief 更多提示信息。
622
+ * @default 无
623
+ */
624
+ extraTips?: {
625
+ label: string | Record<Lang, string>;
626
+ value: string | Record<Lang, string>;
627
+ }[];
628
+ };
629
+ declare class Error extends Plugin {
630
+ player: Player$0;
631
+ icons: {
632
+ error: HTMLElement;
633
+ };
634
+ langText: {
635
+ refresh: string;
636
+ errorTip: string;
637
+ };
638
+ config: ErrorConfig;
639
+ private _error?;
640
+ static get pluginName(): string;
641
+ static get defaultConfig(): {
642
+ showErrorImg: boolean;
643
+ showErrorTip: boolean;
644
+ showRefresh: boolean;
645
+ errorTipsText: string;
646
+ extraTips: never[];
647
+ position: string;
648
+ };
649
+ get _errorTip(): string;
650
+ afterCreate(): void;
651
+ registerIcons(): {
652
+ error: {
653
+ icon: any;
654
+ class: string;
655
+ };
656
+ };
657
+ updateLang(): void;
658
+ showError(error: VeError | XGError): void;
659
+ hideError(): void;
660
+ destroy(): void;
661
+ render(): string;
662
+ private _focus;
663
+ private _initIcons;
664
+ private _initEvents;
665
+ private _renderText;
666
+ private _renderExtraTips;
667
+ private _handleRefresh;
668
+ private _renderRefresh;
669
+ }
670
+ /**
671
+ * @list option
672
+ * @kind property
673
+ */
674
+ interface DefinitionConfig {
675
+ /** {zh}
676
+ * @brief 等待超时的时间阈值,单位为 ms。等待超过该值,会抛出 `DEFINITION_FALLBACK` 事件,如果 `needFallback` 为 `true` 则会提示清晰度降级。
677
+ * @default 5000
678
+ */
679
+ longWaitingTime?: number;
680
+ /** {zh}
681
+ * @brief 是否开启清晰度降级。
682
+ * @default false
683
+ */
684
+ needFallback?: boolean;
685
+ /** {zh}
686
+ * @brief 降级顺序,按照数组顺序依次降级,数组中的元素与 playlist 中的 definition 相对应。
687
+ * @default ['uhd', 'hd', 'sd', 'ld', 'ao']
688
+ */
689
+ demotePriority?: string[];
690
+ }
691
+ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
692
+ /** {zh}
693
+ * @brief 指定播放器容器 ID,VePlayer 将被插入在该容器中。id 和 el 需至少传入 1 个。如果同时传入,则优先将播放器插入 id 容器中。
694
+ * @default 'veplayer'
695
+ */
696
+ id?: string;
697
+ /** {zh}
698
+ * @brief 指定播放器容器元素,VePlayer 将被插入在该容器中。id 和 el 需至少传入 1 个。如果同时传入,则优先将播放器插入 id 容器中。
699
+ * @default 无
700
+ */
701
+ el?: HTMLElement;
702
+ /** {zh}
703
+ * @brief 设置播放器宽度,传入 number 类型参数则播放器内部默认添加单位px,传入 string 类型参数则直接赋值给播放器容器 width 样式属性。
704
+ * @default '100%'
705
+ */
706
+ width?: number | string;
707
+ /** {zh}
708
+ * @brief 设置播放器高度,传入 number 类型参数则播放器内部默认添加单位px,传入 string 类型参数则直接赋值给播放器容器 height 样式属性。
709
+ * @default '100%'
710
+ */
711
+ height?: number | string;
712
+ /** {zh}
713
+ * @brief 为播放器配置直播拉流地址。您可手动拼接或使用地址生成器生成拉流地址,生成方法请参见[生成直播地址](https://www.volcengine.com/docs/6469/107759)。url 和 playList 需至少传入 1 个。
714
+ * @default 无
715
+ */
716
+ url?: string;
717
+ /** {zh}
718
+ * @brief 为播放器配置直播拉流地址列表。url 和 playlist 需至少传入 1 个。
719
+ * @default 无
720
+ */
721
+ playlist?: ExposedSource[];
722
+ /** {zh}
723
+ * @brief 当存在多个直播线路时,为播放器设置默认直播线路,不传则默认列表第一个。
724
+ * @default 无
725
+ */
726
+ defaultSource?: string;
727
+ /** {zh}
728
+ * @brief 为播放器设置默认直播清晰度,不传则默认列表第一个。
729
+ * @default 无
730
+ */
731
+ defaultDefinition?: string;
732
+ /** {zh}
733
+ * @brief 为播放器设置备路拉流地址,支持设置多个备路拉流地址,在 `maxFallbackRound` 大于 `0` 时有效。当您使用配置的直播拉流地址拉流失败时,会在直播地址和备路直播地址之间循环拉流,直到拉流成功。
734
+ * @default 无
735
+ */
736
+ fallbackUrls?: string[];
737
+ /** {zh}
738
+ * @brief 为播放器设置拉流失败时循环拉流的最大次数。
739
+ * @default 0
740
+ */
741
+ maxFallbackRound?: number;
742
+ /** {zh}
743
+ * @brief 为播放器设置解码方式。
744
+ * @listtip
745
+ * 开启软解后,播放器会使用浏览器的软件解码器来解码视频流。软解模式具有较高的兼容性,适用于各种设备和浏览器,但依赖设备 CPU,在高分辨率或高码率视频播放时会出现卡顿或延迟。建议在以下场景开启软解:
746
+ * 1. 部分安卓浏览器中播放器被劫持,部分功能将不可见,可开启软解;
747
+ * 2. 移动端浏览器不支持 flv 格式,如果需要播放该格式的视频,可开启软解;
748
+ * 3. 部分浏览器不支持 H.265 编码格式,如果需要播放该编码格式的视频,请开启软解。
749
+ * @default 'hardware'
750
+ */
751
+ decodeType?: DecodeType;
752
+ /** {zh}
753
+ * @brief 为播放器设置视频的实际编码格式。如果您在degradation 设置了 `soft-first` 属性(即硬解不支持时降级软解),建议您传入该参数,省去探测实际编码格式的操作。
754
+ * @default 'h264'
755
+ */
756
+ codec?: Codec;
757
+ /** {zh}
758
+ * @brief 为播放器设置是否开启 H.265 兼容模式。在 H.265 兼容模式下,播放器会优先使用硬解来解码 H.265 直播流。如果设备或浏览器不支持 H.265 硬解,则自动降级为 H.265 软解。
759
+ * @default 'soft-first'
760
+ */
761
+ degradation?: Degradation | boolean;
762
+ /** {zh}
763
+ * @brief 为播放器设置封面图 URL。
764
+ * @default 无
765
+ */
766
+ poster?: string;
767
+ /** {zh}
768
+ * @brief 为播放器设置初始显示语言,语言包不存在的情况下默认显示 'en' 语言包 。默认值为 `document.documentElement.getAttribute('lang') || navigator.language || 'zh-cn'`
769
+ * @default -
770
+ */
771
+ lang?: Lang;
772
+ /** {zh}
773
+ * @brief 为播放器设置自定义的多语言词典,可设置每个语种的词典,格式为 { texts: { [key: string]: Object; } }。<br>
774
+ * 例如,{ texts: { 'zh-cn': { PIP: '画中画' }, en: { PIP: 'pip' } }} ,格式请参考[默认词典](https://www.volcengine.com/docs/6469/127529)。
775
+ * @default 无
776
+ */
777
+ i18n?: {
778
+ texts: Record<Lang, Record<string, string>>;
779
+ };
780
+ /** {zh}
781
+ * @brief 为播放器设置是否自动播放, `muted` 设置为 `true` 为静音自动播放。
782
+ * @default { muted: true }
783
+ * @type {{ muted: boolean } | boolean}
784
+ */
785
+ autoplay?: {
786
+ muted?: boolean;
787
+ } | boolean;
788
+ /** {zh}
789
+ * @brief 为播放器设置默认音量,取值范围 [0,1]。
790
+ * @default 0.6
791
+ */
792
+ volume?: number;
793
+ /** {zh}
794
+ * @brief 为播放器设置是否显示画中画功能按钮。
795
+ * - `true`:显示;
796
+ * - `false`:不显示。
797
+ * @default false
798
+ */
799
+ pip?: boolean;
800
+ /**{zh}
801
+ * @brief 为播放器设置是否显示全屏功能按钮,并进行全屏功能设置。
802
+ * - `true`:显示;
803
+ * - `false`:不显示。
804
+ */
805
+ fullscreen?: boolean | Fullscreen;
806
+ /** {zh}
807
+ * @brief 为播放器设置报错信息,支持配置播放异常时,播放器显示的异常文案、图片,以及是否提供刷新按钮等。
808
+ * @default -
809
+ */
810
+ error?: ErrorConfig;
811
+ /** {zh}
812
+ * @brief 为播放器设置清晰度的相关配置。
813
+ * @default -
814
+ */
815
+ definition?: DefinitionConfig;
816
+ /** {zh}
817
+ * @brief 为播放器设置是否显示控制栏。
818
+ * - `true`: 显示;
819
+ * - `false`: 不显示
820
+ * @default true
821
+ */
822
+ controls?: boolean | {
823
+ [propName: string]: any;
824
+ };
825
+ /** {zh}
826
+ * @brief 为播放器设置**清晰度选择**或**线路选择**时的**选择面板样式**,仅在移动端有效。
827
+ * @default 'bottom'
828
+ */
829
+ listType?: ListType;
830
+ /** {zh}
831
+ * @brief 为播放器设置是否启用内联播放模式。playsinline 属性是 HTML5 视频标签的一个属性,用于指定视频是否应在页面文档内播放。
832
+ * - `true`:启用,表示视频将在页面文档内播放;
833
+ * - `false`:停用,默认浏览器播放行为。</br>
834
+ *
835
+ * 该配置项只在移动端生效,当取值为 true 的时候,会在初始化 video 或 audio 对象的时候,将 playsinline、webkit-playsinline、x5-playsinline 三个属性设置为 true,请参考 [New Policies for iOS](https://webkit.org/blog/6784/new-video-policies-for-ios/) 了解内联模式相关知识。
836
+ * @listtip
837
+ * - iOS 10 及以上系统 Safari 浏览器支持配置内联播放模式;
838
+ * - iOS 10 以下系统 Safari 浏览器不支持配置内联播放模式 ,默认播放即进入系统全屏。
839
+ * @default true
840
+ */
841
+ playsinline?: boolean;
842
+ /** {zh}
843
+ * @brief 为播放器设置 video 标签扩展属性,初始化时会设置在 videoElement 或 audioElement 对象上,请参考 [HTMLMediaElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement#properties) 查看其支持的属性配置。
844
+ * @default 无
845
+ */
846
+ videoAttributes?: {
847
+ [propName: string]: any;
848
+ };
849
+ /** {zh}
850
+ * @brief 为播放器设置是否启用流式布局,启用流式布局后播放器会根据屏幕的宽度进行调整,保持在不同屏幕尺寸上都有良好的显示效果。
851
+ * - `true`:启用
852
+ * - `false`:停用
853
+ * @listtip
854
+ * 启用流式布局时:
855
+ * - 如果 `width` 和 `height` 是 `Number` 类型,则按照其数值计算播放器宽高比;
856
+ * - 如果 `width` 和 `height` 不是 `Number` 类型,默认使用 16:9 比例。
857
+ * @default false
858
+ */
859
+ fluid?: boolean;
860
+ /** {zh}
861
+ * @brief 为播放器设置尺寸适配方式,在视频资源初始化之后,根据获取到的 videoWidth 和 videoHeight 值对播放器容器宽高比例进行调整,可选项有:
862
+ * - `fixed`: 保持容器宽/高,不做适配;
863
+ * - `fixWidth`: 保持容器宽度,适配高度;
864
+ * - `fixHeight`: 保持容器高度,适配宽度。
865
+ *
866
+ * @default 'fixed'
867
+ */
868
+ fitVideoSize?: "fixWidth" | "fixHeight" | "fixed";
869
+ /** {zh}
870
+ * @brief 为播放器设置视频画面填充模式,可选项有:
871
+ * - `fillwidth`: 填充宽度,高度溢出则裁剪高度;
872
+ * - `fillHeight`: 填充高度,宽度溢出则裁剪宽度;
873
+ * - `fill`: 拉伸视频以填充容器;
874
+ * - `cover`: 保持其宽高比的同时填充元素的整个内容框;
875
+ * - `auto`: 使用浏览器默认的视频画面填充模式。
876
+ * @default 'auto'
877
+ */
878
+ videoFillMode?: "auto" | "fillHeight" | "fillWidth" | "fill" | "cover";
879
+ /** {zh}
880
+ * @brief 是否开启画面和控制栏分离模式。设置为开启时,控制栏将会常驻,与视频画面不重叠。
881
+ * - `true`:开启
882
+ * - `false`:关闭
883
+ * @default false
884
+ */
885
+ marginControls?: boolean;
886
+ /** {zh}
887
+ * @brief 启用微信同层播放。
888
+ * @default 无
889
+ */
890
+ "x5-video-player-type"?: string;
891
+ /** {zh}
892
+ * @brief 是否启用微信全屏播放模式。
893
+ * - `true`:启用
894
+ * - `false`:停用
895
+ * @default 无
896
+ */
897
+ "x5-video-player-fullscreen"?: boolean;
898
+ /** {zh}
899
+ * @brief 微信横竖屏控制,支持如下取值:
900
+ * - `landscape`:横屏
901
+ * - `portrait`:竖屏
902
+ * - `landscape|portrait`:跟随手机自动旋转
903
+ * @default 无
904
+ */
905
+ "x5-video-orientation"?: "landscape" | "portrait" | "landscape|portrait";
906
+ /** {zh}
907
+ * @brief 为播放器配置关键点样式。
908
+ * @default 无
909
+ * @hidden 直播目前没用到
910
+ */
911
+ commonStyle?: CommonStyle;
912
+ /** {zh}
913
+ * @brief 自定义插件列表。
914
+ * @default 无
915
+ */
916
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
917
+ plugins?: any[];
918
+ /** {zh}
919
+ * @hidden
920
+ */
921
+ preparePlugins?: PreparePlugins;
922
+ }
923
+ /**
924
+ * @list option
925
+ * @kind property
926
+ */
927
+ interface Fullscreen {
928
+ /** {zh}
929
+ * @brief 切换全屏时,是否旋转为横屏播放,通常在移动端使用。如果开启横屏播放,切换全屏时,将在竖屏状态下把播放器旋转 90 度,实现横屏效果。该配置优先级高于 useCssFullscreen。
930
+ * - `true`:使用旋转横屏;
931
+ * - `false`:不使用旋转横屏。
932
+ * @default false
933
+ */
934
+ rotateFullscreen?: boolean;
935
+ /** {zh}
936
+ * @brief 是否使用页面全屏代替系统全屏功能。
937
+ * - `true`:页面全屏;
938
+ * - `false`:系统全屏。
939
+ * @default false
940
+ */
941
+ useCssFullscreen?: boolean;
942
+ /**{zh}
943
+ * 全屏的时候是否显示右上角返回按钮,通常在移动端开启。
944
+ * - `true`:显示;
945
+ * - `false`:不显示。
946
+ * @default false
947
+ */
948
+ needBackIcon?: boolean;
949
+ }
950
+ /**
951
+ * @list option
952
+ * @kind property
953
+ * @hidden
954
+ */
955
+ interface CommonStyle {
956
+ /** {zh}
957
+ * @brief 进度条底色
958
+ * @default 无
959
+ */
960
+ progressColor?: string;
961
+ /** {zh}
962
+ * @brief 播放完成部分进度条底色
963
+ * @default 无
964
+ */
965
+ playedColor?: string;
966
+ /** {zh}
967
+ * @brief 缓存部分进度条底色
968
+ * @default 无
969
+ */
970
+ cachedColor?: string;
971
+ /** {zh}
972
+ * @brief 进度条滑块样式
973
+ * @default 无
974
+ */
975
+ sliderBtnStyle?: {
976
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
977
+ [propName: string]: any;
978
+ };
979
+ /** {zh}
980
+ * @brief 音量颜色
981
+ * @default 无
982
+ */
983
+ volumeColor?: string;
984
+ }
985
+ type PrepareResult = {
986
+ options?: Partial<VePlayerBaseOptions>;
987
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
988
+ plugins?: any[];
989
+ };
990
+ type PreparePlugins = (url: string) => Promise<PrepareResult> | undefined;
991
+ /**
992
+ * @detail option
993
+ * @brief 视频的实际编码格式。如果您在degradation 设置了 SoftFirst 属性(即硬解不支持降级软解),建议您传入该参数,省去探测实际编码格式的操作。
994
+ */
995
+ declare enum Codec {
996
+ /** {zh}
997
+ * @brief H.265 编码格式
998
+ */
999
+ H265 = "h265",
1000
+ /** {zh}
1001
+ * @brief H.264 编码格式
1002
+ */
1003
+ H264 = "h264"
1004
+ }
1005
+ /**
1006
+ * @detail option
1007
+ * @brief 是否开启 H.265 兼容模式。在 H.265 兼容模式下,播放器会优先使用硬解来解码 H.265 直播流。如果设备或浏览器不支持 H.265 硬解,则自动降级为 H.265 软解。
1008
+ */
1009
+ declare enum Degradation {
1010
+ /** {zh}
1011
+ * @brief 硬解不支持降级到软解
1012
+ */
1013
+ SoftFirst = "soft-first",
1014
+ /** {zh}
1015
+ * @brief 硬解不支持降级到h264
1016
+ * @hidden
1017
+ */
1018
+ H264First = "h264-first"
1019
+ }
1020
+ /**
1021
+ * @detail option
1022
+ * @brief 解码方式。
1023
+ * @example
1024
+ */
1025
+ declare enum DecodeType {
1026
+ /** {zh}
1027
+ * @brief 软解
1028
+ */
1029
+ Software = "software",
1030
+ /** {zh}
1031
+ * @brief 硬解
1032
+ */
1033
+ Hardware = "hardware"
1034
+ }
1035
+ type Constructor<T> = new (...args: any[]) => T;
1036
+ declare class VePlayerBase {
1037
+ protected readonly _player: XGPlayer;
1038
+ private readonly _sourceManager;
1039
+ private readonly _preparePlugins?;
1040
+ private _previousPrepareResult?;
1041
+ private _i18nManager;
1042
+ private _events;
1043
+ private _errorCallback;
1044
+ /**
1045
+ * @hidden
1046
+ */
1047
+ constructor(options?: VePlayerBaseOptions);
1048
+ /**
1049
+ * @brief 获取视频的就绪状态,其状态枚举值、枚举名称和说明如下:
1050
+ * - `0`:HAVE_NOTHING,没有关于媒体资源的可用信息
1051
+ * - `1`:HAVE_METADATA,已检索到足够多的媒体资源来初始化元数据, 快进/快退不会引发异常
1052
+ * - `2`:HAVE_CURRENT_DATA,当前播放位置的数据可用,但不足以播放下一帧
1053
+ * - `3`:HAVE_FUTURE_DATA,当前播放位置以及未来至少一小段时间的数据是可用的(至少有两帧以上的数据)
1054
+ * - `4`:HAVE_ENOUGH_DATA,有足够的数据可用,并且下载速率足够,媒体可以不间断地播放到最后
1055
+ */
1056
+ get readyState(): 0 | 2 | 1 | 4 | 3;
1057
+ /**
1058
+ * @brief 获取当前已缓冲的时间范围。
1059
+ */
1060
+ get buffered(): TimeRanges;
1061
+ /**
1062
+ * @brief 获取已经播放的音频/视频的时间范围。
1063
+ */
1064
+ get played(): TimeRanges;
1065
+ /**
1066
+ * @brief 设置/获取视频当前的播放时间, 单位为 s。
1067
+ */
1068
+ get cumulateTime(): number;
1069
+ /**
1070
+ * @brief 获取是否处于焦点状态,处于焦点状态会显示控制栏。
1071
+ */
1072
+ get isFocused(): boolean;
1073
+ /**
1074
+ * @brief 获取播放器是否处于全屏状态。
1075
+ */
1076
+ get isFullscreen(): boolean;
1077
+ /**
1078
+ * @brief 获取播放器是否处于网页全屏状态。
1079
+ */
1080
+ get isCssFullscreen(): boolean;
1081
+ /**
1082
+ * @brief 获取视频的网络状态,其状态枚举值、枚举名称和说明如下:
1083
+ * - `0`:NETWORK_EMPTY,目前还没有数据,readyState 的值是 HAVE_NOTHING
1084
+ * - `1`:NETWORK_IDLE,HTMLMediaElement 处于活动状态并已选择资源,但未使用网络
1085
+ * - `2`:NETWORK_LOADING,浏览器正在下载 HTMLMediaElement 数据
1086
+ * - `3`:NETWORK_NO_SOURCE,未找到 HTMLMediaElement src。
1087
+ */
1088
+ get networkState(): 0 | 2 | 1 | 3;
1089
+ /**
1090
+ * @brief 获取当前视频是否处于暂停状态。
1091
+ */
1092
+ get paused(): boolean;
1093
+ /**
1094
+ * @brief 获取当前视频是否播放结束。
1095
+ */
1096
+ get ended(): boolean;
1097
+ /**
1098
+ * @brief 获取播放器当前所处的状态,其状态枚举值、枚举名称和说明如下:
1099
+ * - `0`:ERROR,播放出现错误
1100
+ * - `1`:INITIAL,初始化
1101
+ * - `2`:READY,配置/事件/插件等均已经初始化/绑定/实例化完成
1102
+ * - `3`:ATTACHING,进入媒体对象挂载阶段
1103
+ * - `4`:ATTACHED,媒体对象已经挂载到了 DOM 中
1104
+ * - `5`:NOTALLOW,播放被阻止
1105
+ * - `6`:RUNNING,已经成功起播进入播放流程
1106
+ * - `7`:ENDED,播放结束
1107
+ * - `8`:DESTROYED,播放器实例处于已被销毁
1108
+ */
1109
+ get state(): number;
1110
+ /**
1111
+ * 获取当前播放视频的拉流地址。
1112
+ */
1113
+ get url(): string | undefined;
1114
+ /**
1115
+ * @brief 获取当播放视频的线路名称唯一标识(name)。
1116
+ */
1117
+ get source(): string | undefined;
1118
+ /**
1119
+ * @brief 获取当前播放视频的清晰度唯一标识(definition)。
1120
+ */
1121
+ get definition(): string;
1122
+ /**
1123
+ * @brief 获取和设置播放器的跨域配置信息,更多信息参考 [crossorigin](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/crossorigin) 属性介绍。
1124
+ */
1125
+ get crossOrigin(): string;
1126
+ /**
1127
+ * @brief 获取和设置播放器的跨域配置信息,更多信息参考 [crossorigin](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/crossorigin) 属性介绍。
1128
+ */
1129
+ set crossOrigin(crossOrigin: string);
1130
+ /**
1131
+ * @brief 获取和设置视频的音量,取值范围为 [0,1]。
1132
+ */
1133
+ // eslint-disable-next-line @typescript-eslint/member-ordering
1134
+ get volume(): number;
1135
+ /**
1136
+ * @brief 获取和设置视频的音量,取值范围为 [0,1]。
1137
+ */
1138
+ set volume(volume: number);
1139
+ /**
1140
+ * @brief 获取和设置视频静音状态。
1141
+ * - `true`:静音
1142
+ * - `false`:非静音
1143
+ */
1144
+ // eslint-disable-next-line @typescript-eslint/member-ordering
1145
+ get muted(): boolean;
1146
+ /**
1147
+ * @brief 获取和设置视频静音状态。
1148
+ * - `true`:静音
1149
+ * - `false`:非静音
1150
+ */
1151
+ set muted(isMuted: boolean);
1152
+ /**
1153
+ * @brief 获取和设置当前语言。
1154
+ */
1155
+ // eslint-disable-next-line @typescript-eslint/member-ordering
1156
+ get lang(): "zh-cn" | "en" | string;
1157
+ /**
1158
+ * @brief 获取和设置当前语言。
1159
+ */
1160
+ set lang(lang: "zh-cn" | "en" | string);
1161
+ // eslint-disable-next-line @typescript-eslint/member-ordering
1162
+ protected get _src(): string;
1163
+ /**
1164
+ * @hidden
1165
+ */
1166
+ static create<T extends VePlayerBase>(options?: VePlayerBaseOptions, Constructor?: Constructor<T>): Promise<T>;
1167
+ /**
1168
+ * @brief 调用此方法切换拉流地址、线路、清晰度。
1169
+ * @param target 目标地址,可以是播放地址,也可以是线路和清晰度
1170
+ * @param options 更多配置信息
1171
+ */
1172
+ switch(target: string | {
1173
+ /**
1174
+ * @brief 清晰度的唯一标识。
1175
+ * @default 无
1176
+ */
1177
+ definition?: string;
1178
+ /**
1179
+ * @brief 线路的唯一标识。
1180
+ * @default 无
1181
+ */
1182
+ source?: string;
1183
+ }, options?: {
1184
+ /**
1185
+ * @brief 清晰度 definition 配置无效时,是否降级到播放列表第一个清晰度地址。
1186
+ * @default false
1187
+ *
1188
+ */
1189
+ fallbackToFirstDefinition?: boolean;
1190
+ }): Promise<ExposedDefinition>;
1191
+ /**
1192
+ * @brief 调用此方法更新拉流地址列表。
1193
+ * @param playlist 要更新的播放列表。
1194
+ * @param target 更新后默认播放的资源。
1195
+ */
1196
+ updatePlaylist(playlist: ExposedSource[] | string, target?: string | {
1197
+ /**
1198
+ * @brief 清晰度唯一标识。
1199
+ * @default 无
1200
+ *
1201
+ */
1202
+ definition?: string;
1203
+ /**
1204
+ * @brief 线路的唯一标识。
1205
+ * @default 无
1206
+ *
1207
+ */
1208
+ source?: string;
1209
+ }): Promise<void>;
1210
+ // TODO: 等西瓜播放器完善错误码后增加函数重载以提供更好的类型
1211
+ /**
1212
+ * @brief 调用此方法监听指定事件,事件处理函数只执行一次。
1213
+ * @param event 表示事件的名称。
1214
+ * @param callback 表示事件的回调函数。
1215
+ */
1216
+ once(event: string, callback: (data?: any) => any): void;
1217
+ /**
1218
+ * @brief 调用此方法解绑或移除指定事件的事件监听。
1219
+ * @param event 表示事件的名称。
1220
+ * @param callback 表示事件的回调函数。
1221
+ */
1222
+ off(event: string, callback: (data?: any) => any): void;
1223
+ /**
1224
+ * @brief 调用此方法触发指定事件。
1225
+ * @param event 表示事件的名称。
1226
+ * @param data 事件信息。
1227
+ */
1228
+ emit(event: string, data?: any): void;
1229
+ /**
1230
+ * @brief 调用此方法解绑或移除指定事件的所有事件监听。
1231
+ */
1232
+ offAll(): void;
1233
+ /**
1234
+ * @brief 调用此方法监听指定事件。
1235
+ * @param event 表示事件名称。
1236
+ * @param callback 表示事件的回调函数。
1237
+ */
1238
+ on(event: string, callback: (data?: any) => any): void;
1239
+ /**
1240
+ * @brief 调用此方法开始播放 。
1241
+ */
1242
+ play(): any;
1243
+ /**
1244
+ * @brief 调用此方法暂停播放。
1245
+ */
1246
+ pause(): void;
1247
+ /**
1248
+ * @brief 调用此方法打开画中画。
1249
+ */
1250
+ requestPIP(): void;
1251
+ /**
1252
+ * @brief 调用此方法关闭画中画。
1253
+ */
1254
+ exitPIP(): void;
1255
+ /**
1256
+ * @brief 调用此方法重新拉流。
1257
+ */
1258
+ retry(): void;
1259
+ /**
1260
+ * @brief 播放器获取焦点,调用该方法 `veplayer.isFocused` 将会变为 `true`,并触发 `PLAYER_FOCUS` 事件。
1261
+ * @param data 播放器获取焦点配置信息。
1262
+ */
1263
+ focus(data?: {
1264
+ /**
1265
+ * @brief 是否需要自动失焦,默认为 true,即经过 delay 时长之后,会自动调用 blur() 进行失焦。
1266
+ * @default true
1267
+ */
1268
+ autoHide?: boolean;
1269
+ /**
1270
+ * @brief 自动失焦延迟时长,单位ms,autoHide 为 true 时生效。
1271
+ * @default 3000
1272
+ */
1273
+ delay?: number;
1274
+ }): void;
1275
+ /**
1276
+ * @brief 播放器失去焦点,调用该方法 `veplayer.isFocused` 将会变为 `false`,并触发 `PLAYER_BLUR` 事件。
1277
+ * @param data 播放器失去焦点配置信息。
1278
+ */
1279
+ blur(data?: {
1280
+ /**
1281
+ * @brief 播放器失焦是否忽略暂停状态,默认值是 true,即默认暂停的时候不取消播放器焦点状态。
1282
+ * @default false
1283
+ */
1284
+ ignorePaused?: boolean;
1285
+ }): void;
1286
+ /**
1287
+ * @brief 调用此方法进入系统全屏状态。如果该方法调用的时候处于网页全屏状态会自动退出网页全屏,下发事件 `Events.FULLSCREEN_CHANGE`。
1288
+ * @param el 全屏作用的 DOM 节点。
1289
+ */
1290
+ requestFullscreen(el?: HTMLElement): Promise<void>;
1291
+ /**
1292
+ * @brief 调用此方法退出系统全屏状态,调用该方法 `veplayer.isFullscreen` 将会变为 `false`,并触发 `Events.FULLSCREEN_CHANGE` 事件。
1293
+ * @param el 全屏作用的 DOM 节点。
1294
+ */
1295
+ exitFullscreen(el?: HTMLElement): Promise<void>;
1296
+ /**
1297
+ * @brief 调用此方法进入网页样式全屏状态,播放器进入网页全屏,利用 CSS 模拟实现全屏效果。如果该接口调用的时候处于全屏状态,会自动退出全屏,下发事件 `Events.CSS_FULLSCREEN_CHANGE`。
1298
+ * @param el 全屏作用的 DOM 节点。
1299
+ */
1300
+ requestCssFullscreen(el?: HTMLElement): void;
1301
+ /**
1302
+ * @brief 调用此方法退出网页样式全屏状态。 调用该方法 `veplayer.isFullscreen` 将会变为 `false`,并触发 `Events.CSS_FULLSCREEN_CHANGE` 事件。
1303
+ */
1304
+ exitCssFullscreen(): void;
1305
+ /**
1306
+ * @brief 调用此方法在当前播放器上注册指定插件。
1307
+ * @param plugin 插件构造函数。
1308
+ * @param config 插件的配置列表。
1309
+ */
1310
+ registerPlugin(plugin:
1311
+ // eslint-disable-next-line @typescript-eslint/ban-types
1312
+ Function | {
1313
+ /**
1314
+ * @brief 插件构造函数。
1315
+ * @default 无
1316
+ */
1317
+ // eslint-disable-next-line @typescript-eslint/ban-types
1318
+ plugin: Function;
1319
+ /**
1320
+ * @brief 插件配置参数。
1321
+ * @default 无
1322
+ */
1323
+ options: object;
1324
+ }, config?: {
1325
+ [propName: string]: any;
1326
+ }): any;
1327
+ /**
1328
+ * @brief 调用此方法在当前播放器上销毁/注销指定插件。
1329
+ * @param plugin 插件实例或者插件名称。
1330
+ */
1331
+ unRegisterPlugin(plugin: any): void;
1332
+ /**
1333
+ * @brief 调用此接口显示指定插件图标。
1334
+ * @param pluginNames 插件名称
1335
+ */
1336
+ showIcon(pluginNames: string[]): void;
1337
+ /**
1338
+ * @brief 调用此接口隐藏指定插件图标。
1339
+ * @param pluginNames 插件名称
1340
+ */
1341
+ hideIcon(pluginNames: string[]): void;
1342
+ /**
1343
+ * @brief 调用此方法销毁播放器实例。
1344
+ */
1345
+ destroy(): void;
1346
+ /**
1347
+ * @hidden
1348
+ */
1349
+ prepare(url: string): Promise<{
1350
+ plugins: any[];
1351
+ options: Partial<VePlayerBaseOptions> | undefined;
1352
+ }>;
1353
+ private _handleFallback;
1354
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
1355
+ private _transformEvent;
1356
+ private _switch;
1357
+ private _switchUrl;
1358
+ // 获取需要卸载和需要注册的播放插件
1359
+ private _diffPlugins;
1360
+ private _callBeforePlayerInitForUrl;
1361
+ }
1362
+ declare const enum State {
1363
+ Fetching = 0,
1364
+ Ready = 1,
1365
+ Error = 2
1366
+ }
1367
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
1368
+ type Exports = Record<string, any>;
1369
+ interface Module {
1370
+ src: string;
1371
+ state: State;
1372
+ name: string;
1373
+ exports: Exports;
1374
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
1375
+ error?: any;
1376
+ }
1377
+ type ModuleSystem = "esm" | "umd";
1378
+ interface LoaderOptions {
1379
+ baseUrl: string;
1380
+ }
1381
+ declare enum DynamicModule {
1382
+ BizVod = "biz:vod",
1383
+ BizLive = "biz:live",
1384
+ PluginFlv = "plugin:flv",
1385
+ PluginMp4 = "plugin:mp4",
1386
+ PluginHls = "plugin:hls",
1387
+ PluginShaka = "plugin:shaka",
1388
+ PluginRtm = "plugin:rtm",
1389
+ PluginXgvideo = "plugin:xgvideo",
1390
+ PluginDrm = "plugin:drm"
1391
+ }
1392
+ type ModulesMap = {
1393
+ [DynamicModule.BizVod]: Exports;
1394
+ [DynamicModule.BizLive]: Exports;
1395
+ [DynamicModule.PluginFlv]: Exports;
1396
+ [DynamicModule.PluginMp4]: Exports;
1397
+ [DynamicModule.PluginHls]: Exports;
1398
+ [DynamicModule.PluginShaka]: Exports;
1399
+ [DynamicModule.PluginRtm]: Exports;
1400
+ [DynamicModule.PluginXgvideo]: Exports;
1401
+ [DynamicModule.PluginDrm]: Exports;
1402
+ };
1403
+ declare const register: (exports: {
1404
+ [x: string]: any;
1405
+ }[]) => {
1406
+ [x: string]: any;
1407
+ }[];
1408
+ declare function load<T extends DynamicModule>(name: T, src?: string): Promise<ModulesMap[T]>;
1409
+ declare module MobilePlayerPanelWrapper {
1410
+ export { MobilePlayerPanel };
1411
+ }
1412
+ declare namespace strategy {
1413
+ const EN: {
1414
+ DEFINITION_FALLBACK_TOAST: string;
1415
+ DEFINITION_SWITCHING: string;
1416
+ ERROR_REFRESH: string;
1417
+ UNMUTE: string;
1418
+ MANIFEST: string;
1419
+ NETWORK: string;
1420
+ NETWORK_TIMEOUT: string;
1421
+ NETWORK_FORBIDDEN: string;
1422
+ NETWORK_NOTFOUND: string;
1423
+ DEMUX: string;
1424
+ REMUX: string;
1425
+ MEDIA: string;
1426
+ MEDIA_ERR_CODEC_NOT_SUPPORTED: string;
1427
+ MEDIA_ERR_URL_EMPTY: string;
1428
+ DRM: string;
1429
+ DRM_LICENSE: string;
1430
+ OTHER: string;
1431
+ RUNTIME: string;
1432
+ MODULE_LOAD_ERROR: string;
1433
+ UNKNOWN: string;
1434
+ ERROR_TYPES: typeof XG_EN.TEXT.ERROR_TYPES;
1435
+ HAVE_NOTHING: string;
1436
+ HAVE_METADATA: string;
1437
+ HAVE_CURRENT_DATA: string;
1438
+ HAVE_FUTURE_DATA: string;
1439
+ HAVE_ENOUGH_DATA: string;
1440
+ NETWORK_EMPTY: string;
1441
+ NETWORK_IDLE: string;
1442
+ NETWORK_LOADING: string;
1443
+ NETWORK_NO_SOURCE: string;
1444
+ MEDIA_ERR_ABORTED: string;
1445
+ MEDIA_ERR_NETWORK: string;
1446
+ MEDIA_ERR_DECODE: string;
1447
+ MEDIA_ERR_SRC_NOT_SUPPORTED: string;
1448
+ REPLAY: string;
1449
+ ERROR: string;
1450
+ PLAY_TIPS: string;
1451
+ PAUSE_TIPS: string;
1452
+ PLAYNEXT_TIPS: string;
1453
+ DOWNLOAD_TIPS: string;
1454
+ ROTATE_TIPS: string;
1455
+ RELOAD_TIPS: string;
1456
+ FULLSCREEN_TIPS: string;
1457
+ EXITFULLSCREEN_TIPS: string;
1458
+ CSSFULLSCREEN_TIPS: string;
1459
+ EXITCSSFULLSCREEN_TIPS: string;
1460
+ TEXTTRACK: string;
1461
+ PIP: string;
1462
+ SCREENSHOT: string;
1463
+ LIVE: string;
1464
+ OFF: string;
1465
+ OPEN: string;
1466
+ MINI_DRAG: string;
1467
+ MINISCREEN: string;
1468
+ REFRESH_TIPS: string;
1469
+ REFRESH: string;
1470
+ FORWARD: string;
1471
+ LIVE_TIP: string;
1472
+ };
1473
+ const ZH_CN: {
1474
+ DEFINITION_FALLBACK_TOAST: string;
1475
+ DEFINITION_SWITCHING: string;
1476
+ ERROR_REFRESH: string;
1477
+ UNMUTE: string;
1478
+ MANIFEST: string;
1479
+ NETWORK: string;
1480
+ NETWORK_TIMEOUT: string;
1481
+ NETWORK_FORBIDDEN: string;
1482
+ NETWORK_NOTFOUND: string;
1483
+ DEMUX: string;
1484
+ REMUX: string;
1485
+ MEDIA: string;
1486
+ MEDIA_ERR_CODEC_NOT_SUPPORTED: string;
1487
+ MEDIA_ERR_URL_EMPTY: string;
1488
+ DRM: string;
1489
+ DRM_LICENSE: string;
1490
+ OTHER: string;
1491
+ RUNTIME: string;
1492
+ MODULE_LOAD_ERROR: string;
1493
+ UNKNOWN: string;
1494
+ ERROR_TYPES: typeof XG_ZH_CN.TEXT.ERROR_TYPES;
1495
+ HAVE_NOTHING: string;
1496
+ HAVE_METADATA: string;
1497
+ HAVE_CURRENT_DATA: string;
1498
+ HAVE_FUTURE_DATA: string;
1499
+ HAVE_ENOUGH_DATA: string;
1500
+ NETWORK_EMPTY: string;
1501
+ NETWORK_IDLE: string;
1502
+ NETWORK_LOADING: string;
1503
+ NETWORK_NO_SOURCE: string;
1504
+ MEDIA_ERR_ABORTED: string;
1505
+ MEDIA_ERR_NETWORK: string;
1506
+ MEDIA_ERR_DECODE: string;
1507
+ MEDIA_ERR_SRC_NOT_SUPPORTED: string;
1508
+ REPLAY: string;
1509
+ ERROR: string;
1510
+ PLAY_TIPS: string;
1511
+ PAUSE_TIPS: string;
1512
+ PLAYNEXT_TIPS: string;
1513
+ DOWNLOAD_TIPS: string;
1514
+ ROTATE_TIPS: string;
1515
+ RELOAD_TIPS: string;
1516
+ FULLSCREEN_TIPS: string;
1517
+ EXITFULLSCREEN_TIPS: string;
1518
+ CSSFULLSCREEN_TIPS: string;
1519
+ EXITCSSFULLSCREEN_TIPS: string;
1520
+ TEXTTRACK: string;
1521
+ PIP: string;
1522
+ SCREENSHOT: string;
1523
+ LIVE: string;
1524
+ OFF: string;
1525
+ OPEN: string;
1526
+ MINI_DRAG: string;
1527
+ MINISCREEN: string;
1528
+ REFRESH_TIPS: string;
1529
+ REFRESH: string;
1530
+ FORWARD: string;
1531
+ LIVE_TIP: string;
1532
+ };
1533
+ type TextKey = keyof typeof EN;
1534
+ type Lang = "zh-cn" | "zh-hk" | "en" | "jp" | string;
1535
+ class VeI18n<T extends string = TextKey> {
1536
+ private _lang;
1537
+ constructor(config?: {
1538
+ lang?: Lang;
1539
+ i18n?: {
1540
+ texts?: Record<Lang, Record<string, string>>;
1541
+ };
1542
+ });
1543
+ static get langKeys(): string[];
1544
+ static isLangValid(lang: Lang): boolean;
1545
+ static extend(i18nTextList: Array<IXGI18nText>, i18nLangs?: IXGI18n): void;
1546
+ setLang(lang: string): void;
1547
+ getLang(): string;
1548
+ normalize(text?: string | Record<Lang, string>): string;
1549
+ getText(textKey?: T | string): Record<string | T, string>[string | T] | undefined;
1550
+ }
1551
+ interface DefinitionUrl {
1552
+ url: string;
1553
+ next: DefinitionUrl | null;
1554
+ }
1555
+ function arrayToList(urls?: string[]): DefinitionUrl;
1556
+ class Definition implements XGDefinition {
1557
+ readonly definition: string;
1558
+ readonly source: Source;
1559
+ readonly text?: Record<Lang, string> | string;
1560
+ readonly fallbackUrl: DefinitionUrl;
1561
+ readonly urls: string[];
1562
+ private _currentUrlRef;
1563
+ constructor(definitionSetting: {
1564
+ url: string;
1565
+ definition: string;
1566
+ source: Source;
1567
+ text?: Record<Lang, string> | string;
1568
+ fallbackUrls?: string[];
1569
+ });
1570
+ get url(): string;
1571
+ set url(url: string);
1572
+ next(): DefinitionUrl;
1573
+ }
1574
+ /**
1575
+ * @list option
1576
+ * @kind property
1577
+ * @id Definition
1578
+ * @alias Definition
1579
+ *
1580
+ */
1581
+ interface ExposedDefinition {
1582
+ /** {zh}
1583
+ * @brief 播放地址。
1584
+ * @default 无
1585
+ */
1586
+ url: string;
1587
+ /** {zh}
1588
+ * @brief 清晰度标识(唯一值)。
1589
+ * @default 无
1590
+ *
1591
+ */
1592
+ definition: string;
1593
+ /** {zh}
1594
+ * @brief 清晰度展示名称。可设置多语言 `{text: {'zh-cn': '高清', 'en': 'HD'}}`。
1595
+ * @default 无
1596
+ */
1597
+ text?: Record<Lang, string> | string;
1598
+ /** {zh}
1599
+ * @brief 为当前清晰度地址设置备路拉流地址,支持设置多个备路拉流地址。当前清晰度地址拉流失败时,会在当前清晰度地址和备路直播地址之间循环拉流,直到拉流成功。
1600
+ * @default 无
1601
+ *
1602
+ */
1603
+ fallbackUrls?: string[];
1604
+ }
1605
+ /**
1606
+ * @list option
1607
+ * @kind property
1608
+ * @id Source
1609
+ * @alias Source
1610
+ */
1611
+ interface ExposedSource {
1612
+ /** {zh}
1613
+ * @brief 线路标识(唯一值)。
1614
+ * @default 无
1615
+ */
1616
+ name?: string;
1617
+ /** {zh}
1618
+ * @brief 线路展示名称。可设置多语言 `{text: {'zh-cn': '线路一', 'en': 'LineOne'}}`。
1619
+ * @default 无
1620
+ *
1621
+ */
1622
+ text?: Record<Lang, string> | string;
1623
+ /** {zh}
1624
+ * @brief 该线路下清晰度列表。
1625
+ * @default 无
1626
+ *
1627
+ */
1628
+ definitions: Array<ExposedDefinition | string>;
1629
+ }
1630
+ interface CompoundSources {
1631
+ sources?: ExposedSource[];
1632
+ url?: string;
1633
+ fallbackUrls?: string[];
1634
+ }
1635
+ class Source {
1636
+ readonly name?: string;
1637
+ readonly text?: Record<Lang, string> | string;
1638
+ readonly definitions: Array<Definition & {
1639
+ source: Source;
1640
+ }>;
1641
+ private constructor();
1642
+ get defaultDefinition(): Definition & {
1643
+ source: Source;
1644
+ };
1645
+ static normalize(input: CompoundSources | ExposedSource[] | string): Source[];
1646
+ private static normalizeUrl;
1647
+ add(definition: Definition): void;
1648
+ }
1649
+ interface Config {
1650
+ listType: ListType;
1651
+ isAutoChange?: boolean;
1652
+ onItemClick?: (e: Event, data: CallbackData) => void;
1653
+ onOptionClick?: (e: Event, data: CallbackData) => void;
1654
+ hide?: () => void;
1655
+ list?: ListItem[];
1656
+ panel?: {
1657
+ className?: string;
1658
+ title?: string | Record<Lang, string>;
1659
+ };
1660
+ }
1661
+ interface Options {
1662
+ config: Config;
1663
+ root: HTMLElement | null;
1664
+ player: Player$0;
1665
+ }
1666
+ class MobilePlayerPanel {
1667
+ private _root?;
1668
+ private _config;
1669
+ private _parent;
1670
+ private _listDom?;
1671
+ private _container?;
1672
+ private _titleDom?;
1673
+ private _player;
1674
+ private _delegates?;
1675
+ private _listType?;
1676
+ constructor(args: Options);
1677
+ changeMode(listType: ListType): void;
1678
+ // 渲染选择列表
1679
+ renderItemList(data?: ListItem[]): HTMLElement;
1680
+ // 渲染panel的标题
1681
+ renderTitle(): HTMLElement | undefined;
1682
+ updatePanel(listType: ListType): void;
1683
+ // 渲染panel
1684
+ renderPanel(): void;
1685
+ show(): void;
1686
+ hide(): void;
1687
+ destroy(): void;
1688
+ private _bind;
1689
+ private _unbind;
1690
+ private _initEvents;
1691
+ private _unbindEvents;
1692
+ private _handleOrientationChange;
1693
+ private _bindDomEvent;
1694
+ private _unbindDomEvent;
1695
+ private _stopPropagation;
1696
+ private _onItemClick;
1697
+ private _handleHide;
1698
+ }
1699
+ import MobilePanel = MobilePlayerPanelWrapper.MobilePlayerPanel;
1700
+ /**
1701
+ * @detail option
1702
+ * @brief **清晰度选择**或**线路选择**时的**选择面板样式**,仅在移动端有效。
1703
+ */
1704
+ enum ListType {
1705
+ /** {zh}
1706
+ * @brief 全屏布局
1707
+ * @hidden
1708
+ */
1709
+ Middle = "middle",
1710
+ /** {zh}
1711
+ * @brief 底部抽屉
1712
+ */
1713
+ Bottom = "bottom",
1714
+ /** {zh}
1715
+ * @brief 右侧抽屉,常用于全屏时展示
1716
+ */
1717
+ Fullscreen = "fullscreen",
1718
+ /** {zh}
1719
+ * @brief 窗口蒙层展示
1720
+ */
1721
+ Inner = "inner"
1722
+ }
1723
+ interface ListItem {
1724
+ [key: string]: any;
1725
+ selected?: boolean;
1726
+ className?: string;
1727
+ showText?: string | HTMLElement;
1728
+ text?: string | Record<Lang, string>;
1729
+ iconText?: string | Record<Lang, string>;
1730
+ }
1731
+ type CallbackData = {
1732
+ to?: ListItem;
1733
+ from?: ListItem;
1734
+ };
1735
+ const enum RenderType {
1736
+ Icon = "Icon",
1737
+ Text = "Text"
1738
+ }
1739
+ type Config$0<T> = {
1740
+ [key: string]: any;
1741
+ // 【xg】顺序
1742
+ index?: number;
1743
+ // 【xg】展示的选择列表
1744
+ list?: Array<T>;
1745
+ // 【xg】竖屏
1746
+ hidePortrait?: boolean;
1747
+ // 【xg】列表点击之后是否隐藏列表
1748
+ isItemClickHide?: boolean;
1749
+ className?: string;
1750
+ // 【xg】是否展示已选择的
1751
+ isShowIcon?: boolean;
1752
+ // 【xg 扩展】列表渲染样式类型
1753
+ listType?: ListType;
1754
+ // 已选择的展示类型(文案 or icon)
1755
+ renderType?: RenderType;
1756
+ // 列表数据只有一个是否展示
1757
+ hideOnSingleOption?: boolean;
1758
+ // 横屏的时候是否切换mode
1759
+ isAutoChange?: boolean;
1760
+ // 自定义组件 mobilePanel的配置
1761
+ panel?: {
1762
+ className?: string;
1763
+ // panel 的标题
1764
+ title?: string | Record<Lang, string>;
1765
+ };
1766
+ };
1767
+ // 源自packages/xgplayer/src/plugins/common/optionsIcon.js
1768
+ // 自定义了几种选择类型
1769
+ class OptionsIcon extends Plugin {
1770
+ icons: Record<string, any>;
1771
+ config: Config$0<ListItem>;
1772
+ optionsList?: MobilePanel | OptionList;
1773
+ private _isIcon?;
1774
+ private _isActive?;
1775
+ private _curIndex;
1776
+ private activeEvent?;
1777
+ constructor(args: IPluginOptions);
1778
+ static get pluginName(): string;
1779
+ static get defaultConfig(): Config$0<ListItem>;
1780
+ updateLang(): void;
1781
+ afterCreate(): void;
1782
+ initIcons(): void;
1783
+ // eslint-disable-next-line @typescript-eslint/ban-ts-comment
1784
+ // @ts-ignore
1785
+ show(): void;
1786
+ hide(): void;
1787
+ onEnter: (e: Event) => void;
1788
+ onLeave: (e: Event) => void;
1789
+ // 状态切换
1790
+ toggle(isActive: boolean): void;
1791
+ // 列表选择回调
1792
+ onItemClick(e: Event, data: CallbackData): void;
1793
+ // 列表点击回调
1794
+ onOptionClick(e: Event, _data: CallbackData): void;
1795
+ // 已选择 option 的文案
1796
+ changeCurrentText(): void;
1797
+ renderItemList(itemList: ListItem[], curIndex?: number): void;
1798
+ destroy(): void;
1799
+ render(): string;
1800
+ private _getListType;
1801
+ }
1802
+ /**
1803
+ * @detail error
1804
+ */
1805
+ enum Level {
1806
+ /**
1807
+ * @brief 严重
1808
+ *
1809
+ */
1810
+ Fatal = "Fatal",
1811
+ /**
1812
+ * @brief 报错
1813
+ */
1814
+ Error = "Error"
1815
+ }
1816
+ enum ErrorCode {
1817
+ /**
1818
+ * @brief 视频解析错误
1819
+ * @solution 请联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
1820
+ */
1821
+ MANIFEST_HLS_ERROR = 1100,
1822
+ /**
1823
+ * @brief 视频解析错误
1824
+ * @solution 请联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
1825
+ */
1826
+ MANIFEST_DASH_ERROR = 1200,
1827
+ /**
1828
+ * @brief 网络错误
1829
+ * @solution 请检查当前网络环境或播放地址是否合法。
1830
+ */
1831
+ NETWORK = 2100,
1832
+ /**
1833
+ * @brief 网络请求超时
1834
+ * @solution 请检查拉流地址是否合法。
1835
+ */
1836
+ NETWORK_TIMEOUT = 2101,
1837
+ /**
1838
+ * @brief 网络请求 403
1839
+ * @solution 请检查拉流地址鉴权信息。
1840
+ */
1841
+ NETWORK_FORBIDDEN = 2103,
1842
+ /**
1843
+ * @brief 网络请求 404
1844
+ * @solution 请检查拉流地址是否合法。
1845
+ */
1846
+ NETWORK_NOTFOUND = 2104,
1847
+ /**
1848
+ * @brief 网络请求 206
1849
+ * @solution 请检查拉流地址是否合法。
1850
+ */
1851
+ NETWORK_RANGE_NOT_SATISFIABLE = 2116,
1852
+ /**
1853
+ * @brief 视频解析错误
1854
+ * @solution 请检查拉流地址是否合法或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
1855
+ */
1856
+ DEMUX_FLV_ERROR = 3100,
1857
+ /**
1858
+ * @brief 视频解析错误
1859
+ * @solution 请检查拉流地址是否合法或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
1860
+ */
1861
+ DEMUX_HLS_ERROR = 3200,
1862
+ /**
1863
+ * @brief 视频解析错误
1864
+ * @solution 请检查拉流地址是否合法或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
1865
+ *
1866
+ */
1867
+ DEMUX_MP4_ERROR = 3300,
1868
+ /**
1869
+ * @brief 视频解析错误
1870
+ * @solution 请检查拉流地址是否合法或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
1871
+ *
1872
+ */
1873
+ DEMUX_FMP4_ERROR = 3400,
1874
+ /**
1875
+ * @brief 视频解析错误
1876
+ * @solution 请检查拉流地址是否合法或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
1877
+ *
1878
+ */
1879
+ DEMUX_SIDX_ERROR = 3410,
1880
+ /**
1881
+ * @brief 视频解析错误
1882
+ * @solution 请检查拉流地址是否合法或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
1883
+ *
1884
+ */
1885
+ REMUX_FMP4_ERROR = 4100,
1886
+ /**
1887
+ * @brief 视频解析错误
1888
+ * @solution 请检查拉流地址是否合法或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
1889
+ *
1890
+ */
1891
+ REMUX_MP4_ERROR = 4200,
1892
+ /**
1893
+ * @brief 获取数据过程被中止
1894
+ * @solution 请检查浏览器网络请求是否正常,再尝试重新拉流。
1895
+ */
1896
+ MEDIA_ERR_ABORTED = 5101,
1897
+ /**
1898
+ * @brief 网络发生错误,无法成功获取媒体文件
1899
+ * @solution 请检查浏览器网络请求是否正常,再尝试重新拉流。
1900
+ */
1901
+ MEDIA_ERR_NETWORK = 5102,
1902
+ /**
1903
+ * @brief 浏览器在解码媒体资源时发生错误
1904
+ * @solution
1905
+ * 1. 请检查原始视频是否正常;
1906
+ * 2. 重新进行转码和播放;
1907
+ * 3. 如仍未解决请联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
1908
+ */
1909
+ MEDIA_ERR_DECODE = 5103,
1910
+ /**
1911
+ * @brief 因视频格式不支持、服务器或网络的问题造成视频无法加载
1912
+ * @solution
1913
+ * 1. 检查浏览器视频数据请求是否正常;
1914
+ * 2. 检查浏览器和页面环境是否支持要播放的视频格式;
1915
+ * 3. 如仍未解决请联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
1916
+ */
1917
+ MEDIA_ERR_SRC_NOT_SUPPORTED = 5104,
1918
+ /**
1919
+ * @brief 当前浏览器不支持视频解码
1920
+ * @solution
1921
+ * 1. 检查浏览器视频数据请求是否正常;
1922
+ * 2. 检查浏览器和页面环境是否支持要播放的视频格式;
1923
+ * 3. 如仍未解决请联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
1924
+ */
1925
+ MEDIA_ERR_CODEC_NOT_SUPPORTED = 5105,
1926
+ /**
1927
+ * @brief 当前播放地址为空
1928
+ * @solution 请检查必要参数 `url` 或 `playlist` 是否传入。
1929
+ */
1930
+ MEDIA_ERR_URL_EMPTY = 5106,
1931
+ /**
1932
+ * @brief 播放异常
1933
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
1934
+ */
1935
+ MEDIA_MSE_ADD_SB = 5200,
1936
+ /**
1937
+ * @brief 播放异常
1938
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
1939
+ */
1940
+ MEDIA_MSE_APPEND_BUFFER = 5201,
1941
+ /**
1942
+ * @brief 播放异常
1943
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
1944
+ */
1945
+ MEDIA_MSE_OTHER = 5202,
1946
+ /**
1947
+ * @brief 播放异常
1948
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
1949
+ */
1950
+ MEDIA_MSE_FULL = 5203,
1951
+ /**
1952
+ * @brief 播放异常
1953
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
1954
+ */
1955
+ MEDIA_MSE_HIJACK = 5204,
1956
+ /**
1957
+ * @brief 播放异常
1958
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
1959
+ */
1960
+ MEDIA_EME_HIJACK = 5301,
1961
+ /**
1962
+ * @brief DRM 权限校验失败
1963
+ * @hidden
1964
+ */
1965
+ DRM_LICENSE = 7100,
1966
+ /**
1967
+ * @brief DRM 权限校验失败
1968
+ * @hidden
1969
+ */
1970
+ DRM_CUSTOM_LICENSE = 7200,
1971
+ /**
1972
+ * @brief 播放异常
1973
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
1974
+ */
1975
+ OTHER = 8000,
1976
+ /**
1977
+ * @brief 播放异常
1978
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
1979
+ */
1980
+ RUNTIME_NO_CANPLAY_ERROR = 9001,
1981
+ /**
1982
+ * @brief 播放异常
1983
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
1984
+ */
1985
+ RUNTIME_BUFFERBREAK_ERROR = 9002,
1986
+ /**
1987
+ * @brief 播放异常
1988
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
1989
+ */
1990
+ RUNTIME_BWAITING_TIMEOUT_ERROR = 9002,
1991
+ // veplayer 报错
1992
+ /**
1993
+ * @brief CDN 异步获取失败
1994
+ * @solution 请刷新重试或者检查网络环境。
1995
+ *
1996
+ */
1997
+ MODULE_LOAD_ERROR = 110,
1998
+ /**
1999
+ * @hidden
2000
+ */
2001
+ UNKNOWN = "UNKNOWN"
2002
+ }
2003
+ enum ErrorType {
2004
+ MANIFEST = "manifest",
2005
+ NETWORK = "network",
2006
+ DEMUX = "demux",
2007
+ REMUX = "remux",
2008
+ MEDIA = "media",
2009
+ DRM = "drm",
2010
+ OTHER = "other",
2011
+ RUNTIME = "runtime"
2012
+ }
2013
+ interface ErrorInfo<T = TextKey> {
2014
+ errorCode?: ErrorCode;
2015
+ message?: string;
2016
+ messageTextKey?: T;
2017
+ level?: Level;
2018
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
2019
+ ext?: any;
2020
+ error?: Error;
2021
+ }
2022
+ const ERROR_INFO: Partial<Record<ErrorCode, ErrorInfo>>;
2023
+ const ERROR_TYPE_INFO: Record<ErrorType, ErrorInfo>;
2024
+ /**
2025
+ * @list error
2026
+ * @detail error
2027
+ * @brief 错误对象
2028
+ * @name VeError
2029
+ * @id VeError
2030
+ */
2031
+ class VeError<T extends string = TextKey> extends Error {
2032
+ /**
2033
+ * @brief 错误码,对应[错误码字典](#ErrorCode)。
2034
+ */
2035
+ readonly errorCode: ErrorCode;
2036
+ /**
2037
+ * @brief 错误等级。
2038
+ */
2039
+ readonly level?: Level;
2040
+ /**
2041
+ * @brief 错误信息。
2042
+ */
2043
+ message: string;
2044
+ /**
2045
+ * @brief 其他错误信息。
2046
+ */
2047
+ readonly ext?: any;
2048
+ /**
2049
+ * @hidden
2050
+ * @param error
2051
+ * @param i18n
2052
+ */
2053
+ constructor(error?: string | ErrorInfo<T>, i18n?: VeI18n<T>);
2054
+ }
2055
+ function create(errorCode: ErrorCode, info?: ErrorInfo, i18n?: VeI18n): VeError<"DEFINITION_FALLBACK_TOAST" | "DEFINITION_SWITCHING" | "ERROR_REFRESH" | "UNMUTE" | "MANIFEST" | "NETWORK" | "NETWORK_TIMEOUT" | "NETWORK_FORBIDDEN" | "NETWORK_NOTFOUND" | "DEMUX" | "REMUX" | "MEDIA" | "MEDIA_ERR_CODEC_NOT_SUPPORTED" | "MEDIA_ERR_URL_EMPTY" | "DRM" | "DRM_LICENSE" | "OTHER" | "RUNTIME" | "MODULE_LOAD_ERROR" | "UNKNOWN" | "ERROR_TYPES" | "HAVE_NOTHING" | "HAVE_METADATA" | "HAVE_CURRENT_DATA" | "HAVE_FUTURE_DATA" | "HAVE_ENOUGH_DATA" | "NETWORK_EMPTY" | "NETWORK_IDLE" | "NETWORK_LOADING" | "NETWORK_NO_SOURCE" | "MEDIA_ERR_ABORTED" | "MEDIA_ERR_NETWORK" | "MEDIA_ERR_DECODE" | "MEDIA_ERR_SRC_NOT_SUPPORTED" | "REPLAY" | "ERROR" | "PLAY_TIPS" | "PAUSE_TIPS" | "PLAYNEXT_TIPS" | "DOWNLOAD_TIPS" | "ROTATE_TIPS" | "RELOAD_TIPS" | "FULLSCREEN_TIPS" | "EXITFULLSCREEN_TIPS" | "CSSFULLSCREEN_TIPS" | "EXITCSSFULLSCREEN_TIPS" | "TEXTTRACK" | "PIP" | "SCREENSHOT" | "LIVE" | "OFF" | "OPEN" | "MINI_DRAG" | "MINISCREEN" | "REFRESH_TIPS" | "REFRESH" | "FORWARD" | "LIVE_TIP">;
2056
+ function transform(xgErr: XGError, i18n?: VeI18n): VeError<"DEFINITION_FALLBACK_TOAST" | "DEFINITION_SWITCHING" | "ERROR_REFRESH" | "UNMUTE" | "MANIFEST" | "NETWORK" | "NETWORK_TIMEOUT" | "NETWORK_FORBIDDEN" | "NETWORK_NOTFOUND" | "DEMUX" | "REMUX" | "MEDIA" | "MEDIA_ERR_CODEC_NOT_SUPPORTED" | "MEDIA_ERR_URL_EMPTY" | "DRM" | "DRM_LICENSE" | "OTHER" | "RUNTIME" | "MODULE_LOAD_ERROR" | "UNKNOWN" | "ERROR_TYPES" | "HAVE_NOTHING" | "HAVE_METADATA" | "HAVE_CURRENT_DATA" | "HAVE_FUTURE_DATA" | "HAVE_ENOUGH_DATA" | "NETWORK_EMPTY" | "NETWORK_IDLE" | "NETWORK_LOADING" | "NETWORK_NO_SOURCE" | "MEDIA_ERR_ABORTED" | "MEDIA_ERR_NETWORK" | "MEDIA_ERR_DECODE" | "MEDIA_ERR_SRC_NOT_SUPPORTED" | "REPLAY" | "ERROR" | "PLAY_TIPS" | "PAUSE_TIPS" | "PLAYNEXT_TIPS" | "DOWNLOAD_TIPS" | "ROTATE_TIPS" | "RELOAD_TIPS" | "FULLSCREEN_TIPS" | "EXITFULLSCREEN_TIPS" | "CSSFULLSCREEN_TIPS" | "EXITCSSFULLSCREEN_TIPS" | "TEXTTRACK" | "PIP" | "SCREENSHOT" | "LIVE" | "OFF" | "OPEN" | "MINI_DRAG" | "MINISCREEN" | "REFRESH_TIPS" | "REFRESH" | "FORWARD" | "LIVE_TIP">;
2057
+ /**
2058
+ * @list option
2059
+ * @kind property
2060
+ */
2061
+ type ErrorConfig = {
2062
+ /** {zh}
2063
+ * @brief 是否展示报错图片。
2064
+ * @default true
2065
+ */
2066
+ showErrorImg?: boolean;
2067
+ /** {zh}
2068
+ * @brief 是否展示报错提示。
2069
+ * @default true
2070
+ */
2071
+ showErrorTip?: boolean;
2072
+ /** {zh}
2073
+ * @brief 是否展示刷新按钮。
2074
+ * @default true
2075
+ */
2076
+ showRefresh?: boolean;
2077
+ /** {zh}
2078
+ * @brief 自定义报错显示。
2079
+ * @default 无
2080
+ */
2081
+ errorTipsText?: string | Record<Lang, string>;
2082
+ /** {zh}
2083
+ * @brief 更多提示信息。
2084
+ * @default 无
2085
+ */
2086
+ extraTips?: {
2087
+ label: string | Record<Lang, string>;
2088
+ value: string | Record<Lang, string>;
2089
+ }[];
2090
+ };
2091
+ class Error extends Plugin {
2092
+ player: Player$0;
2093
+ icons: {
2094
+ error: HTMLElement;
2095
+ };
2096
+ langText: {
2097
+ refresh: string;
2098
+ errorTip: string;
2099
+ };
2100
+ config: ErrorConfig;
2101
+ private _error?;
2102
+ static get pluginName(): string;
2103
+ static get defaultConfig(): {
2104
+ showErrorImg: boolean;
2105
+ showErrorTip: boolean;
2106
+ showRefresh: boolean;
2107
+ errorTipsText: string;
2108
+ extraTips: never[];
2109
+ position: string;
2110
+ };
2111
+ get _errorTip(): string;
2112
+ afterCreate(): void;
2113
+ registerIcons(): {
2114
+ error: {
2115
+ icon: any;
2116
+ class: string;
2117
+ };
2118
+ };
2119
+ updateLang(): void;
2120
+ showError(error: VeError | XGError): void;
2121
+ hideError(): void;
2122
+ destroy(): void;
2123
+ render(): string;
2124
+ private _focus;
2125
+ private _initIcons;
2126
+ private _initEvents;
2127
+ private _renderText;
2128
+ private _renderExtraTips;
2129
+ private _handleRefresh;
2130
+ private _renderRefresh;
2131
+ }
2132
+ /**
2133
+ * @list option
2134
+ * @kind property
2135
+ */
2136
+ interface DefinitionConfig {
2137
+ /** {zh}
2138
+ * @brief 等待超时的时间阈值,单位为 ms。等待超过该值,会抛出 `DEFINITION_FALLBACK` 事件,如果 `needFallback` 为 `true` 则会提示清晰度降级。
2139
+ * @default 5000
2140
+ */
2141
+ longWaitingTime?: number;
2142
+ /** {zh}
2143
+ * @brief 是否开启清晰度降级。
2144
+ * @default false
2145
+ */
2146
+ needFallback?: boolean;
2147
+ /** {zh}
2148
+ * @brief 降级顺序,按照数组顺序依次降级,数组中的元素与 playlist 中的 definition 相对应。
2149
+ * @default ['uhd', 'hd', 'sd', 'ld', 'ao']
2150
+ */
2151
+ demotePriority?: string[];
2152
+ }
2153
+ class DefinitionPlugin extends OptionsIcon {
2154
+ langText: Record<string, string>;
2155
+ private _waitingStartTime;
2156
+ private _timer?;
2157
+ private _toastId?;
2158
+ static get pluginName(): string;
2159
+ static get defaultConfig(): {
2160
+ index: number;
2161
+ list: never[];
2162
+ panel: {
2163
+ title: {
2164
+ jp: string;
2165
+ en: string;
2166
+ "zh-cn": string;
2167
+ "zh-hk": string;
2168
+ };
2169
+ };
2170
+ className: string;
2171
+ hidePortrait: boolean;
2172
+ isShowIcon: boolean;
2173
+ longWaitingTime: number;
2174
+ needFallback: boolean;
2175
+ demotePriority: string[];
2176
+ isItemClickHide?: boolean | undefined;
2177
+ listType?: ListType | undefined;
2178
+ renderType?: RenderType | undefined;
2179
+ hideOnSingleOption?: boolean | undefined;
2180
+ isAutoChange?: boolean | undefined;
2181
+ };
2182
+ static get textTips(): {
2183
+ jp: string;
2184
+ en: string;
2185
+ "zh-cn": string;
2186
+ "zh-hk": string;
2187
+ };
2188
+ updateLang(): void;
2189
+ beforeCreate(args: XGPluginOptions): void;
2190
+ afterCreate(): void;
2191
+ registerIcons(): {
2192
+ source: {
2193
+ icon: any;
2194
+ };
2195
+ };
2196
+ renderItemList(): void;
2197
+ onItemClick(_: never, data: {
2198
+ to: Definition & {
2199
+ showText: string;
2200
+ };
2201
+ }): void;
2202
+ fallback(options?: {
2203
+ toast: boolean;
2204
+ }): Promise<void>;
2205
+ private _waiting;
2206
+ private _clearTimer;
2207
+ private _toast;
2208
+ private _getNextDefinition;
2209
+ private _initTimeUpdateEvent;
2210
+ private _showToast;
2211
+ }
2212
+ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
2213
+ /** {zh}
2214
+ * @brief 指定播放器容器 ID,VePlayer 将被插入在该容器中。id 和 el 需至少传入 1 个。如果同时传入,则优先将播放器插入 id 容器中。
2215
+ * @default 'veplayer'
2216
+ */
2217
+ id?: string;
2218
+ /** {zh}
2219
+ * @brief 指定播放器容器元素,VePlayer 将被插入在该容器中。id 和 el 需至少传入 1 个。如果同时传入,则优先将播放器插入 id 容器中。
2220
+ * @default 无
2221
+ */
2222
+ el?: HTMLElement;
2223
+ /** {zh}
2224
+ * @brief 设置播放器宽度,传入 number 类型参数则播放器内部默认添加单位px,传入 string 类型参数则直接赋值给播放器容器 width 样式属性。
2225
+ * @default '100%'
2226
+ */
2227
+ width?: number | string;
2228
+ /** {zh}
2229
+ * @brief 设置播放器高度,传入 number 类型参数则播放器内部默认添加单位px,传入 string 类型参数则直接赋值给播放器容器 height 样式属性。
2230
+ * @default '100%'
2231
+ */
2232
+ height?: number | string;
2233
+ /** {zh}
2234
+ * @brief 为播放器配置直播拉流地址。您可手动拼接或使用地址生成器生成拉流地址,生成方法请参见[生成直播地址](https://www.volcengine.com/docs/6469/107759)。url 和 playList 需至少传入 1 个。
2235
+ * @default 无
2236
+ */
2237
+ url?: string;
2238
+ /** {zh}
2239
+ * @brief 为播放器配置直播拉流地址列表。url 和 playlist 需至少传入 1 个。
2240
+ * @default 无
2241
+ */
2242
+ playlist?: ExposedSource[];
2243
+ /** {zh}
2244
+ * @brief 当存在多个直播线路时,为播放器设置默认直播线路,不传则默认列表第一个。
2245
+ * @default 无
2246
+ */
2247
+ defaultSource?: string;
2248
+ /** {zh}
2249
+ * @brief 为播放器设置默认直播清晰度,不传则默认列表第一个。
2250
+ * @default 无
2251
+ */
2252
+ defaultDefinition?: string;
2253
+ /** {zh}
2254
+ * @brief 为播放器设置备路拉流地址,支持设置多个备路拉流地址,在 `maxFallbackRound` 大于 `0` 时有效。当您使用配置的直播拉流地址拉流失败时,会在直播地址和备路直播地址之间循环拉流,直到拉流成功。
2255
+ * @default 无
2256
+ */
2257
+ fallbackUrls?: string[];
2258
+ /** {zh}
2259
+ * @brief 为播放器设置拉流失败时循环拉流的最大次数。
2260
+ * @default 0
2261
+ */
2262
+ maxFallbackRound?: number;
2263
+ /** {zh}
2264
+ * @brief 为播放器设置解码方式。
2265
+ * @listtip
2266
+ * 开启软解后,播放器会使用浏览器的软件解码器来解码视频流。软解模式具有较高的兼容性,适用于各种设备和浏览器,但依赖设备 CPU,在高分辨率或高码率视频播放时会出现卡顿或延迟。建议在以下场景开启软解:
2267
+ * 1. 部分安卓浏览器中播放器被劫持,部分功能将不可见,可开启软解;
2268
+ * 2. 移动端浏览器不支持 flv 格式,如果需要播放该格式的视频,可开启软解;
2269
+ * 3. 部分浏览器不支持 H.265 编码格式,如果需要播放该编码格式的视频,请开启软解。
2270
+ * @default 'hardware'
2271
+ */
2272
+ decodeType?: DecodeType;
2273
+ /** {zh}
2274
+ * @brief 为播放器设置视频的实际编码格式。如果您在degradation 设置了 `soft-first` 属性(即硬解不支持时降级软解),建议您传入该参数,省去探测实际编码格式的操作。
2275
+ * @default 'h264'
2276
+ */
2277
+ codec?: Codec;
2278
+ /** {zh}
2279
+ * @brief 为播放器设置是否开启 H.265 兼容模式。在 H.265 兼容模式下,播放器会优先使用硬解来解码 H.265 直播流。如果设备或浏览器不支持 H.265 硬解,则自动降级为 H.265 软解。
2280
+ * @default 'soft-first'
2281
+ */
2282
+ degradation?: Degradation | boolean;
2283
+ /** {zh}
2284
+ * @brief 为播放器设置封面图 URL。
2285
+ * @default 无
2286
+ */
2287
+ poster?: string;
2288
+ /** {zh}
2289
+ * @brief 为播放器设置初始显示语言,语言包不存在的情况下默认显示 'en' 语言包 。默认值为 `document.documentElement.getAttribute('lang') || navigator.language || 'zh-cn'`
2290
+ * @default -
2291
+ */
2292
+ lang?: Lang;
2293
+ /** {zh}
2294
+ * @brief 为播放器设置自定义的多语言词典,可设置每个语种的词典,格式为 { texts: { [key: string]: Object; } }。<br>
2295
+ * 例如,{ texts: { 'zh-cn': { PIP: '画中画' }, en: { PIP: 'pip' } }} ,格式请参考[默认词典](https://www.volcengine.com/docs/6469/127529)。
2296
+ * @default 无
2297
+ */
2298
+ i18n?: {
2299
+ texts: Record<Lang, Record<string, string>>;
2300
+ };
2301
+ /** {zh}
2302
+ * @brief 为播放器设置是否自动播放, `muted` 设置为 `true` 为静音自动播放。
2303
+ * @default { muted: true }
2304
+ * @type {{ muted: boolean } | boolean}
2305
+ */
2306
+ autoplay?: {
2307
+ muted?: boolean;
2308
+ } | boolean;
2309
+ /** {zh}
2310
+ * @brief 为播放器设置默认音量,取值范围 [0,1]。
2311
+ * @default 0.6
2312
+ */
2313
+ volume?: number;
2314
+ /** {zh}
2315
+ * @brief 为播放器设置是否显示画中画功能按钮。
2316
+ * - `true`:显示;
2317
+ * - `false`:不显示。
2318
+ * @default false
2319
+ */
2320
+ pip?: boolean;
2321
+ /**{zh}
2322
+ * @brief 为播放器设置是否显示全屏功能按钮,并进行全屏功能设置。
2323
+ * - `true`:显示;
2324
+ * - `false`:不显示。
2325
+ */
2326
+ fullscreen?: boolean | Fullscreen;
2327
+ /** {zh}
2328
+ * @brief 为播放器设置报错信息,支持配置播放异常时,播放器显示的异常文案、图片,以及是否提供刷新按钮等。
2329
+ * @default -
2330
+ */
2331
+ error?: ErrorConfig;
2332
+ /** {zh}
2333
+ * @brief 为播放器设置清晰度的相关配置。
2334
+ * @default -
2335
+ */
2336
+ definition?: DefinitionConfig;
2337
+ /** {zh}
2338
+ * @brief 为播放器设置是否显示控制栏。
2339
+ * - `true`: 显示;
2340
+ * - `false`: 不显示
2341
+ * @default true
2342
+ */
2343
+ controls?: boolean | {
2344
+ [propName: string]: any;
2345
+ };
2346
+ /** {zh}
2347
+ * @brief 为播放器设置**清晰度选择**或**线路选择**时的**选择面板样式**,仅在移动端有效。
2348
+ * @default 'bottom'
2349
+ */
2350
+ listType?: ListType;
2351
+ /** {zh}
2352
+ * @brief 为播放器设置是否启用内联播放模式。playsinline 属性是 HTML5 视频标签的一个属性,用于指定视频是否应在页面文档内播放。
2353
+ * - `true`:启用,表示视频将在页面文档内播放;
2354
+ * - `false`:停用,默认浏览器播放行为。</br>
2355
+ *
2356
+ * 该配置项只在移动端生效,当取值为 true 的时候,会在初始化 video 或 audio 对象的时候,将 playsinline、webkit-playsinline、x5-playsinline 三个属性设置为 true,请参考 [New Policies for iOS](https://webkit.org/blog/6784/new-video-policies-for-ios/) 了解内联模式相关知识。
2357
+ * @listtip
2358
+ * - iOS 10 及以上系统 Safari 浏览器支持配置内联播放模式;
2359
+ * - iOS 10 以下系统 Safari 浏览器不支持配置内联播放模式 ,默认播放即进入系统全屏。
2360
+ * @default true
2361
+ */
2362
+ playsinline?: boolean;
2363
+ /** {zh}
2364
+ * @brief 为播放器设置 video 标签扩展属性,初始化时会设置在 videoElement 或 audioElement 对象上,请参考 [HTMLMediaElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement#properties) 查看其支持的属性配置。
2365
+ * @default 无
2366
+ */
2367
+ videoAttributes?: {
2368
+ [propName: string]: any;
2369
+ };
2370
+ /** {zh}
2371
+ * @brief 为播放器设置是否启用流式布局,启用流式布局后播放器会根据屏幕的宽度进行调整,保持在不同屏幕尺寸上都有良好的显示效果。
2372
+ * - `true`:启用
2373
+ * - `false`:停用
2374
+ * @listtip
2375
+ * 启用流式布局时:
2376
+ * - 如果 `width` 和 `height` 是 `Number` 类型,则按照其数值计算播放器宽高比;
2377
+ * - 如果 `width` 和 `height` 不是 `Number` 类型,默认使用 16:9 比例。
2378
+ * @default false
2379
+ */
2380
+ fluid?: boolean;
2381
+ /** {zh}
2382
+ * @brief 为播放器设置尺寸适配方式,在视频资源初始化之后,根据获取到的 videoWidth 和 videoHeight 值对播放器容器宽高比例进行调整,可选项有:
2383
+ * - `fixed`: 保持容器宽/高,不做适配;
2384
+ * - `fixWidth`: 保持容器宽度,适配高度;
2385
+ * - `fixHeight`: 保持容器高度,适配宽度。
2386
+ *
2387
+ * @default 'fixed'
2388
+ */
2389
+ fitVideoSize?: "fixWidth" | "fixHeight" | "fixed";
2390
+ /** {zh}
2391
+ * @brief 为播放器设置视频画面填充模式,可选项有:
2392
+ * - `fillwidth`: 填充宽度,高度溢出则裁剪高度;
2393
+ * - `fillHeight`: 填充高度,宽度溢出则裁剪宽度;
2394
+ * - `fill`: 拉伸视频以填充容器;
2395
+ * - `cover`: 保持其宽高比的同时填充元素的整个内容框;
2396
+ * - `auto`: 使用浏览器默认的视频画面填充模式。
2397
+ * @default 'auto'
2398
+ */
2399
+ videoFillMode?: "auto" | "fillHeight" | "fillWidth" | "fill" | "cover";
2400
+ /** {zh}
2401
+ * @brief 是否开启画面和控制栏分离模式。设置为开启时,控制栏将会常驻,与视频画面不重叠。
2402
+ * - `true`:开启
2403
+ * - `false`:关闭
2404
+ * @default false
2405
+ */
2406
+ marginControls?: boolean;
2407
+ /** {zh}
2408
+ * @brief 启用微信同层播放。
2409
+ * @default 无
2410
+ */
2411
+ "x5-video-player-type"?: string;
2412
+ /** {zh}
2413
+ * @brief 是否启用微信全屏播放模式。
2414
+ * - `true`:启用
2415
+ * - `false`:停用
2416
+ * @default 无
2417
+ */
2418
+ "x5-video-player-fullscreen"?: boolean;
2419
+ /** {zh}
2420
+ * @brief 微信横竖屏控制,支持如下取值:
2421
+ * - `landscape`:横屏
2422
+ * - `portrait`:竖屏
2423
+ * - `landscape|portrait`:跟随手机自动旋转
2424
+ * @default 无
2425
+ */
2426
+ "x5-video-orientation"?: "landscape" | "portrait" | "landscape|portrait";
2427
+ /** {zh}
2428
+ * @brief 为播放器配置关键点样式。
2429
+ * @default 无
2430
+ * @hidden 直播目前没用到
2431
+ */
2432
+ commonStyle?: CommonStyle;
2433
+ /** {zh}
2434
+ * @brief 自定义插件列表。
2435
+ * @default 无
2436
+ */
2437
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
2438
+ plugins?: any[];
2439
+ /** {zh}
2440
+ * @hidden
2441
+ */
2442
+ preparePlugins?: PreparePlugins;
2443
+ }
2444
+ /**
2445
+ * @list option
2446
+ * @kind property
2447
+ */
2448
+ interface Fullscreen {
2449
+ /** {zh}
2450
+ * @brief 切换全屏时,是否旋转为横屏播放,通常在移动端使用。如果开启横屏播放,切换全屏时,将在竖屏状态下把播放器旋转 90 度,实现横屏效果。该配置优先级高于 useCssFullscreen。
2451
+ * - `true`:使用旋转横屏;
2452
+ * - `false`:不使用旋转横屏。
2453
+ * @default false
2454
+ */
2455
+ rotateFullscreen?: boolean;
2456
+ /** {zh}
2457
+ * @brief 是否使用页面全屏代替系统全屏功能。
2458
+ * - `true`:页面全屏;
2459
+ * - `false`:系统全屏。
2460
+ * @default false
2461
+ */
2462
+ useCssFullscreen?: boolean;
2463
+ /**{zh}
2464
+ * 全屏的时候是否显示右上角返回按钮,通常在移动端开启。
2465
+ * - `true`:显示;
2466
+ * - `false`:不显示。
2467
+ * @default false
2468
+ */
2469
+ needBackIcon?: boolean;
2470
+ }
2471
+ /**
2472
+ * @list option
2473
+ * @kind property
2474
+ * @hidden
2475
+ */
2476
+ interface CommonStyle {
2477
+ /** {zh}
2478
+ * @brief 进度条底色
2479
+ * @default 无
2480
+ */
2481
+ progressColor?: string;
2482
+ /** {zh}
2483
+ * @brief 播放完成部分进度条底色
2484
+ * @default 无
2485
+ */
2486
+ playedColor?: string;
2487
+ /** {zh}
2488
+ * @brief 缓存部分进度条底色
2489
+ * @default 无
2490
+ */
2491
+ cachedColor?: string;
2492
+ /** {zh}
2493
+ * @brief 进度条滑块样式
2494
+ * @default 无
2495
+ */
2496
+ sliderBtnStyle?: {
2497
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
2498
+ [propName: string]: any;
2499
+ };
2500
+ /** {zh}
2501
+ * @brief 音量颜色
2502
+ * @default 无
2503
+ */
2504
+ volumeColor?: string;
2505
+ }
2506
+ type PrepareResult = {
2507
+ options?: Partial<VePlayerBaseOptions>;
2508
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
2509
+ plugins?: any[];
2510
+ };
2511
+ type PreparePlugins = (url: string) => Promise<PrepareResult> | undefined;
2512
+ /**
2513
+ * @detail option
2514
+ * @brief 视频的实际编码格式。如果您在degradation 设置了 SoftFirst 属性(即硬解不支持降级软解),建议您传入该参数,省去探测实际编码格式的操作。
2515
+ */
2516
+ enum Codec {
2517
+ /** {zh}
2518
+ * @brief H.265 编码格式
2519
+ */
2520
+ H265 = "h265",
2521
+ /** {zh}
2522
+ * @brief H.264 编码格式
2523
+ */
2524
+ H264 = "h264"
2525
+ }
2526
+ /**
2527
+ * @detail option
2528
+ * @brief 是否开启 H.265 兼容模式。在 H.265 兼容模式下,播放器会优先使用硬解来解码 H.265 直播流。如果设备或浏览器不支持 H.265 硬解,则自动降级为 H.265 软解。
2529
+ */
2530
+ enum Degradation {
2531
+ /** {zh}
2532
+ * @brief 硬解不支持降级到软解
2533
+ */
2534
+ SoftFirst = "soft-first",
2535
+ /** {zh}
2536
+ * @brief 硬解不支持降级到h264
2537
+ * @hidden
2538
+ */
2539
+ H264First = "h264-first"
2540
+ }
2541
+ /**
2542
+ * @detail option
2543
+ * @brief 解码方式。
2544
+ * @example
2545
+ */
2546
+ enum DecodeType {
2547
+ /** {zh}
2548
+ * @brief 软解
2549
+ */
2550
+ Software = "software",
2551
+ /** {zh}
2552
+ * @brief 硬解
2553
+ */
2554
+ Hardware = "hardware"
2555
+ }
2556
+ /// <reference types="./loader" />
2557
+ const NAME_MAP: {
2558
+ readonly "biz:vod": "veplayer.biz.vod.[env].[ext]";
2559
+ readonly "biz:live": "veplayer.biz.live.[env].[ext]";
2560
+ readonly "plugin:flv": "veplayer.plugin.flv.[env].[ext]";
2561
+ readonly "plugin:mp4": "veplayer.plugin.mp4.[env].[ext]";
2562
+ readonly "plugin:hls": "veplayer.plugin.hls.[env].[ext]";
2563
+ readonly "plugin:shaka": "veplayer.plugin.shaka.[env].[ext]";
2564
+ readonly "plugin:rtm": "veplayer.plugin.rtm.[env].[ext]";
2565
+ readonly "plugin:xgvideo": "veplayer.plugin.xgvideo.[env].[ext]";
2566
+ readonly "plugin:drm": "veplayer.plugin.drm.[env].[ext]";
2567
+ };
2568
+ const enum State {
2569
+ Fetching = 0,
2570
+ Ready = 1,
2571
+ Error = 2
2572
+ }
2573
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
2574
+ type Exports = Record<string, any>;
2575
+ interface Module {
2576
+ src: string;
2577
+ state: State;
2578
+ name: string;
2579
+ exports: Exports;
2580
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
2581
+ error?: any;
2582
+ }
2583
+ type ModuleSystem = "esm" | "umd";
2584
+ interface LoaderOptions {
2585
+ baseUrl: string;
2586
+ }
2587
+ enum DynamicModule {
2588
+ BizVod = "biz:vod",
2589
+ BizLive = "biz:live",
2590
+ PluginFlv = "plugin:flv",
2591
+ PluginMp4 = "plugin:mp4",
2592
+ PluginHls = "plugin:hls",
2593
+ PluginShaka = "plugin:shaka",
2594
+ PluginRtm = "plugin:rtm",
2595
+ PluginXgvideo = "plugin:xgvideo",
2596
+ PluginDrm = "plugin:drm"
2597
+ }
2598
+ type ModulesMap = {
2599
+ [DynamicModule.BizVod]: Exports;
2600
+ [DynamicModule.BizLive]: Exports;
2601
+ [DynamicModule.PluginFlv]: Exports;
2602
+ [DynamicModule.PluginMp4]: Exports;
2603
+ [DynamicModule.PluginHls]: Exports;
2604
+ [DynamicModule.PluginShaka]: Exports;
2605
+ [DynamicModule.PluginRtm]: Exports;
2606
+ [DynamicModule.PluginXgvideo]: Exports;
2607
+ [DynamicModule.PluginDrm]: Exports;
2608
+ };
2609
+ class Loader {
2610
+ readonly modules: Record<string, Module>;
2611
+ readonly mountPromiseMap: Record<string, Promise<Exports>>;
2612
+ private _baseUrl;
2613
+ private _moduleSystem?;
2614
+ constructor(options: LoaderOptions);
2615
+ get baseUrl(): string;
2616
+ get moduleSystem(): ModuleSystem | undefined;
2617
+ setModuleSystem(moduleSystem: ModuleSystem): void;
2618
+ setBaseUrl(url: string): void;
2619
+ load: <T extends DynamicModule>(name: T, src?: string) => Promise<ModulesMap[T]>;
2620
+ registerPlugin: (name: string, exports: Exports) => Exports;
2621
+ register: (exports: Exports[]) => Exports[];
2622
+ private _mount;
2623
+ }
2624
+ const registerPlugin: (name: string, exports: {
2625
+ [x: string]: any;
2626
+ }) => {
2627
+ [x: string]: any;
2628
+ };
2629
+ const register: (exports: {
2630
+ [x: string]: any;
2631
+ }[]) => {
2632
+ [x: string]: any;
2633
+ }[];
2634
+ function setModuleSystem(moduleSystem: ModuleSystem): void;
2635
+ function setBaseUrl(url: string): void;
2636
+ function getBaseUrl(): string;
2637
+ function load<T extends DynamicModule>(name: T, src?: string): Promise<ModulesMap[T]>;
2638
+ interface Strategy<T = VePlayerBaseOptions, R extends keyof ModulesMap = any> {
2639
+ options: Partial<T>;
2640
+ module: R;
2641
+ afterLoad?: (module: ModulesMap[R]) => void;
2642
+ }
2643
+ type StrategyCreator<T, R extends keyof ModulesMap = any> = (options?: T) => Strategy<T, R>;
2644
+ const createFlvMseStrategy: StrategyCreator<VePlayerBaseOptions, DynamicModule.PluginFlv>;
2645
+ const createHlsMseStrategy: StrategyCreator<VePlayerBaseOptions, DynamicModule.PluginHls>;
2646
+ const createSoftDecodeH264Strategy: StrategyCreator<VePlayerBaseOptions, DynamicModule.PluginXgvideo>;
2647
+ const createSoftDecodeH265Strategy: StrategyCreator<VePlayerBaseOptions, DynamicModule.PluginXgvideo>;
2648
+ function getCodec(options: VePlayerBaseOptions): Promise<"unknown" | Codec>;
2649
+ function detectCodec(url: string): Promise<"unknown" | Codec>;
2650
+ function isSoftDecode(options: VePlayerBaseOptions, currentCodec?: Codec | "unknown"): Promise<boolean>;
2651
+ function combineOptions<T = VePlayerBaseOptions>(strategyList: (Strategy<T> | undefined)[]): Partial<T>;
2652
+ const getFlvStrategy: (options: VePlayerBaseOptions) => Promise<{
2653
+ options?: undefined;
2654
+ plugins?: undefined;
2655
+ } | {
2656
+ options: Partial<VePlayerBaseOptions>;
2657
+ plugins: any[];
2658
+ }>;
2659
+ const getHlsStrategy: (options: VePlayerBaseOptions) => Promise<{
2660
+ options?: undefined;
2661
+ plugins?: undefined;
2662
+ } | {
2663
+ options: Partial<VePlayerBaseOptions>;
2664
+ plugins: any[];
2665
+ }>;
2666
+ }
2667
+ declare namespace error {
2668
+ const EN: {
2669
+ DEFINITION_FALLBACK_TOAST: string;
2670
+ DEFINITION_SWITCHING: string;
2671
+ ERROR_REFRESH: string;
2672
+ UNMUTE: string;
2673
+ MANIFEST: string;
2674
+ NETWORK: string;
2675
+ NETWORK_TIMEOUT: string;
2676
+ NETWORK_FORBIDDEN: string;
2677
+ NETWORK_NOTFOUND: string;
2678
+ DEMUX: string;
2679
+ REMUX: string;
2680
+ MEDIA: string;
2681
+ MEDIA_ERR_CODEC_NOT_SUPPORTED: string;
2682
+ MEDIA_ERR_URL_EMPTY: string;
2683
+ DRM: string;
2684
+ DRM_LICENSE: string;
2685
+ OTHER: string;
2686
+ RUNTIME: string;
2687
+ MODULE_LOAD_ERROR: string;
2688
+ UNKNOWN: string;
2689
+ ERROR_TYPES: typeof XG_EN.TEXT.ERROR_TYPES;
2690
+ HAVE_NOTHING: string;
2691
+ HAVE_METADATA: string;
2692
+ HAVE_CURRENT_DATA: string;
2693
+ HAVE_FUTURE_DATA: string;
2694
+ HAVE_ENOUGH_DATA: string;
2695
+ NETWORK_EMPTY: string;
2696
+ NETWORK_IDLE: string;
2697
+ NETWORK_LOADING: string;
2698
+ NETWORK_NO_SOURCE: string;
2699
+ MEDIA_ERR_ABORTED: string;
2700
+ MEDIA_ERR_NETWORK: string;
2701
+ MEDIA_ERR_DECODE: string;
2702
+ MEDIA_ERR_SRC_NOT_SUPPORTED: string;
2703
+ REPLAY: string;
2704
+ ERROR: string;
2705
+ PLAY_TIPS: string;
2706
+ PAUSE_TIPS: string;
2707
+ PLAYNEXT_TIPS: string;
2708
+ DOWNLOAD_TIPS: string;
2709
+ ROTATE_TIPS: string;
2710
+ RELOAD_TIPS: string;
2711
+ FULLSCREEN_TIPS: string;
2712
+ EXITFULLSCREEN_TIPS: string;
2713
+ CSSFULLSCREEN_TIPS: string;
2714
+ EXITCSSFULLSCREEN_TIPS: string;
2715
+ TEXTTRACK: string;
2716
+ PIP: string;
2717
+ SCREENSHOT: string;
2718
+ LIVE: string;
2719
+ OFF: string;
2720
+ OPEN: string;
2721
+ MINI_DRAG: string;
2722
+ MINISCREEN: string;
2723
+ REFRESH_TIPS: string;
2724
+ REFRESH: string;
2725
+ FORWARD: string;
2726
+ LIVE_TIP: string;
2727
+ };
2728
+ const ZH_CN: {
2729
+ DEFINITION_FALLBACK_TOAST: string;
2730
+ DEFINITION_SWITCHING: string;
2731
+ ERROR_REFRESH: string;
2732
+ UNMUTE: string;
2733
+ MANIFEST: string;
2734
+ NETWORK: string;
2735
+ NETWORK_TIMEOUT: string;
2736
+ NETWORK_FORBIDDEN: string;
2737
+ NETWORK_NOTFOUND: string;
2738
+ DEMUX: string;
2739
+ REMUX: string;
2740
+ MEDIA: string;
2741
+ MEDIA_ERR_CODEC_NOT_SUPPORTED: string;
2742
+ MEDIA_ERR_URL_EMPTY: string;
2743
+ DRM: string;
2744
+ DRM_LICENSE: string;
2745
+ OTHER: string;
2746
+ RUNTIME: string;
2747
+ MODULE_LOAD_ERROR: string;
2748
+ UNKNOWN: string;
2749
+ ERROR_TYPES: typeof XG_ZH_CN.TEXT.ERROR_TYPES;
2750
+ HAVE_NOTHING: string;
2751
+ HAVE_METADATA: string;
2752
+ HAVE_CURRENT_DATA: string;
2753
+ HAVE_FUTURE_DATA: string;
2754
+ HAVE_ENOUGH_DATA: string;
2755
+ NETWORK_EMPTY: string;
2756
+ NETWORK_IDLE: string;
2757
+ NETWORK_LOADING: string;
2758
+ NETWORK_NO_SOURCE: string;
2759
+ MEDIA_ERR_ABORTED: string;
2760
+ MEDIA_ERR_NETWORK: string;
2761
+ MEDIA_ERR_DECODE: string;
2762
+ MEDIA_ERR_SRC_NOT_SUPPORTED: string;
2763
+ REPLAY: string;
2764
+ ERROR: string;
2765
+ PLAY_TIPS: string;
2766
+ PAUSE_TIPS: string;
2767
+ PLAYNEXT_TIPS: string;
2768
+ DOWNLOAD_TIPS: string;
2769
+ ROTATE_TIPS: string;
2770
+ RELOAD_TIPS: string;
2771
+ FULLSCREEN_TIPS: string;
2772
+ EXITFULLSCREEN_TIPS: string;
2773
+ CSSFULLSCREEN_TIPS: string;
2774
+ EXITCSSFULLSCREEN_TIPS: string;
2775
+ TEXTTRACK: string;
2776
+ PIP: string;
2777
+ SCREENSHOT: string;
2778
+ LIVE: string;
2779
+ OFF: string;
2780
+ OPEN: string;
2781
+ MINI_DRAG: string;
2782
+ MINISCREEN: string;
2783
+ REFRESH_TIPS: string;
2784
+ REFRESH: string;
2785
+ FORWARD: string;
2786
+ LIVE_TIP: string;
2787
+ };
2788
+ type TextKey = keyof typeof EN;
2789
+ type Lang = "zh-cn" | "zh-hk" | "en" | "jp" | string;
2790
+ class VeI18n<T extends string = TextKey> {
2791
+ private _lang;
2792
+ constructor(config?: {
2793
+ lang?: Lang;
2794
+ i18n?: {
2795
+ texts?: Record<Lang, Record<string, string>>;
2796
+ };
2797
+ });
2798
+ static get langKeys(): string[];
2799
+ static isLangValid(lang: Lang): boolean;
2800
+ static extend(i18nTextList: Array<IXGI18nText>, i18nLangs?: IXGI18n): void;
2801
+ setLang(lang: string): void;
2802
+ getLang(): string;
2803
+ normalize(text?: string | Record<Lang, string>): string;
2804
+ getText(textKey?: T | string): Record<string | T, string>[string | T] | undefined;
2805
+ }
2806
+ /**
2807
+ * @detail error
2808
+ */
2809
+ enum Level {
2810
+ /**
2811
+ * @brief 严重
2812
+ *
2813
+ */
2814
+ Fatal = "Fatal",
2815
+ /**
2816
+ * @brief 报错
2817
+ */
2818
+ Error = "Error"
2819
+ }
2820
+ enum ErrorCode {
2821
+ /**
2822
+ * @brief 视频解析错误
2823
+ * @solution 请联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
2824
+ */
2825
+ MANIFEST_HLS_ERROR = 1100,
2826
+ /**
2827
+ * @brief 视频解析错误
2828
+ * @solution 请联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
2829
+ */
2830
+ MANIFEST_DASH_ERROR = 1200,
2831
+ /**
2832
+ * @brief 网络错误
2833
+ * @solution 请检查当前网络环境或播放地址是否合法。
2834
+ */
2835
+ NETWORK = 2100,
2836
+ /**
2837
+ * @brief 网络请求超时
2838
+ * @solution 请检查拉流地址是否合法。
2839
+ */
2840
+ NETWORK_TIMEOUT = 2101,
2841
+ /**
2842
+ * @brief 网络请求 403
2843
+ * @solution 请检查拉流地址鉴权信息。
2844
+ */
2845
+ NETWORK_FORBIDDEN = 2103,
2846
+ /**
2847
+ * @brief 网络请求 404
2848
+ * @solution 请检查拉流地址是否合法。
2849
+ */
2850
+ NETWORK_NOTFOUND = 2104,
2851
+ /**
2852
+ * @brief 网络请求 206
2853
+ * @solution 请检查拉流地址是否合法。
2854
+ */
2855
+ NETWORK_RANGE_NOT_SATISFIABLE = 2116,
2856
+ /**
2857
+ * @brief 视频解析错误
2858
+ * @solution 请检查拉流地址是否合法或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
2859
+ */
2860
+ DEMUX_FLV_ERROR = 3100,
2861
+ /**
2862
+ * @brief 视频解析错误
2863
+ * @solution 请检查拉流地址是否合法或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
2864
+ */
2865
+ DEMUX_HLS_ERROR = 3200,
2866
+ /**
2867
+ * @brief 视频解析错误
2868
+ * @solution 请检查拉流地址是否合法或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
2869
+ *
2870
+ */
2871
+ DEMUX_MP4_ERROR = 3300,
2872
+ /**
2873
+ * @brief 视频解析错误
2874
+ * @solution 请检查拉流地址是否合法或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
2875
+ *
2876
+ */
2877
+ DEMUX_FMP4_ERROR = 3400,
2878
+ /**
2879
+ * @brief 视频解析错误
2880
+ * @solution 请检查拉流地址是否合法或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
2881
+ *
2882
+ */
2883
+ DEMUX_SIDX_ERROR = 3410,
2884
+ /**
2885
+ * @brief 视频解析错误
2886
+ * @solution 请检查拉流地址是否合法或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
2887
+ *
2888
+ */
2889
+ REMUX_FMP4_ERROR = 4100,
2890
+ /**
2891
+ * @brief 视频解析错误
2892
+ * @solution 请检查拉流地址是否合法或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
2893
+ *
2894
+ */
2895
+ REMUX_MP4_ERROR = 4200,
2896
+ /**
2897
+ * @brief 获取数据过程被中止
2898
+ * @solution 请检查浏览器网络请求是否正常,再尝试重新拉流。
2899
+ */
2900
+ MEDIA_ERR_ABORTED = 5101,
2901
+ /**
2902
+ * @brief 网络发生错误,无法成功获取媒体文件
2903
+ * @solution 请检查浏览器网络请求是否正常,再尝试重新拉流。
2904
+ */
2905
+ MEDIA_ERR_NETWORK = 5102,
2906
+ /**
2907
+ * @brief 浏览器在解码媒体资源时发生错误
2908
+ * @solution
2909
+ * 1. 请检查原始视频是否正常;
2910
+ * 2. 重新进行转码和播放;
2911
+ * 3. 如仍未解决请联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
2912
+ */
2913
+ MEDIA_ERR_DECODE = 5103,
2914
+ /**
2915
+ * @brief 因视频格式不支持、服务器或网络的问题造成视频无法加载
2916
+ * @solution
2917
+ * 1. 检查浏览器视频数据请求是否正常;
2918
+ * 2. 检查浏览器和页面环境是否支持要播放的视频格式;
2919
+ * 3. 如仍未解决请联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
2920
+ */
2921
+ MEDIA_ERR_SRC_NOT_SUPPORTED = 5104,
2922
+ /**
2923
+ * @brief 当前浏览器不支持视频解码
2924
+ * @solution
2925
+ * 1. 检查浏览器视频数据请求是否正常;
2926
+ * 2. 检查浏览器和页面环境是否支持要播放的视频格式;
2927
+ * 3. 如仍未解决请联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
2928
+ */
2929
+ MEDIA_ERR_CODEC_NOT_SUPPORTED = 5105,
2930
+ /**
2931
+ * @brief 当前播放地址为空
2932
+ * @solution 请检查必要参数 `url` 或 `playlist` 是否传入。
2933
+ */
2934
+ MEDIA_ERR_URL_EMPTY = 5106,
2935
+ /**
2936
+ * @brief 播放异常
2937
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
2938
+ */
2939
+ MEDIA_MSE_ADD_SB = 5200,
2940
+ /**
2941
+ * @brief 播放异常
2942
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
2943
+ */
2944
+ MEDIA_MSE_APPEND_BUFFER = 5201,
2945
+ /**
2946
+ * @brief 播放异常
2947
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
2948
+ */
2949
+ MEDIA_MSE_OTHER = 5202,
2950
+ /**
2951
+ * @brief 播放异常
2952
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
2953
+ */
2954
+ MEDIA_MSE_FULL = 5203,
2955
+ /**
2956
+ * @brief 播放异常
2957
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
2958
+ */
2959
+ MEDIA_MSE_HIJACK = 5204,
2960
+ /**
2961
+ * @brief 播放异常
2962
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
2963
+ */
2964
+ MEDIA_EME_HIJACK = 5301,
2965
+ /**
2966
+ * @brief DRM 权限校验失败
2967
+ * @hidden
2968
+ */
2969
+ DRM_LICENSE = 7100,
2970
+ /**
2971
+ * @brief DRM 权限校验失败
2972
+ * @hidden
2973
+ */
2974
+ DRM_CUSTOM_LICENSE = 7200,
2975
+ /**
2976
+ * @brief 播放异常
2977
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
2978
+ */
2979
+ OTHER = 8000,
2980
+ /**
2981
+ * @brief 播放异常
2982
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
2983
+ */
2984
+ RUNTIME_NO_CANPLAY_ERROR = 9001,
2985
+ /**
2986
+ * @brief 播放异常
2987
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
2988
+ */
2989
+ RUNTIME_BUFFERBREAK_ERROR = 9002,
2990
+ /**
2991
+ * @brief 播放异常
2992
+ * @solution 请检查播放源或联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
2993
+ */
2994
+ RUNTIME_BWAITING_TIMEOUT_ERROR = 9002,
2995
+ // veplayer 报错
2996
+ /**
2997
+ * @brief CDN 异步获取失败
2998
+ * @solution 请刷新重试或者检查网络环境。
2999
+ *
3000
+ */
3001
+ MODULE_LOAD_ERROR = 110,
3002
+ /**
3003
+ * @hidden
3004
+ */
3005
+ UNKNOWN = "UNKNOWN"
3006
+ }
3007
+ enum ErrorType {
3008
+ MANIFEST = "manifest",
3009
+ NETWORK = "network",
3010
+ DEMUX = "demux",
3011
+ REMUX = "remux",
3012
+ MEDIA = "media",
3013
+ DRM = "drm",
3014
+ OTHER = "other",
3015
+ RUNTIME = "runtime"
3016
+ }
3017
+ interface ErrorInfo<T = TextKey> {
3018
+ errorCode?: ErrorCode;
3019
+ message?: string;
3020
+ messageTextKey?: T;
3021
+ level?: Level;
3022
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
3023
+ ext?: any;
3024
+ error?: Error;
3025
+ }
3026
+ const ERROR_INFO: Partial<Record<ErrorCode, ErrorInfo>>;
3027
+ const ERROR_TYPE_INFO: Record<ErrorType, ErrorInfo>;
3028
+ /**
3029
+ * @list error
3030
+ * @detail error
3031
+ * @brief 错误对象
3032
+ * @name VeError
3033
+ * @id VeError
3034
+ */
3035
+ class VeError<T extends string = TextKey> extends Error {
3036
+ /**
3037
+ * @brief 错误码,对应[错误码字典](#ErrorCode)。
3038
+ */
3039
+ readonly errorCode: ErrorCode;
3040
+ /**
3041
+ * @brief 错误等级。
3042
+ */
3043
+ readonly level?: Level;
3044
+ /**
3045
+ * @brief 错误信息。
3046
+ */
3047
+ message: string;
3048
+ /**
3049
+ * @brief 其他错误信息。
3050
+ */
3051
+ readonly ext?: any;
3052
+ /**
3053
+ * @hidden
3054
+ * @param error
3055
+ * @param i18n
3056
+ */
3057
+ constructor(error?: string | ErrorInfo<T>, i18n?: VeI18n<T>);
3058
+ }
3059
+ function create(errorCode: ErrorCode, info?: ErrorInfo, i18n?: VeI18n): VeError<"DEFINITION_FALLBACK_TOAST" | "DEFINITION_SWITCHING" | "ERROR_REFRESH" | "UNMUTE" | "MANIFEST" | "NETWORK" | "NETWORK_TIMEOUT" | "NETWORK_FORBIDDEN" | "NETWORK_NOTFOUND" | "DEMUX" | "REMUX" | "MEDIA" | "MEDIA_ERR_CODEC_NOT_SUPPORTED" | "MEDIA_ERR_URL_EMPTY" | "DRM" | "DRM_LICENSE" | "OTHER" | "RUNTIME" | "MODULE_LOAD_ERROR" | "UNKNOWN" | "ERROR_TYPES" | "HAVE_NOTHING" | "HAVE_METADATA" | "HAVE_CURRENT_DATA" | "HAVE_FUTURE_DATA" | "HAVE_ENOUGH_DATA" | "NETWORK_EMPTY" | "NETWORK_IDLE" | "NETWORK_LOADING" | "NETWORK_NO_SOURCE" | "MEDIA_ERR_ABORTED" | "MEDIA_ERR_NETWORK" | "MEDIA_ERR_DECODE" | "MEDIA_ERR_SRC_NOT_SUPPORTED" | "REPLAY" | "ERROR" | "PLAY_TIPS" | "PAUSE_TIPS" | "PLAYNEXT_TIPS" | "DOWNLOAD_TIPS" | "ROTATE_TIPS" | "RELOAD_TIPS" | "FULLSCREEN_TIPS" | "EXITFULLSCREEN_TIPS" | "CSSFULLSCREEN_TIPS" | "EXITCSSFULLSCREEN_TIPS" | "TEXTTRACK" | "PIP" | "SCREENSHOT" | "LIVE" | "OFF" | "OPEN" | "MINI_DRAG" | "MINISCREEN" | "REFRESH_TIPS" | "REFRESH" | "FORWARD" | "LIVE_TIP">;
3060
+ function transform(xgErr: XGError, i18n?: VeI18n): VeError<"DEFINITION_FALLBACK_TOAST" | "DEFINITION_SWITCHING" | "ERROR_REFRESH" | "UNMUTE" | "MANIFEST" | "NETWORK" | "NETWORK_TIMEOUT" | "NETWORK_FORBIDDEN" | "NETWORK_NOTFOUND" | "DEMUX" | "REMUX" | "MEDIA" | "MEDIA_ERR_CODEC_NOT_SUPPORTED" | "MEDIA_ERR_URL_EMPTY" | "DRM" | "DRM_LICENSE" | "OTHER" | "RUNTIME" | "MODULE_LOAD_ERROR" | "UNKNOWN" | "ERROR_TYPES" | "HAVE_NOTHING" | "HAVE_METADATA" | "HAVE_CURRENT_DATA" | "HAVE_FUTURE_DATA" | "HAVE_ENOUGH_DATA" | "NETWORK_EMPTY" | "NETWORK_IDLE" | "NETWORK_LOADING" | "NETWORK_NO_SOURCE" | "MEDIA_ERR_ABORTED" | "MEDIA_ERR_NETWORK" | "MEDIA_ERR_DECODE" | "MEDIA_ERR_SRC_NOT_SUPPORTED" | "REPLAY" | "ERROR" | "PLAY_TIPS" | "PAUSE_TIPS" | "PLAYNEXT_TIPS" | "DOWNLOAD_TIPS" | "ROTATE_TIPS" | "RELOAD_TIPS" | "FULLSCREEN_TIPS" | "EXITFULLSCREEN_TIPS" | "CSSFULLSCREEN_TIPS" | "EXITCSSFULLSCREEN_TIPS" | "TEXTTRACK" | "PIP" | "SCREENSHOT" | "LIVE" | "OFF" | "OPEN" | "MINI_DRAG" | "MINISCREEN" | "REFRESH_TIPS" | "REFRESH" | "FORWARD" | "LIVE_TIP">;
3061
+ }
3062
+ declare namespace event {
3063
+ const BaseEvents: {
3064
+ SEI: string;
3065
+ PLAYER_CREATE_FINISH: string;
3066
+ FALLBACK_ERROR: string;
3067
+ FALLBACK: string;
3068
+ AUTOPLAY_STARTED: string;
3069
+ AUTOPLAY_PREVENTED: string;
3070
+ DOWNLOAD_SPEED_CHANGE: string;
3071
+ FULLSCREEN_CHANGE: string;
3072
+ CSS_FULLSCREEN_CHANGE: string;
3073
+ MINI_STATE_CHANGE: string;
3074
+ DEFINITION_CHANGE: string;
3075
+ BEFORE_DEFINITION_CHANGE: string;
3076
+ AFTER_DEFINITION_CHANGE: string;
3077
+ VIDEO_RESIZE: string;
3078
+ PIP_CHANGE: string;
3079
+ USER_ACTION: string;
3080
+ AUTOPLAY_UNMUTE: string;
3081
+ LONG_WAITING: string;
3082
+ DEFINITION_FALLBACK: string;
3083
+ AUTOPLAY_FAIL: string;
3084
+ AUTOPLAY_SUCCESS: string;
3085
+ ERROR_REFRESH_CLICK: string;
3086
+ SOURCE_CHANGE: string;
3087
+ };
3088
+ const Events: {
3089
+ SEI: string;
3090
+ PLAYER_CREATE_FINISH: string;
3091
+ FALLBACK_ERROR: string;
3092
+ FALLBACK: string;
3093
+ AUTOPLAY_STARTED: string;
3094
+ AUTOPLAY_PREVENTED: string;
3095
+ DOWNLOAD_SPEED_CHANGE: string;
3096
+ FULLSCREEN_CHANGE: string;
3097
+ CSS_FULLSCREEN_CHANGE: string;
3098
+ MINI_STATE_CHANGE: string;
3099
+ DEFINITION_CHANGE: string;
3100
+ BEFORE_DEFINITION_CHANGE: string;
3101
+ AFTER_DEFINITION_CHANGE: string;
3102
+ VIDEO_RESIZE: string;
3103
+ PIP_CHANGE: string;
3104
+ USER_ACTION: string;
3105
+ AUTOPLAY_UNMUTE: string;
3106
+ LONG_WAITING: string;
3107
+ DEFINITION_FALLBACK: string;
3108
+ AUTOPLAY_FAIL: string;
3109
+ AUTOPLAY_SUCCESS: string;
3110
+ ERROR_REFRESH_CLICK: string;
3111
+ SOURCE_CHANGE: string;
3112
+ REPLAY: string;
3113
+ ERROR: string;
3114
+ PLAY: string;
3115
+ PLAYING: string;
3116
+ ENDED: string;
3117
+ PAUSE: string;
3118
+ SEEKING: string;
3119
+ SEEKED: string;
3120
+ TIME_UPDATE: string;
3121
+ WAITING: string;
3122
+ CANPLAY: string;
3123
+ CANPLAY_THROUGH: string;
3124
+ DURATION_CHANGE: string;
3125
+ VOLUME_CHANGE: string;
3126
+ LOADED_DATA: string;
3127
+ LOADED_METADATA: string;
3128
+ RATE_CHANGE: string;
3129
+ PROGRESS: string;
3130
+ LOAD_START: string;
3131
+ EMPTIED: string;
3132
+ STALLED: string;
3133
+ SUSPEND: string;
3134
+ ABORT: string;
3135
+ BUFFER_CHANGE: string;
3136
+ PLAYER_FOCUS: string;
3137
+ PLAYER_BLUR: string;
3138
+ READY: string;
3139
+ URL_NULL: string;
3140
+ COMPLETE: string;
3141
+ DESTROY: string;
3142
+ URL_CHANGE: string;
3143
+ SEI_PARSED: string;
3144
+ RETRY: string;
3145
+ ROTATE: string;
3146
+ SCREEN_SHOT: string;
3147
+ PLAYNEXT: string;
3148
+ SHORTCUT: string;
3149
+ XGLOG: string;
3150
+ RESET: string;
3151
+ SOURCE_ERROR: string;
3152
+ SOURCE_SUCCESS: string;
3153
+ SWITCH_SUBTITLE: string;
3154
+ VIDEO_EVENTS: string;
3155
+ STATS_EVENTS: string;
3156
+ FPS_STUCK: string;
3157
+ };
3158
+ function transform(event: string, callback?: (data?: any) => void): {
3159
+ xgEventName: string;
3160
+ xgCallback: ((...args: any) => void) | undefined;
3161
+ };
3162
+ }
3163
+ interface VodVePlayerOptions {
3164
+ plugins: any[];
3165
+ }
3166
+ declare function createVodPlayer(options?: VodVePlayerOptions): Promise<VePlayerBase>;
3167
+ export { load, register, createVodPlayer };