@byteplus/veplayer 1.17.0-rc.7 → 1.17.0-rc.8

package/index.d.ts

@@ -3349,6 +3349,23 @@ export interface IPlayerConfig extends IPlayerOptions {
 	 * @default false
 	 */
 	enableHlsMSE?: boolean;
+	/** {zh}
+	 * @brief 移动端播放 HLS 时优先使用 hls.js 插件（MSE/MMS）：
+	 * - **Android**：直接启用 hls.js 播放。
+	 * - **iOS**：仅在设备支持 `ManagedMediaSource`（iOS 17.1+，即 `VePlayer.isMMSSupported()` 为 `true`）时启用；
+	 *   不满足时自动回退至原生 HLS 播放。
+	 * 开启后可在移动端解锁多音轨切换、`setAudioOption` 偏好持久化等 hls.js 特有能力。
+	 * @default false
+	 */
+	/** {en}
+	 * @brief Prefer hls.js (MSE/MMS) for HLS playback on mobile:
+	 * - **Android**: always enables hls.js.
+	 * - **iOS**: enables hls.js only when `ManagedMediaSource` is supported (iOS 17.1+,
+	 *   i.e. `VePlayer.isMMSSupported()` returns `true`); falls back to native HLS otherwise.
+	 * Unlocks hls.js-specific features such as multi-audio-track switching on mobile.
+	 * @default false
+	 */
+	enableMobileHlsPlugin?: boolean;
 	/** {zh}
 	 * @brief 是否启用 {@link https://hlsjs.video-dev.org/ hls.js} 插件播放HLS视频，默认为true，设置为false后，PC端播放HLS使用自研hls插件播放HLS视频
 	 * @default true
@@ -6132,10 +6149,23 @@ declare class VePlayer {
 	/** {zh}
 	 * @brief 切换音频轨道。
 	 * @param id 目标轨道的 id，可通过 `getAudioTracks()` 获取。
+	 * @param lang 目标轨道的语言代码（BCP-47）。若提供，则 id 与 lang 同时匹配时才执行切换，
+	 *             可用于 iOS 原生 audioTracks 中存在重复 id 的场景。
 	 * @notes 切换完成后会触发 `Events.AUDIO_TRACK_CHANGE` 事件；
 	 *        同时 PC 端和移动端音频轨道插件的选中状态会自动更新。
 	 */
-	switchAudioTrack(id: string | number): void;
+	switchAudioTrack(track: {
+		id: string | number;
+		lang?: string;
+		assocLang?: string;
+		characteristics?: string;
+		channels?: string;
+		name?: string;
+		audioCodec?: string;
+		groupId?: string;
+		default?: boolean;
+		[key: string]: unknown;
+	}): void;
 	/** {zh}
 	 * @brief 当前播放器命中预加载的情况
 	 * @type {{