@volcengine/veplayer 1.15.3-rc.35 → 1.15.3-rc.37

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 等配置请求短剧信息。
 	 */
@@ -5068,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;
@@ -5077,7 +5120,7 @@ declare class AuthToken extends SdkPlugin {
 	/**
 	 * 短剧 Minis 环境：通过 JSB getDramaInfo 获取媒体信息
 	 */
-	getDramaInfoViaJSB(): Promise<VideoInfoRes | undefined>;
+	getDramaInfoViaJSB(sourceConfigs?: IPlayerConfig): Promise<VideoInfoRes | undefined>;
 	/**
 	 * 将审核状态映射到短剧错误码
 	 */
@@ -5096,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;
@@ -5113,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信息
@@ -5317,6 +5360,10 @@ declare class PlayerData {
 	 */
 	get playDomain(): string;
 	setVodTeaId(): void;
+	/**
+	 * 基于当前配置生成合并后的候选配置，不修改当前播放状态。
+	 */
+	getMergedConfigs(newConfigs: IPlayerConfig): IPlayerConfig;
 	/**
 	 * 更新configs,即更新用户的configs，常用于playNext时
 	 * @param newConfigs {IPlayerConfig} 要更新的配置
@@ -6127,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;