@volcengine/veplayer 1.18.0-rc.2 → 1.18.0-rc.4

package/index.d.ts

@@ -882,8 +882,13 @@ export interface IListItem {
 	 */
 	[propName: string]: any;
 }
-/**
- * @brief 字幕文案配置
+/** {zh}
+ * @brief 字幕文案配置。
+ * @list Options
+ * @kind property
+ */
+/** {en}
+ * @brief Subtitle text item configuration.
  * @list Options
  * @kind property
  */
@@ -930,7 +935,7 @@ export interface ITextItem {
 	 */
 	index?: number;
 }
-/**
+/** {zh}
  * @brief 清晰度降级配置。
  * @list Options
  * @kind property
@@ -941,7 +946,7 @@ export interface ITextItem {
  * @kind property
  */
 export interface IDefinitionDemotePlugin {
-	/**
+	/** {zh}
 	 * @brief 是否开启自动降级，取值如下：
 	 *        - `false`：关闭自动降级。
 	 *        - `true`：开启自动降级。
@@ -954,7 +959,7 @@ export interface IDefinitionDemotePlugin {
 	 *        - `true`: automatic downgrade is enabled.
 	 */
 	isNeedAutoDemote?: boolean;
-	/**
+	/** {zh}
 	 * @brief 清晰度降级顺序。数组中的元素需与 `playList` 中的 `definition` 相对应。
 	 * @default []
 	 *
@@ -962,49 +967,59 @@ export interface IDefinitionDemotePlugin {
 	 * @memberof IDefinitionDemotePlugin
 	 */
 	/** {en}
+	 * @brief The order of definition downgrade. The elements in the array should correspond to the `definition` in the `playList`.
+	 * @default []
+	 *
+	 * @type {string[]}
+	 * @memberof IDefinitionDemotePlugin
 	 */
 	demotePriority: string[];
-	/**
+	/** {zh}
 	 * @brief 长时间卡顿的时间阈值，单位为毫秒。卡顿时长超过该值，即视为长时间卡顿。发生长时间卡顿时，SDK 会触发 `LONG_WAITING` 事件。
 	 * @default 5000
 	 *
 	 */
 	/** {en}
+	 * @brief The threshold for long waiting time, in milliseconds. If the waiting time exceeds this value, it is considered as long waiting. The `LONG_WAITING` event will be triggered when long waiting occurs.
 	 * @default 5000
 	 *
 	 */
 	longWaitingTime?: number;
-	/**
+	/** {zh}
 	 * @brief 频繁卡顿的次数阈值。`oftenWaitingTime` 内卡顿次数大于或等于阈值时，SDK 会触发 `OFTEN_WAITING` 事件，提示发生了频繁卡顿。
 	 * @default 3
 	 *
 	 */
 	/** {en}
+	 * @brief The threshold for frequent stuttering, in milliseconds. If the stuttering count exceeds this value, the `OFTEN_WAITING` event will be triggered, indicating frequent stuttering.
 	 * @default 3
 	 *
 	 */
 	oftenWaitingCount?: number;
-	/**
+	/** {zh}
 	 * @brief 频繁卡顿监测的时间范围。`oftenWaitingTime` 内卡顿次数大于或等于 `oftenWaitingCount` 时，SDK 会触发 `OFTEN_WAITING` 事件，提示发生了频繁卡顿。
 	 * @default 5000
 	 */
 	/** {en}
+	 * @brief The time range for frequent stuttering monitoring. If the stuttering count exceeds `oftenWaitingCount` within `oftenWaitingTime`, the `OFTEN_WAITING` event will be triggered, indicating frequent stuttering.
 	 * @default 5000
 	 */
 	oftenWaitingTime?: number;
-	/**
+	/** {zh}
 	 * @brief 卡顿时是否显示清晰度降级提示 toast。
 	 * @default true
 	 */
 	/** {en}
+	 * @brief Whether to display the definition downgrade toast.
 	 * @default true
 	 */
 	isNeedShowTips?: boolean;
-	/**
+	/** {zh}
 	 * @brief 清晰度降级提示 toast 的显示时长，单位为毫秒。
 	 * @default 3000
 	 */
 	/** {en}
+	 * @brief The duration of the definition downgrade toast, in milliseconds.
 	 * @default 3000
 	 */
 	toastShowTime?: number;
@@ -1040,79 +1055,253 @@ export declare class DefinitionDemotePlugin extends Plugin {
 	showToast(definition: Stream): void;
 	destroy(): void;
 }
-/**
- * 音轨选择选项。
+/** {zh}
+ * @brief 音轨选择选项。
  * 对应 hls.js `AudioSelectionOption` 的所有字段，所有字段均可选。
- * 用于 `switchAudioTrack()` 参数（配合 `id` 使用）以及 `audioPreference` 配置。
+ * 用于 `switchAudioTrack()` 参数以及 `audioPreference` 配置。
+ * @list Options
+ * @kind property
+ */
+/** {en}
+ * @brief Audio track selection options.
+ * Corresponding to all fields of hls.js `AudioSelectionOption`, all fields are optional.
+ * Used for `switchAudioTrack()` and `audioPreference` configuration.
+ * @list Options
+ * @kind property
  */
 export interface AudioTrackOption {
+	/** {zh}
+	 * @brief 音轨主要语言，BCP-47 格式（如 `zh`、`en`）。对应 `#EXT-X-MEDIA` 的 `LANGUAGE`。
+	 */
+	/** {en}
+	 * @brief Primary track language in BCP-47 format (e.g. `zh`, `en`). Maps to `#EXT-X-MEDIA` `LANGUAGE`.
+	 */
 	lang?: string;
+	/** {zh}
+	 * @brief 关联语言代码。对应 `#EXT-X-MEDIA` 的 `ASSOC-LANGUAGE`。
+	 */
+	/** {en}
+	 * @brief Associated language code. Maps to `#EXT-X-MEDIA` `ASSOC-LANGUAGE`.
+	 */
 	assocLang?: string;
+	/** {zh}
+	 * @brief 轨道特征描述字符串。对应 `#EXT-X-MEDIA` 的 `CHARACTERISTICS`（如 `public.accessibility.describes-video`）。
+	 */
+	/** {en}
+	 * @brief Track characteristics string. Maps to `#EXT-X-MEDIA` `CHARACTERISTICS`.
+	 */
 	characteristics?: string;
+	/** {zh}
+	 * @brief 声道数。对应 `#EXT-X-MEDIA` 的 `CHANNELS`（如 `"2"`）。
+	 */
+	/** {en}
+	 * @brief Number of audio channels. Maps to `#EXT-X-MEDIA` `CHANNELS` (e.g. `"2"`).
+	 */
 	channels?: string;
+	/** {zh}
+	 * @brief 音轨名称，用于展示或精确匹配（如 `Stereo`）。hls.js 路径下与 `lang` 组合可唯一定位轨道。
+	 */
+	/** {en}
+	 * @brief Track name for display or precise matching (e.g. `Stereo`). With `lang`, uniquely identifies a track on the hls.js path.
+	 */
 	name?: string;
+	/** {zh}
+	 * @brief 音频编解码器标识（如 `mp4a.40.2`）。
+	 */
+	/** {en}
+	 * @brief Audio codec identifier (e.g. `mp4a.40.2`).
+	 */
 	audioCodec?: string;
+	/** {zh}
+	 * @brief 音频组 ID。对应 `#EXT-X-MEDIA` 的 `GROUP-ID`。
+	 */
+	/** {en}
+	 * @brief Audio group ID. Maps to `#EXT-X-MEDIA` `GROUP-ID`.
+	 */
 	groupId?: string;
+	/** {zh}
+	 * @brief 是否为 manifest 中的默认音轨。
+	 */
+	/** {en}
+	 * @brief Whether this is the default track declared in the manifest.
+	 */
 	default?: boolean;
+	/** {zh}
+	 * @hidden
+	 */
+	/** {en}
+	 * @hidden
+	 */
 	[key: string]: unknown;
 }
+/** {zh}
+ * @detail Api
+ * @brief HLS 音轨对象。在 `AudioTrackOption` 基础上包含列表索引与展示名称。
+ */
+/** {en}
+ * @detail Api
+ * @brief HLS audio track object. Extends `AudioTrackOption` with list index and display name.
+ */
 export interface AudioTrack extends AudioTrackOption {
+	/** {zh}
+	 * @brief 轨道在 `audioTracks` 列表中的索引（hls.js 与原生路径均为 number）。
+	 */
+	/** {en}
+	 * @brief Track index in the `audioTracks` list (number on both hls.js and native paths).
+	 */
 	id: number;
+	/** {zh}
+	 * @brief 展示名称（由 `lang` / `name` 等字段生成或来自 manifest）。
+	 */
+	/** {en}
+	 * @brief Display name (derived from `lang` / `name` or from the manifest).
+	 */
 	name: string;
+	/** {zh}
+	 * @brief 是否为 manifest 默认音轨。
+	 */
+	/** {en}
+	 * @brief Whether this is the default track in the manifest.
+	 */
 	default: boolean;
 }
-/**
- * `getAudioTracks()` / `getCurrentAudioTrack()` 的返回项类型。
- * 是 `switchAudioTrack()` 参数类型的子类型，可直接传入。
+/** {zh}
+ * @detail Api
+ * @brief `getAudioTracks()` / `getCurrentAudioTrack()` 的返回项类型，可直接传入 `switchAudioTrack()`。
+ */
+/** {en}
+ * @detail Api
+ * @brief Return type of `getAudioTracks()` / `getCurrentAudioTrack()`; can be passed directly to `switchAudioTrack()`.
  */
 export interface AudioTrackInfo extends AudioTrack {
-	/** 是否为当前激活轨道。`getCurrentAudioTrack()` 返回时始终为 `true`。 */
+	/** {zh}
+	 * @brief 是否为当前激活轨道。`getCurrentAudioTrack()` 返回时始终为 `true`。
+	 */
+	/** {en}
+	 * @brief Whether this is the currently active track. Always `true` when returned by `getCurrentAudioTrack()`.
+	 */
 	selected: boolean;
 }
+/** {zh}
+ * @brief PC 端音轨切换插件配置。
+ * @list Options
+ * @kind property
+ */
+/** {en}
+ * @brief PC audio track selector plugin configuration.
+ * @list Options
+ * @kind property
+ */
 export interface IAudioTrackConfig {
-	/** 控件在控制栏中的排列顺序，数值越小越靠左。@default 5 */
+	/** {zh}
+	 * @brief 控件在控制栏中的排列顺序，数值越小越靠左。
+	 * @default 70
+	 */
+	/** {en}
+	 * @brief Sort weight in the control bar; smaller values appear further left.
+	 * @default 70
+	 */
 	index?: number;
-	/** 是否显示图标按钮。@default true */
+	/** {zh}
+	 * @brief 是否显示音轨切换图标按钮。
+	 * @default true
+	 */
+	/** {en}
+	 * @brief Whether to show the audio track switcher icon.
+	 * @default true
+	 */
 	isShowIcon?: boolean;
-	/** 竖屏时是否隐藏控件。@default false */
+	/** {zh}
+	 * @brief 竖屏时是否隐藏音轨控件。
+	 * @default false
+	 */
+	/** {en}
+	 * @brief Whether to hide the audio track control in portrait orientation.
+	 * @default false
+	 */
 	hidePortrait?: boolean;
-	/** 音轨列表中是否在语言名称后显示括号内的原始轨道名，如 `日本語 (Stereo AudioTrack1)`。@default true */
+	/** {zh}
+	 * @brief 音轨列表中是否在语言名称后显示括号内的原始轨道名，如 `日本語 (Stereo AudioTrack1)`。
+	 * @default true
+	 */
+	/** {en}
+	 * @brief Whether to append the raw track name in parentheses after the language label, e.g. `Japanese (Stereo AudioTrack1)`.
+	 * @default true
+	 */
 	showNameSuffix?: boolean;
 }
+/** {zh}
+ * @brief 移动端音轨切换插件配置。
+ * @list Options
+ * @kind property
+ */
+/** {en}
+ * @brief Mobile audio track selector plugin configuration.
+ * @list Options
+ * @kind property
+ */
 export interface IAudioTrackMobileConfig {
-	/** 控件在控制栏中的排列顺序，数值越小越靠左。@default 2.6 */
+	/** {zh}
+	 * @brief 控件在控制栏中的排列顺序，数值越小越靠左。
+	 * @default 2.6
+	 */
+	/** {en}
+	 * @brief Sort weight in the control bar; smaller values appear further left.
+	 * @default 2.6
+	 */
 	index?: number;
-	/** 是否显示图标按钮。@default true */
+	/** {zh}
+	 * @brief 是否显示音轨切换图标按钮。
+	 * @default true
+	 */
+	/** {en}
+	 * @brief Whether to show the audio track switcher icon.
+	 * @default true
+	 */
 	isShowIcon?: boolean;
-	/** 音轨列表中是否在语言名称后显示括号内的原始轨道名，如 `日本語 (Stereo AudioTrack1)`。@default true */
+	/** {zh}
+	 * @brief 音轨列表中是否在语言名称后显示括号内的原始轨道名，如 `日本語 (Stereo AudioTrack1)`。
+	 * @default true
+	 */
+	/** {en}
+	 * @brief Whether to append the raw track name in parentheses after the language label, e.g. `Japanese (Stereo AudioTrack1)`.
+	 * @default true
+	 */
 	showNameSuffix?: boolean;
 }
-/**
+/** {zh}
  * @brief DASH 播放配置。
  * @list Options
  * @kind property
  */
 /** {en}
+ * @brief DASH playback configuration.
  * @list Options
  * @kind property
  */
 export interface IDashPluginConfig {
-	/**
+	/** {zh}
 	 * @brief 视频 ID。
 	 * @default -
 	 * @notes 播放加密视频时必选
 	 */
 	/** {en}
+	 * @brief Video ID.
 	 * @default -
+	 * @notes When playing encrypted videos, it is required.
 	 */
 	vid?: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 播放类型
 	 * @default TOP
 	 */
+	/** {en}
+	 * @brief Playback type.
+	 * @default TOP
+	 */
 	playInfoType: "TOP";
-	/**
+	/** {zh}
 	 * @brief 清晰度映射文案。
 	 * @default -
 	 * @example
@@ -1127,6 +1316,16 @@ export interface IDashPluginConfig {
 	 */
 	/** {en}
 	 * @brief Definition label mapping.
+	 * @default -
+	 * @example
+	 * ``` javascript
+	 * {
+	 *   360p: "SD 360p",
+	 *   480p: "HD 480p",
+	 *   720p: "FHD 720p",
+	 *   1080p: "UHD 1080p"
+	 * }
+	 * ```
 	 */
 	definitionText: Record<string, string>;
 	/**
@@ -1135,91 +1334,142 @@ export interface IDashPluginConfig {
 	 */
 	/** {en}
 	 * @brief Default definition.
+	 * @default The first definition in the list
 	 */
 	defaultDefinition?: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 * 获取证书地址
 	 * 默认：`//i.snssdk.com/video/drm/v1/play_licenses`
 	 * 播放加密视频时必选
 	 */
+	/** {en}
+	 * @brief Get the certificate address.
+	 * @default `//i.snssdk.com/video/drm/v1/play_licenses`
+	 * @notes When playing encrypted videos, it is required.
+	 */
 	getLicenseUrl?: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 * dash播放信息，由`Service.url`服务接口获取
 	 * 默认：无
 	 * 必选
 	 */
+	/** {en}
+	 * @hidden
+	 * @brief Dash playback information, obtained from the `Service.url` service interface.
+	 * @default -
+	 * @notes Required.
+	 */
 	dashOpts?: {
 		Data: any;
 	};
-	/**
+	/** {zh}
 	 * @brief 兜底的mp4播放列表，由`Service.url`服务接口获取
 	 * @default -
 	 * @hidden
 	 */
+	/** {en}
+	 * @brief Fallback mp4 playback list, obtained from the `Service.url` service interface.
+	 * @default -
+	 * @hidden
+	 */
 	mp4Opts: {
 		mp4List: mp4OptsItem[];
 	};
-	/**
-	 * 预加载时间，单位ms
+	/** {zh}
+	 * @brief 预加载时间，单位ms
 	 * @default 50
-	 * @brief 预加载时间，单位为毫秒。
 	 */
 	/** {en}
 	 * @brief Preload time in milliseconds.
+	 * @default 50
 	 */
 	preloadTime?: number;
-	/**
+	/** {zh}
 	 * @hidden
 	 * 自适应配置项
 	 * 默认：undefined
 	 * 非必选
 	 */
+	/** {en}
+	 * @brief Adaptive configuration item.
+	 * @default undefined
+	 * @hidden
+	 */
 	autoBitrateOpts?: any;
-	/**
+	/** {zh}
 	 * @hidden
 	 * 备用地址降级,默认情况下，当dash播放出问题后，会降级为mp4播放；
 	 * 设置改参数后，会优先使用备用地址进行dash的降级播放，再次出错时，会降级为mp4播放
 	 * 默认：false
 	 * 非必选
 	 */
+	/** {en}
+	 * @brief Fallback address degradation. By default, when dash playback fails, it will be downgraded to mp4 playback.
+	 * @default false
+	 * @hidden
+	 */
 	useBackUrl?: boolean;
-	/**
+	/** {zh}
 	 * @hidden
 	 * 优化首帧
 	 * 是针对域名，将range参数放在url后面，避免OPTIONS请求，从而优化首帧
 	 * 默认：无
 	 * 非必选
 	 */
+	/** {en}
+	 * @brief Optimize the first frame.
+	 * @default undefined
+	 * @hidden
+	 */
 	url_range_domains?: string[];
 }
-/**
+/** {zh}
  * @brief dash播放的mp4兜底播放列表配置
  * @list Options
+ * @kind property
+ * @hidden
+ */
+/** {en}
+ * @brief Fallback mp4 playback list configuration for dash playback.
+ * @list Options
+ * @kind property
  * @hidden
  */
 export interface mp4OptsItem {
-	/**
+	/** {zh}
 	 * 清晰度
 	 * 默认： 无
 	 * 必传
 	 */
+	/** {en}
+	 * @brief Definition for fallback mp4 playback.
+	 * @default -
+	 * @notes Required.
+	 */
 	definition: string;
-	/**
-	 * mp4地址
-	 * 默认： 无
-	 * 必传
+	/** {zh}
+	 * @briefmp4地址
+	 * @default -
+	 * @notes Required.
+	 */
+	/** {en}
+	 * @brief URL for fallback mp4 playback.
+	 * @default -
+	 * @notes Required.
 	 */
 	url: string;
 }
-/**
+/** {zh}
  * @brief HLS 加密播放配置。
  * @list Options
  * @kind property
  */
 /** {en}
  * @brief HLS encrypted playback configuration.
+ * @list Options
+ * @kind property
  */
 export interface IEncryptHlsPluginConfig {
 	/** {zh}
@@ -1231,49 +1481,77 @@ export interface IEncryptHlsPluginConfig {
 	 * @default https://vod.byteplusapi.com
 	 */
 	playDomain?: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 请求类型，固定值 'TOP'
 	 * @default TOP
 	 */
+	/** {en}
+	 * @brief Request type, fixed value 'TOP'
+	 * @default TOP
+	 * @hidden
+	 */
 	getKeyType?: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 密钥请求域名
 	 * @default https://vod.volcengineapi.com
 	 */
+	/** {en}
+	 * @brief Request domain name for key request
+	 * @default https://vod.byteplusapi.com
+	 */
 	keyDomain?: string;
-	/**
+	/** {zh}
 	 * @brief 播放地址获取token，由服务端生成下发，详见{@link https://www.volcengine.com/docs/4/67350#%E4%B8%B4%E6%97%B6%E5%AE%89%E5%85%A8%E5%87%AD%E8%AF%81%E6%9C%BA%E5%88%B6%E8%AF%B4%E6%98%8E 播放临时安全凭证（PlayAuthToken）}
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Playback address acquisition token, generated by the server and distributed by the server, see {@link https://docs.byteplus.com/en/docs/byteplus-vod/reference-getplayinfo PlayAuthToken}
+	 * @default -
+	 */
 	playAuthToken?: string;
-	/**
+	/** {zh}
 	 * @brief 密钥获取token，由服务端生成下发，详见{@link https://www.volcengine.com/docs/4/65659#%E7%AD%BE%E5%8F%91-hls-%E6%A0%87%E5%87%86%E5%8A%A0%E5%AF%86-authtoken%EF%BC%88sha1hlsdrmauthtoken%EF%BC%89 签发 Hls 标准加密AuthToken}
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Key acquisition token, generated by the server and distributed by the server, see {@link https://docs.byteplus.com/en/docs/byteplus-vod/docs-go-sdk#generating-hls-decryption-token keyToken}
+	 */
 	keyToken: string;
 }
-/**
+/** {zh}
  * @brief 质量日志上报配置。
  * @list Options
  * @kind property
  */
 /** {en}
  * @brief Quality log configuration.
+ * @list Options
+ * @kind property
  */
 export interface IVodLogOptsConfig {
-	/**
+	/** {zh}
 	 * @brief 视频点播应用 ID。您可在视频{@link https://console.volcengine.com/vod/region:vod+cn-north-1/sdk/app/ 点播控制台 > 点播SDK > 应用管理}页面获取应用 ID（App ID）。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief VOD application ID. You can get the application ID (App ID) on the video {@link https://console.byteplus.com/vodpaas/region:vodpaas+ap-singapore-1/sdk/app/?projectName=default VOD Console > VOD SDK > application management} page.
+	 * @default -
+	 */
 	line_app_id: number;
-	/**
+	/** {zh}
 	 * @brief 用于识别单一用户的 ID，可在{@link https://www.volcengine.com/docs/4/75736#qoe-%E6%8C%87%E6%A0%87%E8%AF%B4%E6%98%8E QoE指标}中用于用户维度的筛选，也可以用于{@link https://www.volcengine.com/docs/4/106093 单点追查} 查找单用户的播放日志
 	 * 用户 ID 对应于单点追查功能的查询条件中的设备 ID 维度。如不设置用户 ID，VePlayer 将根据用户浏览器随机生成一个值，该值会在浏览器端缓存。
 	 * @notes 强烈建议您使用与业务相关的用户 ID，以便在发生播放错误时通过{@link https://console.volcengine.com/vod/region:vod+cn-north-1/quality_control/SingleTracing/?Tab=play 点播控制台 > 质量平台 > 单点追查}功能排查故障。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief The ID used to identify a single user. It can be used for user-level filtering in {@link https://docs.byteplus.com/en/docs/byteplus-vod/docs-quality-insight-overview QoE indicators}, and also for {@link https://www.volcengine.com/docs/4/106093 single-point tracing} to find the playback logs of a single user.
+	 * The user ID corresponds to the device ID dimension in the query conditions of the single-point tracing function. If no user ID is set, VePlayer will generate a random value according to the user's browser, which will be cached in the browser.
+	 * @notes It is strongly recommended to use a user ID related to your business to troubleshoot problems through the {@link https://docs.byteplus.com/en/docs/byteplus-vod/docs-end-point-tracker VOD Console > Quality Platform > Single Tracing} function.
+	 * @default -
+	 */
 	line_user_id: string | number;
 	/**
 	 * @hidden
@@ -1281,154 +1559,273 @@ export interface IVodLogOptsConfig {
 	 * @default MP4
 	 */
 	vtype?: "MP4" | "HLS" | "DASH" | "FLV";
-	/**
+	/** {zh}
 	 * @brief 业务标签。对应于质量平台上的业务类型维度，其作用是区分业务中的不同场景，以便进行多维度分析。举例来说，假设您的应用中包含短视频和长视频两个场景，则可分别将 `tag` 设为 `short` 和 `long`。这样一来，您就能够在{@link https://www.volcengine.com/docs/4/120175 质量平台}上通过业务标签维度查询或过滤不同场景的数据。
 	 * @notes 如需自定义配置 tag 值在点播控制台上的展示文案，请联系{@link https://www.volcengine.com/docs/4/108992#%E5%94%AE%E5%90%8E%E6%94%AF%E6%8C%81 技术支持}
 	 * @default 普通视频
 	 */
+	/** {en}
+	 * @brief Business tag. Corresponds to the business type dimension on the quality platform, which is used to distinguish different scenarios in the business and facilitate multi-dimensional analysis. For example, if your application contains short video and long video scenarios, you can set `tag` to `short` and `long` respectively. This way, you can query or filter data for different scenarios through the business tag dimension on the {@link https://docs.byteplus.com/en/docs/byteplus-vod/docs-end-point-tracker quality platform}.
+	 * @notes If you need to customize the display text of `tag` in the VOD Console, please contact {@link https://docs.byteplus.com/en/docs/byteplus-vod/docs-quality-insight-overview technical support}.
+	 * @default Normal
+	 */
 	tag?: string;
-	/**
+	/** {zh}
 	 * @brief 自定义子标签。对应于质量平台上的自定义标签维度，与 `tag` 配合使用，可用于区分同一业务类型下更为细分的音视频类型，比如加密视频、非加密视频、音频等。
 	 * @default -
 	 */
 	/** {en}
 	 * @brief Custom sub-tag for quality platform analytics; use with `tag` to distinguish sub-types such as encrypted/non-encrypted video or audio.
+	 * @default -
 	 */
 	subtag?: string;
-	/**
+	/** {zh}
 	 * @brief 视频编码类型，取值如下
 	 * - `h264`：H.264
 	 * - `h265`：H.265
 	 * @default unknown
 	 */
+	/** {en}
+	 * @brief Video codec type, values:
+	 * - `h264`: H.264
+	 * - `h265`: H.265
+	 * @default unknown
+	 */
 	codec_type?: "h264" | "h265";
-	/**
+	/** {zh}
 	 * @brief 是否加密，0:非drm视频，1：drm视频
 	 * @hidden
 	 * @default 0
 	 */
+	/** {en}
+	 * @brief Whether the video is encrypted, 0: non-drm video, 1: drm video
+	 * @hidden
+	 * @default 0
+	 */
 	drm_type?: 0 | 1;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 播放内核版本号
 	 */
+	/** {en}
+	 * @brief Player core version number
+	 * @hidden
+	 * @default -
+	 */
 	playerCoreVersion?: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 播放器版本号
 	 */
+	/** {en}
+	 * @brief Player version number
+	 * @hidden
+	 * @default -
+	 */
 	playerVersion?: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief DASH播放的封装类型
 	 */
+	/** {en}
+	 * @brief DASH playback packaging type
+	 * @hidden
+	 * @default -
+	 */
 	dynamic_type?: "segment_base" | "segment_template";
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 是否使用bash，0:不使用，1：使用
 	 * @default 0
 	 */
+	/** {en}
+	 * @brief Whether to use bash, 0: not use, 1: use
+	 * @hidden
+	 * @default 0
+	 */
 	enable_bash?: 0 | 1;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 发送的埋点日志是本地缓存的时候回调
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Callback when the local cache of the sent log is sent
+	 * @hidden
+	 * @default -
+	 */
 	sendLocalCallback?: (event: any, data: any) => void;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 是否禁用localStorage暂时缓存onPlay逻辑
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to disable localStorage temporarily cache onPlay logic
+	 * @hidden
+	 * @default false
+	 */
 	disableLocalCache?: boolean;
-	/**
+	/** {zh}
 	 * @brief 日志上报渠道，可选值：cn(国内) 、sg(新加坡)
 	 * @default cn
+	 * @hidden
+	 */
+	/** {en}
+	 * @brief Log reporting channel, optional values: cn(domestic) 、va(overseas) 、sg(Singapore)
+	 * @default sg
+	 * @hidden
 	 */
 	channel?: "cn" | "va" | "sg";
-	/**
+	/** {zh}
 	 * @brief 日志上报额外配置
 	 * @note 火山海外区域的用户播放需要配置为`{log_from_region: 'volc-overseas'}`
+	 * @hidden
+	 */
+	/** {en}
+	 * @brief Log reporting additional configuration
+	 * @note BytePlus need to configure `{log_from_region: 'byteplus'}`
+	 * @hidden
 	 */
 	trackerConfig?: Record<string, string>;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 是否关闭清晰度切换埋点
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to close the resolution switching log
+	 * @hidden
+	 * @default false
+	 */
 	closeResolutionLog?: boolean;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 关闭seek相关埋点
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to close the seek related log
+	 * @hidden
+	 * @default false
+	 */
 	closeSeekLog?: boolean;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 队列超过多少条日志的时候发送
 	 * @default 5
 	 */
+	/** {en}
+	 * @brief The number of logs when the queue exceeds the threshold
+	 * @hidden
+	 * @default 5
+	 */
 	maxQueueCount?: number;
 }
-/**
+/** {zh}
  * @brief mp4加密日志配置项
  * @list Options
  * @hidden
  */
 export interface IMp4EncryptPlayerConfig {
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 是否加密
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to encrypt
+	 * @hidden
+	 * @default false
+	 */
 	isEncrypt?: boolean;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 视频vid
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Video vid
+	 * @hidden
+	 * @default -
+	 */
 	vid?: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 视频密钥 id
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Video kid
+	 * @hidden
+	 * @default -
+	 */
 	kid?: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 获取密钥凭证地址
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Get the certificate address
+	 * @hidden
+	 * @default -
+	 */
 	getLicenseUrl?: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 是否使用EME
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to use EME
+	 * @hidden
+	 * @default false
+	 */
 	useEME?: boolean;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 视频密钥值
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Video key value
+	 * @hidden
+	 * @default -
+	 */
 	keyValue?: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 加密后的视频密钥值
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Encrypted video key value
+	 * @hidden
+	 * @default -
+	 */
 	secretKey?: string;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief 是否携带cookie
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to carry cookie
+	 * @hidden
+	 * @default false
+	 */
 	withCredentials?: boolean;
-	/**
+	/** {zh}
 	 * @hidden
 	 * @brief drm内容
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Drm content
+	 * @hidden
+	 * @default -
+	 */
 	drm?: {
 		clearKeys: {
 			[propName: string]: string;
@@ -1451,73 +1848,127 @@ export declare type IDefinition = {
 		[propName: string]: any;
 	};
 };
-/**
+/** {zh}
  * @brief 音量配置。
  * @list Options
  * @kind property
  */
+/** {en}
+ * @brief Volume configuration.
+ * @list Options
+ * @kind property
+ */
 export declare type IVolume = number | {
-	/**
+	/** {zh}
 	 * @brief 插件Dom挂载的位置，默认播放器底部控制栏右侧
 	 * @default POSITIONS.CONTROLS_RIGHT
 	 */
+	/** {en}
+	 * @brief The position of the plugin dom. The default value is `POSITIONS.CONTROLS_RIGHT`.
+	 * @default POSITIONS.CONTROLS_RIGHT
+	 */
 	position?: POSITIONS;
-	/**
+	/** {zh}
 	 * @brief 插件在挂载的位置的排序权重
 	 * @default 1
 	 */
+	/** {en}
+	 * @brief The index of the plugin in the position. The default value is `1`.
+	 * @default 1
+	 */
 	index?: number;
-	/**
+	/** {zh}
 	 * @brief 是否禁用插件交互行为，即是否隐藏音量调节按钮
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to disable the plugin interaction behavior, i.e., whether to hide the volume adjustment button.
+	 * @default false
+	 */
 	disable?: boolean;
-	/**
+	/** {zh}
 	 * @brief 是否在音量调节slider上方显示当前音量数值
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to show the current volume value on the volume adjustment slider.
+	 * @default false
+	 */
 	showValueLabel?: boolean;
-	/**
+	/** {zh}
 	 * @brief 默认音量大小，取值范围0-1
 	 * @default 0.6
 	 */
+	/** {en}
+	 * @brief The default volume value. The value range is `[0, 1]`.
+	 * @default 0.6
+	 */
 	default?: number;
-	/**
+	/** {zh}
 	 * @brief 静音恢复的时候最小音量
 	 * @default 0.2
 	 */
+	/** {en}
+	 * @brief The minimum volume value when unmuting. The value range is `[0, 1]`.
+	 * @default 0.2
+	 */
 	miniVolume?: number;
 };
-/**
+/** {zh}
  * @brief 进度条标记点配置。
  * @list Options
  * @kind property
  */
+/** {en}
+ * @brief Progress bar marker point configuration.
+ * @list Options
+ * @kind property
+ */
 export interface IDot {
-	/**
+	/** {zh}
 	 * @brief 进度条标记点
 	 * @default 1
 	 */
+	/** {en}
+	 * @brief The id of the progress bar marker point.
+	 * @default 1
+	 */
 	id: string | number;
-	/**
+	/** {zh}
 	 * @brief 标记点所在的播放时间
 	 * @default 0
 	 */
+	/** {en}
+	 * @brief The time of the progress bar marker point.
+	 * @default 0
+	 */
 	time: number;
-	/**
+	/** {zh}
 	 * @brief 进度条自定义文案
 	 * @default -
 	 */
+	/** {en}
+	 * @brief The text of the progress bar marker point.
+	 * @default -
+	 */
 	text?: string;
-	/**
+	/** {zh}
 	 * @brief 标记点持续的时间，单位秒
 	 * @default 1
 	 */
+	/** {en}
+	 * @brief The duration of the progress bar marker point.
+	 * @default 1
+	 */
 	duration?: number;
-	/**
+	/** {zh}
 	 * @brief 进度条自定义的CSS Style样式
 	 * @default -
 	 */
+	/** {en}
+	 * @brief The custom CSS style of the progress bar marker point.
+	 * @default -
+	 */
 	style?: CSSStyleDeclaration;
 }
 /**
@@ -1636,49 +2087,83 @@ export declare type IPlayerOptions = {
 		volumeColor?: string;
 	};
 };
-/**
+/** {zh}
  * @brief mobile端交互配置。
  */
+/** {en}
+ * @brief Mobile interaction configuration.
+ */
 export interface IMobileConfig {
-	/**
+	/** {zh}
 	 * @brief 是否禁用手势，手势包括：
 	 * - 水平手势滑动快进/快退
 	 * - 左侧手势滑动调节亮度
 	 * - 右侧手势滑动调节音量（iOS不可用）
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to disable gestures. Gesture includes:
+	 * - Horizontal gesture to fast forward/rewind
+	 * - Left gesture to adjust brightness
+	 * - Right gesture to adjust volume (iOS not available)
+	 * @default false
+	 */
 	disableGesture?: boolean;
-	/**
+	/** {zh}
 	 * @brief 是否启用水平手势处理，水平手势快进/快退
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to enable horizontal gesture processing. Horizontal gesture includes fast forward/rewind.
+	 * @default false
+	 */
 	gestureX?: boolean;
-	/**
+	/** {zh}
 	 * @brief 是否启用垂直手势处理，默认不启用, 垂直手势包括屏幕右侧和屏幕左侧，默认左侧调节亮度，右侧调节音量，左右范围比例通过scopeL和scopeR设置
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to enable vertical gesture processing. Vertical gesture includes screen right and screen left. Default left to adjust brightness, right to adjust volume. The left and right range ratio is set through scopeL and scopeR.
+	 * @default false
+	 */
 	gestureY?: boolean;
-	/**
+	/** {zh}
 	 * @brief 左侧手势范围比例，取值0-1
 	 * @default 0.25
 	 */
+	/** {en}
+	 * @brief The left gesture range ratio, the value is 0-1.
+	 * @default 0.25
+	 */
 	scopeL?: number;
-	/**
+	/** {zh}
 	 * @brief 右侧手势范围，取值0-1
 	 * @default 0.25
 	 */
+	/** {en}
+	 * @brief The right gesture range ratio, the value is 0-1.
+	 * @default 0.25
+	 */
 	scopeR?: number;
-	/**
+	/** {zh}
 	 * @brief 是否启用左侧调暗功能，因为web端无法调用系统的亮度，这个功能实际使用透明蒙层实
 	 * @default true
 	 */
+	/** {en}
+	 * @brief Whether to enable left dimming function. Because the web cannot call the system brightness, this function is actually implemented using a transparent overlay.
+	 * @default true
+	 */
 	darkness?: boolean;
-	/**
-	 * @brief 播放器可调节的最大暗度，即蒙层最大透明度
+	/** {zh}
+	 * @brief 播放器可调节的最大暗度，即蒙层最大透明度。
+	 * @default 0.6
+	 */
+	/** {en}
+	 * @brief The maximum darkness of the player, i.e., the maximum transparency of the transparent layer.
 	 * @default 0.6
 	 */
 	maxDarkness?: number;
-	/**
+	/** {zh}
 	 * @brief 是否启用上下渐变阴影，即在播放器在激活时上下范围内有阴影
 	 * - normal 上下阴影
 	 * - none 无阴影
@@ -1686,90 +2171,165 @@ export interface IMobileConfig {
 	 * - bottom 仅下阴影
 	 * @default normal
 	 */
+	/** {en}
+	 * @brief Whether to enable vertical gradient shadow, i.e., there is a shadow in the upper and lower range when the player is activated.
+	 * - normal: normal shadow
+	 * - none: no shadow
+	 * - top: only upper shadow
+	 * - bottom: only lower shadow
+	 * @default normal
+	 */
 	gradient?: "normal" | "none" | "top" | "bottom";
-	/**
+	/** {zh}
 	 * @brief 是否在touchMove事件触发时（即手势滑动时）同时更新播放器的currentTime, 在手势移动过程中，不会直接调用播放器的快进快退，在toucheEnd的时候再设置
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to update the player's currentTime when the touchMove event is triggered (i.e., when the gesture is slid). During the gesture movement, the player's fast forward/rewind is not directly called, and the currentTime is set when the toucheEnd event is triggered.
+	 * @default false
+	 */
 	isTouchingSeek?: boolean;
-	/**
-	 * @brief 手势滑动的最小步伐，单位px，即滑动距离超过多少算作滑动，以减少不必要的滑动手势事件触发
+	/** {zh}
+	 * @brief 手势滑动的最小步伐，单位px，即滑动距离超过多少算作滑动，以减少不必要的滑动手势事件触发。
+	 * @default 5
+	 */
+	/** {en}
+	 * @brief The minimum step of the gesture movement, the unit is px, i.e., the sliding distance exceeding which is considered as sliding, to reduce unnecessary sliding gesture event triggers.
 	 * @default 5
 	 */
 	miniMoveStep?: number;
-	/**
+	/** {zh}
 	 * @brief 长按快进倍速
 	 * @default 2
 	 */
+	/** {en}
+	 * @brief The long press fast forward speed.
+	 * @default 2
+	 */
 	pressRate?: number;
-	/**
-	 * @brief 是否禁用时间预览雪碧图面板
+	/** {zh}
+	 * @brief 是否禁用时间预览雪碧图面板。
 	 * @notice 前提需要配置进度条预览雪碧图 thumbnail
 	 * @default true
 	 */
+	/** {en}
+	 * @brief Whether to disable the time preview sprite panel.
+	 * @notice The prerequisite is to configure the progress bar preview sprite thumbnail.
+	 * @default true
+	 */
 	disableActive?: boolean;
-	/**
+	/** {zh}
 	 * @brief 是否禁用时间进度条，即拖动时不展示mini进度条
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to disable the time progress bar, i.e., not to show the mini progress bar when dragging.
+	 * @default false
+	 */
 	disableTimeProgress?: boolean;
-	/**
+	/** {zh}
 	 * @brief 手势拖动的时候是否隐藏控制栏
 	 * @default true
 	 */
+	/** {en}
+	 * @brief Whether to hide the control bar when dragging.
+	 * @default true
+	 */
 	hideControlsActive?: boolean;
-	/**
+	/** {zh}
 	 * @brief 手势结束时隐藏控制栏
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to hide the control bar when the gesture ends.
+	 * @default false
+	 */
 	hideControlsEnd?: boolean;
-	/**
+	/** {zh}
 	 * @brief 滑动播放器区域快进/快退时，播放器区域对应的时长，即完整滑过播放器所对应的时长，单位ms
 	 * @default 360000
 	 */
+	/** {en}
+	 * @brief The duration of the player area when fast forward/rewind is performed, i.e., the duration corresponding to the full passage of the player area, the unit is ms.
+	 * @default 360000
+	 */
 	moveDuration?: number;
-	/**
+	/** {zh}
 	 * @brief 是否关闭双击切换暂停/播放的能力，同closeVideoDblclick
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to disable the double-click to switch pause/play ability, same as closeVideoDblclick.
+	 * @default false
+	 */
 	closedbClick?: boolean;
-	/**
+	/** {zh}
 	 * @brief 禁用长按倍速调整
 	 * @default true
 	 */
+	/** {en}
+	 * @brief Whether to disable the long press to adjust the speed.
+	 * @default true
+	 */
 	disablePress?: boolean;
-	/**
+	/** {zh}
 	 * @brief 是否禁用快进/快退的时候按钮提示
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to disable the fast forward/rewind button prompt.
+	 * @default false
+	 */
 	disableSeekIcon?: boolean;
 }
-/**
+/** {zh}
  * @brief 播放器中间切换暂停/播放的按钮。
  */
+/** {en}
+ * @brief The center play/pause button.
+ */
 export interface IStartConfig {
-	/**
+	/** {zh}
 	 * @brief 暂停是否常驻
 	 * @default true
 	 */
+	/** {en}
+	 * @brief Whether to keep the pause button visible.
+	 * @default true
+	 */
 	isShowPause?: boolean;
-	/**
+	/** {zh}
 	 * @brief 是否播放结束常驻
 	 * @default false
 	 */
+	/** {en}
+	 * @brief Whether to keep the end button visible.
+	 * @default false
+	 */
 	isShowEnd?: boolean;
-	/**
+	/** {zh}
 	 * @brief 是否禁用点击动画
 	 * @default pc：true，mobile：false
 	 */
+	/** {en}
+	 * @brief Whether to disable the click animation.
+	 * @default pc: true, mobile: false
+	 */
 	disableAnimate?: boolean;
-	/**
+	/** {zh}
 	 * @brief 按钮的跟随模式
 	 * - hide：起播之后隐藏
 	 * - show：常驻一直存在
 	 * - auto：自动跟随，播放器激活时即player.isActive=true的时候显示，否则隐藏
 	 * @default hide
 	 */
+	/** {en}
+	 * @brief The following modes are supported:
+	 * - hide: hidden after playback starts
+	 * - show: always visible
+	 * - auto: automatically follows, visible when player.isActive=true
+	 * @default hide
+	 */
 	mode?: "hide" | "show" | "auto";
 }
 /**
@@ -1777,7 +2337,7 @@ export interface IStartConfig {
  * @brief 西瓜插件
  */
 export declare type XGPlugin = typeof Plugin | typeof BasePlugin;
-/**
+/** {zh}
  * @brief 自动播放配置。
  * @list Options
  * @kind property
@@ -1792,7 +2352,7 @@ export interface IAutoplayPluginConfig {
 	 * @hidden
 	 */
 	position?: string;
-	/**
+	/** {zh}
 	 * @brief 是否开启降级静音自动播放。开启后，如果当前浏览器环境不支持有声音自动播放，则降级为静音自动播放。
 	 * @default false
 	 */
@@ -1801,7 +2361,7 @@ export interface IAutoplayPluginConfig {
 	 * @default false
 	 */
 	enableDegradeMuteAutoplay?: boolean;
-	/**
+	/** {zh}
 	 * @brief 启用微信jsBridge方式的自动播放
 	 * @default false
 	 * @hidden
@@ -1813,7 +2373,7 @@ export interface IAutoplayPluginConfig {
 	 * @hidden
 	 */
 	enableWxJsBridgeAutoplay?: boolean;
-	/**
+	/** {zh}
 	 * @brief 用户触发自动播放的目标 dom。
 	 * @default window.document.body
 	 */
@@ -1863,21 +2423,21 @@ declare class PlayList {
 	setStyle(style: any): void;
 	destroy(): void;
 }
-/**
+/** {zh}
  * @brief 播放列表展示面板触发动作类型。
  */
 /** {en}
  * @brief Playlist panel trigger action type.
  */
 export declare const enum TOGGLE_MODES {
-	/**
+	/** {zh}
 	 * @brief 鼠标点击。
 	 */
 	/** {en}
 	 * @brief Mouse click.
 	 */
 	CLICK = "click",
-	/**
+	/** {zh}
 	 * @brief 鼠标悬浮。
 	 */
 	/** {en}
@@ -1885,20 +2445,26 @@ export declare const enum TOGGLE_MODES {
 	 */
 	HOVER = "hover"
 }
-/**
+/** {zh}
  * @list Options
  * @brief 播放列表项配置，支持 DirectUrl 和 Vid + playAuthToken 两种播放模式。
  * @notes 列表数据由外部提供，播放器内部不直接获取播放列表数据。
  * @kind property
  */
+/** {en}
+ * @list Options
+ * @brief Playlist item configuration, supporting DirectUrl and Vid + playAuthToken two playback modes.
+ * @notes The list data is provided by external, and the player does not directly obtain the list data.
+ * @kind property
+ */
 export interface IPlayListItem {
-	/**
+	/** {zh}
 	 * @notes 临时播放 Token 为空时，此参数必传。
 	 * @default -
 	 * @listtip `playAuthToken` 为空时，此参数必传。
 	 * @brief 视频地址。
 	 */
-	/**
+	/** {en}
 	 * @notes Required when temporary play token is empty.
 	 * @default -
 	 * @listtip when `playAuthToken` is empty, this parameter is required.
@@ -1936,7 +2502,7 @@ export interface IPlayListItem {
 	 * @brief Video cover image URL.
 	 */
 	poster?: string;
-	/**
+	/** {zh}
 	 * @default -
 	 * @brief 视频标题。
 	 */
@@ -1945,7 +2511,7 @@ export interface IPlayListItem {
 	 * @brief Video title.
 	 */
 	title?: string;
-	/**
+	/** {zh}
 	 * @brief 视频时长，单位为秒。
 	 * @default -
 	 */
@@ -1978,10 +2544,11 @@ declare enum EPlayMode {
  */
 /** {en}
  * @list Options
+ * @brief Playlist plugin configuration.
  * @kind property
  */
 export interface IPlayListConfig {
-	/**
+	/** {zh}
 	 * @brief 按钮位置。取值如下：
 	 *
 	 *        - `controlsLeft`: 播控栏左侧
@@ -2007,7 +2574,7 @@ export interface IPlayListConfig {
 	 * @default controlsLeft
 	 */
 	position?: string;
-	/**
+	/** {zh}
 	 * @brief 按钮在所在区域的次序。默认值为 `2`，表示在播放按钮后。
 	 * @default 20
 	 */
@@ -2016,7 +2583,7 @@ export interface IPlayListConfig {
 	 * @default 20
 	 */
 	index?: number;
-	/**
+	/** {zh}
 	 * @brief 播放列表数据。
 	 * @default []
 	 */
@@ -2025,7 +2592,7 @@ export interface IPlayListConfig {
 	 * @default []
 	 */
 	list: IPlayListItem[];
-	/**
+	/** {zh}
 	 * @brief 循环模式，取值如下：
 	 *
 	 *        - `order`: 不循环播放，即列表中最后一个视频播放完成后就停止播放。
@@ -2040,7 +2607,7 @@ export interface IPlayListConfig {
 	 * @default order
 	 */
 	mode?: EPlayMode;
-	/**
+	/** {zh}
 	 * @brief 默认起始的播放次序。
 	 * @default order
 	 */
@@ -2049,7 +2616,7 @@ export interface IPlayListConfig {
 	 * @default order
 	 */
 	defaultIndex?: number;
-	/**
+	/** {zh}
 	 * @brief 列表点击之后是否隐藏。
 	 * @default true
 	 */
@@ -2058,7 +2625,7 @@ export interface IPlayListConfig {
 	 * @default true
 	 */
 	isItemClickHide?: boolean;
-	/**
+	/** {zh}
 	 * @brief 列表行为触发模式。
 	 * @default click
 	 */
@@ -2067,7 +2634,7 @@ export interface IPlayListConfig {
 	 * @default click
 	 */
 	toggleMode?: TOGGLE_MODES;
-	/**
+	/** {zh}
 	 * @brief 是否显示播放列表按钮。
 	 * @default true
 	 */
@@ -2156,16 +2723,18 @@ export declare class PlayListPlugin extends Plugin {
 	get disable(): boolean;
 	render(): string;
 }
-/**
+/** {zh}
  * @brief 动态水印配置。
  * @list Options
  * @kind property
  */
 /** {en}
  * @brief watermark config
+ * @list Options
+ * @kind property
  */
 export interface IWatermarkConfig {
-	/**
+	/** {zh}
 	 * @brief 是否开启动态水印，取值如下：<br/>
 	 *        - `true`：开启动态水印
 	 *        - `false`：关闭动态水印
@@ -2175,17 +2744,19 @@ export interface IWatermarkConfig {
 	 * @brief Is dynamic watermark enabled? The value is as follows:<br/>
 	 *        - `true`: Enable dynamic watermark
 	 *        - `false`: Disable dynamic watermark
+	 * @default false
 	 */
 	enable: boolean;
-	/**
+	/** {zh}
 	 * @brief 水印文案。
 	 * @default -
 	 */
 	/** {en}
+	 * @brief Watermark content.
 	 * @default -
 	 */
 	content: string;
-	/**
+	/** {zh}
 	 * @brief 水印展示形式，取值如下：<br/>
 	 *        - `0`：固定位置
 	 *        - `1`：全屏滚动
@@ -2193,18 +2764,23 @@ export interface IWatermarkConfig {
 	 * @default 1
 	 */
 	/** {en}
+	 * @brief Watermark display type. The value is as follows:<br/>
+	 *        - `0`: Fixed position
+	 *        - `1`: Full screen scrolling
+	 *        - `2`: Random flickering
 	 * @default 1
 	 */
 	displayType?: 0 | 1 | 2;
-	/**
+	/** {zh}
 	 * @brief 水印字体大小。`number`类型时单位为 px，`string` 类型时需要携带单位。
 	 * @default 12
 	 */
 	/** {en}
+	 * @brief Watermark font size. When the type is `number`, the unit is px. When the type is `string`, the unit needs to be included.
 	 * @default 12
 	 */
 	fontSize?: number | string;
-	/**
+	/** {zh}
 	 * @brief 水印字体颜色。
 	 * @brief 水印字体颜色。
 	 */
@@ -2213,15 +2789,16 @@ export interface IWatermarkConfig {
 	 * @brief Watermark font color.
 	 */
 	fontColor?: string;
-	/**
+	/** {zh}
 	 * @brief 水印不透明度。取值范围：\[0~1\]。
 	 * @default 0.3
 	 */
 	/** {en}
+	 * @brief Watermark opacity. The value is in the range of [0~1].
 	 * @default 0.3
 	 */
 	opacity?: number;
-	/**
+	/** {zh}
 	 * @brief 水印闪烁速度，取值如下：<br/>
 	 *        - `MODERATE`：适中
 	 *        - `FAST`：较快
@@ -2229,33 +2806,57 @@ export interface IWatermarkConfig {
 	 * @default MODERATE
 	 */
 	/** {en}
+	 * @brief Watermark ticker speed. The value is as follows:<br/>
+	 *        - `MODERATE`: Moderate
+	 *        - `FAST`: Fast
+	 *        - `SLOW`: Slow
 	 * @default MODERATE
 	 */
 	tickerSpeed?: "SLOW" | "MODERATE" | "FAST";
-	/**
+	/** {zh}
 	 * @brief 水印字体类型
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Watermark font family.
+	 * @default -
+	 */
 	fontFamily?: string;
-	/**
+	/** {zh}
 	 * @brief 水印相对于播放容器顶部的距离，单位为 px
 	 * @default 0
 	 */
+	/** {en}
+	 * @brief Watermark top distance. The unit is px.
+	 * @default 0
+	 */
 	top?: number;
-	/**
+	/** {zh}
 	 * @brief 水印相对于播放容器左侧的距离，单位为 px。
 	 * @default 0
 	 */
+	/** {en}
+	 * @brief Watermark left distance. The unit is px.
+	 * @default 0
+	 */
 	left?: number;
-	/**
+	/** {zh}
 	 * @brief 水印相对于播放容器底部的距离，单位为 px。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Watermark bottom distance. The unit is px.
+	 * @default -
+	 */
 	bottom?: number;
-	/**
+	/** {zh}
 	 * @brief 水印相对于播放容器右侧的距离，单位为 px。
 	 * @default -
 	 */
+	/** {en}
+	 * @brief Watermark right distance. The unit is px.
+	 * @default -
+	 */
 	right?: number;
 }
 export declare class DynamicWatermarkPlugin extends Plugin {
@@ -2828,6 +3429,7 @@ export interface IABCycle {
  */
 /** {en}
  * @list Options
+ * @brief Music playback mode configuration.
  * @kind property
  */
 export interface IMusicConfig {
@@ -5462,7 +6064,7 @@ declare class AuthToken extends SdkPlugin {
 	getDrmConfig(videoInfo: IVideoInfo): void;
 	init(): void;
 	initConfig(getVideoByToken: IPlayAuthTokenConfig): void;
-	/**
+	/** {zh}
 	 * @description 更新playAuthToken
 	 * @param {IPlayAuthTokenConfig} getVideoByToken token信息
 	 * @param {boolean} isNewVideo 是否新视频，即是否为切换视频
@@ -6229,21 +6831,35 @@ export declare type PlayerCore = Player & {
 		licenseType: LicenseEdition;
 	};
 };
-/**
+/** {zh}
  * @brief 加密混淆信息
+ * @hidden
+ */
+/** {en}
+ * @brief Encrypted obfuscation information
+ * @hidden
  */
 export interface EncryptInfo {
-	/**
+	/** {zh}
 	 * @breif 会话ID
 	 */
+	/** {en}
+	 * @brief Session ID
+	 */
 	sessionId: string;
-	/**
+	/** {zh}
 	 * @brief 混淆后的公钥
 	 */
+	/** {en}
+	 * @brief Encrypted public key
+	 */
 	drmKeK: string;
-	/**
+	/** {zh}
 	 * @breif 唯一身份信息
 	 */
+	/** {en}
+	 * @brief Unique identity information
+	 */
 	unionInfo: string;
 }
 declare class VePlayer {
@@ -6392,11 +7008,16 @@ declare class VePlayer {
 	 * @hidden
 	 */
 	static veStrategy: typeof VeStrategy;
-	/**
+	/** {zh}
 	 * @brief SDK 版本
 	 * @type {*}
 	 * @memberof VePlayer
 	 */
+	/** {en}
+	 * @brief SDK version
+	 * @type {*}
+	 * @memberof VePlayer
+	 */
 	static sdkVersion: string;
 	/**
 	 * @hidden
@@ -6778,10 +7399,14 @@ declare class VePlayer {
 	 * @private
 	 */
 	private _onMediaExpiredAction;
-	/**
+	/** {zh}
 	 * @brief 更新播放源。您可在视频播放地址过期前调用此方法更新地址及过期时间戳。
 	 * @param source 播放源配置。详见 [SourceConfig](1248901#sourceconfig)。支持传入视频播放地址 `url`、播放列表 `playList` 或者 `vid` 和 `playAuthToken`，还需包含新地址的过期时间戳 `urlExpireTimestamp`。
 	 */
+	/** {en}
+	 * @brief Update the media source. You can call this method to update the address and expiration timestamp before the video playback address expires.
+	 * @param source The media source configuration. See SourceConfig. Supports passing video playback address `url`, playback list `playList`, or `vid` and `playAuthToken`, and also includes the expiration timestamp `urlExpireTimestamp` of the new address.
+	 */
 	updateMediaSource(source: SourceConfig): Promise<void>;
 	/** {zh}
 	 * @hidden
@@ -7032,6 +7657,8 @@ declare class VePlayer {
 	 * @notes 每项包含 `id`、`name`、`lang`、`channels`、`default`、`selected` 字段；轨道数量 ≤ 1 时返回空数组。
 	 */
 	/** {en}
+	 * @brief Get the audio track list. For HLS, tracks come from hls.js; on iOS native playback, from `HTMLMediaElement.audioTracks`.
+	 * @notes Each item includes `id`, `name`, `lang`, `channels`, `default`, and `selected`. Returns an empty array when there is at most one track.
 	 */
 	getAudioTracks(): AudioTrackInfo[];
 	/** {zh}
@@ -7039,18 +7666,20 @@ declare class VePlayer {
 	 * @notes HLS 流通过 hls.js 获取，iOS 原生播放通过 HTMLMediaElement.audioTracks 获取；无激活轨道时返回 null。
 	 */
 	/** {en}
+	 * @brief Get the currently active audio track.
+	 * @notes For HLS, from hls.js; on iOS native playback, from `HTMLMediaElement.audioTracks`. Returns `null` when no track is active.
 	 */
 	getCurrentAudioTrack(): AudioTrackInfo | null;
 	/** {zh}
 	 * @brief 切换音频轨道。
-	 * @param id 目标轨道的 id，可通过 `getAudioTracks()` 获取。
-	 * @param lang 目标轨道的语言代码（BCP-47）。若提供，则 id 与 lang 同时匹配时才执行切换，
-	 *             可用于 iOS 原生 audioTracks 中存在重复 id 的场景。
+	 * @param track 目标音轨对象，可通过 `getAudioTracks()` 获取。
 	 * @notes 切换完成后会触发 `Events.AUDIO_TRACK_CHANGE` 事件；
 	 *        同时 PC 端和移动端音频轨道插件的选中状态会自动更新。
 	 */
 	/** {en}
 	 * @brief Switch audio track.
+	 * @param track Target audio track object from `getAudioTracks()`.
+	 * @notes Emits `Events.AUDIO_TRACK_CHANGE` when done. PC and mobile audio track plugins update selection automatically.
 	 */
 	switchAudioTrack(track: AudioTrackInfo): void;
 	/** {zh}