@volcengine/veplayer 2.8.0-rc.1 → 2.8.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.
@@ -26,6 +26,15 @@ declare const EN: {
26
26
  MEDIA_ERR_URL_EMPTY: string;
27
27
  DRM: string;
28
28
  DRM_LICENSE: string;
29
+ DRM_UNSUPPORTED: string;
30
+ DRM_NO_MEDIA_KEY: string;
31
+ DRM_NO_KEY_SESSION: string;
32
+ DRM_GENERATE_QUEST_FAIL: string;
33
+ DRM_LACK_SERVER_CERTIFICATE_PATH: string;
34
+ DRM_LACK_SERVER_PROCESS_SPC_PATH: string;
35
+ DRM_LICENSE_FAIL: string;
36
+ DRM_KEY_ERROR: string;
37
+ DRM_CERT_FAIL: string;
29
38
  OTHER: string;
30
39
  RUNTIME: string;
31
40
  MODULE_LOAD_ERROR: string;
@@ -154,6 +163,14 @@ interface ExposedDefinition {
154
163
  *
155
164
  */
156
165
  fallbackUrls?: string[];
166
+ /** {zh}
167
+ * @hidden
168
+ * @brief 自定义播放地址类型标识。可用于区分不同来源的播放地址。
169
+ */
170
+ /** {en}
171
+ * @hidden
172
+ * @brief Custom identifier for the playback address type. Can be used to distinguish different stream sources.
173
+ */
157
174
  type?: string;
158
175
  }
159
176
  /** {zh}
@@ -423,7 +440,7 @@ declare enum ErrorCode {
423
440
  */
424
441
  /** {en}
425
442
  * @brief Video parsing error.
426
- * @solution Please contact your [technical support](https://www.byteplus.com/en/support).
443
+ * @solution Please [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
427
444
  */
428
445
  MANIFEST_HLS_ERROR = 1100,
429
446
  /** {zh}
@@ -432,7 +449,7 @@ declare enum ErrorCode {
432
449
  */
433
450
  /** {en}
434
451
  * @brief Video parsing error.
435
- * @solution Please contact your [technical support](https://www.byteplus.com/en/support).
452
+ * @solution Please [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
436
453
  */
437
454
  MANIFEST_DASH_ERROR = 1200,
438
455
  /** {zh}
@@ -486,7 +503,7 @@ declare enum ErrorCode {
486
503
  */
487
504
  /** {en}
488
505
  * @brief Video parsing error.
489
- * @solution Check whether the pull stream address is valid, or contact [technical support](https://www.byteplus.com/en/support).
506
+ * @solution Check whether the pull stream address is valid, or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
490
507
  */
491
508
  DEMUX_FLV_ERROR = 3100,
492
509
  /** {zh}
@@ -495,7 +512,7 @@ declare enum ErrorCode {
495
512
  */
496
513
  /** {en}
497
514
  * @brief Video parsing error.
498
- * @solution Check whether the pull stream address is valid, or contact [technical support](https://www.byteplus.com/en/support).
515
+ * @solution Check whether the pull stream address is valid, or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
499
516
  */
500
517
  DEMUX_HLS_ERROR = 3200,
501
518
  /** {zh}
@@ -505,8 +522,7 @@ declare enum ErrorCode {
505
522
  */
506
523
  /** {en}
507
524
  * @brief Video parsing error.
508
- * @solution Check whether the pull stream address is valid, or contact [technical support](https://www.byteplus.com/en/support).
509
- *
525
+ * @solution Check whether the pull stream address is valid, or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
510
526
  */
511
527
  DEMUX_MP4_ERROR = 3300,
512
528
  /** {zh}
@@ -516,8 +532,7 @@ declare enum ErrorCode {
516
532
  */
517
533
  /** {en}
518
534
  * @brief Video parsing error.
519
- * @solution Check whether the pull stream address is valid, or contact [technical support](https://www.byteplus.com/en/support).
520
- *
535
+ * @solution Check whether the pull stream address is valid, or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
521
536
  */
522
537
  DEMUX_FMP4_ERROR = 3400,
523
538
  /** {zh}
@@ -527,8 +542,7 @@ declare enum ErrorCode {
527
542
  */
528
543
  /** {en}
529
544
  * @brief Video parsing error.
530
- * @solution Check whether the pull stream address is valid, or contact [technical support](https://www.byteplus.com/en/support).
531
- *
545
+ * @solution Check whether the pull stream address is valid, or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
532
546
  */
533
547
  DEMUX_SIDX_ERROR = 3410,
534
548
  /** {zh}
@@ -538,8 +552,7 @@ declare enum ErrorCode {
538
552
  */
539
553
  /** {en}
540
554
  * @brief Video parsing error.
541
- * @solution Check whether the pull stream address is valid, or contact [technical support](https://www.byteplus.com/en/support).
542
- *
555
+ * @solution Check whether the pull stream address is valid, or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
543
556
  */
544
557
  REMUX_FMP4_ERROR = 4100,
545
558
  /** {zh}
@@ -549,8 +562,7 @@ declare enum ErrorCode {
549
562
  */
550
563
  /** {en}
551
564
  * @brief Video parsing error.
552
- * @solution Check whether the pull stream address is valid, or contact [technical support](https://www.byteplus.com/en/support).
553
- *
565
+ * @solution Check whether the pull stream address is valid, or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
554
566
  */
555
567
  REMUX_MP4_ERROR = 4200,
556
568
  /** {zh}
@@ -580,10 +592,9 @@ declare enum ErrorCode {
580
592
  */
581
593
  /** {en}
582
594
  * @brief An error occurred to the browser while decoding the media resources.
583
- * @solution
584
- * 1. Check whether there is any issue with the original video.
585
- * 2. Re-transcode the video and play it again.
586
- * 3. If the error persists, please contact your [technical support](https://www.byteplus.com/en/support).
595
+ * @solution 1. Check whether there is any issue with the original video.
596
+ * 2. Re-transcode the video and play it again.
597
+ * 3. If the error persists, please [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
587
598
  */
588
599
  MEDIA_ERR_DECODE = 5103,
589
600
  /** {zh}
@@ -595,10 +606,9 @@ declare enum ErrorCode {
595
606
  */
596
607
  /** {en}
597
608
  * @brief The video cannot be loaded due to unsupported video format or server or network issues.
598
- * @solution
599
- * 1. Check whether there is any issue with the browser's request.
600
- * 2. Check whether the browser and the current page support the video format.
601
- * 3. If the error persists, please contact your [technical support](https://www.byteplus.com/en/support).
609
+ * @solution 1. Check whether there is any issue with the browser's request.
610
+ * 2. Check whether the browser and the current page support the video format.
611
+ * 3. If the error persists, please [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
602
612
  */
603
613
  MEDIA_ERR_SRC_NOT_SUPPORTED = 5104,
604
614
  /** {zh}
@@ -610,10 +620,9 @@ declare enum ErrorCode {
610
620
  */
611
621
  /** {en}
612
622
  * @brief The current browser does not support video decoding.
613
- * @solution
614
- * 1. Check whether there is any issue with the browser's request.
615
- * 2. Check whether the browser and the current page support the video format.
616
- * 3. If the error persists, please contact your [technical support](https://www.byteplus.com/en/support).
623
+ * @solution 1. Check whether there is any issue with the browser's request.
624
+ * 2. Check whether the browser and the current page support the video format.
625
+ * 3. If the error persists, please [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
617
626
  */
618
627
  MEDIA_ERR_CODEC_NOT_SUPPORTED = 5105,
619
628
  /** {zh}
@@ -631,7 +640,7 @@ declare enum ErrorCode {
631
640
  */
632
641
  /** {en}
633
642
  * @brief A playback issue occurred.
634
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
643
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
635
644
  */
636
645
  MEDIA_MSE_ADD_SB = 5200,
637
646
  /** {zh}
@@ -640,7 +649,7 @@ declare enum ErrorCode {
640
649
  */
641
650
  /** {en}
642
651
  * @brief A playback issue occurred.
643
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
652
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
644
653
  */
645
654
  MEDIA_MSE_APPEND_BUFFER = 5201,
646
655
  /** {zh}
@@ -649,7 +658,7 @@ declare enum ErrorCode {
649
658
  */
650
659
  /** {en}
651
660
  * @brief A playback issue occurred.
652
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
661
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
653
662
  */
654
663
  MEDIA_MSE_OTHER = 5202,
655
664
  /** {zh}
@@ -658,7 +667,7 @@ declare enum ErrorCode {
658
667
  */
659
668
  /** {en}
660
669
  * @brief A playback issue occurred.
661
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
670
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
662
671
  */
663
672
  MEDIA_MSE_FULL = 5203,
664
673
  /** {zh}
@@ -667,7 +676,7 @@ declare enum ErrorCode {
667
676
  */
668
677
  /** {en}
669
678
  * @brief A playback issue occurred.
670
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
679
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
671
680
  */
672
681
  MEDIA_MSE_HIJACK = 5204,
673
682
  /** {zh}
@@ -676,25 +685,92 @@ declare enum ErrorCode {
676
685
  */
677
686
  /** {en}
678
687
  * @brief A playback issue occurred.
679
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
688
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
680
689
  */
681
690
  MEDIA_EME_HIJACK = 5301,
682
691
  /** {zh}
683
692
  * @brief DRM 权限校验失败
684
693
  * @hidden
694
+ * @solution 请检查权限配置,确保播放权限正确。
685
695
  */
686
696
  /** {en}
687
697
  * @brief DRM authentication failed.
688
698
  * @hidden
699
+ * @solution Verify the authentication and ensure proper playback permissions.
689
700
  */
690
701
  DRM_LICENSE = 7100,
702
+ /** {zh}
703
+ * @brief 不支持 DRM 加密播放
704
+ */
705
+ /** {en}
706
+ * @brief DRM encrypted playback is not supported
707
+ */
708
+ DRM_UNSUPPORTED = 7101,
709
+ /** {zh}
710
+ * @brief 视频数据缺少相应 MediaKey
711
+ */
712
+ /** {en}
713
+ * @brief Video data lacks the corresponding MediaKey
714
+ */
715
+ DRM_NO_MEDIA_KEY = 7103,
716
+ /** {zh}
717
+ * @brief 浏览器不支持相应 DRM KeySession
718
+ */
719
+ /** {en}
720
+ * @brief Browser does not support the corresponding DRM KeySession
721
+ */
722
+ DRM_NO_KEY_SESSION = 7104,
723
+ /** {zh}
724
+ * @brief 解密播放错误
725
+ */
726
+ /** {en}
727
+ * @brief Decryption playback error
728
+ */
729
+ DRM_GENERATE_QUEST_FAIL = 7105,
730
+ /** {zh}
731
+ * @brief 缺少 DRM 证书请求链接
732
+ */
733
+ /** {en}
734
+ * @brief Missing DRM certificate request link
735
+ */
736
+ DRM_LACK_SERVER_CERTIFICATE_PATH = 7106,
737
+ /** {zh}
738
+ * @brief 缺少 DRM License 请求链接
739
+ */
740
+ /** {en}
741
+ * @brief Missing DRM License request link
742
+ */
743
+ DRM_LACK_SERVER_PROCESS_SPC_PATH = 7107,
744
+ /** {zh}
745
+ * @brief 请求或更新 License 失败
746
+ */
747
+ /** {en}
748
+ * @brief Request or update License failed
749
+ */
750
+ DRM_LICENSE_FAIL = 7108,
751
+ /** {zh}
752
+ * @brief 解密错误
753
+ */
754
+ /** {en}
755
+ * @brief Decryption error
756
+ */
757
+ DRM_KEY_ERROR = 7109,
758
+ /** {zh}
759
+ * @brief 请求 DRM 证书失败'
760
+ */
761
+ /** {en}
762
+ * @brief Request for DRM certificate failed'
763
+ */
764
+ DRM_CERT_FAIL = 7110,
691
765
  /** {zh}
692
766
  * @brief DRM 权限校验失败
693
767
  * @hidden
768
+ * @solution 请检查自定义 DRM 权限。
694
769
  */
695
770
  /** {en}
696
771
  * @brief DRM authentication failed.
697
772
  * @hidden
773
+ * @solution Please check the custom DRM authentication.
698
774
  */
699
775
  DRM_CUSTOM_LICENSE = 7200,
700
776
  /** {zh}
@@ -703,7 +779,7 @@ declare enum ErrorCode {
703
779
  */
704
780
  /** {en}
705
781
  * @brief A playback issue occurred.
706
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
782
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
707
783
  */
708
784
  OTHER = 8000,
709
785
  /** {zh}
@@ -712,7 +788,7 @@ declare enum ErrorCode {
712
788
  */
713
789
  /** {en}
714
790
  * @brief A playback issue occurred.
715
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
791
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
716
792
  */
717
793
  RUNTIME_NO_CANPLAY_ERROR = 9001,
718
794
  /** {zh}
@@ -721,7 +797,7 @@ declare enum ErrorCode {
721
797
  */
722
798
  /** {en}
723
799
  * @brief A playback issue occurred.
724
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
800
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
725
801
  */
726
802
  RUNTIME_BUFFERBREAK_ERROR = 9002,
727
803
  /** {zh}
@@ -730,9 +806,9 @@ declare enum ErrorCode {
730
806
  */
731
807
  /** {en}
732
808
  * @brief A playback issue occurred.
733
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
809
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
734
810
  */
735
- RUNTIME_BWAITING_TIMEOUT_ERROR = 9002,
811
+ RUNTIME_WAITING_TIMEOUT_ERROR = 9003,
736
812
  // veplayer 报错
737
813
  /** {zh}
738
814
  * @brief CDN 异步获取失败
@@ -747,9 +823,11 @@ declare enum ErrorCode {
747
823
  MODULE_LOAD_ERROR = 110,
748
824
  /** {zh}
749
825
  * @hidden
826
+ * @solution 请重试操作,如仍未解决,请联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
750
827
  */
751
828
  /** {en}
752
829
  * @hidden
830
+ * @solution Please retry the operation. If the issue persists, please [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
753
831
  */
754
832
  UNKNOWN = "UNKNOWN"
755
833
  }
@@ -927,10 +1005,12 @@ declare class Error extends Plugin {
927
1005
  /** {zh}
928
1006
  * @list option
929
1007
  * @kind property
1008
+ * @hidden
930
1009
  */
931
1010
  /** {en}
932
1011
  * @list option
933
1012
  * @kind property
1013
+ * @hidden
934
1014
  */
935
1015
  interface DefinitionConfig {
936
1016
  /** {zh}
@@ -1083,7 +1163,7 @@ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
1083
1163
  /** {en}
1084
1164
  * @brief The URL of the player's cover image.
1085
1165
  */
1086
- poster?: string;
1166
+ poster?: string | Poster;
1087
1167
  /** {zh}
1088
1168
  * @brief 为播放器设置初始显示语言,语言包不存在的情况下默认显示 'en' 语言包 。默认值为 `document.documentElement.getAttribute('lang') || navigator.language || 'zh-cn'`
1089
1169
  */
@@ -1456,8 +1536,7 @@ interface CommonStyle {
1456
1536
  * @brief 缓存部分进度条底色。
1457
1537
  */
1458
1538
  /** {en}
1459
- * @brief
1460
- * @brief The background color of the progress bar for the cached portion of video playback.
1539
+ * @brief The background color of the buffered portion of the progress bar.
1461
1540
  */
1462
1541
  cachedColor?: string;
1463
1542
  /** {zh}
@@ -1478,6 +1557,73 @@ interface CommonStyle {
1478
1557
  */
1479
1558
  volumeColor?: string;
1480
1559
  }
1560
+ /** {zh}
1561
+ * @list option
1562
+ * @kind property
1563
+ */
1564
+ /** {en}
1565
+ * @list option
1566
+ * @kind property
1567
+ */
1568
+ interface Poster {
1569
+ /** {zh}
1570
+ * @brief 封面图 URL 地址。
1571
+ */
1572
+ /** {en}
1573
+ * @brief The URL of the player's cover image.
1574
+ */
1575
+ poster: string;
1576
+ /** {zh}
1577
+ * @brief 是否在播放结束之后显示封面图。
1578
+ * - `true`:播放结束之后显示封面图。
1579
+ * - `false`:播放结束之后不显示封面图。
1580
+ * @default true
1581
+ */
1582
+ /** {en}
1583
+ * @brief Whether to display the cover image after playback ends.
1584
+ * - `true`:display the cover image after playback ends.
1585
+ * - `false`:not display the cover image after playback ends.
1586
+ * @default true
1587
+ */
1588
+ isEndedShow?: boolean;
1589
+ /** {zh}
1590
+ * @brief 是否播放后再隐藏封面图。
1591
+ * - `true`:播放后隐藏,未启播时一直显示封面图。
1592
+ * - `false`:在 `play` 事件触发后隐藏封面图。
1593
+ * @default false
1594
+ */
1595
+ /** {en}
1596
+ * @brief Whether to hide the cover image after `canplay` event.
1597
+ * - `true`:hide the cover image after `canplay` event.
1598
+ * - `false`:hide the cover image after `play` event.
1599
+ * @default false
1600
+ */
1601
+ hideCanplay?: boolean;
1602
+ /** {zh}
1603
+ * @brief 是否一直显示封面图。
1604
+ * @default false
1605
+ * @hidden
1606
+ */
1607
+ /** {}
1608
+ * @hidden
1609
+ */
1610
+ notHidden?: boolean;
1611
+ /** {zh}
1612
+ * @brief 封面图填充方式。取值如下:
1613
+ * - `fixWidth`:宽度方向填充,不会被拉伸压缩。
1614
+ * - `fixHeight`:高度方向填充,不会被拉伸压缩。
1615
+ * - `cover`:完全覆盖容器,多余部分会被裁剪。
1616
+ * - `contain`:完全覆盖,与容器不匹配时会被拉伸压缩。
1617
+ */
1618
+ /** {en}
1619
+ * @brief Cover image fill mode.
1620
+ * - `fixWidth`:Fill the width of the container and crop the height if necessary.
1621
+ * - `fixHeight`:Fill the height of the container and crop the width if necessary.
1622
+ * - `cover`:Fill the entire container while keeping the original aspect ratio.
1623
+ * - `contain`:Stretch the video to fill the container.
1624
+ */
1625
+ fillMode?: "fixWidth" | "fixHeight" | "cover" | "contain";
1626
+ }
1481
1627
  type PrepareResult = {
1482
1628
  options?: Partial<VePlayerBaseOptions>;
1483
1629
  // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -1838,11 +1984,15 @@ declare class VePlayerBase {
1838
1984
  */
1839
1985
  fallbackToFirstDefinition?: boolean;
1840
1986
  /** {zh}
1841
- * @brief 是否无缝切换,true 为无缝切换,false 为非无缝切换。
1987
+ * @brief 是否启用无缝切换。
1988
+ * - `true`:启用无缝切换,保证播放过程中不中断。
1989
+ * - `false`:不启用无缝切换,可能会出现播放中断。
1842
1990
  * @default false
1843
1991
  */
1844
1992
  /** {en}
1845
- * @brief Whether seamless switching or not. True means seamless switching and false means non-seamless switching.
1993
+ * @brief Whether seamless switching is enabled.
1994
+ * - `true`: Enables seamless switching, ensuring no interruption during playback.
1995
+ * - `false`: Disables seamless switching, which may cause interruptions during playback.
1846
1996
  */
1847
1997
  seamless?: boolean;
1848
1998
  }): Promise<ExposedDefinition>;
@@ -1927,7 +2077,7 @@ declare class VePlayerBase {
1927
2077
  */
1928
2078
  on(event: string, callback: (data?: any) => any): void;
1929
2079
  /** {zh}
1930
- * @brief 调用此方法开始播放 。
2080
+ * @brief 调用此方法开始播放。
1931
2081
  */
1932
2082
  /** {en}
1933
2083
  * @brief Starts playback.
@@ -1971,20 +2121,24 @@ declare class VePlayerBase {
1971
2121
  */
1972
2122
  focus(data?: {
1973
2123
  /** {zh}
1974
- * @brief 是否需要自动失焦,默认为 true,即经过 delay 时长之后,会自动调用 blur() 进行失焦。
2124
+ * @brief 是否需要自动失焦。
2125
+ * - `true`:启用自动失焦,经过指定的延迟时间后,自动调用 `blur()` 方法进行失焦。
2126
+ * - `false`:禁用自动失焦,不会在延迟时间后自动调用 `blur()` 方法。
1975
2127
  * @default true
1976
2128
  */
1977
2129
  /** {en}
1978
- * @brief Whether to turn on automatic hide, that is, after the duration specified by `delay`, the `blur` method will be automatically called so that the player loses focus. The default is `true`.
2130
+ * @brief Whether auto-blur is enabled.
2131
+ * - `true`: Enables auto-blur, meaning `blur()` will be automatically called after the specified delay time.
2132
+ * - `false`: Disables auto-blur, meaning `blur()` will not be automatically called after the delay.
1979
2133
  * @default true
1980
2134
  */
1981
2135
  autoHide?: boolean;
1982
2136
  /** {zh}
1983
- * @brief 自动失焦延迟时长,单位ms,autoHide 为 true 时生效。
2137
+ * @brief 自动失焦的延迟时间,单位为毫秒。在 `autoHide``true` 时生效。
1984
2138
  * @default 3000
1985
2139
  */
1986
2140
  /** {en}
1987
- * @brief The duration after which the player automatically loses focus, in milliseconds. This parameter takes effect when `autoHide` is `true`.
2141
+ * @brief Delay duration (in milliseconds) before auto-blur is triggered. This takes effect only when `autoHide` is set to `true`.
1988
2142
  * @default 3000
1989
2143
  */
1990
2144
  delay?: number;
@@ -1999,11 +2153,11 @@ declare class VePlayerBase {
1999
2153
  */
2000
2154
  blur(data?: {
2001
2155
  /** {zh}
2002
- * @brief 播放器失焦是否忽略暂停状态,默认值是 true,即默认暂停的时候不取消播放器焦点状态。
2156
+ * @brief 播放器在暂停时是否保留焦点状态。默认值为 `true`,即播放器暂停时不会自动失焦。
2003
2157
  * @default false
2004
2158
  */
2005
2159
  /** {en}
2006
- * @brief Whether to ignore the pause state. The default value is `true`, which means the player will not lose focus when the playback is paused.
2160
+ * @brief Whether the player retains focus when paused. The default is `true`, meaning the player will not automatically lose focus during pause.
2007
2161
  * @default false
2008
2162
  */
2009
2163
  ignorePaused?: boolean;
@@ -2163,6 +2317,7 @@ declare enum DynamicModule {
2163
2317
  PluginMp4 = "plugin:mp4",
2164
2318
  PluginHls = "plugin:hls",
2165
2319
  PluginHlsJs = "plugin:hlsjs",
2320
+ PluginDashJs = "plugin:dashjs",
2166
2321
  PluginShaka = "plugin:shaka",
2167
2322
  PluginRtm = "plugin:rtm",
2168
2323
  PluginXgvideo = "plugin:xgvideo",
@@ -2178,6 +2333,7 @@ type ModulesMap = {
2178
2333
  [DynamicModule.PluginMp4]: Exports;
2179
2334
  [DynamicModule.PluginHls]: Exports;
2180
2335
  [DynamicModule.PluginHlsJs]: Exports;
2336
+ [DynamicModule.PluginDashJs]: Exports;
2181
2337
  [DynamicModule.PluginShaka]: Exports;
2182
2338
  [DynamicModule.PluginRtm]: Exports;
2183
2339
  [DynamicModule.PluginXgvideo]: Exports;
@@ -2213,6 +2369,15 @@ declare namespace strategy {
2213
2369
  MEDIA_ERR_URL_EMPTY: string;
2214
2370
  DRM: string;
2215
2371
  DRM_LICENSE: string;
2372
+ DRM_UNSUPPORTED: string;
2373
+ DRM_NO_MEDIA_KEY: string;
2374
+ DRM_NO_KEY_SESSION: string;
2375
+ DRM_GENERATE_QUEST_FAIL: string;
2376
+ DRM_LACK_SERVER_CERTIFICATE_PATH: string;
2377
+ DRM_LACK_SERVER_PROCESS_SPC_PATH: string;
2378
+ DRM_LICENSE_FAIL: string;
2379
+ DRM_KEY_ERROR: string;
2380
+ DRM_CERT_FAIL: string;
2216
2381
  OTHER: string;
2217
2382
  RUNTIME: string;
2218
2383
  MODULE_LOAD_ERROR: string;
@@ -2273,6 +2438,15 @@ declare namespace strategy {
2273
2438
  MEDIA_ERR_URL_EMPTY: string;
2274
2439
  DRM: string;
2275
2440
  DRM_LICENSE: string;
2441
+ DRM_UNSUPPORTED: string;
2442
+ DRM_NO_MEDIA_KEY: string;
2443
+ DRM_NO_KEY_SESSION: string;
2444
+ DRM_GENERATE_QUEST_FAIL: string;
2445
+ DRM_LACK_SERVER_CERTIFICATE_PATH: string;
2446
+ DRM_LACK_SERVER_PROCESS_SPC_PATH: string;
2447
+ DRM_LICENSE_FAIL: string;
2448
+ DRM_KEY_ERROR: string;
2449
+ DRM_CERT_FAIL: string;
2276
2450
  OTHER: string;
2277
2451
  RUNTIME: string;
2278
2452
  MODULE_LOAD_ERROR: string;
@@ -2402,6 +2576,14 @@ declare namespace strategy {
2402
2576
  *
2403
2577
  */
2404
2578
  fallbackUrls?: string[];
2579
+ /** {zh}
2580
+ * @hidden
2581
+ * @brief 自定义播放地址类型标识。可用于区分不同来源的播放地址。
2582
+ */
2583
+ /** {en}
2584
+ * @hidden
2585
+ * @brief Custom identifier for the playback address type. Can be used to distinguish different stream sources.
2586
+ */
2405
2587
  type?: string;
2406
2588
  }
2407
2589
  /** {zh}
@@ -2668,7 +2850,7 @@ declare namespace strategy {
2668
2850
  */
2669
2851
  /** {en}
2670
2852
  * @brief Video parsing error.
2671
- * @solution Please contact your [technical support](https://www.byteplus.com/en/support).
2853
+ * @solution Please [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
2672
2854
  */
2673
2855
  MANIFEST_HLS_ERROR = 1100,
2674
2856
  /** {zh}
@@ -2677,7 +2859,7 @@ declare namespace strategy {
2677
2859
  */
2678
2860
  /** {en}
2679
2861
  * @brief Video parsing error.
2680
- * @solution Please contact your [technical support](https://www.byteplus.com/en/support).
2862
+ * @solution Please [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
2681
2863
  */
2682
2864
  MANIFEST_DASH_ERROR = 1200,
2683
2865
  /** {zh}
@@ -2731,7 +2913,7 @@ declare namespace strategy {
2731
2913
  */
2732
2914
  /** {en}
2733
2915
  * @brief Video parsing error.
2734
- * @solution Check whether the pull stream address is valid, or contact [technical support](https://www.byteplus.com/en/support).
2916
+ * @solution Check whether the pull stream address is valid, or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
2735
2917
  */
2736
2918
  DEMUX_FLV_ERROR = 3100,
2737
2919
  /** {zh}
@@ -2740,7 +2922,7 @@ declare namespace strategy {
2740
2922
  */
2741
2923
  /** {en}
2742
2924
  * @brief Video parsing error.
2743
- * @solution Check whether the pull stream address is valid, or contact [technical support](https://www.byteplus.com/en/support).
2925
+ * @solution Check whether the pull stream address is valid, or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
2744
2926
  */
2745
2927
  DEMUX_HLS_ERROR = 3200,
2746
2928
  /** {zh}
@@ -2750,8 +2932,7 @@ declare namespace strategy {
2750
2932
  */
2751
2933
  /** {en}
2752
2934
  * @brief Video parsing error.
2753
- * @solution Check whether the pull stream address is valid, or contact [technical support](https://www.byteplus.com/en/support).
2754
- *
2935
+ * @solution Check whether the pull stream address is valid, or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
2755
2936
  */
2756
2937
  DEMUX_MP4_ERROR = 3300,
2757
2938
  /** {zh}
@@ -2761,8 +2942,7 @@ declare namespace strategy {
2761
2942
  */
2762
2943
  /** {en}
2763
2944
  * @brief Video parsing error.
2764
- * @solution Check whether the pull stream address is valid, or contact [technical support](https://www.byteplus.com/en/support).
2765
- *
2945
+ * @solution Check whether the pull stream address is valid, or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
2766
2946
  */
2767
2947
  DEMUX_FMP4_ERROR = 3400,
2768
2948
  /** {zh}
@@ -2772,8 +2952,7 @@ declare namespace strategy {
2772
2952
  */
2773
2953
  /** {en}
2774
2954
  * @brief Video parsing error.
2775
- * @solution Check whether the pull stream address is valid, or contact [technical support](https://www.byteplus.com/en/support).
2776
- *
2955
+ * @solution Check whether the pull stream address is valid, or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
2777
2956
  */
2778
2957
  DEMUX_SIDX_ERROR = 3410,
2779
2958
  /** {zh}
@@ -2783,8 +2962,7 @@ declare namespace strategy {
2783
2962
  */
2784
2963
  /** {en}
2785
2964
  * @brief Video parsing error.
2786
- * @solution Check whether the pull stream address is valid, or contact [technical support](https://www.byteplus.com/en/support).
2787
- *
2965
+ * @solution Check whether the pull stream address is valid, or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
2788
2966
  */
2789
2967
  REMUX_FMP4_ERROR = 4100,
2790
2968
  /** {zh}
@@ -2794,8 +2972,7 @@ declare namespace strategy {
2794
2972
  */
2795
2973
  /** {en}
2796
2974
  * @brief Video parsing error.
2797
- * @solution Check whether the pull stream address is valid, or contact [technical support](https://www.byteplus.com/en/support).
2798
- *
2975
+ * @solution Check whether the pull stream address is valid, or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
2799
2976
  */
2800
2977
  REMUX_MP4_ERROR = 4200,
2801
2978
  /** {zh}
@@ -2825,10 +3002,9 @@ declare namespace strategy {
2825
3002
  */
2826
3003
  /** {en}
2827
3004
  * @brief An error occurred to the browser while decoding the media resources.
2828
- * @solution
2829
- * 1. Check whether there is any issue with the original video.
2830
- * 2. Re-transcode the video and play it again.
2831
- * 3. If the error persists, please contact your [technical support](https://www.byteplus.com/en/support).
3005
+ * @solution 1. Check whether there is any issue with the original video.
3006
+ * 2. Re-transcode the video and play it again.
3007
+ * 3. If the error persists, please [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
2832
3008
  */
2833
3009
  MEDIA_ERR_DECODE = 5103,
2834
3010
  /** {zh}
@@ -2840,10 +3016,9 @@ declare namespace strategy {
2840
3016
  */
2841
3017
  /** {en}
2842
3018
  * @brief The video cannot be loaded due to unsupported video format or server or network issues.
2843
- * @solution
2844
- * 1. Check whether there is any issue with the browser's request.
2845
- * 2. Check whether the browser and the current page support the video format.
2846
- * 3. If the error persists, please contact your [technical support](https://www.byteplus.com/en/support).
3019
+ * @solution 1. Check whether there is any issue with the browser's request.
3020
+ * 2. Check whether the browser and the current page support the video format.
3021
+ * 3. If the error persists, please [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
2847
3022
  */
2848
3023
  MEDIA_ERR_SRC_NOT_SUPPORTED = 5104,
2849
3024
  /** {zh}
@@ -2855,10 +3030,9 @@ declare namespace strategy {
2855
3030
  */
2856
3031
  /** {en}
2857
3032
  * @brief The current browser does not support video decoding.
2858
- * @solution
2859
- * 1. Check whether there is any issue with the browser's request.
2860
- * 2. Check whether the browser and the current page support the video format.
2861
- * 3. If the error persists, please contact your [technical support](https://www.byteplus.com/en/support).
3033
+ * @solution 1. Check whether there is any issue with the browser's request.
3034
+ * 2. Check whether the browser and the current page support the video format.
3035
+ * 3. If the error persists, please [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
2862
3036
  */
2863
3037
  MEDIA_ERR_CODEC_NOT_SUPPORTED = 5105,
2864
3038
  /** {zh}
@@ -2876,7 +3050,7 @@ declare namespace strategy {
2876
3050
  */
2877
3051
  /** {en}
2878
3052
  * @brief A playback issue occurred.
2879
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
3053
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
2880
3054
  */
2881
3055
  MEDIA_MSE_ADD_SB = 5200,
2882
3056
  /** {zh}
@@ -2885,7 +3059,7 @@ declare namespace strategy {
2885
3059
  */
2886
3060
  /** {en}
2887
3061
  * @brief A playback issue occurred.
2888
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
3062
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
2889
3063
  */
2890
3064
  MEDIA_MSE_APPEND_BUFFER = 5201,
2891
3065
  /** {zh}
@@ -2894,7 +3068,7 @@ declare namespace strategy {
2894
3068
  */
2895
3069
  /** {en}
2896
3070
  * @brief A playback issue occurred.
2897
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
3071
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
2898
3072
  */
2899
3073
  MEDIA_MSE_OTHER = 5202,
2900
3074
  /** {zh}
@@ -2903,7 +3077,7 @@ declare namespace strategy {
2903
3077
  */
2904
3078
  /** {en}
2905
3079
  * @brief A playback issue occurred.
2906
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
3080
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
2907
3081
  */
2908
3082
  MEDIA_MSE_FULL = 5203,
2909
3083
  /** {zh}
@@ -2912,7 +3086,7 @@ declare namespace strategy {
2912
3086
  */
2913
3087
  /** {en}
2914
3088
  * @brief A playback issue occurred.
2915
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
3089
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
2916
3090
  */
2917
3091
  MEDIA_MSE_HIJACK = 5204,
2918
3092
  /** {zh}
@@ -2921,25 +3095,92 @@ declare namespace strategy {
2921
3095
  */
2922
3096
  /** {en}
2923
3097
  * @brief A playback issue occurred.
2924
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
3098
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
2925
3099
  */
2926
3100
  MEDIA_EME_HIJACK = 5301,
2927
3101
  /** {zh}
2928
3102
  * @brief DRM 权限校验失败
2929
3103
  * @hidden
3104
+ * @solution 请检查权限配置,确保播放权限正确。
2930
3105
  */
2931
3106
  /** {en}
2932
3107
  * @brief DRM authentication failed.
2933
3108
  * @hidden
3109
+ * @solution Verify the authentication and ensure proper playback permissions.
2934
3110
  */
2935
3111
  DRM_LICENSE = 7100,
3112
+ /** {zh}
3113
+ * @brief 不支持 DRM 加密播放
3114
+ */
3115
+ /** {en}
3116
+ * @brief DRM encrypted playback is not supported
3117
+ */
3118
+ DRM_UNSUPPORTED = 7101,
3119
+ /** {zh}
3120
+ * @brief 视频数据缺少相应 MediaKey
3121
+ */
3122
+ /** {en}
3123
+ * @brief Video data lacks the corresponding MediaKey
3124
+ */
3125
+ DRM_NO_MEDIA_KEY = 7103,
3126
+ /** {zh}
3127
+ * @brief 浏览器不支持相应 DRM KeySession
3128
+ */
3129
+ /** {en}
3130
+ * @brief Browser does not support the corresponding DRM KeySession
3131
+ */
3132
+ DRM_NO_KEY_SESSION = 7104,
3133
+ /** {zh}
3134
+ * @brief 解密播放错误
3135
+ */
3136
+ /** {en}
3137
+ * @brief Decryption playback error
3138
+ */
3139
+ DRM_GENERATE_QUEST_FAIL = 7105,
3140
+ /** {zh}
3141
+ * @brief 缺少 DRM 证书请求链接
3142
+ */
3143
+ /** {en}
3144
+ * @brief Missing DRM certificate request link
3145
+ */
3146
+ DRM_LACK_SERVER_CERTIFICATE_PATH = 7106,
3147
+ /** {zh}
3148
+ * @brief 缺少 DRM License 请求链接
3149
+ */
3150
+ /** {en}
3151
+ * @brief Missing DRM License request link
3152
+ */
3153
+ DRM_LACK_SERVER_PROCESS_SPC_PATH = 7107,
3154
+ /** {zh}
3155
+ * @brief 请求或更新 License 失败
3156
+ */
3157
+ /** {en}
3158
+ * @brief Request or update License failed
3159
+ */
3160
+ DRM_LICENSE_FAIL = 7108,
3161
+ /** {zh}
3162
+ * @brief 解密错误
3163
+ */
3164
+ /** {en}
3165
+ * @brief Decryption error
3166
+ */
3167
+ DRM_KEY_ERROR = 7109,
3168
+ /** {zh}
3169
+ * @brief 请求 DRM 证书失败'
3170
+ */
3171
+ /** {en}
3172
+ * @brief Request for DRM certificate failed'
3173
+ */
3174
+ DRM_CERT_FAIL = 7110,
2936
3175
  /** {zh}
2937
3176
  * @brief DRM 权限校验失败
2938
3177
  * @hidden
3178
+ * @solution 请检查自定义 DRM 权限。
2939
3179
  */
2940
3180
  /** {en}
2941
3181
  * @brief DRM authentication failed.
2942
3182
  * @hidden
3183
+ * @solution Please check the custom DRM authentication.
2943
3184
  */
2944
3185
  DRM_CUSTOM_LICENSE = 7200,
2945
3186
  /** {zh}
@@ -2948,7 +3189,7 @@ declare namespace strategy {
2948
3189
  */
2949
3190
  /** {en}
2950
3191
  * @brief A playback issue occurred.
2951
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
3192
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
2952
3193
  */
2953
3194
  OTHER = 8000,
2954
3195
  /** {zh}
@@ -2957,7 +3198,7 @@ declare namespace strategy {
2957
3198
  */
2958
3199
  /** {en}
2959
3200
  * @brief A playback issue occurred.
2960
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
3201
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
2961
3202
  */
2962
3203
  RUNTIME_NO_CANPLAY_ERROR = 9001,
2963
3204
  /** {zh}
@@ -2966,7 +3207,7 @@ declare namespace strategy {
2966
3207
  */
2967
3208
  /** {en}
2968
3209
  * @brief A playback issue occurred.
2969
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
3210
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
2970
3211
  */
2971
3212
  RUNTIME_BUFFERBREAK_ERROR = 9002,
2972
3213
  /** {zh}
@@ -2975,9 +3216,9 @@ declare namespace strategy {
2975
3216
  */
2976
3217
  /** {en}
2977
3218
  * @brief A playback issue occurred.
2978
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
3219
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
2979
3220
  */
2980
- RUNTIME_BWAITING_TIMEOUT_ERROR = 9002,
3221
+ RUNTIME_WAITING_TIMEOUT_ERROR = 9003,
2981
3222
  // veplayer 报错
2982
3223
  /** {zh}
2983
3224
  * @brief CDN 异步获取失败
@@ -2992,9 +3233,11 @@ declare namespace strategy {
2992
3233
  MODULE_LOAD_ERROR = 110,
2993
3234
  /** {zh}
2994
3235
  * @hidden
3236
+ * @solution 请重试操作,如仍未解决,请联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
2995
3237
  */
2996
3238
  /** {en}
2997
3239
  * @hidden
3240
+ * @solution Please retry the operation. If the issue persists, please [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
2998
3241
  */
2999
3242
  UNKNOWN = "UNKNOWN"
3000
3243
  }
@@ -3074,8 +3317,8 @@ declare namespace strategy {
3074
3317
  */
3075
3318
  constructor(error?: string | ErrorInfo<T>, i18n?: VeI18n<T>);
3076
3319
  }
3077
- 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">;
3078
- 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">;
3320
+ 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" | "DRM_UNSUPPORTED" | "DRM_NO_MEDIA_KEY" | "DRM_NO_KEY_SESSION" | "DRM_GENERATE_QUEST_FAIL" | "DRM_LACK_SERVER_CERTIFICATE_PATH" | "DRM_LACK_SERVER_PROCESS_SPC_PATH" | "DRM_LICENSE_FAIL" | "DRM_KEY_ERROR" | "DRM_CERT_FAIL" | "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">;
3321
+ 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" | "DRM_UNSUPPORTED" | "DRM_NO_MEDIA_KEY" | "DRM_NO_KEY_SESSION" | "DRM_GENERATE_QUEST_FAIL" | "DRM_LACK_SERVER_CERTIFICATE_PATH" | "DRM_LACK_SERVER_PROCESS_SPC_PATH" | "DRM_LICENSE_FAIL" | "DRM_KEY_ERROR" | "DRM_CERT_FAIL" | "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">;
3079
3322
  /** {zh}
3080
3323
  * @list option
3081
3324
  * @kind property
@@ -3176,10 +3419,12 @@ declare namespace strategy {
3176
3419
  /** {zh}
3177
3420
  * @list option
3178
3421
  * @kind property
3422
+ * @hidden
3179
3423
  */
3180
3424
  /** {en}
3181
3425
  * @list option
3182
3426
  * @kind property
3427
+ * @hidden
3183
3428
  */
3184
3429
  interface DefinitionConfig {
3185
3430
  /** {zh}
@@ -3391,7 +3636,7 @@ declare namespace strategy {
3391
3636
  /** {en}
3392
3637
  * @brief The URL of the player's cover image.
3393
3638
  */
3394
- poster?: string;
3639
+ poster?: string | Poster;
3395
3640
  /** {zh}
3396
3641
  * @brief 为播放器设置初始显示语言,语言包不存在的情况下默认显示 'en' 语言包 。默认值为 `document.documentElement.getAttribute('lang') || navigator.language || 'zh-cn'`
3397
3642
  */
@@ -3764,8 +4009,7 @@ declare namespace strategy {
3764
4009
  * @brief 缓存部分进度条底色。
3765
4010
  */
3766
4011
  /** {en}
3767
- * @brief
3768
- * @brief The background color of the progress bar for the cached portion of video playback.
4012
+ * @brief The background color of the buffered portion of the progress bar.
3769
4013
  */
3770
4014
  cachedColor?: string;
3771
4015
  /** {zh}
@@ -3786,6 +4030,73 @@ declare namespace strategy {
3786
4030
  */
3787
4031
  volumeColor?: string;
3788
4032
  }
4033
+ /** {zh}
4034
+ * @list option
4035
+ * @kind property
4036
+ */
4037
+ /** {en}
4038
+ * @list option
4039
+ * @kind property
4040
+ */
4041
+ interface Poster {
4042
+ /** {zh}
4043
+ * @brief 封面图 URL 地址。
4044
+ */
4045
+ /** {en}
4046
+ * @brief The URL of the player's cover image.
4047
+ */
4048
+ poster: string;
4049
+ /** {zh}
4050
+ * @brief 是否在播放结束之后显示封面图。
4051
+ * - `true`:播放结束之后显示封面图。
4052
+ * - `false`:播放结束之后不显示封面图。
4053
+ * @default true
4054
+ */
4055
+ /** {en}
4056
+ * @brief Whether to display the cover image after playback ends.
4057
+ * - `true`:display the cover image after playback ends.
4058
+ * - `false`:not display the cover image after playback ends.
4059
+ * @default true
4060
+ */
4061
+ isEndedShow?: boolean;
4062
+ /** {zh}
4063
+ * @brief 是否播放后再隐藏封面图。
4064
+ * - `true`:播放后隐藏,未启播时一直显示封面图。
4065
+ * - `false`:在 `play` 事件触发后隐藏封面图。
4066
+ * @default false
4067
+ */
4068
+ /** {en}
4069
+ * @brief Whether to hide the cover image after `canplay` event.
4070
+ * - `true`:hide the cover image after `canplay` event.
4071
+ * - `false`:hide the cover image after `play` event.
4072
+ * @default false
4073
+ */
4074
+ hideCanplay?: boolean;
4075
+ /** {zh}
4076
+ * @brief 是否一直显示封面图。
4077
+ * @default false
4078
+ * @hidden
4079
+ */
4080
+ /** {}
4081
+ * @hidden
4082
+ */
4083
+ notHidden?: boolean;
4084
+ /** {zh}
4085
+ * @brief 封面图填充方式。取值如下:
4086
+ * - `fixWidth`:宽度方向填充,不会被拉伸压缩。
4087
+ * - `fixHeight`:高度方向填充,不会被拉伸压缩。
4088
+ * - `cover`:完全覆盖容器,多余部分会被裁剪。
4089
+ * - `contain`:完全覆盖,与容器不匹配时会被拉伸压缩。
4090
+ */
4091
+ /** {en}
4092
+ * @brief Cover image fill mode.
4093
+ * - `fixWidth`:Fill the width of the container and crop the height if necessary.
4094
+ * - `fixHeight`:Fill the height of the container and crop the width if necessary.
4095
+ * - `cover`:Fill the entire container while keeping the original aspect ratio.
4096
+ * - `contain`:Stretch the video to fill the container.
4097
+ */
4098
+ fillMode?: "fixWidth" | "fixHeight" | "cover" | "contain";
4099
+ }
3789
4100
  type PrepareResult = {
3790
4101
  options?: Partial<VePlayerBaseOptions>;
3791
4102
  // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -3878,6 +4189,7 @@ declare namespace strategy {
3878
4189
  readonly "plugin:mp4": "veplayer.plugin.mp4.[env].[ext]";
3879
4190
  readonly "plugin:hls": "veplayer.plugin.hls.[env].[ext]";
3880
4191
  readonly "plugin:hlsjs": "veplayer.plugin.hlsjs.[env].[ext]";
4192
+ readonly "plugin:dashjs": "veplayer.plugin.dashjs.[env].[ext]";
3881
4193
  readonly "plugin:shaka": "veplayer.plugin.shaka.[env].[ext]";
3882
4194
  readonly "plugin:rtm": "veplayer.plugin.rtm.[env].[ext]";
3883
4195
  readonly "plugin:xgvideo": "veplayer.plugin.xgvideo.[env].[ext]";
@@ -3912,6 +4224,7 @@ declare namespace strategy {
3912
4224
  PluginMp4 = "plugin:mp4",
3913
4225
  PluginHls = "plugin:hls",
3914
4226
  PluginHlsJs = "plugin:hlsjs",
4227
+ PluginDashJs = "plugin:dashjs",
3915
4228
  PluginShaka = "plugin:shaka",
3916
4229
  PluginRtm = "plugin:rtm",
3917
4230
  PluginXgvideo = "plugin:xgvideo",
@@ -3927,6 +4240,7 @@ declare namespace strategy {
3927
4240
  [DynamicModule.PluginMp4]: Exports;
3928
4241
  [DynamicModule.PluginHls]: Exports;
3929
4242
  [DynamicModule.PluginHlsJs]: Exports;
4243
+ [DynamicModule.PluginDashJs]: Exports;
3930
4244
  [DynamicModule.PluginShaka]: Exports;
3931
4245
  [DynamicModule.PluginRtm]: Exports;
3932
4246
  [DynamicModule.PluginXgvideo]: Exports;
@@ -3998,6 +4312,15 @@ declare namespace error {
3998
4312
  MEDIA_ERR_URL_EMPTY: string;
3999
4313
  DRM: string;
4000
4314
  DRM_LICENSE: string;
4315
+ DRM_UNSUPPORTED: string;
4316
+ DRM_NO_MEDIA_KEY: string;
4317
+ DRM_NO_KEY_SESSION: string;
4318
+ DRM_GENERATE_QUEST_FAIL: string;
4319
+ DRM_LACK_SERVER_CERTIFICATE_PATH: string;
4320
+ DRM_LACK_SERVER_PROCESS_SPC_PATH: string;
4321
+ DRM_LICENSE_FAIL: string;
4322
+ DRM_KEY_ERROR: string;
4323
+ DRM_CERT_FAIL: string;
4001
4324
  OTHER: string;
4002
4325
  RUNTIME: string;
4003
4326
  MODULE_LOAD_ERROR: string;
@@ -4058,6 +4381,15 @@ declare namespace error {
4058
4381
  MEDIA_ERR_URL_EMPTY: string;
4059
4382
  DRM: string;
4060
4383
  DRM_LICENSE: string;
4384
+ DRM_UNSUPPORTED: string;
4385
+ DRM_NO_MEDIA_KEY: string;
4386
+ DRM_NO_KEY_SESSION: string;
4387
+ DRM_GENERATE_QUEST_FAIL: string;
4388
+ DRM_LACK_SERVER_CERTIFICATE_PATH: string;
4389
+ DRM_LACK_SERVER_PROCESS_SPC_PATH: string;
4390
+ DRM_LICENSE_FAIL: string;
4391
+ DRM_KEY_ERROR: string;
4392
+ DRM_CERT_FAIL: string;
4061
4393
  OTHER: string;
4062
4394
  RUNTIME: string;
4063
4395
  MODULE_LOAD_ERROR: string;
@@ -4157,7 +4489,7 @@ declare namespace error {
4157
4489
  */
4158
4490
  /** {en}
4159
4491
  * @brief Video parsing error.
4160
- * @solution Please contact your [technical support](https://www.byteplus.com/en/support).
4492
+ * @solution Please [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
4161
4493
  */
4162
4494
  MANIFEST_HLS_ERROR = 1100,
4163
4495
  /** {zh}
@@ -4166,7 +4498,7 @@ declare namespace error {
4166
4498
  */
4167
4499
  /** {en}
4168
4500
  * @brief Video parsing error.
4169
- * @solution Please contact your [technical support](https://www.byteplus.com/en/support).
4501
+ * @solution Please [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
4170
4502
  */
4171
4503
  MANIFEST_DASH_ERROR = 1200,
4172
4504
  /** {zh}
@@ -4220,7 +4552,7 @@ declare namespace error {
4220
4552
  */
4221
4553
  /** {en}
4222
4554
  * @brief Video parsing error.
4223
- * @solution Check whether the pull stream address is valid, or contact [technical support](https://www.byteplus.com/en/support).
4555
+ * @solution Check whether the pull stream address is valid, or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
4224
4556
  */
4225
4557
  DEMUX_FLV_ERROR = 3100,
4226
4558
  /** {zh}
@@ -4229,7 +4561,7 @@ declare namespace error {
4229
4561
  */
4230
4562
  /** {en}
4231
4563
  * @brief Video parsing error.
4232
- * @solution Check whether the pull stream address is valid, or contact [technical support](https://www.byteplus.com/en/support).
4564
+ * @solution Check whether the pull stream address is valid, or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
4233
4565
  */
4234
4566
  DEMUX_HLS_ERROR = 3200,
4235
4567
  /** {zh}
@@ -4239,8 +4571,7 @@ declare namespace error {
4239
4571
  */
4240
4572
  /** {en}
4241
4573
  * @brief Video parsing error.
4242
- * @solution Check whether the pull stream address is valid, or contact [technical support](https://www.byteplus.com/en/support).
4243
- *
4574
+ * @solution Check whether the pull stream address is valid, or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
4244
4575
  */
4245
4576
  DEMUX_MP4_ERROR = 3300,
4246
4577
  /** {zh}
@@ -4250,8 +4581,7 @@ declare namespace error {
4250
4581
  */
4251
4582
  /** {en}
4252
4583
  * @brief Video parsing error.
4253
- * @solution Check whether the pull stream address is valid, or contact [technical support](https://www.byteplus.com/en/support).
4254
- *
4584
+ * @solution Check whether the pull stream address is valid, or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
4255
4585
  */
4256
4586
  DEMUX_FMP4_ERROR = 3400,
4257
4587
  /** {zh}
@@ -4261,8 +4591,7 @@ declare namespace error {
4261
4591
  */
4262
4592
  /** {en}
4263
4593
  * @brief Video parsing error.
4264
- * @solution Check whether the pull stream address is valid, or contact [technical support](https://www.byteplus.com/en/support).
4265
- *
4594
+ * @solution Check whether the pull stream address is valid, or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
4266
4595
  */
4267
4596
  DEMUX_SIDX_ERROR = 3410,
4268
4597
  /** {zh}
@@ -4272,8 +4601,7 @@ declare namespace error {
4272
4601
  */
4273
4602
  /** {en}
4274
4603
  * @brief Video parsing error.
4275
- * @solution Check whether the pull stream address is valid, or contact [technical support](https://www.byteplus.com/en/support).
4276
- *
4604
+ * @solution Check whether the pull stream address is valid, or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
4277
4605
  */
4278
4606
  REMUX_FMP4_ERROR = 4100,
4279
4607
  /** {zh}
@@ -4283,8 +4611,7 @@ declare namespace error {
4283
4611
  */
4284
4612
  /** {en}
4285
4613
  * @brief Video parsing error.
4286
- * @solution Check whether the pull stream address is valid, or contact [technical support](https://www.byteplus.com/en/support).
4287
- *
4614
+ * @solution Check whether the pull stream address is valid, or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
4288
4615
  */
4289
4616
  REMUX_MP4_ERROR = 4200,
4290
4617
  /** {zh}
@@ -4314,10 +4641,9 @@ declare namespace error {
4314
4641
  */
4315
4642
  /** {en}
4316
4643
  * @brief An error occurred to the browser while decoding the media resources.
4317
- * @solution
4318
- * 1. Check whether there is any issue with the original video.
4319
- * 2. Re-transcode the video and play it again.
4320
- * 3. If the error persists, please contact your [technical support](https://www.byteplus.com/en/support).
4644
+ * @solution 1. Check whether there is any issue with the original video.
4645
+ * 2. Re-transcode the video and play it again.
4646
+ * 3. If the error persists, please [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
4321
4647
  */
4322
4648
  MEDIA_ERR_DECODE = 5103,
4323
4649
  /** {zh}
@@ -4329,10 +4655,9 @@ declare namespace error {
4329
4655
  */
4330
4656
  /** {en}
4331
4657
  * @brief The video cannot be loaded due to unsupported video format or server or network issues.
4332
- * @solution
4333
- * 1. Check whether there is any issue with the browser's request.
4334
- * 2. Check whether the browser and the current page support the video format.
4335
- * 3. If the error persists, please contact your [technical support](https://www.byteplus.com/en/support).
4658
+ * @solution 1. Check whether there is any issue with the browser's request.
4659
+ * 2. Check whether the browser and the current page support the video format.
4660
+ * 3. If the error persists, please [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
4336
4661
  */
4337
4662
  MEDIA_ERR_SRC_NOT_SUPPORTED = 5104,
4338
4663
  /** {zh}
@@ -4344,10 +4669,9 @@ declare namespace error {
4344
4669
  */
4345
4670
  /** {en}
4346
4671
  * @brief The current browser does not support video decoding.
4347
- * @solution
4348
- * 1. Check whether there is any issue with the browser's request.
4349
- * 2. Check whether the browser and the current page support the video format.
4350
- * 3. If the error persists, please contact your [technical support](https://www.byteplus.com/en/support).
4672
+ * @solution 1. Check whether there is any issue with the browser's request.
4673
+ * 2. Check whether the browser and the current page support the video format.
4674
+ * 3. If the error persists, please [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
4351
4675
  */
4352
4676
  MEDIA_ERR_CODEC_NOT_SUPPORTED = 5105,
4353
4677
  /** {zh}
@@ -4365,7 +4689,7 @@ declare namespace error {
4365
4689
  */
4366
4690
  /** {en}
4367
4691
  * @brief A playback issue occurred.
4368
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
4692
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
4369
4693
  */
4370
4694
  MEDIA_MSE_ADD_SB = 5200,
4371
4695
  /** {zh}
@@ -4374,7 +4698,7 @@ declare namespace error {
4374
4698
  */
4375
4699
  /** {en}
4376
4700
  * @brief A playback issue occurred.
4377
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
4701
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
4378
4702
  */
4379
4703
  MEDIA_MSE_APPEND_BUFFER = 5201,
4380
4704
  /** {zh}
@@ -4383,7 +4707,7 @@ declare namespace error {
4383
4707
  */
4384
4708
  /** {en}
4385
4709
  * @brief A playback issue occurred.
4386
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
4710
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
4387
4711
  */
4388
4712
  MEDIA_MSE_OTHER = 5202,
4389
4713
  /** {zh}
@@ -4392,7 +4716,7 @@ declare namespace error {
4392
4716
  */
4393
4717
  /** {en}
4394
4718
  * @brief A playback issue occurred.
4395
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
4719
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
4396
4720
  */
4397
4721
  MEDIA_MSE_FULL = 5203,
4398
4722
  /** {zh}
@@ -4401,7 +4725,7 @@ declare namespace error {
4401
4725
  */
4402
4726
  /** {en}
4403
4727
  * @brief A playback issue occurred.
4404
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
4728
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
4405
4729
  */
4406
4730
  MEDIA_MSE_HIJACK = 5204,
4407
4731
  /** {zh}
@@ -4410,25 +4734,92 @@ declare namespace error {
4410
4734
  */
4411
4735
  /** {en}
4412
4736
  * @brief A playback issue occurred.
4413
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
4737
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
4414
4738
  */
4415
4739
  MEDIA_EME_HIJACK = 5301,
4416
4740
  /** {zh}
4417
4741
  * @brief DRM 权限校验失败
4418
4742
  * @hidden
4743
+ * @solution 请检查权限配置,确保播放权限正确。
4419
4744
  */
4420
4745
  /** {en}
4421
4746
  * @brief DRM authentication failed.
4422
4747
  * @hidden
4748
+ * @solution Verify the authentication and ensure proper playback permissions.
4423
4749
  */
4424
4750
  DRM_LICENSE = 7100,
4751
+ /** {zh}
4752
+ * @brief 不支持 DRM 加密播放
4753
+ */
4754
+ /** {en}
4755
+ * @brief DRM encrypted playback is not supported
4756
+ */
4757
+ DRM_UNSUPPORTED = 7101,
4758
+ /** {zh}
4759
+ * @brief 视频数据缺少相应 MediaKey
4760
+ */
4761
+ /** {en}
4762
+ * @brief Video data lacks the corresponding MediaKey
4763
+ */
4764
+ DRM_NO_MEDIA_KEY = 7103,
4765
+ /** {zh}
4766
+ * @brief 浏览器不支持相应 DRM KeySession
4767
+ */
4768
+ /** {en}
4769
+ * @brief Browser does not support the corresponding DRM KeySession
4770
+ */
4771
+ DRM_NO_KEY_SESSION = 7104,
4772
+ /** {zh}
4773
+ * @brief 解密播放错误
4774
+ */
4775
+ /** {en}
4776
+ * @brief Decryption playback error
4777
+ */
4778
+ DRM_GENERATE_QUEST_FAIL = 7105,
4779
+ /** {zh}
4780
+ * @brief 缺少 DRM 证书请求链接
4781
+ */
4782
+ /** {en}
4783
+ * @brief Missing DRM certificate request link
4784
+ */
4785
+ DRM_LACK_SERVER_CERTIFICATE_PATH = 7106,
4786
+ /** {zh}
4787
+ * @brief 缺少 DRM License 请求链接
4788
+ */
4789
+ /** {en}
4790
+ * @brief Missing DRM License request link
4791
+ */
4792
+ DRM_LACK_SERVER_PROCESS_SPC_PATH = 7107,
4793
+ /** {zh}
4794
+ * @brief 请求或更新 License 失败
4795
+ */
4796
+ /** {en}
4797
+ * @brief Request or update License failed
4798
+ */
4799
+ DRM_LICENSE_FAIL = 7108,
4800
+ /** {zh}
4801
+ * @brief 解密错误
4802
+ */
4803
+ /** {en}
4804
+ * @brief Decryption error
4805
+ */
4806
+ DRM_KEY_ERROR = 7109,
4807
+ /** {zh}
4808
+ * @brief 请求 DRM 证书失败'
4809
+ */
4810
+ /** {en}
4811
+ * @brief Request for DRM certificate failed'
4812
+ */
4813
+ DRM_CERT_FAIL = 7110,
4425
4814
  /** {zh}
4426
4815
  * @brief DRM 权限校验失败
4427
4816
  * @hidden
4817
+ * @solution 请检查自定义 DRM 权限。
4428
4818
  */
4429
4819
  /** {en}
4430
4820
  * @brief DRM authentication failed.
4431
4821
  * @hidden
4822
+ * @solution Please check the custom DRM authentication.
4432
4823
  */
4433
4824
  DRM_CUSTOM_LICENSE = 7200,
4434
4825
  /** {zh}
@@ -4437,7 +4828,7 @@ declare namespace error {
4437
4828
  */
4438
4829
  /** {en}
4439
4830
  * @brief A playback issue occurred.
4440
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
4831
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
4441
4832
  */
4442
4833
  OTHER = 8000,
4443
4834
  /** {zh}
@@ -4446,7 +4837,7 @@ declare namespace error {
4446
4837
  */
4447
4838
  /** {en}
4448
4839
  * @brief A playback issue occurred.
4449
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
4840
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
4450
4841
  */
4451
4842
  RUNTIME_NO_CANPLAY_ERROR = 9001,
4452
4843
  /** {zh}
@@ -4455,7 +4846,7 @@ declare namespace error {
4455
4846
  */
4456
4847
  /** {en}
4457
4848
  * @brief A playback issue occurred.
4458
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
4849
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
4459
4850
  */
4460
4851
  RUNTIME_BUFFERBREAK_ERROR = 9002,
4461
4852
  /** {zh}
@@ -4464,9 +4855,9 @@ declare namespace error {
4464
4855
  */
4465
4856
  /** {en}
4466
4857
  * @brief A playback issue occurred.
4467
- * @solution Check the live stream source or contact your [technical support](https://www.byteplus.com/en/support).
4858
+ * @solution Check the live stream source or [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
4468
4859
  */
4469
- RUNTIME_BWAITING_TIMEOUT_ERROR = 9002,
4860
+ RUNTIME_WAITING_TIMEOUT_ERROR = 9003,
4470
4861
  // veplayer 报错
4471
4862
  /** {zh}
4472
4863
  * @brief CDN 异步获取失败
@@ -4481,9 +4872,11 @@ declare namespace error {
4481
4872
  MODULE_LOAD_ERROR = 110,
4482
4873
  /** {zh}
4483
4874
  * @hidden
4875
+ * @solution 请重试操作,如仍未解决,请联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
4484
4876
  */
4485
4877
  /** {en}
4486
4878
  * @hidden
4879
+ * @solution Please retry the operation. If the issue persists, please [contact support](https://console.byteplus.com/auth/login?redirectURI=%2Fworkorder%2Fcreate).
4487
4880
  */
4488
4881
  UNKNOWN = "UNKNOWN"
4489
4882
  }
@@ -4563,8 +4956,8 @@ declare namespace error {
4563
4956
  */
4564
4957
  constructor(error?: string | ErrorInfo<T>, i18n?: VeI18n<T>);
4565
4958
  }
4566
- 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">;
4567
- 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">;
4959
+ 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" | "DRM_UNSUPPORTED" | "DRM_NO_MEDIA_KEY" | "DRM_NO_KEY_SESSION" | "DRM_GENERATE_QUEST_FAIL" | "DRM_LACK_SERVER_CERTIFICATE_PATH" | "DRM_LACK_SERVER_PROCESS_SPC_PATH" | "DRM_LICENSE_FAIL" | "DRM_KEY_ERROR" | "DRM_CERT_FAIL" | "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">;
4960
+ 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" | "DRM_UNSUPPORTED" | "DRM_NO_MEDIA_KEY" | "DRM_NO_KEY_SESSION" | "DRM_GENERATE_QUEST_FAIL" | "DRM_LACK_SERVER_CERTIFICATE_PATH" | "DRM_LACK_SERVER_PROCESS_SPC_PATH" | "DRM_LICENSE_FAIL" | "DRM_KEY_ERROR" | "DRM_CERT_FAIL" | "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">;
4568
4961
  }
4569
4962
  declare namespace event {
4570
4963
  const BaseEvents: {