@byteplus/veplayer 1.18.0 → 1.19.0-rc.1

package/lite.d.ts

@@ -22,6 +22,629 @@ export declare enum UmdKeys {
 }
 /** Resolved UMD module values keyed by their public UMD key. */
 export type UmdModules = Partial<Record<UmdKeys, unknown>>;
+interface ISubTitleItem {
+	/** {zh}
+	 * @brief 字幕来源。业务配置字幕为 `config`，Master M3U8 或原生 HLS 字幕为 `hls`。
+	 * @default config
+	 */
+	/** {en}
+	 * @brief Subtitle source. Business-configured subtitles use `config`; Master M3U8 or native HLS subtitles use `hls`.
+	 * @default config
+	 */
+	source?: "config" | "hls";
+	/** {zh}
+	 * @brief 字幕语言。
+	 * @default -
+	 */
+	/** {en}
+	 * @brief Subtitle language.
+	 * @default -
+	 */
+	language?: string | number;
+	/** {zh}
+	 * @brief 字幕 ID。
+	 * @default -
+	 */
+	/** {en}
+	 * @brief Subtitle ID.
+	 * @default -
+	 */
+	id?: number | string;
+	/** {zh}
+	 * @brief 是否为默认选择的字幕。
+	 * @default false
+	 */
+	/** {en}
+	 * @brief Whether this is the default selected subtitle.
+	 * @default false
+	 */
+	isDefault?: boolean;
+	/** {zh}
+	 * @brief 是否为强制字幕轨。
+	 * @default false
+	 */
+	/** {en}
+	 * @brief Whether the subtitle track is forced.
+	 * @default false
+	 */
+	forced?: boolean;
+	/** {zh}
+	 * @brief HLS 字幕轨的特征标识，例如无障碍字幕特征；未声明时为空。
+	 * @default -
+	 */
+	/** {en}
+	 * @brief HLS subtitle-track characteristics, such as accessibility traits; absent when not declared.
+	 * @default -
+	 */
+	characteristics?: string;
+	/** {zh}
+	 * @brief 字幕名称。
+	 * @default -
+	 */
+	/** {en}
+	 * @brief Subtitle display name.
+	 * @default -
+	 */
+	text?: string;
+	/** {zh}
+	 * @brief 字幕名称。兼容 xgplayer-subtitles 的 label 字段。
+	 * @default -
+	 */
+	/** {en}
+	 * @brief 字幕名称。兼容 xgplayer-subtitles 的 label 字段。
+	 * @default -
+	 */
+	label?: string | number;
+	/** {zh}
+	 * @brief 外挂字幕 URL 地址。
+	 * @default -
+	 */
+	/** {en}
+	 * @brief External subtitle URL.
+	 * @default -
+	 */
+	url?: string;
+	/**
+	 * @hidden
+	 * @type {string}
+	 * @memberof ISubTitleItem
+	 */
+	stringContent?: string;
+	/** {zh}
+	 * @brief 字幕内容列表。非 `url` 形式时使用。
+	 * @default -
+	 * @type {Array<Object>}
+	 * @memberof ISubTitleItem
+	 */
+	/** {en}
+	 * @brief Subtitle content list when not using URL.
+	 * @default -
+	 * @type {Array<Object>}
+	 * @memberof ISubTitleItem
+	 */
+	list?: IListItem[];
+}
+interface IListItem {
+	/** {zh}
+	 * @brief 开始时间，单位为秒。
+	 * @type {number}
+	 */
+	/** {en}
+	 * @brief Start time in seconds.
+	 * @type {number}
+	 */
+	start: number;
+	/** {zh}
+	 * @brief 结束时间，单位为秒。
+	 * @type {number}
+	 */
+	/** {en}
+	 * @brief End time in seconds.
+	 * @type {number}
+	 */
+	end: number;
+	/** {zh}
+	 * @brief 字幕数据列表。
+	 * @type {Array<ITextItem>}
+	 */
+	/** {en}
+	 * @brief Subtitle cue data list.
+	 * @type {Array<ITextItem>}
+	 */
+	list: Array<ITextItem>;
+	/**
+	 * @hidden
+	 * @type {any}
+	 */
+	[propName: string]: any;
+}
+interface ITextItem {
+	/**
+	 * @hidden
+	 * @type {any}
+	 */
+	[propName: string]: any;
+	/** {zh}
+	 * @brief 开始时间，单位为秒。
+	 * @type {number}
+	 */
+	/** {en}
+	 * @brief Start time in seconds.
+	 * @type {number}
+	 */
+	start: number;
+	/** {zh}
+	 * @brief 结束时间，单位为秒。
+	 * @type {number}
+	 */
+	/** {en}
+	 * @brief End time in seconds.
+	 * @type {number}
+	 */
+	end: number;
+	/** {zh}
+	 * @brief 字幕文案数组。
+	 * @type {string[]}
+	 */
+	/** {en}
+	 * @brief Subtitle text array.
+	 * @type {string[]}
+	 */
+	text: string[];
+	/** {zh}
+	 * @brief 字幕顺序。
+	 * @type {number}
+	 */
+	/** {en}
+	 * @brief Subtitle display order.
+	 * @type {number}
+	 */
+	index?: number;
+}
+/** {zh}
+ * @brief VePlayer 实际使用的 HLS 播放内核。
+ * @detail ref
+ */
+/** {en}
+ * @brief The HLS playback engine actually used by VePlayer.
+ * @detail ref
+ */
+export type HlsPlaybackEngine = "hlsjs" | "veplayer-hls" | "native" | "none";
+/** {zh}
+ * @brief HLS 自动码率决策引擎配置值。
+ * @detail ref
+ */
+/** {en}
+ * @brief Configurable HLS adaptive-bitrate decision engine.
+ * @detail ref
+ */
+export type HlsAbrEngine = "hlsjs" | "veplayer";
+/** {zh}
+ * @brief 当前播放会话最终解析出的自动码率决策引擎。
+ * @detail ref
+ */
+/** {en}
+ * @brief Adaptive-bitrate decision engine resolved for the current playback session.
+ * @detail ref
+ */
+export type ResolvedAbrEngine = HlsAbrEngine | "native" | "none";
+/** {zh}
+ * @brief HLS 自动码率控制模式。
+ * @detail ref
+ */
+/** {en}
+ * @brief HLS adaptive-bitrate control mode.
+ * @detail ref
+ */
+export type HlsAbrMode = "auto" | "manual";
+/** {zh}
+ * @brief 当前播放会话无法使用 HLS ABR 的原因。
+ * @detail ref
+ */
+/** {en}
+ * @brief Reason why HLS ABR is unavailable for the current playback session.
+ * @detail ref
+ */
+export type HlsAbrUnavailableReason = "NOT_HLS" | "NOT_HLSJS_ENGINE" | "MANIFEST_NOT_READY" | "MULTI_LEVEL_MASTER_REQUIRED" | "DEFINITION_LIST_REQUIRED" | "ABR_MODULE_UNAVAILABLE" | "ABR_RUNTIME_UNAVAILABLE" | "LICENSE_UNAVAILABLE" | "NO_ABR_VARIANTS";
+/** {zh}
+ * @brief 当前 HLS 播放会话支持的 ABR 能力。
+ * @detail ref
+ */
+/** {en}
+ * @brief ABR capabilities supported by the current HLS playback session.
+ * @detail ref
+ */
+export interface IHlsAbrCapabilities {
+	/** {zh} @brief 是否可读取 HLS Level 列表。 */
+	/** {en} @brief Whether the HLS Level list is available. */
+	levelList: boolean;
+	/** {zh} @brief 是否支持手动切换 HLS Level。 */
+	/** {en} @brief Whether manual HLS Level switching is supported. */
+	manualLevelSwitch: boolean;
+	/** {zh} @brief 是否支持恢复当前 ABR 引擎的自动模式。 */
+	/** {en} @brief Whether automatic mode can be restored for the resolved ABR engine. */
+	restoreAuto: boolean;
+	/** {zh} @brief 是否支持按 Level 设置自动码率上限。 */
+	/** {en} @brief Whether an automatic bitrate cap can be set by Level. */
+	levelCap: boolean;
+	/** {zh} @brief 是否支持按码率设置自动码率上限。 */
+	/** {en} @brief Whether an automatic bitrate cap can be set by bitrate. */
+	bitrateCap: boolean;
+	/** {zh} @brief 是否支持按 VePlayer 清晰度设置自动码率上限。 */
+	/** {en} @brief Whether an automatic bitrate cap can be set by VePlayer definition. */
+	definitionCap: boolean;
+}
+/** {zh}
+ * @brief 当前播放会话的 HLS ABR 状态快照。
+ * @detail ref
+ */
+/** {en}
+ * @brief HLS ABR state snapshot for the current playback session.
+ * @detail ref
+ */
+export interface IHlsAbrState {
+	/** {zh} @brief 播放会话 ID，用于识别过期状态和事件。 */
+	/** {en} @brief Playback session ID used to reject stale state and events. */
+	playbackSessionId: string;
+	/** {zh} @brief VePlayer 实际使用的 HLS 播放内核。 */
+	/** {en} @brief HLS playback engine actually used by VePlayer. */
+	playbackEngine: HlsPlaybackEngine;
+	/** {zh} @brief 业务显式配置的 ABR 引擎；未配置时为 `null`。 */
+	/** {en} @brief Explicitly configured ABR engine, or `null` when omitted. */
+	configuredEngine: HlsAbrEngine | null;
+	/** {zh} @brief 当前播放会话最终解析出的 ABR 决策引擎。 */
+	/** {en} @brief ABR decision engine resolved for the current playback session. */
+	engine: ResolvedAbrEngine;
+	/** {zh} @brief 当前清晰度决策使用的数据源。 */
+	/** {en} @brief Data source used for the current rendition decision. */
+	decisionSource: "hls-levels" | "definition-list" | "native" | "none";
+	/** {zh} @brief 当前播放会话是否具备所选 ABR 引擎所需条件。 */
+	/** {en} @brief Whether the selected ABR engine is available in the current session. */
+	available: boolean;
+	/** {zh} @brief 当前 ABR 决策引擎是否正在自动选档。 */
+	/** {en} @brief Whether the resolved ABR engine is actively selecting renditions. */
+	active: boolean;
+	/** {zh} @brief 当前为自动模式还是手动模式。 */
+	/** {en} @brief Whether the current mode is automatic or manual. */
+	mode: HlsAbrMode;
+	/** {zh} @brief hls.js 当前实际播放的 Level 索引。 */
+	/** {en} @brief Current hls.js Level index being rendered. */
+	currentLevel?: number;
+	/** {zh} @brief VePlayer ABR 当前实际播放的清晰度。 */
+	/** {en} @brief Current definition rendered by VePlayer ABR. */
+	currentDefinition?: string;
+	/** {zh} @brief ABR 不可用时的稳定原因码。 */
+	/** {en} @brief Stable reason code when ABR is unavailable. */
+	reason?: HlsAbrUnavailableReason;
+	/** {zh} @brief 当前播放会话支持的 ABR 控制能力。 */
+	/** {en} @brief ABR control capabilities supported by the current session. */
+	capabilities: IHlsAbrCapabilities;
+}
+/** {zh}
+ * @brief HLS ABR 上限；`null` 表示清除上限。
+ * @detail ref
+ */
+/** {en}
+ * @brief HLS ABR limit; `null` clears the active limit.
+ * @detail ref
+ */
+export type IHlsAbrLimit = {
+	type: "level";
+	maxLevel: number;
+} | {
+	type: "bitrate";
+	maxBitrate: number;
+} | {
+	type: "definition";
+	maxDefinition: string;
+} | null;
+/** {zh}
+ * @brief `HLS_ABR_ENGINE_RESOLVED` 事件数据。
+ * @detail ref
+ */
+/** {en}
+ * @brief Payload of the `HLS_ABR_ENGINE_RESOLVED` event.
+ * @detail ref
+ */
+export interface IHlsAbrEngineResolvedEvent extends IHlsAbrState {
+}
+/** {zh}
+ * @brief `HLS_ABR_STATE_CHANGE` 事件数据。
+ * @detail ref
+ */
+/** {en}
+ * @brief Payload of the `HLS_ABR_STATE_CHANGE` event.
+ * @detail ref
+ */
+export interface IHlsAbrStateChangeEvent extends IHlsAbrState {
+}
+/** {zh}
+ * @brief `HLS_ABR_LIMIT_CHANGE` 事件数据。
+ * @detail ref
+ */
+/** {en}
+ * @brief Payload of the `HLS_ABR_LIMIT_CHANGE` event.
+ * @detail ref
+ */
+export interface IHlsAbrLimitChangeEvent {
+	/** {zh} @brief 事件所属的播放会话 ID。 */
+	/** {en} @brief Playback session ID that owns the event. */
+	playbackSessionId: string;
+	/** {zh} @brief 当前播放会话最终解析出的 ABR 决策引擎。 */
+	/** {en} @brief ABR decision engine resolved for the current playback session. */
+	engine: ResolvedAbrEngine;
+	/** {zh} @brief 已生效的 ABR 上限；`null` 表示上限已清除。 */
+	/** {en} @brief Applied ABR limit, or `null` when the limit has been cleared. */
+	limit: IHlsAbrLimit;
+}
+/** {zh}
+ * @brief Master M3U8 中一个标准化的 HLS Level；`index` 仅在当前播放会话内有效。
+ * @detail ref
+ */
+/** {en}
+ * @brief A normalized HLS Level from a Master M3U8; `index` is valid only in the current playback session.
+ * @detail ref
+ */
+export interface IHlsLevel {
+	/** {zh} @brief 当前播放会话内的 Level 索引。 */
+	/** {en} @brief Level index within the current playback session. */
+	index: number;
+	/** {zh} @brief 峰值码率，单位为 bit/s。 */
+	/** {en} @brief Peak bitrate in bits per second. */
+	bitrate: number;
+	/** {zh} @brief 平均码率，单位为 bit/s。 */
+	/** {en} @brief Average bitrate in bits per second. */
+	averageBitrate?: number;
+	/** {zh} @brief 视频宽度，单位为像素。 */
+	/** {en} @brief Video width in pixels. */
+	width?: number;
+	/** {zh} @brief 视频高度，单位为像素。 */
+	/** {en} @brief Video height in pixels. */
+	height?: number;
+	/** {zh} @brief 视频帧率。 */
+	/** {en} @brief Video frame rate. */
+	frameRate?: number;
+	/** {zh} @brief 视频编码标识。 */
+	/** {en} @brief Video codec identifier. */
+	videoCodec?: string;
+	/** {zh} @brief 音频编码标识。 */
+	/** {en} @brief Audio codec identifier. */
+	audioCodec?: string;
+	/** {zh} @brief 视频动态范围标识。 */
+	/** {en} @brief Video dynamic-range identifier. */
+	videoRange?: string;
+	/** {zh} @brief Manifest 声明的 Level 名称。 */
+	/** {en} @brief Level name declared by the manifest. */
+	name?: string;
+}
+/** {zh}
+ * @brief 当前播放会话的 HLS Level 状态快照。
+ * @detail ref
+ */
+/** {en}
+ * @brief HLS Level state snapshot for the current playback session.
+ * @detail ref
+ */
+export interface IHlsLevelState {
+	/** {zh} @brief 播放会话 ID，用于识别过期状态和事件。 */
+	/** {en} @brief Playback session ID used to reject stale state and events. */
+	playbackSessionId: string;
+	/** {zh} @brief Level 列表是否已就绪。 */
+	/** {en} @brief Whether the Level list is ready. */
+	ready: boolean;
+	/** {zh} @brief 当前播放会话内的标准化 Level 列表。 */
+	/** {en} @brief Normalized Level list for the current playback session. */
+	levels: IHlsLevel[];
+	/** {zh} @brief 当前实际播放的 Level 索引，未知时为 `-1`。 */
+	/** {en} @brief Currently rendered Level index, or `-1` when unknown. */
+	currentLevel: number;
+	/** {zh} @brief 当前加载的 Level 索引，未知时为 `-1`。 */
+	/** {en} @brief Currently loaded Level index, or `-1` when unknown. */
+	loadLevel: number;
+	/** {zh} @brief 下一个分片使用的 Level 索引，未知时为 `-1`。 */
+	/** {en} @brief Level index for the next fragment, or `-1` when unknown. */
+	nextLevel: number;
+	/** {zh} @brief 手动 Level 索引；自动模式下为 `-1`。 */
+	/** {en} @brief Manual Level index; `-1` in automatic mode. */
+	manualLevel: number;
+	/** {zh} @brief hls.js 是否处于自动选档模式。 */
+	/** {en} @brief Whether hls.js automatic Level selection is enabled. */
+	autoLevelEnabled: boolean;
+	/** {zh} @brief hls.js 自动选档的 Level 上限；未设置时为 `-1`。 */
+	/** {en} @brief hls.js automatic Level cap; `-1` when unset. */
+	autoLevelCapping: number;
+}
+/** {zh}
+ * @brief HLS Level 手动切换模式。
+ * @detail ref
+ */
+/** {en}
+ * @brief Manual HLS Level switching mode.
+ * @detail ref
+ */
+export type HlsLevelSwitchMode = "immediate" | "next-fragment" | "smooth";
+/** {zh}
+ * @brief 手动切换 HLS Level 的选项。
+ * @detail ref
+ */
+/** {en}
+ * @brief Options for manually switching an HLS Level.
+ * @detail ref
+ */
+export interface IHlsLevelSwitchOptions {
+	/** {zh} @brief 切换模式，默认为 `next-fragment`。 */
+	/** {en} @brief Switching mode. Defaults to `next-fragment`. */
+	mode?: HlsLevelSwitchMode;
+	/** {zh} @brief 可选的播放会话 ID；不匹配时拒绝本次切换。 */
+	/** {en} @brief Optional playback session ID; a mismatch rejects the switch. */
+	playbackSessionId?: string;
+}
+/** {zh}
+ * @brief HLS Level 切换事件数据。
+ * @detail ref
+ */
+/** {en}
+ * @brief HLS Level switching event payload.
+ * @detail ref
+ */
+export interface IHlsLevelSwitchEvent {
+	/** {zh} @brief 事件所属的播放会话 ID。 */
+	/** {en} @brief Playback session ID that owns the event. */
+	playbackSessionId: string;
+	/** {zh} @brief 切换前的 Level 索引。 */
+	/** {en} @brief Level index before switching. */
+	from: number;
+	/** {zh} @brief 目标或已切换到的 Level 索引。 */
+	/** {en} @brief Target or switched-to Level index. */
+	to: number;
+	/** {zh} @brief 本次切换由手动操作还是 ABR 触发。 */
+	/** {en} @brief Whether the switch was triggered manually or by ABR. */
+	reason: "manual" | "abr";
+	/** {zh} @brief 当前播放会话的 ABR 决策引擎。 */
+	/** {en} @brief ABR decision engine for the current playback session. */
+	abrEngine: ResolvedAbrEngine;
+	/** {zh} @brief 目标或已生效的安全 Level 快照。 */
+	/** {en} @brief Safe snapshot of the target or active Level. */
+	level?: IHlsLevel;
+}
+/** {zh}
+ * @brief `HLS_SUBTITLE_TRACKS_UPDATED` 事件数据。
+ * @detail ref
+ */
+/** {en}
+ * @brief Payload of the `HLS_SUBTITLE_TRACKS_UPDATED` event.
+ * @detail ref
+ */
+export interface IHlsSubtitleTracksUpdatedEvent {
+	/** {zh} @brief 事件所属的播放会话 ID。 */
+	/** {en} @brief Playback session ID that owns the event. */
+	playbackSessionId: string;
+	/** {zh} @brief 当前实际使用的 HLS 播放内核。 */
+	/** {en} @brief HLS playback engine actually used by the session. */
+	playbackEngine: HlsPlaybackEngine;
+	/** {zh} @brief 不含播放地址和底层轨道索引的安全字幕列表。 */
+	/** {en} @brief Safe subtitle list without media URLs or internal track indexes. */
+	tracks: ReadonlyArray<ISubTitleItem>;
+}
+/** {zh}
+ * @brief HLS 字幕轨切换事件数据。
+ * @detail ref
+ */
+/** {en}
+ * @brief HLS subtitle-track switching event payload.
+ * @detail ref
+ */
+export interface IHlsSubtitleTrackSwitchEvent {
+	/** {zh} @brief 事件所属的播放会话 ID。 */
+	/** {en} @brief Playback session ID that owns the event. */
+	playbackSessionId: string;
+	/** {zh} @brief 当前实际使用的 HLS 播放内核。 */
+	/** {en} @brief HLS playback engine actually used by the session. */
+	playbackEngine: HlsPlaybackEngine;
+	/** {zh} @brief 切换前的安全字幕 ID；关闭状态为 `null`。 */
+	/** {en} @brief Safe subtitle ID before switching, or `null` when disabled. */
+	from: string | number | null;
+	/** {zh} @brief 目标或已生效的安全字幕 ID；关闭状态为 `null`。 */
+	/** {en} @brief Target or active safe subtitle ID, or `null` when disabled. */
+	to: string | number | null;
+	/** {zh} @brief 目标或已生效的安全字幕快照。 */
+	/** {en} @brief Safe snapshot of the target or active subtitle track. */
+	track?: ISubTitleItem;
+}
+/** {zh}
+ * @brief HLS 控制 API 的标准错误码。
+ * @detail ref
+ */
+/** {en}
+ * @brief Standard error codes for HLS control APIs.
+ * @detail ref
+ */
+export type HlsControlErrorCode = "HLS_MANIFEST_NOT_READY" | "HLS_ENGINE_UNSUPPORTED" | "HLS_LEVEL_OUT_OF_RANGE" | "HLS_PLAYBACK_SESSION_EXPIRED" | "HLS_ABR_UNAVAILABLE" | "HLS_ABR_LIMIT_UNSUPPORTED" | "HLS_SUBTITLE_TRACK_NOT_FOUND" | "HLS_SUBTITLE_TRACK_AMBIGUOUS" | "HLS_SUBTITLE_SWITCH_FAILED" | "HLS_SUBTITLE_SWITCH_TIMEOUT";
+/** {zh}
+ * @brief HLS Level、ABR 或字幕控制失败时抛出的标准错误。
+ * @detail Api
+ */
+/** {en}
+ * @brief Standard error thrown when HLS Level, ABR, or subtitle control fails.
+ * @detail Api
+ */
+export declare class HlsControlError extends Error {
+	/** {zh} @brief 稳定的 HLS 控制错误码。 */
+	/** {en} @brief Stable HLS control error code. */
+	readonly code: HlsControlErrorCode;
+	constructor(code: HlsControlErrorCode, message: string);
+}
+/** {zh}
+ * @list Options
+ * @brief 自适应码率配置。
+ * @kind property
+ */
+/** {en}
+ * @list Options
+ * @brief Adaptive bitrate (ABR) playback configuration.
+ * @kind property
+ */
+export interface IAutoBitrateOpts {
+	/** {zh}
+	 * @brief 是否开启自适应码率功能。
+	 * @default false
+	 */
+	/** {en}
+	 * @brief Whether to enable adaptive bitrate (ABR).
+	 * @default false
+	 */
+	enable: boolean;
+	/** {zh}
+	 * @brief HLS 自动码率决策引擎。仅对 HLS 生效；开启 ABR 但不设置时，为兼容旧版本使用 VePlayer ABR。
+	 * @default veplayer
+	 */
+	/** {en}
+	 * @brief HLS adaptive-bitrate decision engine. Applies only to HLS; when ABR is enabled and this field is omitted, VePlayer ABR is used for backward compatibility.
+	 * @default veplayer
+	 */
+	engine?: HlsAbrEngine;
+	/** {zh}
+	 * @brief 是否以自动清晰度档位起播。开启自适应码率功能且 `defaultDefinition` 为 `auto` 时，才会以自动清晰度档位起播。
+	 * @default false
+	 */
+	/** {en}
+	 * @brief Whether to start playback with the auto definition level. Takes effect only when ABR is enabled and `defaultDefinition` is `auto`.
+	 * @default false
+	 */
+	startWithAuto?: boolean;
+	/** {zh}
+	 * @brief 自动清晰度档位是否展示当前实际清晰度，如自动（720p）。
+	 * @default false
+	 */
+	/** {en}
+	 * @brief Whether the auto definition label shows the actual resolution, e.g. Auto (720p).
+	 * @default false
+	 */
+	showRealDefinition?: boolean;
+	/** {zh}
+	 * @brief 自动清晰度档位的显示文案。
+	 * @default 自动
+	 */
+	/** {en}
+	 * @brief Display text for the auto definition level.
+	 * @default auto
+	 */
+	autoDefinitionText?: string;
+	/** {zh}
+	 * @brief 自动清晰度档位的多语言 key。
+	 * @default DEFINITION_AUTO
+	 */
+	/** {en}
+	 * @brief i18n key for the auto definition level label.
+	 * @default DEFINITION_AUTO
+	 */
+	definitionTextKey?: string;
+	/**
+	 * @hidden
+	 * @brief 软解module
+	 */
+	module?: unknown;
+}
 /** Video and audio codec names supported by the player. */
 export declare const CodecType: {
 	readonly H264: "h264";
@@ -373,6 +996,8 @@ export interface LiteSubtitleConfig {
 	list?: LiteSubtitleItem[];
 	defaultSubtitleId?: string | number;
 	defaultSubtitleLanguage?: string | number;
+	mode?: "external" | "native";
+	nativeRenderMode?: "system" | "dom";
 	updateMode?: "vod";
 	[key: string]: unknown;
 }
@@ -533,6 +1158,7 @@ export interface LitePlayerConfig<MediaUrl extends LiteMediaUrl = LiteMediaUrl,
 	mobile?: LiteMobileConfig;
 	start?: LiteStartConfig;
 	enableHlsMSE?: boolean;
+	hlsLevelSwitchMode?: HlsLevelSwitchMode;
 	useHlsPluginForSafari?: boolean;
 	enableMp4MSE?: boolean;
 	defaultDefinition?: string;
@@ -593,6 +1219,10 @@ export interface LiteSubtitleItem {
 	label?: string | number;
 	text?: string;
 	url?: string;
+	isDefault?: boolean;
+	source?: "config" | "hls";
+	forced?: boolean;
+	characteristics?: string;
 }
 export interface LitePluginInstance {
 	readonly pluginName?: string;
@@ -615,6 +1245,10 @@ export interface LiteVePlayer {
 	emit(action: string, payload?: unknown): void;
 	getCurrentPlayerConfig(): LiteDefaultConfig;
 	getDefinitionList(): LiteDefinition[];
+	getHlsAbrLimit(): IHlsAbrLimit;
+	getHlsAbrState(): IHlsAbrState;
+	getHlsLevels(): IHlsLevel[];
+	getHlsLevelState(): IHlsLevelState;
 	getLogUserId(): string | undefined;
 	getPlayerInstance(): unknown;
 	getPlugin(pluginName: string): LitePluginInstance | null;
@@ -627,6 +1261,9 @@ export interface LiteVePlayer {
 	once(action: string, func: (...args: unknown[]) => void): void;
 	playNext<MediaUrl extends LiteMediaUrl, StreamUrl extends LiteMediaUrl>(config: LitePlayerConfig<MediaUrl, StreamUrl>, isNewVideo?: boolean): Promise<unknown>;
 	showSubtitle(): void;
+	setHlsAbrLimit(limit: IHlsAbrLimit): void;
+	setHlsAbrMode(mode: HlsAbrMode): void;
+	setHlsLevel(levelIndex: number, options?: IHlsLevelSwitchOptions): void;
 	switchAuthToken(config: LitePlayAuthTokenConfig, isNewVideo?: boolean): Promise<void>;
 	switchSubtitle(subtitle: {
 		id?: string | number;