@byteplus/veplayer 1.18.0-rc.6 → 1.18.0-rc.7

package/lite.d.ts

@@ -118,6 +118,32 @@ export interface LitePlayAuthTokenConfig {
 	autoDemoteDefinitionTextKey?: string;
 	urlQueryParams?: Record<string, string>;
 }
+/** Minis short-drama transcoding options exposed by Lite. */
+export interface LiteTranscodeParam {
+	format?: string;
+	codec?: string;
+	definition?: string;
+	fileType?: string;
+	needThumbs?: string;
+	needBarrageMask?: string;
+	unionInfo?: string;
+	quality?: string;
+	drmKek?: string;
+	jsPlayer?: string;
+}
+/** Snake-case transcode parameters passed to the host drama bridge. */
+export interface LiteDramaInfoTranscodeParam {
+	format?: string;
+	codec?: string;
+	definition?: string;
+	file_type?: string;
+	need_thumbs?: string;
+	need_barrage_mask?: string;
+	union_info?: string;
+	quality?: string;
+	drm_kek?: string;
+	js_player?: string;
+}
 /** Lite-only preloading scene values supported by the player runtime. */
 export type LitePreloadScene = 0 | 1;
 /** Lite-safe preload strategy configuration. */
@@ -161,6 +187,19 @@ export interface LiteMediaInfoCacheState {
 	expireTime: number;
 	maxEntries: number;
 }
+/** Stable playback lifecycle values exposed to JSSDK integrations. */
+export type LitePlayerPlaybackState = "creating" | "ready" | "playing" | "paused" | "buffering" | "ended" | "error" | "destroyed";
+/** Current or most recently played VePlayer snapshot. Times are in seconds. */
+export interface LitePlayerPlaybackStateSnapshot {
+	playbackState: LitePlayerPlaybackState;
+	isEnded: boolean;
+	isPaused: boolean;
+	isBeforePlayerCreate: boolean;
+	albumId: string | null;
+	episodeId: string | null;
+	duration: number;
+	currentTime: number;
+}
 /** Minimal preloader operations available from the Lite static surface. */
 export interface LitePreloaderManager {
 	removeAll(): void;
@@ -193,6 +232,7 @@ export interface LitePreloadDramaStream {
 	albumId: string;
 	episodeId: string;
 	defaultDefinition?: string;
+	transcodeParam?: LiteTranscodeParam;
 	getVideoByToken?: LitePlayAuthTokenConfig;
 }
 /** A token-resolved VOD item accepted by Lite preload APIs. */
@@ -209,6 +249,7 @@ export interface LiteDramaInfoRequest {
 	albumId: string;
 	episodeId: string;
 	vid: string;
+	transcodeParam?: LiteDramaInfoTranscodeParam;
 }
 /** Error returned by the host short-drama bridge. */
 export interface LiteDramaInfoError {
@@ -280,6 +321,7 @@ export interface LiteTTDramaEnv {
 	appVersion: string;
 	clientKey: string;
 	canIUseGetDramaInfo: boolean;
+	canIUseGetDramaInfoTranscodeParam?: boolean;
 	canAndroidBatchGetDramaInfo?: boolean;
 	getDramaInfo: (callback: (res: LiteDramaInfoResponse) => void, options: LiteDramaInfoRequest) => void;
 	videoSecurityModule?: unknown;
@@ -428,6 +470,7 @@ export interface LitePlayerConfig<MediaUrl extends LiteMediaUrl = LiteMediaUrl,
 	vid?: string;
 	albumId?: string;
 	episodeId?: string;
+	transcodeParam?: LiteTranscodeParam;
 	onGetMediaInfo?: (...args: unknown[]) => void;
 	onGetDramaInfoPerf?: (...args: unknown[]) => void;
 	autoSubtitle?: boolean;
@@ -624,6 +667,7 @@ export interface LiteVePlayerConstructor {
 	setMediaInfoCacheConfig(config: LiteMediaInfoCacheConfig): void;
 	getMediaInfoCacheConfig(): LiteMediaInfoCacheState;
 	clearMediaInfoCache(): void;
+	getPlayerPlaybackState(): LitePlayerPlaybackStateSnapshot | null;
 	generateEncryptInfo(unionId: string, streamType: "hls" | "mp4" | "dash"): Promise<LiteEncryptInfo | undefined>;
 }
 declare const LiteVePlayer: LiteVePlayerConstructor;