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

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

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

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

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