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

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

@@ -3,7 +3,12 @@ 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) 。
+     */
     /** {en}
      * @detail api
      * @brief Sets the level of the output log.
@@ -11,7 +16,13 @@ export declare class TVLManager {
      * @order 5
      */
     static setLogLevel(logLevel: VeLivePlayerLogLevel): void;
-    
+    /** {zh}
+     * @detail api
+     * @brief 获取播放器 SDK 的版本号。
+     * @return
+     *     播放器 SDK 版本号。
+     * @order 4
+     */
     /** {en}
      * @detail api
      * @brief Gets the version number of the Player SDK.
@@ -20,25 +31,40 @@ export declare class TVLManager {
      * @order 4
      */
     static getVersion(): NSString;
-    
+    /** {zh}
+     * @detail keytype
+     * @brief 播放器的回调事件监听器。
+     */
     /** {en}
      * @detail keytype
      * @brief The player observer.
      */
     observer: id<VeLivePlayerObserver>;
-    
+    /** {zh}
+     * @detail keytype
+     * @brief 获取播放器内部用于渲染视频画面的视图 view，调用本方法将 playerView 添加到应用的视图层级中，实现视频内容显示。
+     */
     /** {en}
      * @detail keytype
      * @brief The view used by the player to render video. Add `playerView` to the view hierarchy of your app to display the video content.
      */
     playerView: UIView;
-    
+    /** {zh}
+     * @detail keytype
+     * @brief 设置或获取播放器播放音量，默认值为 1.0。取值范围为 0.0～1.0。
+     */
     /** {en}
      * @detail keytype
      * @brief The player volume. The default value is `1.0`. The value range is [0.0, 1.0].
      */
     volume: float;
-    
+    /** {zh}
+     * @detail keytype
+     * @brief 检查播放器是否正在播放。
+     * @return 是否正在播放。<br>
+     *      - YES：正在播放；
+     *      - NO：未播放。
+     */
     /** {en}
      * @detail keytype
      * @brief Checks whether the player is playing.
@@ -47,20 +73,34 @@ export declare class TVLManager {
      *       - NO: The player is not playing.
      */
     isPlaying: BOOL;
-    
+    /** {zh}
+     * @detail api
+     * @brief 播放器初始化方法。
+     * @order 9
+     */
     /** {en}
      * @detail api
      * @brief Initializes the player.
      * @order 9
      */
     init(): this;
-    
+    /** {zh}
+     * @brief 初始化特定类型的播放器。
+     * @param type 播放器类型，详情请参见 [VeLivePlayerType](188121#VeLivePlayerType)。
+     */
     /** {en}
      * @brief Initializes the specified type of player.
      * @param type The player type. Refer to [VeLivePlayerType](docs-player-sdk-for-ios-type-definition#VeLivePlayerType) for details.
      */
     initWithType(type: VeLivePlayerType): this;
-    
+    /** {zh}
+     * @detail api
+     * @brief 初始化播放器，用于设置是否开启 SEI 消息、是否开启硬件解码和是否开启本地 DNS 预解析等配置信息。
+     * @notes
+     *     需要在调用 play{@link #VeLivePlayer#play} 开始播放之前，调用本方法进行播放器的初始化。
+     * @param config 播放器配置信息，详情请参见 VeLivePlayerConfiguration{@link #VeLivePlayerConfiguration}。
+     * @order 1
+     */
     /** {en}
      * @detail api
      * @brief Configures player settings, including whether to turn on SEI messaging, hardware decoding, and local DNS prefetch.
@@ -70,7 +110,14 @@ export declare class TVLManager {
      * @order 1
      */
     setConfig(config: VeLivePlayerConfiguration): void;
-    
+    /** {zh}
+     * @detail api
+     * @brief 设置播放器回调，用于监听播放器 VeLivePlayer 的播放错误、播放状态、音视频首帧渲染状态和清晰度档位信息等回调事件。
+     * @notes
+     *     需要在调用 play{@link #VeLivePlayer#play} 开始播放之前，调用本方法设置回调。
+     * @param observer 播放器的事件回调对象。详情请参见 VeLivePlayerObserver{@link #VeLivePlayerObserver}。
+     * @order 2
+     */
     /** {en}
      * @detail api
      * @brief Sets the player observer to listen to the VeLivePlayer's events, such as playback errors or status updates, rendering of the first audio and video frame, and resolution switching.
@@ -80,7 +127,15 @@ export declare class TVLManager {
      * @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)。
+     */
     /** {en}
      * @detail api
      * @brief Sets the fill mode of the player screen.
@@ -91,7 +146,14 @@ export declare class TVLManager {
      * @param fillMode The fill mode of SurfaceView. The default value is `VeLivePlayerFillModeAspectFill`. See VeLivePlayerFillMode{@link #VeLivePlayerFillMode} for details.
      */
     setRenderFillMode(fillMode: VeLivePlayerFillMode): Promise<void>;
-    
+    /** {zh}
+     * @detail api
+     * @brief 设置单个直播播放地址。
+     * @notes
+     *        需要在调用 [play](#TVLManager(VeLivePlayer)-play) 开始播放之前，调用本方法设置单个直播播放地址。
+     * @order 6
+     * @param url 直播播放地址
+     */
     /** {en}
      * @detail api
      * @brief Sets a pull stream address.
@@ -101,7 +163,12 @@ export declare class TVLManager {
      * @param url The pull stream address.
      */
     setPlayUrl(url: NSString): void;
-    
+    /** {zh}
+     * @detail api
+     * @brief 设置域名和服务器的 IP 地址映射关系。
+     * @param hostIpMap 域名和服务器 IP 地址的映射关系列表。其中 `Map` 的 Key 是域名，Value 是 `List` 类型，表示该域名对应的服务器 IP 地址列表
+     * @order 17
+     */
     /** {en}
      * @detail api
      * @brief Sets the mapping of domain names to server IP addresses.
@@ -109,7 +176,13 @@ export declare class TVLManager {
      * @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 参数对应的参数值。
+     */
     /** {en}
      * @detail api
      * @brief Configures advanced settings for the player, including offscreen rendering, maximum buffer duration, and adaptive bitrate (ABR) algorithms. [Create a ticket](https://console.byteplus.com/workorder/create?step=2&SubProductID=P00000980) to contact BytePlus technical support if you need further information.
@@ -118,7 +191,14 @@ export declare class TVLManager {
      * @order 18
      */
     setProperty(key: NSString, value: id): void;
-    
+    /** {zh}
+     * @detail api
+     * @brief 多路流信息配置。例如，您需要使用 ABR、手动切档和主备流等依赖多路流的功能，可以调用本方法进行配置。
+     * @notes
+     *      需要在调用 play{@link #VeLivePlayer#play} 开始播放之前，调用本方法设置多路流信息。
+     * @order 7
+     * @param streamData 多路流信息配置。详情请参见 [VeLivePlayerStreamData](188121#VeLivePlayerStreamData) 。
+     */
     /** {en}
      * @detail api
      * @brief Sets multiple live streams. Call this method if you need to enable features requiring multiple live streams, such as adaptive bitrate (ABR), manual resolution switching, and primary and backup streams.
@@ -128,7 +208,13 @@ export declare class TVLManager {
      * @order 7
      */
     setPlayStreamData(streamData: VeLivePlayerStreamData): void;
-    
+    /** {zh}
+     * @detail api
+     * @brief 开始/恢复播放。
+     * @notes
+     *        调用本方法，在播放器完成拉流准备和首帧渲染播放后，都会触发 [onPlayerStatusUpdate:status:](188119#VeLivePlayerObserver-onplayerstatusupdate-status) 播放器状态回调。
+     * @order 10
+     */
     /** {en}
      * @detail api
      * @brief Starts or resumes playback.
@@ -137,7 +223,12 @@ export declare class TVLManager {
      * @order 10
      */
     play(): Promise<void>;
-    
+    /** {zh}
+     * @detail api
+     * @brief 暂停播放。
+     * @notes 调用本方法暂停播放后，会触发 [onPlayerStatusUpdate:status:](188119#VeLivePlayerObserver-onplayerstatusupdate-status) 播放器状态回调。
+     * @order 11
+     */
     /** {en}
      * @detail api
      * @brief Pauses playback.
@@ -146,7 +237,12 @@ export declare class TVLManager {
      * @order 11
      */
     pause(): Promise<void>;
-    
+    /** {zh}
+     * @detail api
+     * @brief 停止播放，不销毁播放器。
+     * @notes 调用本方法停止播放后，会触发 [onPlayerStatusUpdate:status:](188119#VeLivePlayerObserver-onplayerstatusupdate-status) 播放器状态回调。
+     * @order 12
+     */
     /** {en}
      * @detail api
      * @brief Stops playback. This method does not destroy the player.
@@ -155,14 +251,23 @@ export declare class TVLManager {
      * @order 12
      */
     stop(): Promise<void>;
-    
+    /** {zh}
+     * @detail api
+     * @brief 停止播放，并销毁播放器。
+     * @order 13
+     */
     /** {en}
      * @detail api
      * @brief Stops playback and destroys the player.
      * @order 13
      */
     destroy(): void;
-    
+    /** {zh}
+     * @brief 检查播放器当前是否支持指定的分辨率档位。
+     * @param resolution 分辨率档位，详情请参见 [VeLivePlayerResolution](188121#VeLivePlayerResolution)。
+     * @return - 0：支持；
+     *         - 其他：不支持。其他返回值详情请参见 [VeLivePlayerSupportResolutionSwitchError](188121#VeLivePlayerSupportResolutionSwitchError)。
+     */
     /** {en}
      * @brief Check whether the player currently supports the specified resolution level.
      * @param resolution Resolution levels. For details, please refer to [VeLivePlayerResolution](docs-player-sdk-for-ios-type-definition#VeLivePlayerResolution).
@@ -170,7 +275,18 @@ export declare class TVLManager {
      *         - Others: Not supported. For details of other return values, please refer to [VeLivePlayerSupportResolutionSwitchError](docs-player-sdk-for-ios-type-definition#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：失败。
+     */
     /** {en}
      * @detail api
      * @brief Changes the video resolution.
@@ -184,7 +300,14 @@ export declare class TVLManager {
      *     - NO: Failure.
      */
     switchResolution(resolution: VeLivePlayerResolution): void;
-    
+    /** {zh}
+     * @detail api
+     * @brief 设置是否静音播放。
+     * @param mute 是否开启静音播放，默认值为 NO。<br>
+     *             - YES：开启；
+     *             - NO：关闭。
+     * @order 15
+     */
     /** {en}
      * @detail api
      * @brief Sets whether to mute playback.
@@ -194,7 +317,14 @@ export declare class TVLManager {
      * @order 15
      */
     setMute(mute: BOOL): void;
-    
+    /** {zh}
+     * @detail api
+     * @brief 获取是否处于静音状态。
+     * @return 是否处于静音状态。<br>
+     *     - YES：静音；
+     *     - NO：未静音。
+     * @order 16
+     */
     /** {en}
      * @detail api
      * @brief Checks whether playback is muted.
@@ -204,7 +334,16 @@ export declare class TVLManager {
      * @order 16
      */
     isMute(): BOOL;
-    
+    /** {zh}
+     * @detail api
+     * @brief 设置视频顺时针旋转角度。
+     * @notes
+     *      - 支持在播放前和播放中动态修改视频旋转角度。
+     *      - 每次调用本方法，播放器都将基于图像的原始角度进行旋转。
+     *      - 当同时使用旋转和镜像功能，播放器会先进行镜像，再进行旋转。
+     * @order 23
+     * @param rotation 视频旋转角度，默认关闭旋转，详情请参见 [VeLivePlayerRotation](188121#VeLivePlayerRotation) 。
+     */
     /** {en}
      * @detail api
      * @brief Sets the clockwise rotation angle of the video.
@@ -216,7 +355,16 @@ export declare class TVLManager {
      * @order 23
      */
     setRenderRotation(rotation: VeLivePlayerRotation): Promise<void>;
-    
+    /** {zh}
+     * @detail api
+     * @brief 设置视频镜像。
+     * @notes
+     *      - 支持在播放前和播放中动态修改视频镜像方式。
+     *      - 每次调用本方法，播放器都将基于原始图像进行镜像。
+     *      - 当同时使用旋转和镜像功能，播放器会先进行镜像，再进行旋转。
+     * @order 24
+     * @param mirror 视频镜像，默认关闭镜像，详情请参见 [VeLivePlayerMirror](188121#VeLivePlayerMirror) 。
+     */
     /** {en}
      * @detail api
      * @brief Configures mirroring settings.
@@ -228,7 +376,17 @@ export declare class TVLManager {
      * @order 24
      */
     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}：当前状态不支持截图。
+     */
     /** {en}
      * @detail api
      * @brief Takes a screenshot of the video.
@@ -241,7 +399,20 @@ export declare class TVLManager {
      *      - VeLivePlayerErrorRefused{@link #VeLivePlayerErrorCode#VeLivePlayerErrorRefused}: Screenshot capturing is not allowed.
      */
     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) 。
+     */
     /** {en}
      * @detail api
      * @brief Sets the video frame observer.
@@ -257,7 +428,21 @@ export declare class TVLManager {
      * @param bufferType The encapsulation format of the video data in the callback. See VeLivePlayerVideoBufferType{@link #VeLivePlayerVideoBufferType} for details.
      */
     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：关闭。
+     */
     /** {en}
      * @detail api
      * @brief Sets the audio frame observer.
@@ -274,7 +459,18 @@ export declare class TVLManager {
      *                         - NO: Disable.
      */
     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：关闭。
+     */
     /** {en}
      * @detail api
      * @brief Enables or disables super resolution.