@volcengine/veplayer 1.19.2-rc.1 → 1.20.0-rc.1

package/lite.d.ts

@@ -1039,6 +1039,27 @@ export type LitePreloadScene = 0 | 1;
 export type LiteServiceConfigMode = "remote" | "local-only";
 /** Lite-safe preload strategy configuration. */
 export interface LitePreloadStrategyConfig {
+	/** {zh}
+	 * @brief 预加载格式；数组可同时初始化 MP4 和 HLS，默认 MP4。
+	 */
+	/** {en}
+	 * @brief Preload format. An array initializes MP4 and HLS; defaults to MP4.
+	 */
+	format?: "mp4" | "hls" | Array<"mp4" | "hls">;
+	/** {zh}
+	 * @brief HLS 分片数量，正整数，默认 2。
+	 */
+	/** {en}
+	 * @brief HLS segment count. Positive integer; defaults to 2.
+	 */
+	sn?: number;
+	/** {zh}
+	 * @brief HLS master 子列表索引，从 0 开始，默认 0。
+	 */
+	/** {en}
+	 * @brief Zero-based HLS master variant index; defaults to 0.
+	 */
+	level?: number;
 	preloadScene?: LitePreloadScene;
 	prevCount?: number;
 	nextCount?: number;
@@ -1093,7 +1114,6 @@ export interface LitePlayerPlaybackStateSnapshot {
 	isBeforePlayerCreate: boolean;
 	albumId: string | null;
 	episodeId: string | null;
-	vid: string | null;
 	playbackSessionId: string;
 	duration: number;
 	currentTime: number;
@@ -1115,10 +1135,24 @@ export interface LiteVeStrategy {
 export type LiteEncryptInfo = Record<string, unknown>;
 /** A direct media entry accepted by Lite preload APIs. */
 export interface LitePreloadResolvedStream {
+	/** {zh}
+	 * @brief HLS 分片数量，覆盖策略默认值。
+	 */
+	/** {en}
+	 * @brief HLS segment count; overrides the strategy default.
+	 */
+	sn?: number;
+	/** {zh}
+	 * @brief HLS master 子列表索引，覆盖策略默认值。
+	 */
+	/** {en}
+	 * @brief Zero-based HLS master variant index; overrides the strategy default.
+	 */
+	level?: number;
 	vid: string;
 	url: string;
 	definition: string;
-	streamType: "mp4";
+	streamType: "mp4" | "hls";
 	codec: "h264";
 	bitrate: number;
 	duration: number;
@@ -1188,35 +1222,18 @@ export interface LiteDramaVideoInfo {
 }
 /** Short-drama bridge result with only Lite-safe media data. */
 export interface LiteDramaInfoResponse {
-	/** {zh} @brief 旧回包的顶层 Native 通参；优先使用 data.tracking_context。 */
-	/** {en} @brief Legacy top-level tracking fields; data.tracking_context takes priority. */
-	tracking_context?: {
-		enter_from?: string;
-		minis_type?: string;
-		minis_id?: string;
-		ttoclid?: string;
-	};
 	is_success: number | boolean;
 	error?: LiteDramaInfoError;
 	data?: {
-		/** {zh} @brief Native 埋点通参；缺失时不报对应字段。 */
-		/** {en} @brief Native tracking fields; omitted fields are not reported. */
-		tracking_context?: LiteDramaInfoResponse["tracking_context"];
 		status: number;
 		drama_info: {
-			drama_id?: string;
-			album_id?: string;
-			album_name?: string;
-			episode_total_num?: number;
-			drama_name?: string;
-			album_cover?: string;
-			drama_cover?: string;
-			album_description?: string;
-			drama_description?: string;
+			album_id: string;
+			drama_name: string;
+			drama_cover: string;
+			drama_description: string;
 		};
 		episode_info: {
 			episode_id: string;
-			episode_current_num?: number;
 			episode_name: string;
 			episode_cover: string;
 			episode_description: string;
@@ -1241,19 +1258,6 @@ export interface LiteTTDramaEnv {
 	getDramaInfo: (callback: (res: LiteDramaInfoResponse) => void, options: LiteDramaInfoRequest) => void;
 	videoSecurityModule?: unknown;
 	sendLog: (eventName: string, params: Record<string, unknown>) => void;
-	/** {zh}
-	 * @hidden
-	 * @brief 当前在播短剧身份变化通知，由宿主集成层消费。
-	 */
-	/** {en}
-	 * @hidden
-	 * @brief Notifies the host integration when the current drama playback identity changes.
-	 */
-	onCurrentDramaPlaybackContextChange?: (context: {
-		albumId: string | null;
-		episodeId: string | null;
-		vid: string | null;
-	} | null) => boolean | void;
 	getTokenVerifySecret?: () => Promise<string>;
 }
 export interface LiteDefaultConfig {