@volcengine/veplayer 1.8.6-rc.15 → 1.8.6-rc.16

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.
package/index.d.ts CHANGED
@@ -787,31 +787,21 @@ export interface ITextItem {
787
787
  */
788
788
  export interface IDefinitionDemotePlugin {
789
789
  /**
790
- * 是否开启自动降级
791
- * 默认:false
790
+ * 超时重试次数
791
+ * 默认:3
792
792
  *
793
- * @type {boolean}
793
+ * @type {number}
794
794
  * @memberof IDefinitionDemotePlugin
795
795
  */
796
- isNeedAutoDemote?: boolean;
797
- /**
798
- * @brief 卡顿时是否展示toast
799
- * @default true
800
- */
801
- isNeedShowTips?: boolean;
802
- /**
803
- * @brief 提醒降级的toast显示持续时间
804
- */
805
- toastShowTime?: number;
796
+ oftenWaitingCount?: number;
806
797
  /**
798
+ * 设置经常超时时间
799
+ * 默认:5000
807
800
  *
808
- * 降级顺序,按照数组顺序依次降级,数字元素对应playList中的definition
809
- * 默认: ['uhd', 'hd', 'sd', 'ld', 'ao']
810
- *
811
- * @type {string[]}
801
+ * @type {number}
812
802
  * @memberof IDefinitionDemotePlugin
813
803
  */
814
- demotePriority?: string[];
804
+ oftenWaitingTime?: number;
815
805
  /**
816
806
  * 设置超时时间
817
807
  * 默认5000
@@ -821,21 +811,22 @@ export interface IDefinitionDemotePlugin {
821
811
  */
822
812
  longWaitingTime?: number;
823
813
  /**
824
- * 超时重试次数
825
- * 默认:3
814
+ * 是否自动触发降级
815
+ * 默认:false
826
816
  *
827
- * @type {number}
817
+ * @type {boolean}
828
818
  * @memberof IDefinitionDemotePlugin
829
819
  */
830
- oftenWaitingCount?: number;
820
+ isNeedAutoDemote?: boolean;
831
821
  /**
832
- * 设置经常超时时间
833
- * 默认:5000
834
822
  *
835
- * @type {number}
823
+ * 降级顺序,按照数组顺序依次降级,数字元素对应playList中的definition
824
+ * 默认: ['uhd', 'hd', 'sd', 'ld', 'ao']
825
+ *
826
+ * @type {string[]}
836
827
  * @memberof IDefinitionDemotePlugin
837
828
  */
838
- oftenWaitingTime?: number;
829
+ demotePriority?: string[];
839
830
  }
840
831
  /**
841
832
  * @brief DASH 播放配置。
@@ -1640,7 +1631,7 @@ export declare class PlayListPlugin extends Plugin {
1640
1631
  get disable(): boolean;
1641
1632
  render(): string;
1642
1633
  }
1643
- export interface IPlayInfoListItem {
1634
+ export interface IPlayInfoList {
1644
1635
  BackupPlayUrl: string;
1645
1636
  BackupUrlExpire: string;
1646
1637
  BarrageMaskOffset: string;
@@ -1667,98 +1658,6 @@ export interface IPlayInfoListItem {
1667
1658
  Volume?: number;
1668
1659
  Width: number;
1669
1660
  }
1670
- /**
1671
- * @brief 动态水印配置。
1672
- * @list Options
1673
- * @kind property
1674
- */
1675
- /** {en}
1676
- * @brief watermark config
1677
- */
1678
- export interface IWatermarkConfig {
1679
- /**
1680
- * @brief 是否开启水印
1681
- * @default false
1682
- */
1683
- enable: boolean;
1684
- /**
1685
- * @brief 水印文案内容
1686
- * @default -
1687
- */
1688
- content: string;
1689
- /**
1690
- * @brief 水印展示形式
1691
- * - 0: 固定位置
1692
- * - 1: 全屏滚动
1693
- * - 2: 随机闪烁
1694
- * @default 1
1695
- */
1696
- displayType: 0 | 1 | 2;
1697
- /**
1698
- * @brief 水印字体大小,number类型时单位为px,string类型需要携带单位
1699
- * @default 12
1700
- */
1701
- fontSize: number | string;
1702
- /**
1703
- * @brief 水印字体颜色
1704
- * @brief #FFFFFF
1705
- */
1706
- fontColor: string;
1707
- /**
1708
- * @brief 不透明度
1709
- * @default 0.3
1710
- */
1711
- opacity: number;
1712
- /**
1713
- * @brief 水印闪烁速度
1714
- * @default MODERATE
1715
- * - MODERATE: 适中
1716
- * - FAST: 较快
1717
- * - SLOW: 较慢
1718
- */
1719
- tickerSpeed?: "SLOW" | "MODERATE" | "FAST";
1720
- /**
1721
- * @brief 水印字体类型
1722
- * @default -
1723
- */
1724
- fontFamily?: string;
1725
- /**
1726
- * @brief 水印相对于播放容器顶部起始位置,单位px
1727
- * @default 0
1728
- */
1729
- top?: number;
1730
- /**
1731
- * @brief 水印相对于播放容器左侧起始位置,单位px
1732
- * @default 0
1733
- */
1734
- left?: number;
1735
- /**
1736
- * @brief 水印相对于播放容器底部起始位置,单位px
1737
- * @default -
1738
- */
1739
- bottom?: number;
1740
- /**
1741
- * @brief 水印相对于播放容器右侧起始位置,单位px
1742
- * @default -
1743
- */
1744
- right?: number;
1745
- }
1746
- export declare class DynamicWatermarkPlugin extends Plugin {
1747
- private wm;
1748
- static get pluginName(): string;
1749
- static get defaultConfig(): IWatermarkConfig & {
1750
- position: string;
1751
- };
1752
- constructor(props: any);
1753
- afterCreate(): void;
1754
- start(): void;
1755
- pause(): void;
1756
- resume(): void;
1757
- resize(): void;
1758
- _initWatermark(): void;
1759
- destroy(): void;
1760
- render(): string | HTMLElement;
1761
- }
1762
1661
  declare enum CodecType {
1763
1662
  /** {zh}
1764
1663
  * @brief H.265
@@ -1914,7 +1813,7 @@ export interface IMusicConfig {
1914
1813
  * @export
1915
1814
  * @interface Stream
1916
1815
  */
1917
- export interface Stream extends Partial<IPlayInfoListItem> {
1816
+ export interface Stream extends Partial<IPlayInfoList> {
1918
1817
  /** {zh}
1919
1818
  * @type {('rtm' | 'flv' | 'mp4' | 'hls')}
1920
1819
  * @memberof IPlayerConfig
@@ -1938,12 +1837,6 @@ export interface Stream extends Partial<IPlayInfoListItem> {
1938
1837
  * @brief 清晰度 key
1939
1838
  */
1940
1839
  definition?: string;
1941
- /** {zh}
1942
- * @type {string}
1943
- * @memberof Stream
1944
- * @brief 映射清晰度 key
1945
- */
1946
- mapDefinition?: string;
1947
1840
  /** {zh}
1948
1841
  * @type {string}
1949
1842
  * @memberof Stream
@@ -2087,7 +1980,7 @@ export interface IPlayerConfig extends IPlayerOptions {
2087
1980
  */
2088
1981
  autoplay?: boolean;
2089
1982
  /** {zh}
2090
- * @brief 视频封面图配置。
1983
+ * @brief 视频封面图片的 URL。
2091
1984
  */
2092
1985
  poster?: string | IPoster;
2093
1986
  /** {zh}
@@ -2452,11 +2345,6 @@ export interface IPlayerConfig extends IPlayerOptions {
2452
2345
  * @default -
2453
2346
  */
2454
2347
  disableVodLogOptsCheck?: boolean;
2455
- /** {zh}
2456
- * @brief 是否开启调试模式
2457
- * @default false
2458
- */
2459
- debug?: boolean;
2460
2348
  /** {zh}
2461
2349
  * @brief 播放器报错信息。支持配置播放异常时显示的异常文案、图片以及是否提供刷新按钮等。
2462
2350
  * @default -
@@ -2476,6 +2364,7 @@ export interface IPlayerConfig extends IPlayerOptions {
2476
2364
  DanmuPlugin?: IDanmuConfig | boolean;
2477
2365
  /** {zh}
2478
2366
  * @brief 清晰度自动降级配置
2367
+ * @hidden
2479
2368
  * @notes 需要先引入DefinitionDemotePlugin插件,plugins: [VePlayer.DefinitionDemotePlugin]
2480
2369
  */
2481
2370
  DefinitionDemotePlugin?: IDefinitionDemotePlugin;
@@ -2536,16 +2425,6 @@ export interface IPlayerConfig extends IPlayerOptions {
2536
2425
  * @brief 播放列表配置。
2537
2426
  */
2538
2427
  playListPlugin?: IPlayListConfig;
2539
- /** {zh}
2540
- * @brief 动态水印配置
2541
- * @default -
2542
- */
2543
- dynamicwatermark?: IWatermarkConfig;
2544
- /** {zh}
2545
- * @brief 进度条预览缩略图配置
2546
- * @default -
2547
- */
2548
- thumbnail?: IThumbnailConfig;
2549
2428
  }
2550
2429
  /** {zh}
2551
2430
  * @hidden
@@ -2724,18 +2603,6 @@ export interface IPlayAuthTokenConfig {
2724
2603
  * @default 1
2725
2604
  */
2726
2605
  retryCount?: number;
2727
- /** {zh}
2728
- * @brief 清晰度自动降级开启时的自动档位,对应{@link https://www.volcengine.com/docs/4/2918 GetPlayInfo}返回的Definition字段
2729
- * @notice 如果指定的清晰度,playAuthToken从服务端返回的清晰度列表中不存在该清晰度,则此参数无效。
2730
- * @default -
2731
- */
2732
- autoDemoteDefinition?: string;
2733
- /** {zh}
2734
- * @brief 清晰度自动降级开启时的自动档位对应的多语言文案key,即languages字段中对应语种的相应key
2735
- * @notice 如果指定的清晰度,playAuthToken从服务端返回的清晰度列表中不存在该清晰度,则此参数无效。
2736
- * @default -
2737
- */
2738
- autoDemoteDefinitionTextKey?: string;
2739
2606
  }
2740
2607
  /** {zh}
2741
2608
  * @list Options
@@ -2828,12 +2695,12 @@ export interface IMemoryPlayConfig {
2828
2695
  * @type {(id: number | string, time: number) => unknown}
2829
2696
  * @memberof IMemoryPlayConfig
2830
2697
  */
2831
- saveTime?: (id: number | string, time: number) => unknown;
2698
+ saveTime: (id: number | string, time: number) => unknown;
2832
2699
  /** {zh}
2833
2700
  * @brief 获取最后一次播放时间函数
2834
2701
  * @default -
2835
2702
  */
2836
- getTime?: (id: number | string) => number | Promise<number>;
2703
+ getTime: (id: number | string) => number | Promise<number>;
2837
2704
  }
2838
2705
  /** {zh}
2839
2706
  * @brief 插件按钮位置
@@ -3046,58 +2913,6 @@ export interface IPoster {
3046
2913
  */
3047
2914
  fillMode?: "fixWidth" | "fixHeight" | "cover" | "contain";
3048
2915
  }
3049
- /** {zh}
3050
- * @list Options
3051
- * @brief 进度条预览缩略图配置
3052
- * @kind property
3053
- */
3054
- export interface IThumbnailConfig {
3055
- /** {zh}
3056
- * @brief 雪碧图截图地址数组
3057
- * @default -
3058
- */
3059
- urls: Array<string>;
3060
- /** {zh}
3061
- * @brief 雪碧图中小图总数目
3062
- * @default -
3063
- */
3064
- pic_num: number;
3065
- /** {zh}
3066
- * @brief 雪碧图每张大图中小图列数
3067
- * @default -
3068
- */
3069
- col: number;
3070
- /** {zh}
3071
- * @brief 雪碧图每张大图中小图行数
3072
- * @default -
3073
- */
3074
- row: number;
3075
- /** {zh}
3076
- * @brief 雪碧图每张小图的高度
3077
- * @default -
3078
- */
3079
- height?: number;
3080
- /** {zh}
3081
- * @brief 雪碧图每张小图的宽度
3082
- * @default -
3083
- */
3084
- width?: number;
3085
- /** {zh}
3086
- * @brief 显示缩放比例
3087
- * @default 1
3088
- */
3089
- scale?: 1;
3090
- /** {zh}
3091
- * @brief 额外添加在dom上的class
3092
- * @default -
3093
- */
3094
- className?: string;
3095
- /** {zh}
3096
- * @brief 是否在竖屏的时候隐藏
3097
- * @default false
3098
- */
3099
- hidePortrait?: false;
3100
- }
3101
2916
  /**
3102
2917
  * @brief api map
3103
2918
  * @hidden
@@ -3224,10 +3039,9 @@ declare class PlayerData {
3224
3039
  getUrlList(condition: Condition): Stream[];
3225
3040
  /**
3226
3041
  * @description: 获取当期清晰的上一级清晰度或下一级清晰度
3227
- * @param {boolean} isDown 是否取下一级清晰度
3228
- * @param {string[]} demotePriority 清晰度降级顺序
3042
+ * @param {boolean} isDown
3229
3043
  */
3230
- getNextDefinition(isDown: boolean, demotePriority: string[]): Stream[];
3044
+ getNextDefinition(isDown: boolean, demotePriority: any): Stream[];
3231
3045
  /**
3232
3046
  * 获取api map
3233
3047
  * @return { ApiMapConfig }
@@ -3366,7 +3180,7 @@ declare class VePlayer {
3366
3180
  * @type {*}
3367
3181
  * @memberof VePlayer
3368
3182
  */
3369
- mountingDom: Element;
3183
+ mountingDom: any;
3370
3184
  /** {zh}
3371
3185
  * @hidden
3372
3186
  *
@@ -4264,15 +4078,51 @@ export declare class Subtitle extends Plugin {
4264
4078
  destroy(): void;
4265
4079
  render(): string;
4266
4080
  }
4081
+ export interface WatermarkConfig {
4082
+ enable: boolean;
4083
+ content: string;
4084
+ displayType: 0 | 1 | 2;
4085
+ fontSize: number | string;
4086
+ fontColor: string;
4087
+ opacity: number;
4088
+ tickerSpeed?: "SLOW" | "MODERATE" | "FAST";
4089
+ fontFamily?: string;
4090
+ top?: number;
4091
+ left?: number;
4092
+ bottom?: number;
4093
+ right?: number;
4094
+ }
4095
+ export declare class DynamicWatermarkPlugin extends Plugin {
4096
+ private wm;
4097
+ static get pluginName(): string;
4098
+ static get defaultConfig(): WatermarkConfig & {
4099
+ position: string;
4100
+ };
4101
+ constructor(props: any);
4102
+ afterCreate(): void;
4103
+ start(): void;
4104
+ pause(): void;
4105
+ resume(): void;
4106
+ resize(): void;
4107
+ _initWatermark(): void;
4108
+ destroy(): void;
4109
+ render(): string | HTMLElement;
4110
+ }
4267
4111
  export declare class DefinitionDemotePlugin extends Plugin {
4268
4112
  static get pluginName(): string;
4269
4113
  waitings: number[];
4270
- timer: ReturnType<typeof setTimeout>;
4271
- toastId: number;
4114
+ timer: any;
4272
4115
  longWaitingEmitTime: number;
4273
4116
  waitingStartTime: number;
4274
- playerData: PlayerData;
4275
- static get defaultConfig(): IDefinitionDemotePlugin;
4117
+ playerData: any;
4118
+ isNeedShowTips: boolean;
4119
+ static get defaultConfig(): {
4120
+ oftenWaitingCount: number;
4121
+ oftenWaitingTime: number;
4122
+ longWaitingTime: number;
4123
+ isNeedAutoDemote: boolean;
4124
+ demotePriority: any[];
4125
+ };
4276
4126
  constructor(args: any);
4277
4127
  registerLanguageTexts(): {
4278
4128
  definition_demote_txt: {
@@ -4291,8 +4141,8 @@ export declare class DefinitionDemotePlugin extends Plugin {
4291
4141
  _clearTime(): void;
4292
4142
  clearState(): void;
4293
4143
  demote(): void;
4294
- changeUrl(url: string): void;
4295
- showToast(definition: Stream): void;
4144
+ changeUrl(url: any): void;
4145
+ showToast(definition: any): void;
4296
4146
  destroy(): void;
4297
4147
  }
4298
4148
  export declare class TimeShiftPlugin extends Plugin {