@byteplus/react-native-live-pull 1.5.1-rc.2 → 1.5.1-rc.3

package/lib/typescript/codegen/android/keytype.d.ts

@@ -1,36 +1,55 @@
 import { int, String, List, long, float, ByteBuffer, EGLContext } from './types';
 export declare enum VeLivePlayerResolution {
-    
+    /** {zh}
+     * @brief 原始流。
+     *
+     */
     /** {en}
      * @brief Original.
      *
      */
     VeLivePlayerResolutionOrigin = "origin",
-    
+    /** {zh}
+     * @brief UHD 超高清。
+     *
+     */
     /** {en}
      * @brief Ultra high definition (UHD).
      *
      */
     VeLivePlayerResolutionUHD = "uhd",
-    
+    /** {zh}
+     * @brief HD 高清。
+     *
+     */
     /** {en}
      * @brief High definition (HD).
      *
      */
     VeLivePlayerResolutionHD = "hd",
-    
+    /** {zh}
+     * @brief SD 标清。
+     *
+     */
     /** {en}
      * @brief Standard definition (SD).
      *
      */
     VeLivePlayerResolutionSD = "sd",
-    
+    /** {zh}
+     * @brief LD 低清。
+     *
+     */
     /** {en}
      * @brief Low definition (LD).
      *
      */
     VeLivePlayerResolutionLD = "ld",
-    
+    /** {zh}
+     * @brief AO 纯音频流。
+     * @hidden (Android)
+     *
+     */
     /** {en}
      * @brief AO pure audio stream.
      * @hidden (Android)
@@ -39,7 +58,12 @@ export declare enum VeLivePlayerResolution {
     VeLivePlayerResolutionAO = "ao"
 }
 export declare class VeLivePlayerConfiguration {
-    
+    /** {zh}
+     * @brief 是否开启字符串 SEI 消息的解析，默认值为 false。<br/>
+     *        - true：开启；
+     *        - false：关闭。
+     *
+     */
     /** {en}
      * @brief Whether to enable the parsing of string SEI messages. The default value is `false`.<br/>
      *        - true: Enable;
@@ -47,7 +71,13 @@ export declare class VeLivePlayerConfiguration {
      *
      */
     enableSei: boolean;
-    
+    /** {zh}
+     * @brief 是否开启二进制 SEI 消息的解析，默认值为 false。<br/>
+     *        - true：开启；
+     *        - false：关闭。
+     * @notes 二进制 SEI 开启后，字符串 SEI 的回调将不再发送。
+     *
+     */
     /** {en}
      * @brief Whether to enable the parsing of binary SEI messages. The default value is `false`. <br>
      *       - true: Enable;
@@ -56,7 +86,12 @@ export declare class VeLivePlayerConfiguration {
      *
      */
     enableBinarySei: boolean;
-    
+    /** {zh}
+     * @brief 是否开启硬件解码功能，默认值为 true。开启硬件解码后，如果出现硬件解码启动失败或硬件解码失败的情况，播放器内部会自动切换为软解。<br>
+     *      - true：开启；
+     *      - false：关闭。
+     *
+     */
     /** {en}
      * @brief Whether to turn on hardware decoding. The default value is `true`. When hardware decoding is enabled, if the player fails to start hardware decoding or if hardware decoding fails, the player automatically switches to software decoding. <br>
      *       - true: Enable;
@@ -64,13 +99,21 @@ export declare class VeLivePlayerConfiguration {
      *
      */
     enableHardwareDecode: boolean;
-    
+    /** {zh}
+     * @brief 网络超时时间，单位为 ms，默认值为 5000。播放器发起网络请求，如果超过了该时间仍未收到服务器响应，则认为网络请求失败。
+     *
+     */
     /** {en}
      * @brief Network timeout duration, in milliseconds. The default value is `5000`. Once the player sends a network request, if the player does not receive a response from the server after the timeout duration, the network request is considered failed.
      *
      */
     networkTimeoutMs: int;
-    
+    /** {zh}
+     * @brief 重试时间间隔，单位为 ms，默认值为 5000，仅在无备流时生效。<br>
+     *     - 在无备流的场景下，若遇到网络异常等问题导致播放中断，播放器会立即进行重试，前三次重试为立即执行，第四次及之后的重试将按照设置的重试时间间隔执行；
+     *     - 在有备流的场景下，重试时间间隔将不生效，所有重试均会立即执行。
+     *
+     */
     /** {en}
      * @brief The retry time interval, in milliseconds. The default value is `5000`. This variable takes effect only when there is no backup stream.<br>
      *     - In the absence of a backup stream, if playback is interrupted due to network issues or other anomalies, the player will immediately initiate a retry. The player will make the first three retries immediately without any waiting time. However, for subsequent retries starting from the fourth attempt, the player will wait for the specified time interval between each attempt.
@@ -78,7 +121,12 @@ export declare class VeLivePlayerConfiguration {
      *
      */
     retryIntervalTimeMs: int;
-    
+    /** {zh}
+     * @brief 在网络连接错误的情况下，播放器最大重试次数，默认值为 5。如果取值为 0，表示关闭播放器内部重试。<br>
+     *     - 在无备流的场景下，每次重试，会消耗一次重试次数；
+     *     - 在有备流的场景下，每次主备流切换，会消耗一次重试次数。
+     *
+     */
     /** {en}
      * @brief In the case of a network connection error, the maximum number of automatic retries of the player. The default value is `5`. If the value is `0`, the player will not automatically retry.<br>
      *     - In the absence of a backup stream, each retry will count as one retry attempt.
@@ -86,7 +134,12 @@ export declare class VeLivePlayerConfiguration {
      *
      */
     retryMaxCount: int;
-    
+    /** {zh}
+     * @brief 是否开启本地 DNS 预解析，默认值为 false。开启本地 DNS 预解析可以缩短启播时间。如果本地 DNS 预解析出现异常，可能会影响播放器的正常使用。<br>
+     *      - true：开启；
+     *      - false：关闭。
+     *
+     */
     /** {en}
      * @brief Whether to enable local DNS prefetch. The default value is `false`. Enabling local DNS prefetch can reduce the time required to start playback. If an abnormality occurs with local DNS prefetch, the player may not function properly. <br>
      *       - true: Enable;
@@ -94,7 +147,12 @@ export declare class VeLivePlayerConfiguration {
      *
      */
     enableLiveDNS: boolean;
-    
+    /** {zh}
+     * @brief 是否开启播放信息周期性回调。默认值为 false。周期性回调参数详细说明请参见 [VeLivePlayerStatistics](188115#VeLivePlayerStatistics) 。当 `enableStatisticsCallback` 为 `true`，且 [statisticsCallbackInterval](188115#VeLivePlayerConfiguration-statisticscallbackinterval) 大于 0 时，播放器会在指定的时间间隔内，周期性地回调播放器状态信息。<br>
+     *        - true：开启；
+     *        - false：关闭。
+     *
+     */
     /** {en}
      * @brief Whether to enable periodic callbacks for playback information. The default value is `false`. Refer to [VeLivePlayerStatistics](#VeLivePlayerStatistics) for more information on callback statistics. If `enableStatisticsCallback` is `true` and [statisticsCallbackInterval](#VeLivePlayerConfiguration-statisticscallbackinterval) is greater than `0`, the player will periodically report the player status information after the specified time interval.<br/>
      *        - true: Enable;
@@ -102,7 +160,10 @@ export declare class VeLivePlayerConfiguration {
      *
      */
     enableStatisticsCallback: boolean;
-    
+    /** {zh}
+     * @brief 播放信息周期性回调的时间间隔，单位为 s，默认值为 5。当 [enableStatisticsCallback](188115#VeLivePlayerConfiguration-enablestatisticscallback) 为 `true`，且 `statisticsCallbackInterval` 大于 0 时，播放器会在指定的时间间隔内，周期性地回调播放器状态信息。
+     *
+     */
     /** {en}
      * @brief The time interval for periodic callbacks that provide playback information, in seconds. The default value is `5`. If [enableStatisticsCallback](#VeLivePlayerConfiguration-enablestatisticscallback) is `true` and `statisticsCallbackInterval` is greater than `0`, the player will periodically report the player status information after the specified time interval.
      *
@@ -110,25 +171,37 @@ export declare class VeLivePlayerConfiguration {
     statisticsCallbackInterval: int;
 }
 export declare enum VeLivePlayerFormat {
-    
+    /** {zh}
+     * @brief FLV 格式。
+     *
+     */
     /** {en}
      * @brief FLV.
      *
      */
     VeLivePlayerFormatFLV = 0,
-    
+    /** {zh}
+     * @brief HLS 格式。
+     *
+     */
     /** {en}
      * @brief HLS.
      *
      */
     VeLivePlayerFormatHLS = 1,
-    
+    /** {zh}
+     * @brief RTM 格式。
+     *
+     */
     /** {en}
      * @brief Real Time Media (RTM).
      *
      */
     VeLivePlayerFormatRTM = 2,
-    
+    /** {zh}
+     * @brief CMAF 格式
+     *
+     */
     /** {en}
      * @brief CMAF format
      *
@@ -136,25 +209,37 @@ export declare enum VeLivePlayerFormat {
     VeLivePlayerFormatCMAF = 3
 }
 export declare enum VeLivePlayerProtocol {
-    
+    /** {zh}
+     * @brief TCP 协议。
+     *
+     */
     /** {en}
      * @brief TCP.
      *
      */
     VeLivePlayerProtocolTCP = 0,
-    
+    /** {zh}
+     * @brief QUIC 协议。
+     *
+     */
     /** {en}
      * @brief QUIC.
      *
      */
     VeLivePlayerProtocolQUIC = 1,
-    
+    /** {zh}
+     * @brief TLS 协议。
+     *
+     */
     /** {en}
      * @brief TLS.
      *
      */
     VeLivePlayerProtocolTLS = 2,
-    
+    /** {zh}
+     * @brief HTTP2.0 协议。
+     *
+     */
     /** {en}
      * @brief HTTP2.0 protocol
      *
@@ -162,19 +247,28 @@ export declare enum VeLivePlayerProtocol {
     VeLivePlayerProtocolHTTP2 = 3
 }
 export declare enum VeLivePlayerMirror {
-    
+    /** {zh}
+     * @brief 关闭镜像。
+     *
+     */
     /** {en}
      * @brief No mirroring.
      *
      */
     VeLivePlayerMirrorNone = 0,
-    
+    /** {zh}
+     * @brief 水平镜像。
+     *
+     */
     /** {en}
      * @brief Horizontal mirroring.
      *
      */
     VeLivePlayerMirrorHorizontal = 1,
-    
+    /** {zh}
+     * @brief 垂直镜像。
+     *
+     */
     /** {en}
      * @brief Vertical mirroring.
      *
@@ -182,25 +276,37 @@ export declare enum VeLivePlayerMirror {
     VeLivePlayerMirrorVertical = 2
 }
 export declare enum VeLivePlayerVideoBufferType {
-    
+    /** {zh}
+     * @brief 未知格式。
+     *
+     */
     /** {en}
      * @brief Unknown format.
      *
      */
     VeLivePlayerVideoBufferTypeUnknown = 0,
-    
+    /** {zh}
+     * @brief ByteBuffer 格式。
+     *
+     */
     /** {en}
      * @brief ByteBuffer.
      *
      */
     VeLivePlayerVideoBufferTypeByteBuffer = 1,
-    
+    /** {zh}
+     * @brief ByteArray 格式。
+     *
+     */
     /** {en}
      * @brief ByteArray.
      *
      */
     VeLivePlayerVideoBufferTypeByteArray = 2,
-    
+    /** {zh}
+     * @brief 纹理格式。
+     *
+     */
     /** {en}
      * @brief Texture.
      *
@@ -208,31 +314,46 @@ export declare enum VeLivePlayerVideoBufferType {
     VeLivePlayerVideoBufferTypeTexture = 3
 }
 export declare enum VeLivePlayerStatus {
-    
+    /** {zh}
+     * @brief 停止播放状态。
+     *
+     */
     /** {en}
      * @brief The playback is stopped.
      *
      */
     VeLivePlayerStatusStopped = 0,
-    
+    /** {zh}
+     * @brief 暂停播放状态。
+     *
+     */
     /** {en}
      * @brief The playback is paused.
      *
      */
     VeLivePlayerStatusPaused = 1,
-    
+    /** {zh}
+     * @brief 播放器准备完成，等待渲染。
+     *
+     */
     /** {en}
      * @brief The player finishes preparing and is waiting to render the video.
      *
      */
     VeLivePlayerStatusPrepared = 2,
-    
+    /** {zh}
+     * @brief 正在播放，即首帧渲染完成且播放器未发生错误。
+     *
+     */
     /** {en}
      * @brief Playback is currently in progress, meaning that the first frame has been rendered and no errors have occurred to the player.
      *
      */
     VeLivePlayerStatusPlaying = 3,
-    
+    /** {zh}
+     * @brief 播放器发生错误。
+     *
+     */
     /** {en}
      * @brief An error has occurred to the player.
      *
@@ -240,49 +361,79 @@ export declare enum VeLivePlayerStatus {
     VeLivePlayerStatusError = 4
 }
 export declare class VeLivePlayerLogConfig {
-    
+    /** {zh}
+     * @brief 日志文件保存路径。缺省情况下，使用默认路径 `/cache/Log`。
+     *
+     */
     /** {en}
      * @brief The log file directory path. The default value is `/cache/Log`.
      *
      */
     logPath: String;
-    
+    /** {zh}
+     * @brief 日志文件整体最大尺寸，单位为 M，默认值为 100。
+     *
+     */
     /** {en}
      * @brief The maximum size of log files, in MB. The default value is `100`.
      *
      */
     maxLogSizeM: int;
-    
+    /** {zh}
+     * @brief 单个日志文件最大尺寸，单位为 M，默认值为 2。
+     *
+     */
     /** {en}
      * @brief The size of a single log file, in MB. The default value is `2`.
      *
      */
     singleLogSizeM: int;
-    
+    /** {zh}
+     * @brief 日志文件有效期，过期后下次创建日志文件时会删除之前的文件。单位为 s，默认值为 604,800，即 7 天。
+     *
+     */
     /** {en}
      * @brief  The log expiration time, in seconds. Once a log file expires, a new log file will be created and the existing file will be deleted. The default value is `604800`, or seven days.
      *
      */
     logExpireTimeS: int;
-    
+    /** {zh}
+     * @brief 日志是否打印到控制台输出，默认值为 true。<br>
+     *                   - true：打印；
+     *                   - false：不打印。
+     *
+     */
     /** {en}
      * @brief Whether to print log in the console. The default value is `true`.
      *
      */
     enableConsole: boolean;
-    
+    /** {zh}
+     * @brief 日志是否打印到文件，默认值为 true。<br>
+     *                   - true：打印；
+     *                   - false：不打印。
+     *
+     */
     /** {en}
      * @brief Whether to save log to a file. The default value is `true`.
      *
      */
     enableLogFile: boolean;
-    
+    /** {zh}
+     * @brief 日志上报路径。
+     *
+     */
     /** {en}
      * @brief The upload URL of the log file.
      *
      */
     queryUrl: String;
-    
+    /** {zh}
+     * @brief 是否轮询。<br>
+     *      - `true`：开启；
+     *      - `false`：关闭。
+     *
+     */
     /** {en}
      * @brief Whether to enable thread polling. <br>
      *      - `true`: Enable
@@ -290,25 +441,37 @@ export declare class VeLivePlayerLogConfig {
      *
      */
     enableThreadLoop: boolean;
-    
+    /** {zh}
+     * @brief 轮询间隔时间, 单位为 ms。取值范围：大于 0。
+     *
+     */
     /** {en}
      * @brief The polling interval, in milliseconds. The value should be greater than 0.
      *
      */
     intervalMS: int;
-    
+    /** {zh}
+     * @brief HTTP 请求超时时间。取值范围：大于 0。
+     *
+     */
     /** {en}
      * @brief The timeout for an HTTP request. Value range: > 0.
      *
      */
     httpTimeoutMS: int;
-    
+    /** {zh}
+     * @brief 文件上传超时时间。取值范围：大于 0。
+     *
+     */
     /** {en}
      * @brief The timeout for an HTTP request to upload a file. Value range: > 0.
      *
      */
     httpUploadFileTimeoutMS: int;
-    
+    /** {zh}
+     * @brief 允许写入的日志等级，默认为 VeLivePlayerLogLevelDebug，详情请参见 [VeLivePlayerLogLevel](#VeLivePlayerLogLevel)。
+     *
+     */
     /** {en}
      * @brief The output log level. The default value is `VeLivePlayerLogLevelDebug`. For details, see [VeLivePlayerLogLevel](#VeLivePlayerLogLevel).
      *
@@ -316,7 +479,12 @@ export declare class VeLivePlayerLogConfig {
     logLevel: VeLivePlayerLogLevel;
 }
 export declare class VeLivePlayerStreamData {
-    
+    /** {zh}
+     * @brief 是否打开 ABR 平滑切档功能，默认为 false。<br>
+     *     - true：开启；
+     *     - false：关闭。
+     *
+     */
     /** {en}
      * @brief Whether to enable adaptive bitrate (ABR). The default value is `false`. <br>
      *      - true: Enable;
@@ -324,7 +492,12 @@ export declare class VeLivePlayerStreamData {
      *
      */
     enableABR: boolean;
-    
+    /** {zh}
+     * @brief 是否打开主备切换，默认为 false。<br>
+     *     - true：开启；
+     *     - false：关闭。
+     *
+     */
     /** {en}
      * @brief Whether to enable switching between primary and backup streams. The default value is `false`. <br>
      *      - true: Enable;
@@ -332,31 +505,46 @@ export declare class VeLivePlayerStreamData {
      *
      */
     enableMainBackupSwitch: boolean;
-    
+    /** {zh}
+     * @brief 播放器的默认清晰度档位，默认使用原始流清晰度。详情请参见 [VeLivePlayerResolution](#VeLivePlayerResolution)。
+     *
+     */
     /** {en}
      * @brief The default resolution. The default value is `VeLivePlayerResolutionOrigin`, which indicates the original resolution. See [VeLivePlayerResolution](#VeLivePlayerResolution) for details.
      *
      */
     defaultResolution: VeLivePlayerResolution;
-    
+    /** {zh}
+     * @brief 播放器的默认播放格式，默认值为 FLV。详情请参见 [VeLivePlayerFormat](#VeLivePlayerFormat)。
+     *
+     */
     /** {en}
      * @brief The default video format. The default value is `VeLivePlayerFormatFLV`. See [VeLivePlayerFormat](#VeLivePlayerFormat) for details.
      *
      */
     defaultFormat: VeLivePlayerFormat;
-    
+    /** {zh}
+     * @brief 播放器的默认播放传输层协议，默认值为 TCP。详情请参见 [VeLivePlayerProtocol](#VeLivePlayerProtocol)。
+     *
+     */
     /** {en}
      * @brief The default transmission protocol. The default value is `VeLivePlayerProtocolTCP`. See [VeLivePlayerProtocol](#VeLivePlayerProtocol) for details.
      *
      */
     defaultProtocol: VeLivePlayerProtocol;
-    
+    /** {zh}
+     * @brief 主路流地址列表，详情请参见 [[VeLivePlayerStream](#VeLivePlayerStreamData-VeLivePlayerStream)。
+     *
+     */
     /** {en}
      * @brief A list of main stream addresses. See [VeLivePlayerStream](#VeLivePlayerStreamData-VeLivePlayerStream) for details.
      *
      */
     mainStreamList: List<VeLivePlayerStream>;
-    
+    /** {zh}
+     * @brief 备路流地址列表。详情请参见 [VeLivePlayerStream](#VeLivePlayerStreamData-VeLivePlayerStream)。
+     *
+     */
     /** {en}
      * @brief A list of backup stream addresses. See [VeLivePlayerStream](#VeLivePlayerStreamData-VeLivePlayerStream) for details.
      *
@@ -364,13 +552,19 @@ export declare class VeLivePlayerStreamData {
     backupStreamList: List<VeLivePlayerStream>;
 }
 export declare enum VeLivePlayerResolutionSwitchReason {
-    
+    /** {zh}
+     * @brief ABR 自动切档。
+     *
+     */
     /** {en}
      * @brief The resolution is switched automatically through the adaptive bitrate (ABR) feature.
      *
      */
     VeLiveplayerResolutionSwitchByAuto = 0,
-    
+    /** {zh}
+     * @brief 调用 [switchResolution](188111#VeLivePlayer-switchresolution) 手动切换档位导致的分辨率变化。
+     *
+     */
     /** {en}
      * @brief The resolution is changed after switchResolution{@link #VeLivePlayer#switchResolution} is called.
      *
@@ -379,31 +573,46 @@ export declare enum VeLivePlayerResolutionSwitchReason {
 }
 export declare class VeLivePlayerStream {
     constructor();
-    
+    /** {zh}
+     * @brief 播放地址。
+     *
+     */
     /** {en}
      * @brief The pull stream address.
      *
      */
     url: String;
-    
+    /** {zh}
+     * @brief 清晰度档位。详情请参见 [VeLivePlayerResolution](#VeLivePlayerResolution)。
+     *
+     */
     /** {en}
      * @brief The playback resolution. For details, see [VeLivePlayerResolution](#VeLivePlayerResolution).
      *
      */
     resolution: VeLivePlayerResolution;
-    
+    /** {zh}
+     * @brief 播放码率，单位为 kbps。
+     *
+     */
     /** {en}
      * @brief The playback bitrate, in Kbps.
      *
      */
     bitrate: long;
-    
+    /** {zh}
+     * @brief 播放格式。详情请参见 [VeLivePlayerFormat](#VeLivePlayerFormat)。
+     *
+     */
     /** {en}
      * @brief The format of the live stream. See [VeLivePlayerFormat](#VeLivePlayerFormat) for details.
      *
      */
     format: VeLivePlayerFormat;
-    
+    /** {zh}
+     * @brief 播放流类型为主路或备路。详情请参见 [VeLivePlayerStreamType](#VeLivePlayerStreamType)。
+     *
+     */
     /** {en}
      * @brief Whether the stream is a main or backup stream. See [VeLivePlayerStreamType](#VeLivePlayerStreamType) for details.
      *
@@ -411,19 +620,28 @@ export declare class VeLivePlayerStream {
     streamType: VeLivePlayerStreamType;
 }
 export declare enum VeLivePlayerFillMode {
-    
+    /** {zh}
+     * @brief 显示完整的视频帧。视频帧等比缩放，直至视频帧恰好在画布上全部显示。如果视频帧长宽比例与画布不同，视窗上未被视频帧填满区域将填充为黑色。
+     *
+     */
     /** {en}
      * @brief Display the full video. The video is uniformly scaled until one dimension of the video hits the boundary of the screen. Any remaining space on the screen will be filled with black.
      *
      */
     VeLivePlayerFillModeAspectFit = 0,
-    
+    /** {zh}
+     * @brief 视频帧自适应画布。视频帧非等比缩放，直至填满画布。在此过程中，视频帧的长宽比例可能会发生变化。
+     *
+     */
     /** {en}
      * @brief Stretch the video to fill the screen. The aspect ratio of the video might change.
      *
      */
     VeLivePlayerFillModeFullFill = 1,
-    
+    /** {zh}
+     * @brief 视频填满画布。视频帧等比缩放，直至填满画布，超出屏幕的部分将被裁剪，画面可能不完整。
+     *
+     */
     /** {en}
      * @brief Uniformly scale the video until the screen is completely filled. Part of the video may be cropped.
      *
@@ -431,19 +649,28 @@ export declare enum VeLivePlayerFillMode {
     VeLivePlayerFillModeAspectFill = 2
 }
 export declare enum VeLivePlayerPixelFormat {
-    
+    /** {zh}
+     * @brief 未知格式。
+     *
+     */
     /** {en}
      * @brief Unknown format.
      *
      */
     VeLivePlayerPixelFormatUnknown = 0,
-    
+    /** {zh}
+     * @brief RGBA8888 格式。
+     *
+     */
     /** {en}
      * @brief RGBA8888.
      *
      */
     VeLivePlayerPixelFormatRGBA32 = 1,
-    
+    /** {zh}
+     * @brief 纹理格式。
+     *
+     */
     /** {en}
      * @brief Texture.
      *
@@ -452,13 +679,21 @@ export declare enum VeLivePlayerPixelFormat {
 }
 export declare class VeLivePlayerStatistics {
     constructor();
-    
+    /** {zh}
+     * @brief 当前直播的播放地址。
+     *
+     */
     /** {en}
      * @brief The current pull stream address.
      *
      */
     url: String;
-    
+    /** {zh}
+     * @brief 是否使用硬件解码。<br>
+     *     - true：硬解；
+     *     - false：非硬解。
+     *
+     */
     /** {en}
      * @brief Whether hardware decoding is used. <br>
      *      - true: Hardware decoding is used;
@@ -466,73 +701,109 @@ export declare class VeLivePlayerStatistics {
      *
      */
     isHardwareDecode: boolean;
-    
+    /** {zh}
+     * @brief 视频的编码类型。
+     *
+     */
     /** {en}
      * @brief The encoding format of the video.
      *
      */
     videoCodec: String;
-    
+    /** {zh}
+     * @brief 从当前视频开始播放起，累计的卡顿时长，单位为 ms。
+     *
+     */
     /** {en}
      * @brief The cumulative duration of stutters that occurred since the beginning of playback, in milliseconds.
      *
      */
     stallTimeMs: long;
-    
+    /** {zh}
+     * @brief 带宽预测 ，单位为 kbps
+     *
+     */
     /** {en}
      * @brief Bandwidth estimation, unit is kbps.
      *
      */
     bandwidthEstimation: long;
-    
+    /** {zh}
+     * @brief 当前播放延时，单位为 ms。仅在使用了火山引擎视频直播推流 SDK 时，支持统计播放延时。
+     *
+     */
     /** {en}
      * @brief The current playback latency, in milliseconds. The latency data is available only if you use the BytePlus MediaLive Broadcast SDK to push the live stream.
      *
      */
     delayMs: long;
-    
+    /** {zh}
+     * @brief 当前播放视频的宽度，单位为 px。
+     *
+     */
     /** {en}
      * @brief The width of the video, in pixels.
      *
      */
     width: int;
-    
+    /** {zh}
+     * @brief 当前播放视频的高度，单位为 px。
+     *
+     */
     /** {en}
      * @brief The height of the video, in pixels.
      *
      */
     height: int;
-    
+    /** {zh}
+     * @brief 当前播放视频的帧率，单位为 fps。
+     *
+     */
     /** {en}
      * @brief The frame rate of the video, in fps.
      *
      */
     fps: float;
-    
+    /** {zh}
+     * @brief 实时下载的码率，单位为 kbps。
+     *
+     */
     /** {en}
      * @brief The downlink bitrate, in Kbps.
      *
      */
     bitrate: long;
-    
+    /** {zh}
+     * @brief 视频播放的缓冲区 buffer 大小，单位为 ms。
+     *
+     */
     /** {en}
      * @brief The video buffer, in milliseconds.
      *
      */
     videoBufferMs: long;
-    
+    /** {zh}
+     * @brief 音频播放的缓冲区 buffer 大小，单位为 ms。
+     *
+     */
     /** {en}
      * @brief The audio buffer, in milliseconds.
      *
      */
     audioBufferMs: long;
-    
+    /** {zh}
+     * @brief 当前播放的视频格式。
+     *
+     */
     /** {en}
      * @brief The video format.
      *
      */
     format: String;
-    
+    /** {zh}
+     * @brief 当前播放的传输协议。
+     *
+     */
     /** {en}
      * @brief The transmission protocol of the live stream.
      *
@@ -540,49 +811,73 @@ export declare class VeLivePlayerStatistics {
     protocol: String;
 }
 export declare class VeLivePlayerVideoFrame {
-    
+    /** {zh}
+     * @brief 视频帧数据封装格式。详情请参见 [VeLivePlayerVideoBufferType](#VeLivePlayerVideoBufferType)。
+     *
+     */
     /** {en}
      * @brief The encapsulation format. See [VeLivePlayerVideoBufferType](#VeLivePlayerVideoBufferType) for details.
      *
      */
     bufferType: VeLivePlayerVideoBufferType;
-    
+    /** {zh}
+     * @brief 视频帧像素格式。详情请参见 [VeLivePlayerPixelFormat](#VeLivePlayerPixelFormat)。
+     *
+     */
     /** {en}
      * @brief The pixel format. See [VeLivePlayerPixelFormat](#VeLivePlayerPixelFormat) for details.
      *
      */
     pixelFormat: VeLivePlayerPixelFormat;
-    
+    /** {zh}
+     * @brief 视频宽度，单位为 px。
+     *
+     */
     /** {en}
      * @brief The video width, in pixels.
      *
      */
     width: int;
-    
+    /** {zh}
+     * @brief 视频高度，单位为 px。
+     *
+     */
     /** {en}
      * @brief The video height, in pixels.
      *
      */
     height: int;
-    
+    /** {zh}
+     * @brief 视频帧的渲染时间戳。单位为 ms。
+     *
+     */
     /** {en}
      * @brief The timestamp indicating the time when the video frame is rendered, in milliseconds.
      *
      */
     pts: long;
-    
+    /** {zh}
+     * @brief OpenGL 渲染的视频纹理数据。如果将 [VeLivePlayerPixelFormat](#VeLivePlayerPixelFormat) 设置为`VeLivePlayerPixelFormatTexture`，并将 [VeLivePlayerVideoBufferType](#VeLivePlayerVideoBufferType) 设置为`VeLivePlayerVideoBufferTypeTexture`，SDK 会返回此视频数据类型。有关详细信息，请参阅[VeLivePlayerVideoTexture](#VeLivePlayerVideoTexture)。
+     *
+     */
     /** {en}
      * @brief The texture data for OpenGL rendering. The SDK returns this video data type if you set [VeLivePlayerPixelFormat](#VeLivePlayerPixelFormat) to `VeLivePlayerPixelFormatTexture` and set [VeLivePlayerVideoBufferType](#VeLivePlayerVideoBufferType) to `VeLivePlayerVideoBufferTypeTexture`. See [VeLivePlayerVideoTexture](#VeLivePlayerVideoTexture) for details.
      *
      */
     texture: VeLivePlayerVideoTexture;
-    
+    /** {zh}
+     * @brief ByteBuffer 格式的视频数据。如果将 [VeLivePlayerPixelFormat](#VeLivePlayerPixelFormat)设置为`VeLivePlayerPixelFormatRGBA32`，并将 [VeLivePlayerVideoBufferType](#VeLivePlayerVideoBufferType) 设置为`VeLivePlayerVideoBufferTypeByteBuffer`，则 SDK 会返回此视频数据类型。
+     *
+     */
     /** {en}
      * @brief The video data in ByteBuffer format. The SDK returns this video data type if you set [VeLivePlayerPixelFormat](#VeLivePlayerPixelFormat) to `VeLivePlayerPixelFormatRGBA32` and set [VeLivePlayerVideoBufferType](#VeLivePlayerVideoBufferType) to `VeLivePlayerVideoBufferTypeByteBuffer`.
      *
      */
     buffer: ByteBuffer;
-    
+    /** {zh}
+     * @brief ByteArray 格式的视频数据。如果将 [VeLivePlayerPixelFormat](#VeLivePlayerPixelFormat) 设置为“VeLivePlayerPixelFormatRGBA32”，并将 [VeLivePlayerVideoBufferType](#VeLivePlayerVideoBufferType) 设置为“VeLivePlayerVideoBufferTypeByteArray”，则 SDK 会返回这种视频数据类型。
+     *
+     */
     /** {en}
      * @brief The video data in ByteArray format. The SDK returns this video data type if you set [VeLivePlayerPixelFormat](#VeLivePlayerPixelFormat) to `VeLivePlayerPixelFormatRGBA32` and set [VeLivePlayerVideoBufferType](#VeLivePlayerVideoBufferType) to `VeLivePlayerVideoBufferTypeByteArray`.
      *
@@ -590,13 +885,19 @@ export declare class VeLivePlayerVideoFrame {
     data: ArrayBuffer;
 }
 export declare class VeLivePlayerVideoTexture {
-    
+    /** {zh}
+     * @brief 视频纹理 ID。
+     *
+     */
     /** {en}
      * @brief The video texture ID.
      *
      */
     texId: int;
-    
+    /** {zh}
+     * @brief OpenGL ES 图形上下文环境，用于自定义渲染。将 EGLContext 绑定到 GLSurfaceView 或 TextureView 上，您可以在被绑定的 View 上进行自定义的 OpenGL ES 渲染。
+     *
+     */
     /** {en}
      * @brief OpenGL ES context for custom rendering. After you bind EGLContext to GLSurfaceView or TextureView, you can perform custom OpenGL ES rendering on the bound View.
      *
@@ -604,13 +905,19 @@ export declare class VeLivePlayerVideoTexture {
     eglContext: EGLContext;
 }
 export declare enum VeLivePlayerStreamType {
-    
+    /** {zh}
+     * @brief 主路流。
+     *
+     */
     /** {en}
      * @brief The primary stream.
      *
      */
     VeLivePlayerStreamTypeMain = 0,
-    
+    /** {zh}
+     * @brief 备路流。
+     *
+     */
     /** {en}
      * @brief The backup stream.
      *
@@ -618,37 +925,55 @@ export declare enum VeLivePlayerStreamType {
     VeLivePlayerStreamTypeBackup = 1
 }
 export declare enum VeLivePlayerLogLevel {
-    
+    /** {zh}
+     * @brief 输出 VERBOSE、DEBUG、INFO、WARNING 和 ERROR 级别的日志。
+     *
+     */
     /** {en}
      * @brief Output logs at the VERBOSE, DEBUG, INFO, WARNING, and ERROR levels.
      *
      */
     VeLivePlayerLogLevelVerbose = 0,
-    
+    /** {zh}
+     * @brief 输出 DEBUG、INFO、WARNING 和 ERROR 级别的日志。
+     *
+     */
     /** {en}
      * @brief Output logs at the DEBUG, INFO, WARNING, and ERROR levels.
      *
      */
     VeLivePlayerLogLevelDebug = 1,
-    
+    /** {zh}
+     * @brief 输出 INFO、WARNING 和 ERROR 级别的日志。
+     *
+     */
     /** {en}
      * @brief Output logs at the INFO, WARNING, and ERROR levels.
      *
      */
     VeLivePlayerLogLevelInfo = 2,
-    
+    /** {zh}
+     * @brief 输出 WARNING 和 ERROR 级别的日志。
+     *
+     */
     /** {en}
      * @brief Output logs at the WARNING and ERROR levels.
      *
      */
     VeLivePlayerLogLevelWarn = 3,
-    
+    /** {zh}
+     * @brief 输出 ERROR 级别的日志。
+     *
+     */
     /** {en}
      * @brief Output logs at the ERROR level.
      *
      */
     VeLivePlayerLogLevelError = 4,
-    
+    /** {zh}
+     * @brief 关闭日志打印。
+     *
+     */
     /** {en}
      * @brief Disable log printing.
      *
@@ -656,19 +981,30 @@ export declare enum VeLivePlayerLogLevel {
     VeLivePlayerLogLevelNone = 5
 }
 export declare class VeLivePlayerAudioFrame {
-    
+    /** {zh}
+     * @brief 音频帧数据封装格式，详情请参见 [VeLivePlayerAudioBufferType](#VeLivePlayerAudioBufferType)。
+     *
+     */
     /** {en}
      * @brief The encapsulation format of the audio data. See [VeLivePlayerAudioBufferType](#VeLivePlayerAudioBufferType) for details.
      *
      */
     bufferType: VeLivePlayerAudioBufferType;
-    
+    /** {zh}
+     * @brief 音频采样率，单位为 Hz。
+     *
+     */
     /** {en}
      * @brief The audio sample rate, in Hz.
      *
      */
     sampleRate: int;
-    
+    /** {zh}
+     * @brief 声道数。<br>
+     *     - 1：单声道；
+     *     - 2：双声道。
+     *
+     */
     /** {en}
      * @brief The number of audio channels. <br>
      *      - 1: Mono;
@@ -676,31 +1012,46 @@ export declare class VeLivePlayerAudioFrame {
      *
      */
     channels: int;
-    
+    /** {zh}
+     * @brief 音频位深度。
+     *
+     */
     /** {en}
      * @brief The audio bit depth.
      *
      */
     bitDepth: int;
-    
+    /** {zh}
+     * @brief 音频渲染时间戳。单位为 ms。
+     *
+     */
     /** {en}
      * @brief The timestamp indicating the time when the audio is rendered, in milliseconds.
      *
      */
     pts: long;
-    
+    /** {zh}
+     * @brief PCM 音频数据。byte[]类型
+     *
+     */
     /** {en}
      * @brief The PCM audio data. byte[] type.
      *
      */
     bufferArray: ArrayBuffer;
-    
+    /** {zh}
+     * @brief PCM 音频数据。ByteBuffer[]类型
+     *
+     */
     /** {en}
      * @brief The PCM audio data. ByteBuffer[] type.
      *
      */
     buffer: Array<ByteBuffer>;
-    
+    /** {zh}
+     * @brief 音频采样点个数。
+     *
+     */
     /** {en}
      * @brief The number of audio samples.
      *
@@ -708,13 +1059,19 @@ export declare class VeLivePlayerAudioFrame {
     samples: int;
 }
 export declare enum VeLivePlayerAudioBufferType {
-    
+    /** {zh}
+     * @brief 未知格式。
+     *
+     */
     /** {en}
      * @brief Unknown format.
      *
      */
     VeLivePlayerAudioBufferTypeUnknown = 0,
-    
+    /** {zh}
+     * @brief ByteArray 格式。
+     *
+     */
     /** {en}
      * @brief ByteArray.
      *
@@ -722,25 +1079,37 @@ export declare enum VeLivePlayerAudioBufferType {
     VeLivePlayerAudioBufferTypeByteArray = 1
 }
 export declare enum VeLivePlayerRotation {
-    
+    /** {zh}
+     * @brief 关闭旋转。
+     *
+     */
     /** {en}
      * @brief No rotation.
      *
      */
     VeLivePlayerRotation0 = 0,
-    
+    /** {zh}
+     * @brief 顺时针旋转 90 度。
+     *
+     */
     /** {en}
      * @brief Rotate 90 degrees clockwise.
      *
      */
     VeLivePlayerRotation90 = 1,
-    
+    /** {zh}
+     * @brief 顺时针旋转 180 度。
+     *
+     */
     /** {en}
      * @brief Rotate 180 degrees clockwise.
      *
      */
     VeLivePlayerRotation180 = 2,
-    
+    /** {zh}
+     * @brief 顺时针旋转 270 度。
+     *
+     */
     /** {en}
      * @brief Rotate 270 degrees clockwise.
      *