@volcengine/react-native-live-pull 1.3.2-rc.0 → 1.4.0-rc.0

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

@@ -0,0 +1,31 @@
+export type String = string;
+export type Boolean = boolean;
+export type Void = void;
+export type int = number;
+export type float = number;
+export type double = number;
+export type long = number;
+export type Integer = number;
+export type Double = number;
+export type List<T = any> = Array<T>;
+export type list<T = any> = Array<T>;
+export type ArrayList<T = any> = Array<T>;
+export type Map<K extends keyof any = any, V = any> = Record<K, V>;
+export type HashMap<K extends keyof any = any, V = any> = Record<K, V>;
+export type Pair<K extends keyof any = any, V = any> = Record<K, V>;
+export type set<T = any> = Set<T>;
+export type map = Object;
+export type struct = Object;
+export type Bitmap = unknown;
+export type EGLContext = unknown;
+export type ByteArray = number;
+export type ByteBuffer = ArrayBuffer;
+export type Matrix = unknown;
+export type SurfaceHolder = unknown;
+export type Surface = unknown;
+export type Runnable = unknown;
+export type View = unknown;
+export type Intent = unknown;
+export type Context = unknown;
+export type Bundle = any;
+export type JSONObject = any;

package/lib/typescript/codegen/ios/api.d.ts

@@ -0,0 +1,293 @@
+import { VeLivePlayerLogLevel, VeLivePlayerType, VeLivePlayerConfiguration, VeLivePlayerFillMode, VeLivePlayerStreamData, VeLivePlayerResolution, VeLivePlayerRotation, VeLivePlayerMirror, VeLivePlayerPixelFormat, VeLivePlayerVideoBufferType } from './keytype';
+import { NSString, id, float, BOOL, NSDictionary, int } from './types';
+import { VeLivePlayerObserver } from './callback';
+import { UIView } from './external';
+export declare class TVLManager {
+    /** {zh}
+     * @detail api
+     * @brief 设置打印日志的级别。
+     * @order 5
+     * @param logLevel 日志级别，详情请参见 [VeLivePlayerLogLevel](188121#VeLivePlayerLogLevel) 。
+     */
+    
+    static setLogLevel(logLevel: VeLivePlayerLogLevel): void;
+    /** {zh}
+     * @detail api
+     * @brief 获取播放器 SDK 的版本号。
+     * @return
+     *     播放器 SDK 版本号。
+     * @order 4
+     */
+    
+    static getVersion(): NSString;
+    /** {zh}
+     * @detail keytype
+     * @brief 播放器的回调事件监听器。
+     */
+    
+    observer: id<VeLivePlayerObserver>;
+    /** {zh}
+     * @detail keytype
+     * @brief 获取播放器内部用于渲染视频画面的视图 view，调用本方法将 playerView 添加到应用的视图层级中，实现视频内容显示。
+     */
+    
+    playerView: UIView;
+    /** {zh}
+     * @detail keytype
+     * @brief 设置或获取播放器播放音量，默认值为 1.0。取值范围为 0.0～1.0。
+     */
+    
+    volume: float;
+    /** {zh}
+     * @detail keytype
+     * @brief 检查播放器是否正在播放。
+     * @return 是否正在播放。<br>
+     *      - YES：正在播放；
+     *      - NO：未播放。
+     */
+    
+    isPlaying: BOOL;
+    /** {zh}
+     * @detail api
+     * @brief 播放器初始化方法。
+     * @order 9
+     */
+    
+    init(): this;
+    /** {zh}
+     * @brief 初始化特定类型的播放器。
+     * @param type 播放器类型，详情请参见 [VeLivePlayerType](188121#VeLivePlayerType)。
+     */
+    
+    initWithType(type: VeLivePlayerType): this;
+    /** {zh}
+     * @detail api
+     * @brief 初始化播放器，用于设置是否开启 SEI 消息、是否开启硬件解码和是否开启本地 DNS 预解析等配置信息。
+     * @notes
+     *     需要在调用 play{@link #VeLivePlayer#play} 开始播放之前，调用本方法进行播放器的初始化。
+     * @param config 播放器配置信息，详情请参见 VeLivePlayerConfiguration{@link #VeLivePlayerConfiguration}。
+     * @order 1
+     */
+    
+    setConfig(config: VeLivePlayerConfiguration): void;
+    /** {zh}
+     * @detail api
+     * @brief 设置播放器回调，用于监听播放器 VeLivePlayer 的播放错误、播放状态、音视频首帧渲染状态和清晰度档位信息等回调事件。
+     * @notes
+     *     需要在调用 play{@link #VeLivePlayer#play} 开始播放之前，调用本方法设置回调。
+     * @param observer 播放器的事件回调对象。详情请参见 VeLivePlayerObserver{@link #VeLivePlayerObserver}。
+     * @order 2
+     */
+    
+    setObserver(observer: id<VeLivePlayerObserver>): void;
+    /** {zh}
+     * @detail api
+     * @brief 设置播放器画面的填充模式。
+     * @notes
+     *        - 如果用于起播设置，需要在调用 [play](#TVLManager(VeLivePlayer)-play) 开始播放之前，调用本方法设置视频的填充模式。
+     *        - 如果用于调节填充模式，可以在播放过程中调用本方法动态调节视频的填充模式。
+     * @order 3
+     * @param fillMode 设置 SurfaceView 的填充模式，默认值为 `VeLivePlayerFillModeAspectFill`，详情请参见 [VeLivePlayerFillMode](188121#VeLivePlayerFillMode)。
+     */
+    
+    setRenderFillMode(fillMode: VeLivePlayerFillMode): Promise<void>;
+    /** {zh}
+     * @detail api
+     * @brief 设置单个直播播放地址。
+     * @notes
+     *        需要在调用 [play](#TVLManager(VeLivePlayer)-play) 开始播放之前，调用本方法设置单个直播播放地址。
+     * @order 6
+     * @param url 直播播放地址
+     */
+    
+    setPlayUrl(url: NSString): void;
+    /** {zh}
+     * @detail api
+     * @brief 设置域名和服务器的 IP 地址映射关系。
+     * @param hostIpMap 域名和服务器 IP 地址的映射关系列表。其中 `Map` 的 Key 是域名，Value 是 `List` 类型，表示该域名对应的服务器 IP 地址列表
+     * @order 17
+     */
+    
+    setUrlHostIP(hostIpMap: NSDictionary): void;
+    /** {zh}
+     * @detail api
+     * @brief 设置播放器高级配置。高级配置包括离屏渲染设置、缓冲区最大时长、ABR 码率自适应算法类型等，如需了解详细信息，请联系[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
+     * @order 18
+     * @param key 高级配置的参数名。
+     * @param value 参数对应的参数值。
+     */
+    
+    setProperty(key: NSString, value: id): void;
+    /** {zh}
+     * @detail api
+     * @brief 多路流信息配置。例如，您需要使用 ABR、手动切档和主备流等依赖多路流的功能，可以调用本方法进行配置。
+     * @notes
+     *      需要在调用 play{@link #VeLivePlayer#play} 开始播放之前，调用本方法设置多路流信息。
+     * @order 7
+     * @param streamData 多路流信息配置。详情请参见 [VeLivePlayerStreamData](188121#VeLivePlayerStreamData) 。
+     */
+    
+    setPlayStreamData(streamData: VeLivePlayerStreamData): void;
+    /** {zh}
+     * @detail api
+     * @brief 开始/恢复播放。
+     * @notes
+     *        调用本方法，在播放器完成拉流准备和首帧渲染播放后，都会触发 [onPlayerStatusUpdate:status:](188119#VeLivePlayerObserver-onplayerstatusupdate-status) 播放器状态回调。
+     * @order 10
+     */
+    
+    play(): Promise<void>;
+    /** {zh}
+     * @detail api
+     * @brief 暂停播放。
+     * @notes 调用本方法暂停播放后，会触发 [onPlayerStatusUpdate:status:](188119#VeLivePlayerObserver-onplayerstatusupdate-status) 播放器状态回调。
+     * @order 11
+     */
+    
+    pause(): Promise<void>;
+    /** {zh}
+     * @detail api
+     * @brief 停止播放，不销毁播放器。
+     * @notes 调用本方法停止播放后，会触发 [onPlayerStatusUpdate:status:](188119#VeLivePlayerObserver-onplayerstatusupdate-status) 播放器状态回调。
+     * @order 12
+     */
+    
+    stop(): Promise<void>;
+    /** {zh}
+     * @detail api
+     * @brief 停止播放，并销毁播放器。
+     * @order 13
+     */
+    
+    destroy(): void;
+    /** {zh}
+     * @brief 检查播放器当前是否支持指定的分辨率档位。
+     * @param resolution 分辨率档位，详情请参见 [VeLivePlayerResolution](188121#VeLivePlayerResolution)。
+     * @return - 0：支持；
+     *         - 其他：不支持。其他返回值详情请参见 [VeLivePlayerSupportResolutionSwitchError](188121#VeLivePlayerSupportResolutionSwitchError)。
+     */
+    
+    isSupportResolutionSwitch(resolution: VeLivePlayerResolution): int;
+    /** {zh}
+     * @detail api
+     * @brief 切换播放的清晰度档位。
+     * @notes
+     *        - 需要在调用 [setPlayStreamData:](#TVLManager(VeLivePlayer)-setplaystreamdata) 设置多档位后，调用本方法切换播放器的清晰度档位。
+     *        - 调用本方法成功切换档位后，会触发清晰度档位变化 [onResolutionSwitch:resolution:error:reason:](188119#VeLivePlayerObserver-onresolutionswitch-resolution-error-reason) 回调。
+     * @order 14
+     * @param resolution 设置清晰度的目标档位，详情请参见 [VeLivePlayerResolution](188121#VeLivePlayerResolution) 。
+     * @return
+     *     - YES：成功；
+     *     - NO：失败。
+     */
+    
+    switchResolution(resolution: VeLivePlayerResolution): void;
+    /** {zh}
+     * @detail api
+     * @brief 设置是否静音播放。
+     * @param mute 是否开启静音播放，默认值为 NO。<br>
+     *             - YES：开启；
+     *             - NO：关闭。
+     * @order 15
+     */
+    
+    setMute(mute: BOOL): void;
+    /** {zh}
+     * @detail api
+     * @brief 获取是否处于静音状态。
+     * @return 是否处于静音状态。<br>
+     *     - YES：静音；
+     *     - NO：未静音。
+     * @order 16
+     */
+    
+    isMute(): BOOL;
+    /** {zh}
+     * @detail api
+     * @brief 设置视频顺时针旋转角度。
+     * @notes
+     *      - 支持在播放前和播放中动态修改视频旋转角度。
+     *      - 每次调用本方法，播放器都将基于图像的原始角度进行旋转。
+     *      - 当同时使用旋转和镜像功能，播放器会先进行镜像，再进行旋转。
+     * @order 23
+     * @param rotation 视频旋转角度，默认关闭旋转，详情请参见 [VeLivePlayerRotation](188121#VeLivePlayerRotation) 。
+     */
+    
+    setRenderRotation(rotation: VeLivePlayerRotation): Promise<void>;
+    /** {zh}
+     * @detail api
+     * @brief 设置视频镜像。
+     * @notes
+     *      - 支持在播放前和播放中动态修改视频镜像方式。
+     *      - 每次调用本方法，播放器都将基于原始图像进行镜像。
+     *      - 当同时使用旋转和镜像功能，播放器会先进行镜像，再进行旋转。
+     * @order 24
+     * @param mirror 视频镜像，默认关闭镜像，详情请参见 [VeLivePlayerMirror](188121#VeLivePlayerMirror) 。
+     */
+    
+    setRenderMirror(mirror: VeLivePlayerMirror): Promise<void>;
+    /** {zh}
+     * @detail api
+     * @brief 视频截图。
+     * @notes
+     *        - 本方法仅在视频状态为播放时生效。
+     *        - 调用本方法截图成功后，会触发 [onSnapshotComplete:image:](188119#VeLivePlayerObserver-onsnapshotcomplete-image) 回调，回调消息中包含截图的 UIImage 对象。
+     * @order 19
+     * @return
+     *     - 0：当前状态支持截图；
+     *     - VeLivePlayerErrorRefused{@link #VeLivePlayerErrorCode#VeLivePlayerErrorRefused}：当前状态不支持截图。
+     */
+    
+    snapshot(): int;
+    /** {zh}
+     * @detail api
+     * @brief 设置视频帧回调。
+     * @notes
+     *        - 您可以在使用外部渲染的场景下调用本方法，订阅视频帧的解码数据。
+     *        - 调用本方法后，会触发 onRenderVideoFrame:videoFrame:回调，回调消息中包含每个视频帧的详细数据。
+     *        - 如果您使用外部渲染，需要保证音视频同步。
+     * @order 20
+     * @param enable 是否开启视频帧回调，默认值为 NO。 <br>
+     *               - YES：开启；
+     *               - NO：关闭。
+     * @param pixelFormat 回调的视频帧像素格式，详情请参见 [VeLivePlayerPixelFormat](188121#VeLivePlayerPixelFormat) 。
+     * @param bufferType 回调的视频数据封装格式。详情请参见 [VeLivePlayerVideoBufferType](188121#VeLivePlayerVideoBufferType) 。
+     */
+    
+    enableVideoFrameObserver(enable: BOOL, pixelFormat: VeLivePlayerPixelFormat, bufferType: VeLivePlayerVideoBufferType): void;
+    /** {zh}
+     * @detail api
+     * @brief 设置音频帧回调。
+     * @notes
+     *        - 您可以在使用外部渲染的场景下调用本方法，订阅音频帧的解码数据。
+     *        - 调用本方法后，会触发 [onRenderAudioFrame:audioFrame:](188119#VeLivePlayerObserver-onrenderaudioframe-audioframe) 回调，回调消息中包含每个音频帧的详细数据。
+     *        - 如果您使用外部渲染，需要保证音视频同步。
+     * @order 21
+     * @param enable 是否开启音频帧回调，默认值为 NO。 <br>
+     *               - YES：开启；
+     *               - NO：关闭。
+     * @param enableRendering 是否开启播放器渲染。默认值为 NO。<br>
+     *                        - YES：开启；
+     *                        - NO：关闭。
+     */
+    
+    enableAudioFrameObserver(enable: BOOL, enableRendering: BOOL): void;
+    /** {zh}
+     * @detail api
+     * @brief 设置是否开启超分。
+     * @notes
+     *        - 在收到首帧回调后，调用该方法开启超分。
+     *        - 支持在播放中调用该接口，开启或关闭超分。
+     *        - 如果机型、分辨率和帧率不符合限制，将无法开启超分，并触发 [onStreamFailedOpenSuperResolution:error:](188119#VeLivePlayerObserver-onstreamfailedopensuperresolution-error) 回调。
+     * @order 22
+     * @param enable 是否开启，默认值为 NO。<br>
+     *                        - YES：开启；
+     *                        - NO：关闭。
+     */
+    
+    setEnableSuperResolution(enable: BOOL): void;
+    setVolume(volume: float): void;
+    setEnableIgnoreAudioInterruption(enable: BOOL): void;
+    setAllowsVideoRendering(enable: BOOL): void;
+    addExtraHttpRequestHeadersByUser(headers: NSDictionary): void;
+}

package/lib/typescript/codegen/ios/callback.d.ts

@@ -0,0 +1,176 @@
+import { TVLManager } from './api';
+import { VeLivePlayerError } from './errorcode';
+import { BOOL, int64_t, int, NSString, NSData, UIImage } from './types';
+import { VeLivePlayerResolution, VeLivePlayerResolutionSwitchReason, VeLivePlayerStreamType, VeLivePlayerStatus, VeLivePlayerStatistics, VeLivePlayerVideoFrame, VeLivePlayerAudioFrame } from './keytype';
+export declare class VeLivePlayerObserver {
+    /** {zh}
+     * @detail callback
+     * @brief 播放器错误信息回调，播放器出现错误时，触发此回调。
+     * @order 1
+     * @param player 触发该事件回调的播放器对象。
+     * @param error 错误信息，详情请参见 [VeLivePlayerError](188120#VeLivePlayerError) 。
+     */
+    
+    onError$error?(player: TVLManager, error: VeLivePlayerError): void;
+    /** {zh}
+     * @detail callback
+     * @brief 视频首帧渲染事件回调。视频首帧渲染成功，或播放过程中发生重试，重试后的第一个视频帧渲染成功，均会触发此回调。
+     * @order 2
+     * @param player 触发该事件回调的播放器对象。
+     * @param isFirstFrame 渲染成功的是否为视频首帧。<br>
+     *                     - YES：视频首帧；
+     *                     - NO：重试后第一个视频帧。
+     */
+    
+    onFirstVideoFrameRender$isFirstFrame?(player: TVLManager, isFirstFrame: BOOL): void;
+    /** {zh}
+     * @detail callback
+     * @brief 音频首帧渲染事件回调。音频首帧渲染成功，或播放过程中发生重试，重试后的第一个音频帧渲染成功，均会触发此回调。
+     * @param player 触发该事件回调的播放器对象。
+     * @param isFirstFrame 渲染成功的是否为音频首帧。<br>
+     *                     - YES：音频首帧；
+     *                     - NO：重试后第一个音频帧。
+     */
+    
+    onFirstAudioFrameRender$isFirstFrame?(player: TVLManager, isFirstFrame: BOOL): void;
+    /** {zh}
+     * @detail callback
+     * @brief 播放卡顿开始回调。
+     * @param player 触发该事件回调的播放器对象
+     * @order 3
+     *
+     */
+    
+    onStallStart?(player: TVLManager): void;
+    /** {zh}
+     * @detail callback
+     * @brief 播放卡顿结束回调。音频缓冲区达到起播条件且开始播放后，触发此回调。
+     * @order 4
+     * @param player 触发该事件回调的播放器对象。
+     */
+    
+    onStallEnd?(player: TVLManager): void;
+    /** {zh}
+     * @detail callback
+     * @brief 视频渲染卡顿回调。视频渲染发生卡顿时，触发此回调。
+     * @param player 触发该事件回调的播放器对象。
+     * @param stallTime 视频渲染卡顿时长，单位为 ms。
+     */
+    
+    onVideoRenderStall$stallTime?(player: TVLManager, stallTime: int64_t): void;
+    /** {zh}
+     * @detail callback
+     * @brief 音频渲染卡顿回调。音频渲染发生卡顿时，触发此回调。
+     * @param player 触发该事件回调的播放器对象。
+     * @param stallTime 音频渲染卡顿时长，单位为 ms。
+     */
+    
+    onAudioRenderStall$stallTime?(player: TVLManager, stallTime: int64_t): void;
+    /** {zh}
+     * @detail callback
+     * @brief 清晰度档位发生变化回调。
+     * @order 5
+     * @param player 触发该事件回调的播放器对象。
+     * @param resolution 切换后的清晰度档位，详情请参见 [VeLivePlayerResolution](188121#VeLivePlayerResolution) 。
+     * @param error 切换清晰度档位时，是否发生错误，详情请参见 [VeLivePlayerError](188120#VeLivePlayerError)。
+     * @param reason 清晰度档位切换的原因，详情请参见 [VeLivePlayerResolutionSwitchReason](188121#VeLivePlayerResolutionSwitchReason) 。
+     */
+    
+    onResolutionSwitch$resolution$error$reason?(player: TVLManager, resolution: VeLivePlayerResolution, error: VeLivePlayerError, reason: VeLivePlayerResolutionSwitchReason): void;
+    /** {zh}
+     * @detail callback
+     * @brief 视频分辨率变化回调。视频大小发生变化时，触发此回调。
+     * @order 6
+     * @param player 触发该事件回调的播放器对象。
+     * @param width 变化后的视频宽度，单位为 px。
+     * @param height 变化后的视频高度，单位为 px。
+     */
+    
+    onVideoSizeChanged$width$height?(player: TVLManager, width: int, height: int): void;
+    /** {zh}
+     * @detail api
+     * @brief 字符串 SEI 消息回调，当播放器 SDK 接收到 SEI 消息时，触发该回调。需要开启 VeLivePlayerConfiguration 中 enableSei 属性。当 enableBinarySei 属性开启时，字符串 SEI 消息将不再发送。
+     * @order 7
+     * @param player 触发该事件回调的播放器对象。
+     * @param message SEI 信息。
+     */
+    
+    onReceiveSeiMessage$message?(player: TVLManager, message: NSString): void;
+    /** {zh}
+     * @detail api
+     * @brief 二级制 SEI 消息回调，当播放器 SDK 接收到 SEI 消息时，触发该回调。需要开启 VeLivePlayerConfiguration 中 enableBinarySei 属性。当 enableBinarySei 属性开启时，字符串 SEI 消息将不再发送。
+     * @order 7
+     * @param player 触发该事件回调的播放器对象。
+     * @param message SEI 信息。
+     */
+    
+    onReceiveBinarySeiMessage$message?(player: TVLManager, message: NSData): void;
+    /** {zh}
+     * @detail callback
+     * @brief 主备流切换回调。
+     * @order 8
+     * @param player 触发该事件回调的播放器对象。
+     * @param streamType 切换后的流类型为主路流或备路流，详情请参见 [VeLivePlayerStreamType](188121#VeLivePlayerStreamType) 。
+     * @param error 触发主备流切换的原因，详情请参见 [VeLivePlayerError](188120#VeLivePlayerError) 。
+     */
+    
+    onMainBackupSwitch$streamType$error?(player: TVLManager, streamType: VeLivePlayerStreamType, error: VeLivePlayerError): void;
+    /** {zh}
+     * @detail callback
+     * @brief 播放状态发生变化时，触发此回调。
+     * @order 9
+     * @param player 触发该事件回调的播放器对象。
+     * @param status 当前播放器的状态，详情请参见 [VeLivePlayerStatus](188121#VeLivePlayerStatus) 。
+     */
+    
+    onPlayerStatusUpdate$status?(player: TVLManager, status: VeLivePlayerStatus): void;
+    /** {zh}
+     * @detail callback
+     * @brief 播放信息周期性回调。播放器 SDK 会周期性地回调本方法，您可以通过本方法获取当前播放器的播放地址、码率和帧率等信息。
+     * @order 10
+     * @param player 触发该事件回调的播放器对象。
+     * @param statistics 播放器周期性回调的统计信息，详情请参见 [VeLivePlayerStatistics](188121#VeLivePlayerStatistics) 。
+     */
+    
+    onStatistics$statistics?(player: TVLManager, statistics: VeLivePlayerStatistics): void;
+    /** {zh}
+     * @detail callback
+     * @brief 截图成功回调。当播放器调用 snapshot{@link #VeLivePlayer#snapshot} 截图成功后，触发此回调。
+     * @order 11
+     * @param player 触发该事件回调的播放器对象。
+     * @param image 截图的 UIImage 对象。
+     */
+    
+    onSnapshotComplete$image?(player: TVLManager, image: UIImage): void;
+    /** {zh}
+     * @detail callback
+     * @brief 视频帧回调。调用 [enableVideoFrameObserver:pixelFormat:bufferType:](188118#TVLManager(VeLivePlayer)-enablevideoframeobserver-pixelformat-buffertype) 开启视频帧解析回调后，当播放器成功解码视频帧时，会触发此回调。
+     * @notes <br>
+     *       如果自定义渲染使用纹理格式，建议在视频帧回调线程中执行渲染操作。
+     * @order 12
+     * @param player 触发该事件回调的播放器对象。
+     * @param videoFrame 视频帧数据，包含像素格式、封装格式、视频宽高等信息，详情请参见 [VeLivePlayerVideoFrame](188121#VeLivePlayerVideoFrame) 。
+     */
+    
+    onRenderVideoFrame$videoFrame?(player: TVLManager, videoFrame: VeLivePlayerVideoFrame): void;
+    /** {zh}
+     * @detail callback
+     * @brief 音频帧回调。调用 [enableAudioFrameObserver:enableRendering:](188118#TVLManager(VeLivePlayer)-enableaudioframeobserver-enablerendering)开启音频帧解析回调后，当播放器成功解码音频帧时，会触发此回调。
+     * @notes <br>
+     *      回调的音频帧数据为 float32 格式，大端字节序存储。
+     * @order 13
+     * @param player 触发该事件回调的播放器对象。
+     * @param audioFrame 音频帧数据，详情请参见 [VeLivePlayerAudioFrame](188121#VeLivePlayerAudioFrame)。
+     */
+    
+    onRenderAudioFrame$audioFrame?(player: TVLManager, audioFrame: VeLivePlayerAudioFrame): void;
+    /** {zh}
+     * @detail callback
+     * @brief 超分开启失败。调用 [setEnableSuperResolution:](188118#TVLManager(VeLivePlayer)-setenablesuperresolution)开启超分后，当播放器不支持超分开启或者超分处理出错时，会触发此回调。
+     * @order 14
+     * @param player 触发该事件回调的播放器对象。
+     * @param error 开启超分失败的原因，错误码请参见 [VeLivePlayerErrorCode](188120#VeLivePlayerErrorCode)。
+     */
+    
+    onStreamFailedOpenSuperResolution$error?(player: TVLManager, error: VeLivePlayerError): void;
+}

package/lib/typescript/codegen/ios/errorcode.d.ts

@@ -0,0 +1,160 @@
+import { NSInteger, NSString } from './types';
+export declare class VeLivePlayerError {
+    /** {zh}
+     * @brief 直播播放错误码。
+     */
+    
+    errorCode: NSInteger;
+    /** {zh}
+     * @brief 直播播放错误信息。
+     */
+    
+    errorMsg: NSString;
+    init(): this;
+}
+export declare enum VeLivePlayerErrorCode {
+    /** {zh}
+     * @brief 没有错误。
+     *
+     */
+    
+    VeLivePlayerNoError = 0,
+    /** {zh}
+     * @brief License 证书无效。可能证书集成错误或证书过期，请检查证书集成方式和有效性。
+     *
+     */
+    
+    VeLivePlayerInvalidLicense = -1,
+    /** {zh}
+     * @brief 调用时传入的参数不合法。请检查入参，并重新调用。
+     *
+     */
+    
+    VeLivePlayerInvalidParameter = -2,
+    /** {zh}
+     * @brief 调用被拒绝。方法调用时机不合法，请检查调用时机。
+     *
+     */
+    
+    VeLivePlayerErrorRefused = -3,
+    /** {zh}
+     * @brief 加载库文件失败。可能是 SDK 集成错误，请检查 SDK 集成方式。
+     *
+     */
+    
+    VeLivePlayerErrorLibraryLoadFailed = -4,
+    /** {zh}
+     * @brief 播放地址不存在或无效。可能是播放地址为空、地址格式不合法或地址长度不合法，请检查播放地址。
+     *
+     */
+    
+    VeLivePlayerErrorPlayUrl = -100,
+    /** {zh}
+     * @brief 无法获取流数据。可能是直播流不存在、直播流中断或直播已结束，请检查直播状态。
+     *
+     */
+    
+    VeLivePlayerErrorNoStreamData = -101,
+    /** {zh}
+     * @brief 内部播放重试。可能由于播放器内部错误触发了重试。
+     *
+     */
+    
+    VeLivePlayerErrorInternalRetryStart = -102,
+    /** {zh}
+     * @brief 内部重试失败。内部重试次数达到最大限制，播放器停止重试，您可以尝试重新播放。
+     *
+     */
+    
+    VeLivePlayerErrorInternalRetryFailed = -103,
+    /** {zh}
+     * @brief DNS 解析失败。可能是播放地址异常或客户端网络异常，请您检查播放地址和网络情况，如果故障未排除，请[创建工单](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)联系技术支持。
+     *
+     */
+    
+    VeLivePlayerErrorDnsParseFailed = -200,
+    /** {zh}
+     * @brief 网络请求失败。请检查网络情况，如果故障未排除，请[创建工单](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)联系技术支持。
+     *
+     */
+    
+    VeLivePlayerErrorNetworkRequestFailed = -201,
+    /** {zh}
+     * @brief 直播格式解封装失败。可能是使用了不支持的直播流格式和协议，或音视频流错误；请检查流格式，如果故障未排除，请联系火山引擎[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
+     *
+     */
+    
+    VeLivePlayerErrorDemuxFailed = -300,
+    /** {zh}
+     * @brief 视频解码失败。可能使用了不支持的直播流音视频格式，或解码器出错；请检查音视频格式，如果故障未排除，请联系火山引擎[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
+     *
+     */
+    
+    VeLivePlayerErrorDecodeFailed = -301,
+    /** {zh}
+     * @brief 渲染失败。可能是音视频输出设备异常，请重试；如果故障未排除，请联系火山引擎[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
+     *
+     */
+    
+    VeLivePlayerErrorAVOutputFailed = -302,
+    /** {zh}
+     * @brief 该台设备不在超分机型白名单内，不支持超分功能。如您需要帮助，请联系火山引擎[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
+     *
+     */
+    
+    VeLivePlayerErrorSRDeviceUnsupported = -303,
+    /** {zh}
+     * @brief 当前分辨率高于超分的最大分辨率限制。如您需要帮助，请联系火山引擎[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
+     *
+     */
+    
+    VeLivePlayerErrorSRResolutionUnsupported = -304,
+    /** {zh}
+     * @brief 当前帧率高于超分的最大帧率限制。如您需要帮助，请联系火山引擎[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
+     *
+     */
+    
+    VeLivePlayerErrorSRFpsUnsupported = -305,
+    /** {zh}
+     * @brief 超分初始化失败。请检查超分参数配置正确性和版本兼容性，如果故障未排除，请联系火山引擎[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
+     *
+     */
+    
+    VeLivePlayerErrorSRInitFail = -306,
+    /** {zh}
+     * @brief 超分执行失败。请检查超分参数配置正确性和版本兼容性，如果故障未排除，请联系火山引擎[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
+     *
+     */
+    
+    VeLivePlayerErrorSRExecuteFail = -307,
+    /** {zh}
+     * @brief 您使用的基础版 License 暂不支持 H.265 硬件解码，请登录火山引擎[视频直播控制台](https://console.volcengine.com/live/main/sdk)获取高级版 License。
+     *
+     */
+    
+    VeLivePlayerLicenseUnsupportedH265 = -308,
+    /** {zh}
+     * @brief 播放器不支持清晰度的切换。
+     *
+     */
+    
+    VeLivePlayerErrorNotSupportResolutionSwitch = -310,
+    /** {zh}
+     * @brief DRM 鉴权失败。
+     *
+     */
+    
+    VeLivePlayerDRMFetchCKCFailed = -400,
+    /** {zh}
+     * @brief 服务器播放上下文（SPC）生成失败。
+     *
+     */
+    
+    VeLivePlayerDRMFetchSPCFailed = -401,
+    /** {zh}
+     * @brief 内部错误。请联系火山引擎[技术支持](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000076)。
+     *
+     */
+    
+    VeLivePlayerErrorInternal = -999
+}

package/lib/typescript/codegen/ios/external.d.ts

@@ -0,0 +1 @@
+export { VeLivePlayerLogConfig, UIView } from '../../platforms/ios/extends';

package/lib/typescript/codegen/ios/index.d.ts

@@ -0,0 +1,6 @@
+export * from './api';
+export * from './callback';
+export * from './errorcode';
+export * from './keytype';
+export * from './external';
+export * from './types';