@volcengine/veplayer 2.5.0 → 2.5.1-rc.1

package/esm/veplayer.d.ts

@@ -1530,13 +1530,13 @@ interface VePlayerBaseOptions extends Omit<PlayerOptions, "autoplay" | "i18n"> {
  */
 interface Fullscreen {
     /** {zh}
-     * @brief 切换全屏时，是否旋转为横屏播放，通常在移动端使用。如果开启横屏播放，切换全屏时，将在竖屏状态下把播放器旋转 90 度，实现横屏效果。该配置优先级高于 useCssFullscreen。
-     * - `true`：使用旋转横屏；
-     * - `false`：不使用旋转横屏。
+     * @brief 切换全屏时，是否旋转为横屏播放，通常在移动端使用。如果开启横屏播放，切换全屏时，将在竖屏状态下把播放器旋转 90 度，实现横屏效果。该配置优先级低于 useCssFullscreen。
+     *        - `true`：使用旋转横屏；
+     *        - `false`：不使用旋转横屏。
      * @default false
      */
     /** {en}
-     * @brief Whether to play the video in landscape mode when the video enters full-screen mode. This feature is usually used on mobile devices. Once enabled, when the video enters fullscreen mode, the player will be rotated from portrait mode by 90 degrees to landscape mode. This property has a higher priority over `useCssFullscreen`.
+     * @brief Whether to play the video in landscape mode when the video enters full-screen mode. This feature is usually used on mobile devices. Once enabled, when the video enters fullscreen mode, the player will be rotated from portrait mode by 90 degrees to landscape mode. This property has a lower priority than `useCssFullscreen`.
      *        - `true`: Enable.
      *        - `false`: Disable.
      * @default false
@@ -3895,13 +3895,13 @@ declare namespace strategy {
      */
     interface Fullscreen {
         /** {zh}
-         * @brief 切换全屏时，是否旋转为横屏播放，通常在移动端使用。如果开启横屏播放，切换全屏时，将在竖屏状态下把播放器旋转 90 度，实现横屏效果。该配置优先级高于 useCssFullscreen。
-         * - `true`：使用旋转横屏；
-         * - `false`：不使用旋转横屏。
+         * @brief 切换全屏时，是否旋转为横屏播放，通常在移动端使用。如果开启横屏播放，切换全屏时，将在竖屏状态下把播放器旋转 90 度，实现横屏效果。该配置优先级低于 useCssFullscreen。
+         *        - `true`：使用旋转横屏；
+         *        - `false`：不使用旋转横屏。
          * @default false
          */
         /** {en}
-         * @brief Whether to play the video in landscape mode when the video enters full-screen mode. This feature is usually used on mobile devices. Once enabled, when the video enters fullscreen mode, the player will be rotated from portrait mode by 90 degrees to landscape mode. This property has a higher priority over `useCssFullscreen`.
+         * @brief Whether to play the video in landscape mode when the video enters full-screen mode. This feature is usually used on mobile devices. Once enabled, when the video enters fullscreen mode, the player will be rotated from portrait mode by 90 degrees to landscape mode. This property has a lower priority than `useCssFullscreen`.
          *        - `true`: Enable.
          *        - `false`: Disable.
          * @default false
@@ -4175,13 +4175,6 @@ declare namespace strategy {
     function detectCodec(url: string): Promise<"unknown" | Codec>;
     function isSoftDecode(options: VePlayerBaseOptions, currentCodec?: Codec | "unknown"): Promise<boolean>;
     function combineOptions<T = VePlayerBaseOptions>(strategyList: (Strategy<T> | undefined)[]): Partial<T>;
-    const getFlvStrategy: (options: VePlayerBaseOptions) => Promise<{
-        options?: undefined;
-        plugins?: undefined;
-    } | {
-        options: Partial<VePlayerBaseOptions>;
-        plugins: any[];
-    }>;
     const getHlsStrategy: (options: VePlayerBaseOptions) => Promise<{
         options?: undefined;
         plugins?: undefined;
@@ -4194,17 +4187,17 @@ declare function getStreamType(url: string): "unknown" | "hls" | "flv" | "rtm" |
 /** {zh}
  * @detail api
  * @brief 当前浏览器是否支持播放编码格式。
- * @param codec 编码格式。
- *        - `Codec.H264`: 返回当前浏览器是否支持 MediaSource Extends。
- *        - `Codec.H265`: 返回当前浏览器是否支持硬解播放 H265。
+ * @param codec 编码格式，支持以下选择。
+ *        - `Codec.H264`: 检查 MSE 是否支持 H.264 编码格式。
+ *        - `Codec.H265`: 检查 MSE 是否支持 H.265 编码格式。
  * @returns
  */
 /** {en}
  * @detail api
  * @brief Checkes whether the current browser supports the specified encoding format.
- * @param codec The encoding format.
- *        - `Codec.H264`: Checks whether the current browser supports MediaSource Extends.
- *        - `Codec.H265`: Checks whether the current browser supports H.265 using hardware decoding.
+ * @param codec Code format supports the following options.
+ *        - `Codec.H264`: Check whether MSE supports H.264 encoding format.
+ *        - `Codec.H265`: Check whether MSE supports H.265 encoding format.
  * @returns
  */
 declare function isMseSupported(codec?: string): boolean;
@@ -4219,7 +4212,27 @@ declare function isMseSupported(codec?: string): boolean;
  * @returns
  */
 declare function isSoftDecodeSupported(): Promise<boolean>;
-declare function isMMSSupported(): boolean;
+/** {zh}
+ * @detail api
+ * @brief 判断当前浏览器是否支持 MMS（ManagedMediaSource） API，如果支持的话可满足大部分 H.264 视频播放。
+ *        :::tip
+ *        - 当前方法无法判断是否支持 H.265 视频播放。
+ *        - 使用场景：检查 Safari 浏览器是否满足 H.264 编码流拉流要求。
+ *        - Safari 17.1 以上版本浏览器开始支持 MMS。
+ *        :::
+ * @returns
+ */
+/** {en}
+ * @detail api
+ * @returns
+ * @brief Determine whether the current browser supports the MMS (ManagedMediaSource) API, if so, it can meet most of the H.264 playback.
+ *        :::tip
+ *        - The current method cannot determine whether H.265 video playback is supported.
+ *        - Usage scenario: Check whether Safari browser meets the requirements for pulling H.264 encoded streams.
+ *        - Browsers with iOS 17.1 or above start to support MMS.
+ *        :::
+ */
+declare function isMMSSupported(codec?: string): any;
 declare const util: {
     getStreamType: typeof getStreamType;
     isMseSupported: typeof isMseSupported;
@@ -5175,7 +5188,7 @@ interface LoggerConfig {
     /** {en}
      * @brief The SDK application ID. You can access it by logging in to the BytePlus MediaLive console and navigating to [SDK Management](https://console.byteplus.com/live/main/sdk).
      */
-    appId: string;
+    appId?: string;
     /** {zh}
      * @brief 应用名称。
      * @default 无
@@ -5239,23 +5252,25 @@ interface LiveVePlayerOptions extends VePlayerBaseOptions {
      */
     rtm?: Rtm;
     /** {zh}
-     * @brief 为播放器设置 FLV 拉流配置。FLV 格式流相关配置仅适用于支持 MSE 播放的 PC 端浏览器和安卓端浏览器。
+     * @brief 为播放器设置 FLV 拉流配置。
+     * @listtip FLV 拉流格式流相关配置适用于支持 MSE 播放的 PC 端浏览器、安卓端浏览器和支持 MMS API 的 iOS 浏览器。
      */
     /** {en}
-     * @brief Configurations for playing an FLV stream. You can only play FLV streams with web browsers on PC and Android devices, and the browsers need to support Media Source Extensions (MSE) playback.
+     * @brief Configurations for playing an FLV stream.
+     * @listtip FLV pull stream format stream configurations are applicable to PC browsers, Android browsers that support MSE playback, and iOS browsers that support MMS API.
      */
     flv?: Flv;
     /** {zh}
-     * @brief 为播放器设置 HLS 拉流配置。HLS 格式流相关配置仅适用于支持 MSE 播放的 PC 端浏览器和安卓端浏览器。
-     * @listtip
-     *  - PC 端该配置默认生效；
-     *  - 移动端仅在 `enableMSE` 设置为 `true` 且支持 MSE 的浏览器中生效。
+     * @brief 为播放器设置 HLS 拉流配置。
+     * @listtip - HLS 格式流相关配置仅适用于支持 MSE API的 PC 端浏览器和安卓端浏览器。
+     *          - PC 端该配置默认生效；
+     *          - 移动端仅在 `enableMSE` 设置为 `true` 且支持 MSE 的浏览器中生效。
      */
     /** {en}
-     * @brief  Configurations for playing an HLS stream. You can only play HLS streams with web browsers on PC and Android devices, and the browsers need to support Media Source Extensions (MSE) playback.
-     * @listtip
-     *  - This configuration takes effect by default on PC;
-     *  - For mobile devices, the configuration takes effect only when `enableMSE` is set to `true` for the browser.
+     * @brief Configurations for playing an HLS stream.
+     * @listtip - The HLS format stream configuration is only applicable to PC browsers and Android browsers that support the MSE API.
+     *          - This configuration takes effect by default on PC;
+     *          - For mobile devices, the configuration takes effect only when `enableMSE` is set to `true` for the browser.
      */
     hls?: Hls;
     /** {zh}
@@ -5314,14 +5329,14 @@ interface LiveVePlayerOptions extends VePlayerBaseOptions {
 interface Abr {
     /** {zh}
      * @brief 是否开启 FLV 拉流时的自适应码率（ABR）功能，默认为开启。
-     *        - true: 开启
-     *        - false: 关闭
+     *        - `true`: 开启；
+     *        - `false`: 关闭。
      * @default true
      */
     /** {en}
      * @brief Enable or disable the Adaptive Bitrate (ABR) feature. The default setting is enabled.
-     *        - true: Enable;
-     *        - false: Disable.
+     *        - `true`: Enable;
+     *        - `false`: Disable.
      */
     enable?: boolean;
     /** {zh}
@@ -5340,14 +5355,14 @@ interface Abr {
     downTip?: boolean;
     /** {zh}
      * @brief 是否开始调试模式，默认为关闭。
-     *        - true: 开启；
-     *        - false: 关闭。
+     *        - `true`: 开启；
+     *        - `false`: 关闭。
      * @default false
      */
     /** {en}
      * @brief Whether to start debug mode, default is false.
-     *        - true: Enable,
-     *        - false: Disable.
+     *        - `true`: Enable,
+     *        - `false`: Disable.
      * @default false
      */
     debug?: boolean;
@@ -5585,16 +5600,16 @@ interface Rtm {
     retryDelay?: number;
     /** {zh}
      * @brief 播放器发起 RTM 拉流请求时，是否开启自动转码。
-     * - true：开启
-     * - false：关闭
+     *        - `true`：开启；
+     *        - `false`：关闭。
      * @listtip
      * 如有使用 RTM 拉流自动转码的需求，请先创建工单联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)进行配置。
      * @default false
      */
     /** {en}
      * @brief Whether to enable automatic transcoding when the player requests to pull an RTM stream.
-     * - true: Enable
-     * - false: Disable
+     *        - `true`: Enable;
+     *        - `false`: Disable.
      * @listtip
      * If you want to use the automatic transcoding feature when playing an RTM stream, contact your [technical support](https://www.byteplus.com/en/support).
      * @default false
@@ -5609,20 +5624,38 @@ interface Rtm {
      */
     networkEvaluateInterval?: number;
     /** {zh}
-     * @brief 断流后重新拉流是否无缝播放。
+     * @brief 暂停后重新拉流的处理方式是否为无缝替换。
+     *        - `true`：是，重新拉流期间不会出现黑屏现象。
+     *        - `false`：否，重新拉流期间会出现黑屏现象。
      * @default false
+     * @listtip Safari 浏览器在进行 RTM 拉流时不支持使用此配置。
      */
     /** {en}
-     * @brief
+     * @brief Whether the processing method for re-pulling the stream after pausing is seamless replacement.
+     *        - `true`: Yes, there will be no black screen phenomenon during re-pulling the stream.
+     *        - `false`: No, there will be a black screen phenomenon during re-pulling the stream.
+     *        :::tip
+     *        Safari browsers do not support using this configuration when performing RTM stream pulling.
+     *        :::
+     * @default false
      */
     seamlesslyReload?: boolean;
     /** {zh}
-     * @brief 暂停后多久断流，默认不断流。
+     * @brief 暂停播放后的断联时间，单位为秒，默认不断联。
+     * @listtip Safari 浏览器在进行 RTM 拉流时，如果出现断联，重新拉流时会出现短暂黑屏或加载情况。
      */
     /** {en}
-     * @brief
+     * @brief The disconnection time after pausing playback is in seconds. By default, there is no disconnection.
+     * @listtip When Safari browser performs RTM streaming, if there is a disconnection, there will be a short black screen or loading situation when re-streaming.
      */
     disconnectTime?: number;
+    /** {zh}
+     * @hidden
+     */
+    /** {en}
+     * @hidden
+     */
+    enableOriginSdpLogger?: boolean;
 }
 /** {zh}
  * @list option
@@ -5662,14 +5695,14 @@ interface Flv {
     loadTimeout?: number;
     /** {zh}
      * @brief 播放器发起 FLV 拉流请求时，是否开启低延时。例如，当您开启低延时且推流端 GOP 设置为 2s 的情况下，FLV 拉流平均端到端延时约为 2s。
-     * - true：开启
-     * - false：关闭
+     *        - `true`：开启；
+     *        - `false`：关闭
      * @default false
      */
     /** {en}
      * @brief Whether to enable low latency when playing an FLV address. For example, if you have enabled low latency, and set GOP to 2 seconds, the average latency will be around 2 seconds.
-     * - true: Enable
-     * - false: Disable
+     *        - `true`: Enable;
+     *        - `false`: Disable.
      * @default false
      */
     enableLowLatency?: boolean;
@@ -5703,23 +5736,24 @@ interface Flv {
      */
     maxReaderInterval?: number;
     /** {zh}
-     * @brief
-     *        直播暂停时的断流等待时间，单位为秒，默认值为 0，表示直播暂停时即断流。
+     * @brief 暂停播放后的断联时间，单位为秒，默认值为 0，表示暂停播放后立即断联。
      * @default 0
      */
     /** {en}
-     * @brief The waiting time for disconnection during live streaming suspension, measured in seconds. The default value is 0, indicating immediate disconnection when live streaming is suspended.
+     * @brief The disconnection time after pausing playback is in seconds. The default value is 0, indicating immediate disconnection after pausing playback.
      * @default 0
      */
     disconnectTime?: number;
     /** {zh}
-     * @brief 断流后重新拉流是否无缝，无缝拉流时重新拉流不会出现黑帧。
-     *        - `true`：是；
-     *        - `false`：否。
+     * @brief 暂停后重新拉流的处理方式是否为无缝替换。
+     *        - `true`：是，重新拉流期间不会出现黑屏现象。
+     *        - `false`：否，重新拉流期间会出现黑屏现象。
      * @default false
      */
     /** {en}
-     * @brief Whether re-pulling the stream after disconnection is seamless. When seamless stream pulling, there will be no black frames during re-pulling. - `true`: Yes; - `false`: No.
+     * @brief Whether the processing method for re-pulling the stream after pausing is seamless replacement.
+     *        - `true`: Yes, there will be no black screen phenomenon during re-pulling the stream.
+     *        - `false`: No, there will be a black screen phenomenon during re-pulling the stream.
      * @default false
      */
     seamlesslyReload?: boolean;
@@ -5742,14 +5776,14 @@ interface LowLatency {
     abrPts?: string | number;
     /** {zh}
      * @brief FLV 低延时模式下，是否开启倍速追帧。
-     *        - true：开启；
-     *        - false：关闭。
+     *        - `true`：开启；
+     *        - `false`：关闭。
      * @default true
      */
     /** {en}
      * @brief Whether to enable speed-up frame chasing in FLV low latency mode.
-     *        - true: enabled;
-     *        - false: disabled.
+     *        - `true`: enabled;
+     *        - `false`: disabled.
      * @default true
      */
     enableFrameChasing?: boolean;
@@ -6427,7 +6461,7 @@ declare function isRTMSupported(): Promise<boolean>;
  * @returns
  */
 declare function isRTMSupportCodec(codec?: string): Promise<boolean>;
-declare function isFLVSupported(): boolean;
+declare function isFLVSupported(codec?: string): boolean;
 declare module MobilePlayerPanelWrapper {
     export { MobilePlayerPanel };
 }
@@ -8975,13 +9009,13 @@ declare namespace live {
      */
     interface Fullscreen {
         /** {zh}
-         * @brief 切换全屏时，是否旋转为横屏播放，通常在移动端使用。如果开启横屏播放，切换全屏时，将在竖屏状态下把播放器旋转 90 度，实现横屏效果。该配置优先级高于 useCssFullscreen。
-         * - `true`：使用旋转横屏；
-         * - `false`：不使用旋转横屏。
+         * @brief 切换全屏时，是否旋转为横屏播放，通常在移动端使用。如果开启横屏播放，切换全屏时，将在竖屏状态下把播放器旋转 90 度，实现横屏效果。该配置优先级低于 useCssFullscreen。
+         *        - `true`：使用旋转横屏；
+         *        - `false`：不使用旋转横屏。
          * @default false
          */
         /** {en}
-         * @brief Whether to play the video in landscape mode when the video enters full-screen mode. This feature is usually used on mobile devices. Once enabled, when the video enters fullscreen mode, the player will be rotated from portrait mode by 90 degrees to landscape mode. This property has a higher priority over `useCssFullscreen`.
+         * @brief Whether to play the video in landscape mode when the video enters full-screen mode. This feature is usually used on mobile devices. Once enabled, when the video enters fullscreen mode, the player will be rotated from portrait mode by 90 degrees to landscape mode. This property has a lower priority than `useCssFullscreen`.
          *        - `true`: Enable.
          *        - `false`: Disable.
          * @default false
@@ -9867,17 +9901,17 @@ declare namespace live {
     /** {zh}
      * @detail api
      * @brief 当前浏览器是否支持播放编码格式。
-     * @param codec 编码格式。
-     *        - `Codec.H264`: 返回当前浏览器是否支持 MediaSource Extends。
-     *        - `Codec.H265`: 返回当前浏览器是否支持硬解播放 H265。
+     * @param codec 编码格式，支持以下选择。
+     *        - `Codec.H264`: 检查 MSE 是否支持 H.264 编码格式。
+     *        - `Codec.H265`: 检查 MSE 是否支持 H.265 编码格式。
      * @returns
      */
     /** {en}
      * @detail api
      * @brief Checkes whether the current browser supports the specified encoding format.
-     * @param codec The encoding format.
-     *        - `Codec.H264`: Checks whether the current browser supports MediaSource Extends.
-     *        - `Codec.H265`: Checks whether the current browser supports H.265 using hardware decoding.
+     * @param codec Code format supports the following options.
+     *        - `Codec.H264`: Check whether MSE supports H.264 encoding format.
+     *        - `Codec.H265`: Check whether MSE supports H.265 encoding format.
      * @returns
      */
     function isMseSupported(codec?: string): boolean;
@@ -9892,7 +9926,27 @@ declare namespace live {
      * @returns
      */
     function isSoftDecodeSupported(): Promise<boolean>;
-    function isMMSSupported(): boolean;
+    /** {zh}
+     * @detail api
+     * @brief 判断当前浏览器是否支持 MMS（ManagedMediaSource） API，如果支持的话可满足大部分 H.264 视频播放。
+     *        :::tip
+     *        - 当前方法无法判断是否支持 H.265 视频播放。
+     *        - 使用场景：检查 Safari 浏览器是否满足 H.264 编码流拉流要求。
+     *        - Safari 17.1 以上版本浏览器开始支持 MMS。
+     *        :::
+     * @returns
+     */
+    /** {en}
+     * @detail api
+     * @returns
+     * @brief Determine whether the current browser supports the MMS (ManagedMediaSource) API, if so, it can meet most of the H.264 playback.
+     *        :::tip
+     *        - The current method cannot determine whether H.265 video playback is supported.
+     *        - Usage scenario: Check whether Safari browser meets the requirements for pulling H.264 encoded streams.
+     *        - Browsers with iOS 17.1 or above start to support MMS.
+     *        :::
+     */
+    function isMMSSupported(codec?: string): any;
     const util: {
         getStreamType: typeof getStreamType;
         isMseSupported: typeof isMseSupported;
@@ -10134,6 +10188,7 @@ declare namespace live {
     }
     const EN$0: {
         INVALID_PARAMETER: string;
+        INVALID_LOGGER: string;
         FORMAT: string;
         FPS: string;
         BITRATE: string;
@@ -10206,6 +10261,7 @@ declare namespace live {
     };
     const ZH_CN$0: {
         INVALID_PARAMETER: string;
+        INVALID_LOGGER: string;
         FORMAT: string;
         FPS: string;
         BITRATE: string;
@@ -10278,6 +10334,10 @@ declare namespace live {
     };
     type TextKey$0 = keyof typeof EN$0;
     const VeError$0: typeof error.VeError;
+    // ve 自定义错误码
+    // 第一位: 1 表示点播，2 表示直播
+    // 第二位: 功能粒度，比如 210 中 1 表示入参参数有问题
+    // 第三位: 某功能下细分，如果细拆成地址有问题就可以用 211 表示。
     enum LiveErrorCode {
         /** {zh}
          * @brief 参数错误
@@ -10287,7 +10347,16 @@ declare namespace live {
          * @brief Parameter errors.
          * @solution Please check whether the required parameters `url` and `playlist` are specified.
          */
-        INVALID_PARAMETER = 210
+        INVALID_PARAMETER = 210,
+        /** {zh}
+         * @brief 日志错误
+         * @solution 未正确配置质量日志参数, 请参考 https://www.volcengine.com/docs/6469/138655#日志上报 配置。
+         */
+        /** {en}
+         * @brief Log errors.
+         * @solution Log options not configured correctly. Please refer to this document https://docs.byteplus.com/en/docs/byteplus-media-live/docs-feature-implementation#uploading-logs to configure the logs.
+         */
+        INVALID_LOGGER = 220
     }
     const Level$0: typeof error.Level;
     type ErrorInfo$0 = error.ErrorInfo;
@@ -10341,10 +10410,11 @@ declare namespace live {
         MODULE_LOAD_ERROR: error.ErrorCode.MODULE_LOAD_ERROR;
         UNKNOWN: error.ErrorCode.UNKNOWN;
         INVALID_PARAMETER: LiveErrorCode.INVALID_PARAMETER;
+        INVALID_LOGGER: LiveErrorCode.INVALID_LOGGER;
     };
     type ValueOf<T> = T[keyof T];
     const ERRORS: Partial<Record<ValueOf<typeof ErrorCode$0>, error.ErrorInfo<TextKey$0>>>;
-    function create$0(errorCode: ValueOf<typeof ErrorCode$0>, i18n?: VeI18n<TextKey$0>): error.VeError<"DEFINITION_FALLBACK_TOAST" | "DEFINITION_SWITCHING" | "ERROR_REFRESH" | "UNMUTE" | "MANIFEST" | "NETWORK" | "NETWORK_TIMEOUT" | "NETWORK_FORBIDDEN" | "NETWORK_NOTFOUND" | "DEMUX" | "REMUX" | "MEDIA" | "MEDIA_ERR_CODEC_NOT_SUPPORTED" | "MEDIA_ERR_URL_EMPTY" | "DRM" | "DRM_LICENSE" | "OTHER" | "RUNTIME" | "MODULE_LOAD_ERROR" | "UNKNOWN" | "ERROR_TYPES" | "HAVE_NOTHING" | "HAVE_METADATA" | "HAVE_CURRENT_DATA" | "HAVE_FUTURE_DATA" | "HAVE_ENOUGH_DATA" | "NETWORK_EMPTY" | "NETWORK_IDLE" | "NETWORK_LOADING" | "NETWORK_NO_SOURCE" | "MEDIA_ERR_ABORTED" | "MEDIA_ERR_NETWORK" | "MEDIA_ERR_DECODE" | "MEDIA_ERR_SRC_NOT_SUPPORTED" | "REPLAY" | "ERROR" | "PLAY_TIPS" | "PAUSE_TIPS" | "PLAYNEXT_TIPS" | "DOWNLOAD_TIPS" | "ROTATE_TIPS" | "RELOAD_TIPS" | "FULLSCREEN_TIPS" | "EXITFULLSCREEN_TIPS" | "CSSFULLSCREEN_TIPS" | "EXITCSSFULLSCREEN_TIPS" | "TEXTTRACK" | "PIP" | "SCREENSHOT" | "LIVE" | "OFF" | "OPEN" | "MINI_DRAG" | "MINISCREEN" | "REFRESH_TIPS" | "REFRESH" | "FORWARD" | "LIVE_TIP" | "GOP" | "INVALID_PARAMETER" | "FORMAT" | "FPS" | "BITRATE" | "RESOLUTION" | "ENCODE_TYPE" | "BUFFER_END" | "CURRENT_TIME" | "DECODE_EFFICIENCY" | "DECODE_COST" | "DECODE_INFO">;
+    function create$0(errorCode: ValueOf<typeof ErrorCode$0>, i18n?: VeI18n<TextKey$0>): error.VeError<"DEFINITION_FALLBACK_TOAST" | "DEFINITION_SWITCHING" | "ERROR_REFRESH" | "UNMUTE" | "MANIFEST" | "NETWORK" | "NETWORK_TIMEOUT" | "NETWORK_FORBIDDEN" | "NETWORK_NOTFOUND" | "DEMUX" | "REMUX" | "MEDIA" | "MEDIA_ERR_CODEC_NOT_SUPPORTED" | "MEDIA_ERR_URL_EMPTY" | "DRM" | "DRM_LICENSE" | "OTHER" | "RUNTIME" | "MODULE_LOAD_ERROR" | "UNKNOWN" | "ERROR_TYPES" | "HAVE_NOTHING" | "HAVE_METADATA" | "HAVE_CURRENT_DATA" | "HAVE_FUTURE_DATA" | "HAVE_ENOUGH_DATA" | "NETWORK_EMPTY" | "NETWORK_IDLE" | "NETWORK_LOADING" | "NETWORK_NO_SOURCE" | "MEDIA_ERR_ABORTED" | "MEDIA_ERR_NETWORK" | "MEDIA_ERR_DECODE" | "MEDIA_ERR_SRC_NOT_SUPPORTED" | "REPLAY" | "ERROR" | "PLAY_TIPS" | "PAUSE_TIPS" | "PLAYNEXT_TIPS" | "DOWNLOAD_TIPS" | "ROTATE_TIPS" | "RELOAD_TIPS" | "FULLSCREEN_TIPS" | "EXITFULLSCREEN_TIPS" | "CSSFULLSCREEN_TIPS" | "EXITCSSFULLSCREEN_TIPS" | "TEXTTRACK" | "PIP" | "SCREENSHOT" | "LIVE" | "OFF" | "OPEN" | "MINI_DRAG" | "MINISCREEN" | "REFRESH_TIPS" | "REFRESH" | "FORWARD" | "LIVE_TIP" | "GOP" | "INVALID_PARAMETER" | "INVALID_LOGGER" | "FORMAT" | "FPS" | "BITRATE" | "RESOLUTION" | "ENCODE_TYPE" | "BUFFER_END" | "CURRENT_TIME" | "DECODE_EFFICIENCY" | "DECODE_COST" | "DECODE_INFO">;
     /** {zh}
      * @list option
      * @kind property
@@ -10450,7 +10520,7 @@ declare namespace live {
         /** {en}
          * @brief The SDK application ID. You can access it by logging in to the BytePlus MediaLive console and navigating to [SDK Management](https://console.byteplus.com/live/main/sdk).
          */
-        appId: string;
+        appId?: string;
         /** {zh}
          * @brief 应用名称。
          * @default 无
@@ -10534,23 +10604,25 @@ declare namespace live {
          */
         rtm?: Rtm;
         /** {zh}
-         * @brief 为播放器设置 FLV 拉流配置。FLV 格式流相关配置仅适用于支持 MSE 播放的 PC 端浏览器和安卓端浏览器。
+         * @brief 为播放器设置 FLV 拉流配置。
+         * @listtip FLV 拉流格式流相关配置适用于支持 MSE 播放的 PC 端浏览器、安卓端浏览器和支持 MMS API 的 iOS 浏览器。
          */
         /** {en}
-         * @brief Configurations for playing an FLV stream. You can only play FLV streams with web browsers on PC and Android devices, and the browsers need to support Media Source Extensions (MSE) playback.
+         * @brief Configurations for playing an FLV stream.
+         * @listtip FLV pull stream format stream configurations are applicable to PC browsers, Android browsers that support MSE playback, and iOS browsers that support MMS API.
          */
         flv?: Flv;
         /** {zh}
-         * @brief 为播放器设置 HLS 拉流配置。HLS 格式流相关配置仅适用于支持 MSE 播放的 PC 端浏览器和安卓端浏览器。
-         * @listtip
-         *  - PC 端该配置默认生效；
-         *  - 移动端仅在 `enableMSE` 设置为 `true` 且支持 MSE 的浏览器中生效。
+         * @brief 为播放器设置 HLS 拉流配置。
+         * @listtip - HLS 格式流相关配置仅适用于支持 MSE API的 PC 端浏览器和安卓端浏览器。
+         *          - PC 端该配置默认生效；
+         *          - 移动端仅在 `enableMSE` 设置为 `true` 且支持 MSE 的浏览器中生效。
          */
         /** {en}
-         * @brief  Configurations for playing an HLS stream. You can only play HLS streams with web browsers on PC and Android devices, and the browsers need to support Media Source Extensions (MSE) playback.
-         * @listtip
-         *  - This configuration takes effect by default on PC;
-         *  - For mobile devices, the configuration takes effect only when `enableMSE` is set to `true` for the browser.
+         * @brief Configurations for playing an HLS stream.
+         * @listtip - The HLS format stream configuration is only applicable to PC browsers and Android browsers that support the MSE API.
+         *          - This configuration takes effect by default on PC;
+         *          - For mobile devices, the configuration takes effect only when `enableMSE` is set to `true` for the browser.
          */
         hls?: Hls;
         /** {zh}
@@ -10609,14 +10681,14 @@ declare namespace live {
     interface Abr {
         /** {zh}
          * @brief 是否开启 FLV 拉流时的自适应码率（ABR）功能，默认为开启。
-         *        - true: 开启
-         *        - false: 关闭
+         *        - `true`: 开启；
+         *        - `false`: 关闭。
          * @default true
          */
         /** {en}
          * @brief Enable or disable the Adaptive Bitrate (ABR) feature. The default setting is enabled.
-         *        - true: Enable;
-         *        - false: Disable.
+         *        - `true`: Enable;
+         *        - `false`: Disable.
          */
         enable?: boolean;
         /** {zh}
@@ -10635,14 +10707,14 @@ declare namespace live {
         downTip?: boolean;
         /** {zh}
          * @brief 是否开始调试模式，默认为关闭。
-         *        - true: 开启；
-         *        - false: 关闭。
+         *        - `true`: 开启；
+         *        - `false`: 关闭。
          * @default false
          */
         /** {en}
          * @brief Whether to start debug mode, default is false.
-         *        - true: Enable,
-         *        - false: Disable.
+         *        - `true`: Enable,
+         *        - `false`: Disable.
          * @default false
          */
         debug?: boolean;
@@ -10880,16 +10952,16 @@ declare namespace live {
         retryDelay?: number;
         /** {zh}
          * @brief 播放器发起 RTM 拉流请求时，是否开启自动转码。
-         * - true：开启
-         * - false：关闭
+         *        - `true`：开启；
+         *        - `false`：关闭。
          * @listtip
          * 如有使用 RTM 拉流自动转码的需求，请先创建工单联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)进行配置。
          * @default false
          */
         /** {en}
          * @brief Whether to enable automatic transcoding when the player requests to pull an RTM stream.
-         * - true: Enable
-         * - false: Disable
+         *        - `true`: Enable;
+         *        - `false`: Disable.
          * @listtip
          * If you want to use the automatic transcoding feature when playing an RTM stream, contact your [technical support](https://www.byteplus.com/en/support).
          * @default false
@@ -10904,20 +10976,38 @@ declare namespace live {
          */
         networkEvaluateInterval?: number;
         /** {zh}
-         * @brief 断流后重新拉流是否无缝播放。
+         * @brief 暂停后重新拉流的处理方式是否为无缝替换。
+         *        - `true`：是，重新拉流期间不会出现黑屏现象。
+         *        - `false`：否，重新拉流期间会出现黑屏现象。
          * @default false
+         * @listtip Safari 浏览器在进行 RTM 拉流时不支持使用此配置。
          */
         /** {en}
-         * @brief
+         * @brief Whether the processing method for re-pulling the stream after pausing is seamless replacement.
+         *        - `true`: Yes, there will be no black screen phenomenon during re-pulling the stream.
+         *        - `false`: No, there will be a black screen phenomenon during re-pulling the stream.
+         *        :::tip
+         *        Safari browsers do not support using this configuration when performing RTM stream pulling.
+         *        :::
+         * @default false
          */
         seamlesslyReload?: boolean;
         /** {zh}
-         * @brief 暂停后多久断流，默认不断流。
+         * @brief 暂停播放后的断联时间，单位为秒，默认不断联。
+         * @listtip Safari 浏览器在进行 RTM 拉流时，如果出现断联，重新拉流时会出现短暂黑屏或加载情况。
          */
         /** {en}
-         * @brief
+         * @brief The disconnection time after pausing playback is in seconds. By default, there is no disconnection.
+         * @listtip When Safari browser performs RTM streaming, if there is a disconnection, there will be a short black screen or loading situation when re-streaming.
          */
         disconnectTime?: number;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
+        enableOriginSdpLogger?: boolean;
     }
     /** {zh}
      * @list option
@@ -10957,14 +11047,14 @@ declare namespace live {
         loadTimeout?: number;
         /** {zh}
          * @brief 播放器发起 FLV 拉流请求时，是否开启低延时。例如，当您开启低延时且推流端 GOP 设置为 2s 的情况下，FLV 拉流平均端到端延时约为 2s。
-         * - true：开启
-         * - false：关闭
+         *        - `true`：开启；
+         *        - `false`：关闭
          * @default false
          */
         /** {en}
          * @brief Whether to enable low latency when playing an FLV address. For example, if you have enabled low latency, and set GOP to 2 seconds, the average latency will be around 2 seconds.
-         * - true: Enable
-         * - false: Disable
+         *        - `true`: Enable;
+         *        - `false`: Disable.
          * @default false
          */
         enableLowLatency?: boolean;
@@ -10998,23 +11088,24 @@ declare namespace live {
          */
         maxReaderInterval?: number;
         /** {zh}
-         * @brief
-         *        直播暂停时的断流等待时间，单位为秒，默认值为 0，表示直播暂停时即断流。
+         * @brief 暂停播放后的断联时间，单位为秒，默认值为 0，表示暂停播放后立即断联。
          * @default 0
          */
         /** {en}
-         * @brief The waiting time for disconnection during live streaming suspension, measured in seconds. The default value is 0, indicating immediate disconnection when live streaming is suspended.
+         * @brief The disconnection time after pausing playback is in seconds. The default value is 0, indicating immediate disconnection after pausing playback.
          * @default 0
          */
         disconnectTime?: number;
         /** {zh}
-         * @brief 断流后重新拉流是否无缝，无缝拉流时重新拉流不会出现黑帧。
-         *        - `true`：是；
-         *        - `false`：否。
+         * @brief 暂停后重新拉流的处理方式是否为无缝替换。
+         *        - `true`：是，重新拉流期间不会出现黑屏现象。
+         *        - `false`：否，重新拉流期间会出现黑屏现象。
          * @default false
          */
         /** {en}
-         * @brief Whether re-pulling the stream after disconnection is seamless. When seamless stream pulling, there will be no black frames during re-pulling. - `true`: Yes; - `false`: No.
+         * @brief Whether the processing method for re-pulling the stream after pausing is seamless replacement.
+         *        - `true`: Yes, there will be no black screen phenomenon during re-pulling the stream.
+         *        - `false`: No, there will be a black screen phenomenon during re-pulling the stream.
          * @default false
          */
         seamlesslyReload?: boolean;
@@ -11037,14 +11128,14 @@ declare namespace live {
         abrPts?: string | number;
         /** {zh}
          * @brief FLV 低延时模式下，是否开启倍速追帧。
-         *        - true：开启；
-         *        - false：关闭。
+         *        - `true`：开启；
+         *        - `false`：关闭。
          * @default true
          */
         /** {en}
          * @brief Whether to enable speed-up frame chasing in FLV low latency mode.
-         *        - true: enabled;
-         *        - false: disabled.
+         *        - `true`: enabled;
+         *        - `false`: disabled.
          * @default true
          */
         enableFrameChasing?: boolean;