@volcengine/veplayer 1.15.3-rc.34 → 1.15.3-rc.36

package/index.d.ts

@@ -2289,6 +2289,8 @@ export interface ITTDramaEnv {
 	 * @type {boolean}
 	 */
 	canIUseGetDramaInfo: boolean;
+	/** 是否支持在 getDramaInfo 中透传 transcodeParam */
+	canIUseGetDramaInfoTranscodeParam?: boolean;
 	/**
 	 * @brief Android 是否支持批量获取短剧信息（高版本 app）
 	 * @type {boolean}
@@ -2319,6 +2321,20 @@ export interface IGetDramaInfoOptions {
 	albumId: string;
 	episodeId: string;
 	vid: string;
+	transcodeParam?: IGetDramaInfoTranscodeParam;
+}
+/** JSB/TTOP 使用的 snake_case 转码参数。 */
+export interface IGetDramaInfoTranscodeParam {
+	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;
 }
 export interface MinisError {
 	error_code: number;
@@ -2864,6 +2880,24 @@ export interface IGetDramaInfoPerfCallbackPayload {
 	 */
 	timestamp: number;
 }
+/** {zh}
+ * @brief Minis 短剧转码参数。各字段会由 VePlayer 转换为服务端 snake_case 命名后透传。
+ */
+/** {en}
+ * @brief Minis short-drama transcoding parameters. VePlayer converts the fields to server-side snake_case names before forwarding them.
+ */
+export interface ITranscodeParam {
+	format?: string;
+	codec?: string;
+	definition?: string;
+	fileType?: string;
+	needThumbs?: string;
+	needBarrageMask?: string;
+	unionInfo?: string;
+	quality?: string;
+	drmKek?: string;
+	jsPlayer?: string;
+}
 /** {zh}
  * @list Options
  * @kind property
@@ -2917,6 +2951,13 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @brief 剧集id，Minis 短剧播放需要
 	 */
 	episodeId?: string;
+	/** {zh}
+	 * @brief Minis 短剧转码参数。
+	 */
+	/** {en}
+	 * @brief Minis short-drama transcoding parameters.
+	 */
+	transcodeParam?: ITranscodeParam;
 	/** {zh}
 	 * @brief Vid 播放配置项。应用服务端需通过 `vid` 生成临时临时播放 Token，下发给客户端。
 	 * @type {IPlayAuthTokenConfig}
@@ -4729,9 +4770,11 @@ export declare type IPreloadDramaStream = {
 	 */
 	episodeId: string;
 	/**
-	 * 默认清晰度，用于缓存 key 和预加载流选择
+	 * 默认清晰度，仅用于从完整媒体信息中选择预加载流
 	 */
 	defaultDefinition?: string;
+	/** Minis 短剧转码参数。 */
+	transcodeParam?: ITranscodeParam;
 	/**
 	 * Vid 播放配置。短剧预加载会复用 playAuthToken 等配置请求短剧信息。
 	 */
@@ -4788,100 +4831,6 @@ declare class VeStrategyWrapper {
 	private initPreloaderConfig;
 }
 declare const _default: VeStrategyWrapper;
-/** {zh}
- * @hidden
- */
-export declare type IRes = IGetPlayInfoRes & {
-	Data: IGetPlayInfoRes & {
-		VideoID?: string;
-	};
-};
-declare enum VideoFileTypes {
-	VIDEO = "video",
-	EVIDEO = "evideo",
-	DRM_EVIDEO = "drm_evideo"
-}
-declare enum AudioFileTypes {
-	AUDIO = "audio",
-	EAUDIO = "eaudio",
-	DRM_AUDIO = "drm_eaudio"
-}
-export interface ITokenInfo {
-	Action?: string;
-	Codec?: ICodecType;
-	FileType?: VideoFileTypes | AudioFileTypes;
-	Format?: string;
-	Ssl?: 0 | 1;
-	Version?: string;
-	Vid?: string;
-	"X-Algorithm"?: string;
-	"X-Credential"?: string;
-	"X-Expires"?: number | string;
-	"X-Date"?: string;
-	"X-Signature"?: string;
-	"X-SignedQueries"?: string;
-	DrmType?: string;
-	PlayAuthIds?: string;
-	[propName: string]: string | number;
-}
-/** {zh}
- * @hidden
- */
-export interface IDefItem extends Stream {
-	vid: string;
-	lineId?: number;
-	lineName?: string;
-	url: string;
-	streamType: string;
-	backupUrl: string;
-	backUrlList: string[];
-	fileType?: "video" | "audio" | "evideo" | "eaudio";
-	format: string;
-	bitrate?: number;
-	size?: number;
-	kid?: string;
-	vwidth?: number;
-	vheight?: number;
-}
-/** {zh}
- * @hidden
- */
-export interface VideoInfoRes {
-	playList: IDefItem[];
-	type?: string;
-	poster: string;
-	vid: string;
-	duration: number;
-	dashOpts: IRes | {
-		Data: IRes;
-	};
-	thumbs: IThumbInfoItem[];
-	barrageMaskUrl: string;
-	enableAdaptive?: boolean;
-	adaptiveBitrateStreamingInfo?: ABRInfo;
-}
-export interface ICreatePlayerPerfTiming {
-	name: string;
-	duration: number;
-}
-export interface ICreatePlayerPerfReport {
-	totalDuration: number;
-	timings: ICreatePlayerPerfTiming[];
-	timingMap: Record<string, number>;
-}
-declare class CreatePlayerPerfCollector {
-	private now;
-	private startAt;
-	private timings;
-	private timingMap;
-	constructor();
-	markDuration(name: string, durationMs: number): void;
-	measure<T>(name: string, fn: () => T): T;
-	measureAsync<T>(name: string, fn: () => Promise<T>): Promise<T>;
-	finish(): ICreatePlayerPerfReport;
-}
-export declare type CollectorConstructor = new (name: string) => any;
-declare function isMSESupport(mime?: string): boolean;
 /** UMD modules that can be loaded or explicitly pre-registered. */
 export declare enum UmdKeys {
 	HLS = "hls",
@@ -5162,7 +5111,7 @@ declare class AuthToken extends SdkPlugin {
 	playInfo?: VideoInfoRes;
 	constructor(args: any);
 	beforePlayerCreate(): Promise<void>;
-	getVideoInfo(): Promise<{
+	getVideoInfo(sourceConfigs?: IPlayerConfig): Promise<{
 		vid: string;
 		playList: Stream[];
 		codec: ICodecType;
@@ -5171,7 +5120,7 @@ declare class AuthToken extends SdkPlugin {
 	/**
 	 * 短剧 Minis 环境：通过 JSB getDramaInfo 获取媒体信息
 	 */
-	getDramaInfoViaJSB(): Promise<VideoInfoRes | undefined>;
+	getDramaInfoViaJSB(sourceConfigs?: IPlayerConfig): Promise<VideoInfoRes | undefined>;
 	/**
 	 * 将审核状态映射到短剧错误码
 	 */
@@ -5190,7 +5139,7 @@ declare class AuthToken extends SdkPlugin {
 		episodeId?: string;
 		vid?: string;
 	}): void;
-	getVideos(): Promise<any>;
+	getVideos(sourceConfigs?: IPlayerConfig): Promise<any>;
 	getPrivateDrmInfo(playList: Stream[], vid: string, streamType: string): Promise<void>;
 	getThumbnailConfig(thumbs: IThumbInfoItem[]): void;
 	getBarrageMaskUrl(url: string): void;
@@ -5207,11 +5156,11 @@ declare class AuthToken extends SdkPlugin {
 	 */
 	get isMinisDramaMode(): boolean;
 	init(): void;
-	initConfig(getVideoByToken: IPlayAuthTokenConfig): void;
+	initConfig(getVideoByToken: IPlayAuthTokenConfig, sourceConfigs?: IPlayerConfig): void;
 	/**
 	 * 剧集切换：configs 已由 player 更新 album_id/episode_id，重新拉取媒体信息
 	 */
-	updateDramaEpisode(isNewVideo: boolean): Promise<void>;
+	updateDramaEpisode(isNewVideo: boolean, candidateConfig?: IPlayerConfig): Promise<void>;
 	/**
 	 * @description 更新playAuthToken
 	 * @param {IPlayAuthTokenConfig} getVideoByToken token信息
@@ -5411,6 +5360,10 @@ declare class PlayerData {
 	 */
 	get playDomain(): string;
 	setVodTeaId(): void;
+	/**
+	 * 基于当前配置生成合并后的候选配置，不修改当前播放状态。
+	 */
+	getMergedConfigs(newConfigs: IPlayerConfig): IPlayerConfig;
 	/**
 	 * 更新configs,即更新用户的configs，常用于playNext时
 	 * @param newConfigs {IPlayerConfig} 要更新的配置
@@ -6221,6 +6174,7 @@ declare class VePlayer {
 	playNext(config: IPlayerConfig, isNewVideo?: boolean): Promise<any>;
 	private updatePlayNextSubtitleConfig;
 	private _playNext;
+	private _createDramaPlayNextCandidateConfig;
 	/** 从 playerData.configs 取出短剧 id，供 XGPlayer setConfig / playNext 与切换后 configs 一致 */
 	private _getDramaConfigPatchForPlayer;
 	private _buildDramaInvalidParamError;