@byteplus/rtc 4.66.18 → 4.67.0

package/index.d.ts

@@ -40,6 +40,78 @@ declare class VERTC implements IVERTC {
 	}) => void;
 }
 declare const Config: SetParamInterface;
+declare const RTCExceptionCodeMap: {
+	
+	/** 
+	 * @brief Input video frame rate is too low
+	 */
+	FRAMERATE_INPUT_TOO_LOW: number;
+	
+	/** 
+	 * @brief Sent video frame rate is too low
+	 */
+	FRAMERATE_SENT_TOO_LOW: number;
+	
+	/** 
+	 * @brief Sent video bitrate is too low
+	 */
+	SEND_VIDEO_BITRATE_TOO_LOW: number;
+	
+	/** 
+	 * @brief Received video bitrate is too low
+	 */
+	RECV_VIDEO_DECODE_FAILED: number;
+	
+	/** 
+	 * @brief Input audio volume is too low
+	 */
+	AUDIO_INPUT_LEVEL_TOO_LOW: number;
+	
+	/** 
+	 * @brief Output audio volume is too low
+	 */
+	AUDIO_OUTPUT_LEVEL_TOO_LOW: number;
+	
+	/** 
+	 * @brief Send audio bitrate is too low
+	 */
+	SEND_AUDIO_BITRATE_TOO_LOW: number;
+	
+	/** 
+	 * @brief Input video frame rate is too low recovery
+	 */
+	FRAMERATE_INPUT_TOO_LOW_RECOVER: number;
+	
+	/** 
+	 * @brief Sent video frame rate is too low recovery
+	 */
+	FRAMERATE_SENT_TOO_LOW_RECOVER: number;
+	
+	/** 
+	 * @brief Send video bitrate is too low recovery
+	 */
+	SEND_VIDEO_BITRATE_TOO_LOW_RECOVER: number;
+	
+	/** 
+	 * @brief Received video bitrate is too low recovery
+	 */
+	RECV_VIDEO_DECODE_FAILED_RECOVER: number;
+	
+	/** 
+	 * @brief Input audio volume is too low recovery
+	 */
+	AUDIO_INPUT_LEVEL_TOO_LOW_RECOVER: number;
+	
+	/** 
+	 * @brief Output audio volume is too low recovery
+	 */
+	AUDIO_OUTPUT_LEVEL_TOO_LOW_RECOVER: number;
+	
+	/** 
+	 * @brief Send audio bitrate is too low recovery
+	 */
+	SEND_AUDIO_BITRATE_TOO_LOW_RECOVER: number;
+};
 declare const _default: VERTC;
 declare enum AudioMixingError {
 	
@@ -261,6 +333,21 @@ declare enum EngineEventsTypes {
 	 */
 	onLocalStreamStats = "onLocalStreamStats",
 	
+	/** 
+	 * @brief Callback including the state of the local media stream
+	 */
+	onLocalStatsException = "onLocalStatsException",
+	
+	/** 
+	 * @brief Callback including the state of the local media stream
+	 */
+	onRemoteStatsException = "onRemoteStatsException",
+	
+	/** 
+	 * @brief Callback including the state of the local media stream
+	 */
+	onPublicStatsException = "onPublicStatsException",
+	
 	/** 
 	 * @brief Indication of audio volume
 	 */
@@ -333,7 +420,8 @@ declare enum EngineEventsTypes {
 	onSubscribeRetry = "onSubscribeRetry",
 	onPublishResult = "onPublishResult",
 	onSubscribeResult = "onSubscribeResult",
-	onSEIStreamUpdate = "onSEIStreamUpdate"
+	onSEIStreamUpdate = "onSEIStreamUpdate",
+	onPlayerVisibility = "onPlayerVisibility"
 }
 declare enum ErrorCode {
 	
@@ -768,7 +856,7 @@ declare enum ErrorCode {
 	
 	/** 
 	 * @hidden
-	 * @brief Failed to connect to the thrid-party service. Please contact the technical support.
+	 * @brief Failed to connect to the third-party service. Please contact the technical support.
 	 */
 	SUBTITLE_ERR_CONNECTION_ERROR = "SUBTITLE_ERR_CONNECTION_ERROR",
 	
@@ -831,7 +919,15 @@ declare enum ErrorCode {
 	 * @brief Failed to subscribe to the WTN stream via [`startPlayWTN`](docs-104478#wtnstream-startplaywtn).
 	 */
 	WTN_PLAY_FAILED = "WTN_PLAY_FAILED",
+	
+	/** 
+	 * @brief The `RoomMode` is `ROOM_MODE_RTS_ONLY` (indicating that only RTS can be used in the room). Calling the room-external API is not allowed.
+	 */
 	NOT_ALLOWED_IN_RTS_ROOM = "NOT_ALLOWED_IN_RTS_ROOM",
+	
+	/** 
+	 * @brief Calling the room-external message class API is not allowed in the RTS restricted mode.
+	 */
 	NOT_ALLOWED_IN_RESTRICTED_MODE = "NOT_ALLOWED_IN_RESTRICTED_MODE"
 }
 declare enum ExtendMediaType {
@@ -1083,7 +1179,7 @@ export declare enum AudioSelectionPriority {
 	DEFAULT = 0,
 	
 	/** 
-	 * @brief Hight priority with which the stream can skip the audio selection and always be subscribable.
+	 * @brief High priority with which the stream can skip the audio selection and always be subscribable.
 	 */
 	HIGH = 1
 }
@@ -1390,7 +1486,7 @@ export declare enum PublicInterpolationMode {
 }
 
 /** 
- * @brief Whether to inlcude audio or video in the WTN stream.
+ * @brief Whether to include audio or video in the WTN stream.
  */
 export declare enum PublicStreamType {
 	
@@ -1484,14 +1580,12 @@ export declare enum RemoteUserPriority {
 export declare enum RoomMode {
 	
 	/** 
-	 * @brief Create both the RTC room and the RTS room.
-	 * Under this mode, [audio/video call](docs-69871) charges will still be applied even if a user enters the room and only utilizes RTS functionality, without using any audio or video functions. This is because billing starts as soon as a user enters the RTC room (at a minimum, pure audio charges will apply). For detailed billing rules, please refer to [Billing of Audio and Video Calls](docs-69871).
+	 * @brief Default setting. Both RTC and RTS features can be used in the room.
 	 */
 	ROOM_MODE_RTC = 0,
 	
 	/** 
-	 * @brief Create only the RTS room.
-	 * In this mode, the following interfaces cannot be called: `setUserVisibility`、`setAudioSelectionConfig`、`publishStream`、`unpublishStream`、`subscribeStream`、`unsubscribeStream`、`pauseAllSubscribedStream`、`resumeAllSubscribedStream`、`startForwardStreamToRooms`、`updateForwardStreamToRooms`、`stopForwardStreamToRooms`、`pauseForwardStreamToAllRooms`、`resumeForwardStreamToAllRooms`、`publishScreen`、`unpublishScreen`、`subscribeScreen`、`unsubscribeScreen`、`startLiveTranscoding`、`updateLiveTranscoding`、`stopLiveTranscoding`、`sendSEIMessage`、`startSubtitle`、`stopSubtitle`、`updateSubtitleConfig`.
+	 * @brief Only RTS features can be used in the room. In this mode, RTC-related interfaces cannot be called.
 	 */
 	ROOM_MODE_RTS_ONLY = 1
 }
@@ -1624,7 +1718,7 @@ export declare enum StreamRemoveReason {
 	STREAM_REMOVE_REASON_OTHER = 5,
 	
 	/** 
-	 * @brief token lose publish priviledge.
+	 * @brief token lose publish privilege.
 	 */
 	STREAM_REMOVE_REASON_TOKEN_PRIVILEGE_EXPIRED = 6
 }
@@ -1862,6 +1956,42 @@ export declare enum VideoSourceType {
 	VIDEO_SOURCE_TYPE_INTERNAL = 1
 }
 
+/** 
+ * @brief Player visibility status and reasons for invisibility.
+ */
+export declare enum VisibilityStatus {
+	
+	/** 
+	 * @brief Player is visible.
+	 */
+	PLAYER_VISIBLE = "visible",
+	
+	/** 
+	 * @brief Player is invisible due to unmounting from the DOM.
+	 */
+	PLAYER_INVISIBLE_BY_UNMOUNT = "unmount",
+	
+	/** 
+	 * @brief Player is invisible due to size issues (for example, if the size is too small).
+	 */
+	PLAYER_INVISIBLE_BY_SIZE = "size",
+	
+	/** 
+	 * @brief Player is invisible due to style issues. For example: `display: none`, `opacity: 0`.
+	 */
+	PLAYER_INVISIBLE_BY_STYLE = "style",
+	
+	/** 
+	 * @brief Player is invisible due to position issues (for example, if the position is outside the visible area).
+	 */
+	PLAYER_INVISIBLE_BY_POSITION = "position",
+	
+	/** 
+	 * @brief Player is invisible due to being covered.
+	 */
+	PLAYER_INVISIBLE_BY_COVERED = "covered"
+}
+
 /** 
  * @brief Events related to playing WTN streams.
  */
@@ -2196,7 +2326,9 @@ export declare enum WTNStreamEventsTypes {
 	onWTNRemoteVideoStats = "onWTNRemoteVideoStats",
 	onWTNRemoteAudioStats = "onWTNRemoteAudioStats",
 	onWTNFirstRemoteVideoFrameDecoded = "onWTNFirstRemoteVideoFrameDecoded",
-	onWTNSEIMessageReceived = "onWTNSEIMessageReceived"
+	onWTNSEIMessageReceived = "onWTNSEIMessageReceived",
+	onWTNRemoteStatsException = "onWTNRemoteStatsException",
+	onWTNLocalStatsException = "onWTNLocalStatsException"
 }
 
 /** 
@@ -2317,7 +2449,7 @@ export interface AudioPropertiesInfo {
 	
 	/** 
 	 * @brief linear volume. The value is in linear relation to the original volume. The higher the value, the higher the volume. The range is [0,255]. <br>
-	 *        - [0, 25]: Nearly silent <br>
+	 *        - [0, 25]: Silence <br>
 	 *        - [26, 75]: Low volume <br>
 	 *        - [76, 204]: Medium volume <br>
 	 *        - [205, 255]: High volume <br>
@@ -2326,7 +2458,7 @@ export interface AudioPropertiesInfo {
 	
 	/** 
 	 * @brief non-linear volume in dB. The value is in proportion to the log value of the original volume. You can use the value to recognize the Active Speaker in the room. The range is [-127, 0]. <br>
-	 *        - [-127, -60]: Nearly silent
+	 *        - [-127, -60]: Silence <br>
 	 *        - [-59, -40]: Low volume <br>
 	 *        - [-39, -20]: Medium volume <br>
 	 *        - [-19, 0]: High volume <br>
@@ -2461,19 +2593,17 @@ export interface CoreConfigType {
 }
 
 /** 
- * @brief Information of an audio or video media device (such as camera, microphone, speaker) and its connection state.
+ * @brief Information and state of a media device.
  */
 export interface DeviceInfo {
 	
 	/** 
-	 * @brief Device information, including device ID, type, etc. For details, see [MediaDeviceInfo](https://developer.mozilla.org/en-US/docs/Web/API/MediaDeviceInfo).
+	 * @brief Information of a media device. See [MediaDeviceInfo](https://developer.mozilla.org/en-US/docs/Web/API/MediaDeviceInfo).
 	 */
 	mediaDeviceInfo: MediaDeviceInfo;
 	
 	/** 
-	 * @brief Device state:
-	 *        - active: The device is connected.
-	 *        - inactive: The device is disconnected.
+	 * @brief Device state.
 	 */
 	deviceState: "active" | "inactive";
 }
@@ -2914,18 +3044,16 @@ export interface IEngineEvents {
 	[EngineEventsTypes.onRemoteAudioFirstFrame]: (event: onAudioFirstFrameDecodedEvent) => void;
 	
 	/** 
-	 * @brief Triggered when the connection state of a video device (i.e., camera) changes, such as when a device is disconnected/connected due to plugging or unplugging.<br/>
-	 * > You need to obtain device permissions first (which can be acquired through [enableDevices](104478#enabledevices)) to receive this callback.
-	 * @param event Information (such as device ID and type) and connection state of the device.
+	 * @brief Event of video device state changing.
+	 * @param event Information and state of a media device.
 	 * @group Device Management
 	 * @order 60
 	 */
 	[EngineEventsTypes.onVideoDeviceStateChanged]: (event: DeviceInfo) => void;
 	
 	/** 
-	 * @brief Triggered when the connection state of an audio media device (i.e., microphone, speaker) changes, such as when a device is disconnected/connected due to plugging or unplugging.<br/>
-	 * > You need to obtain device permissions first (which can be acquired through [enableDevices](104478#enabledevices)) to receive this callback.
-	 * @param event Information (such as device ID and type) and connection state of the device.
+	 * @brief Event of audio device state changing.
+	 * @param event Information and state of a media device.
 	 * @group Device Management
 	 * @order 50
 	 */
@@ -3059,6 +3187,18 @@ export interface IEngineEvents {
 	 */
 	[EngineEventsTypes.onPublicStreamStats]: (stats: PublicStreamStats) => void;
 	
+	/** 
+	 * @brief SDK detects an abnormal event, which is usually caused by external factors such as network or capture/playback devices. The abnormal event is not an error, but it usually causes a problem with the call quality. If the problem is resolved, you will also receive this callback.
+	 * @param exception
+	 */
+	[EngineEventsTypes.onLocalStatsException]: (exception: LocalStatsException) => void;
+	
+	/** 
+	 * @brief SDK detects an abnormal event, which is usually caused by external factors such as network or capture/playback devices. The abnormal event is not an error, but it usually causes a problem with the call quality. If the problem is resolved, you will also receive this callback.
+	 * @param exception
+	 */
+	[EngineEventsTypes.onRemoteStatsException]: (exception: RemoteStatsException) => void;
+	
 	/** 
 	 * @hidden
 	 * @deprecated since 4.42, use onLocalAudioPropertiesReport and onRemoteAudioPropertiesReport instead.
@@ -3196,7 +3336,7 @@ export interface IEngineEvents {
 		userId: string;
 		
 		/** 
-		 * @brief Wether it is a screen-sharing stream
+		 * @brief Whether it is a screen-sharing stream
 		 */
 		isScreen: boolean;
 		
@@ -3215,7 +3355,7 @@ export interface IEngineEvents {
 	[EngineEventsTypes.onAutoPublishResult]: (event: {
 		
 		/** 
-		 * @brief Wether it is a screen-sharing stream
+		 * @brief Whether it is a screen-sharing stream
 		 */
 		isScreen: boolean;
 		
@@ -3612,6 +3752,14 @@ export interface IEngineEvents {
 		isAutoSubscribe: boolean;
 		errorCode?: ErrorCode;
 	}) => void;
+	
+	/** 
+	 * @brief Event of player visibility change, triggered every 30 seconds to notify users of changes in the visibility status of the player.
+	 * @param e Array of player visibility information, including player ID, user ID, and visibility status.
+	 * @group Video Management
+	 * @order 80
+	 */
+	[EngineEventsTypes.onPlayerVisibility]: (e: PlayerVisibility[]) => void;
 }
 export interface IJoinRoomConfig {
 	useTcpAfterJoinTimeout: boolean;
@@ -3626,7 +3774,6 @@ export interface IPCKillSwitch {
 	sld_fmtp_sps_add: boolean;
 	sld_fmtp_bitrate_add: boolean;
 	sld_fmtp_opus_add: boolean;
-	sld_iceoption_renomination: boolean;
 }
 
 /** 
@@ -4038,12 +4185,12 @@ export interface IRTCEngine extends EnhancedEventEmitter<IEngineEvents> {
 	 * @param userId The user ID. The empty value indicates the local stream.
 	 * @return If the specified stream does not exist, the volume values are `0`.
 	 * + linear volume. The value is in linear relation to the original volume. The higher the value, the higher the volume. The range is [0,255]. <br>
-	 * &ensp; - \[0, 25]: Nearly silent
+	 * &ensp; - \[0, 25]: Silence
 	 * &ensp; - \[26, 75]: Low volume
 	 * &ensp; - \[76, 204]: Medium volume
 	 * &ensp; - \[205, 255]: High volume
 	 * + non-linear volume in dB. The value is in proportion to the log value of the original volume. You can use the value to recognize the Active Speaker in the room. The range is [-127, 0].
-	 * &ensp; - \[-127, -60]: Nearly silent
+	 * &ensp; - \[-127, -60]: Silence
 	 * &ensp; - \[-59, -40]: Low volume
 	 * &ensp; - \[-39, -20]: Medium volume
 	 * &ensp; - \[-19, 0]: High volume
@@ -4161,7 +4308,7 @@ export interface IRTCEngine extends EnhancedEventEmitter<IEngineEvents> {
 	 *         &ensp; - SEI messages are only supported with H.264 encoding and are available only in browsers with Chromium 86+, Firefox 117+, or Safari 15.4+.
 	 *         &ensp; - Android devices do not support sending SEI data in voice call scenarios.
 	 *         &ensp; - SEI messages cannot be used on iOS devices.
-	 *        + In voice call scenarios, you still need to publish and subscribe to video streams, instead of audio streams. The subsciber can enable automatic subscribing to video streams when entering the room, or call [subscribeStream](#subscribestream) with the media stream type `AUDIO_AND_VIDEO`.
+	 *        + In voice call scenarios, you still need to publish and subscribe to video streams, instead of audio streams. The subscriber can enable automatic subscribing to video streams when entering the room, or call [subscribeStream](#subscribestream) with the media stream type `AUDIO_AND_VIDEO`.
 	 *        + In voice call scenarios, if no SEI data is sent within 1 minute after calling this interface, the SDK will automatically cancel the publication of the black frame video stream.
 	 *        + After the message is sent successfully, the remote end will receive [onSEIMessageReceived](docs-104479#onseimessagereceived).
 	 *        + In voice call scenarios, the sending status of the black frame video stream will be notified to remote users through the [onSEIStreamUpdate](docs-104479#onseistreamupdate) event.
@@ -4402,7 +4549,7 @@ export interface IRTCEngine extends EnhancedEventEmitter<IEngineEvents> {
 	getWTNStreamManager: () => IWTNStream;
 	
 	/** 
-	 * @brief > Available since v4.66.<br>
+	 * @brief > Available since v4.66.
 	 * Get the call ID. Call this method after joining a room.
 	 * After creating a room, a `callId` is generated to identify the call for this room.
 	 * @return The call ID (`callId`) of the room.
@@ -4651,7 +4798,7 @@ export interface IRTCEngine extends EnhancedEventEmitter<IEngineEvents> {
 	/** 
 	 * @brief Set the placeholder image during local video capture pause
 	 * @param index
-	 * @param filePath Image path in Http protocal; or Blob object.
+	 * @param filePath Image path in HTTP protocol; or Blob object.
 	 *    The format of the image can be: JPG, PNG, or BMP.
 	 *    When the ratio of the image is not the same as the video encoder configuration, the image will be resized with fixed ratio until the width and the height are no more than that of the encoder configuration.
 	 * @notes + Only available to Chrome browser on Mac
@@ -4859,7 +5006,7 @@ export interface IRTCEngine extends EnhancedEventEmitter<IEngineEvents> {
 	 * @brief Turns on subtitles.
 	 *        After calling this method, you can choose between the recognition and translation modes based on your needs. In the recognition mode, the speech of the speaker in the room will be recognized and converted into captions. In the translation mode, the transcribed text will be translated.You will receive the [onSubtitleMessageReceived](docs-104479#onsubtitlemessagereceived) callback to informs you of related information about subtitles.
 	 *        After calling this method, you will receive the [onSubtitleStateChanged](docs-104479#onsubtitlestatechanged) to inform you of whether subtitles are on.
-	 * @param config Subtitle configrations.
+	 * @param config Subtitle configurations.
 	 * @return `SUBTITLE_ALREADY_ON`: Subtitle is already turned on.
 	 * @notes + You must call this method after joining the room.
 	 *        + You can set your source language to Chinese by calling `joinRoom`  and importing a json formatted string `"source_language": "zh"` through the parameter of extraInfo, to English by importing `"source_language": "en"` , and to Japanese by importing `"source_language": "ja"`. The language of your browser will be automatically set as the source language if you don't set it. If the language of your browser is not Chinese, English or Japanese, SDK will set Chinese as the source language.
@@ -4984,7 +5131,7 @@ export interface IRTCEngine extends EnhancedEventEmitter<IEngineEvents> {
 	 *         `UNEXPECTED_INVOKE_FORWARD_STREAM`: Unexpected operation. Triggered if the timing of API calls related to forwarding media streams across rooms is incorrect. Please refer to the documentation of each API to confirm the correct order of API calls.
 	 * @notes + Users in the former target rooms will receive [onUserUnpublishStream]({{callback}}#EngineEvents.onUserUnpublishStream)/[onUserUnpublishScreen]({{callback}}#EngineEvents.onUserUnpublishScreen) and [onUserLeave]({{callback}}#EngineEvents.onUserLeave).
 	 *        + Call [updateForwardStreamToRooms]({{api}}#RTCEngine.updateForwardStreamToRooms) to stop forwarding media stream to specific rooms.
-	 *        + Call [pauseForwardStreamToAllRooms]({{api}}#RTCEngine.pauseForwardStreamToAllRooms) and [resumeForwardStreamToAllRooms]({{api}}#RTCEngine.resumeForwardStreamToAllRooms) to pause and resume fowarding media stream to all rooms.
+	 *        + Call [pauseForwardStreamToAllRooms]({{api}}#RTCEngine.pauseForwardStreamToAllRooms) and [resumeForwardStreamToAllRooms]({{api}}#RTCEngine.resumeForwardStreamToAllRooms) to pause and resume forwarding media stream to all rooms.
 	 * @group Audio & Video Transport
 	 * @order 42
 	 */
@@ -5101,6 +5248,29 @@ export interface IRTCEngine extends EnhancedEventEmitter<IEngineEvents> {
 	 * @order 80
 	 */
 	setEarMonitorVolume: (streamIndex: StreamIndex, volume: number) => void;
+	
+	/** 
+	 * @brief > Available since V4.67 <br>
+	 * Get the visibility state of local video player and reasons for invisibility.
+	 * @param streamIndex Stream index
+	 * @param playerId Optional parameter, player ID.
+	 * @return Player visibility state.
+	 *         If the corresponding player does not exist, return `undefined`.
+	 * @group Video Management
+	 */
+	getLocalVideoPlayerVisibility: (streamIndex: StreamIndex, playerId?: string) => PlayerVisibility | undefined;
+	
+	/** 
+	 * @brief > Available since V4.67. <br>
+	 * Gets the visibility state of remote video player and reasons for invisibility.
+	 * @param userId User ID.
+	 * @param streamIndex Stream index.
+	 * @param playerId Optional parameter, player ID.
+	 * @return Player visibility state.
+	 *         If the corresponding player does not exist, return `undefined`.
+	 * @group Video Management
+	 */
+	getRemotePlayerVisibility: (userId: string, streamIndex: StreamIndex, playerId?: string) => PlayerVisibility | undefined;
 }
 
 /** 
@@ -5328,7 +5498,7 @@ export interface IWTNStream extends EnhancedEventEmitter<IWTNStreamEvents> {
 	 * @return You will also receive the [onWTNPushStateChanged](docs-104479#wtnstreamevents-onwtnpushstatechanged) callback.
 	 * @group WTN stream
 	 * @order 14
-	*/
+	 */
 	muteWTNLocalAudio: (streamId: string, mute: boolean) => Promise<void>;
 	
 	/** 
@@ -5341,24 +5511,24 @@ export interface IWTNStream extends EnhancedEventEmitter<IWTNStreamEvents> {
 	 * @return You will also receive the [onWTNPushStateChanged](docs-104479#wtnstreamevents-onwtnpushstatechanged) callback.
 	 * @group WTN stream
 	 * @order 13
-	*/
+	 */
 	muteWTNLocalVideo: (streamId: string, mute: boolean) => Promise<void>;
 	
 	/** 
-	* @valid since 4.65
-	* @brief Sends SEI via a WTN stream.
-	* @param streamId The WTN stream's ID. The local user has published the WTN stream via [startPushWTN](docs-104478#wtnstream-startpushwtn).
-	* @param sei SEI message.
-	* @param repeatCount The number of times the SEI message is sent. The value range is [0, max{29, %{video frame rate}-1}]. The recommended range is [2,4]. <br>
-	*                    After calling this interface, the SEI data will be added to the consecutive `repeat_count+1` video frames starting from the current video frame.
-	* @note
-	*        - The number of SEI messages sent per second should not exceed the current video frame rate.
-	*        - The video frame only carries SEI data received within the previous 2s.
-	*        - After the message is successfully sent, the remote will receive the [onWTNSEIMessageReceived](docs-104479#wtnstreamevents-onwtnseimessagereceived) callback.
-	*        - If the call fails, neither the local nor the remote will receive the callback.
-	* @group WTN stream
-	* @order 37
-	*/
+	 * @valid since 4.65
+	 * @brief Sends SEI via a WTN stream.
+	 * @param streamId The WTN stream's ID. The local user has published the WTN stream via [startPushWTN](docs-104478#wtnstream-startpushwtn).
+	 * @param sei SEI message.
+	 * @param repeatCount The number of times the SEI message is sent. The value range is [0, max{29, %{video frame rate}-1}]. The recommended range is [2,4]. <br>
+	 *                    After calling this interface, the SEI data will be added to the consecutive `repeat_count+1` video frames starting from the current video frame.
+	 * @note
+	 *        - The number of SEI messages sent per second should not exceed the current video frame rate.
+	 *        - The video frame only carries SEI data received within the previous 2s.
+	 *        - After the message is successfully sent, the remote will receive the [onWTNSEIMessageReceived](docs-104479#wtnstreamevents-onwtnseimessagereceived) callback.
+	 *        - If the call fails, neither the local nor the remote will receive the callback.
+	 * @group WTN stream
+	 * @order 37
+	 */
 	sendWTNSEIMessage: (streamId: string, sei: Uint8Array, repeatCount: number) => void;
 	
 	/** 
@@ -5444,6 +5614,16 @@ export interface IWTNStream extends EnhancedEventEmitter<IWTNStreamEvents> {
 	 * @order 26
 	 */
 	setWTNRemoteAudioPlaybackVolume: (streamId: string, volume: number) => void;
+	
+	/** 
+	 * @brief Available since v4.67.<br>
+	 * Gets the visibility status of the specified WTN stream's video player.
+	 * @param streamId The WTN stream's ID.
+	 * @return Returns the visibility status of the video player, or `undefined` if the player does not exist.
+	 * @group WTN stream
+	 * @order 27
+	 */
+	getWTNVideoPlayerVisibility: (streamId: string) => PlayerVisibility | undefined;
 }
 
 /** 
@@ -5527,6 +5707,22 @@ export interface IWTNStreamEvents {
 	 * @order 40
 	 */
 	[WTNStreamEventsTypes.onWTNSEIMessageReceived]: (event: onWTNSEIMessageReceivedEvent) => void;
+	
+	/** 
+	 * @brief Exception event callback of local WTN media stream.
+	 * @param event
+	 * @group WTN stream
+	 * @order 41
+	 */
+	[WTNStreamEventsTypes.onWTNLocalStatsException]: (event: onWTNLocalStatsExceptionEvent) => void;
+	
+	/** 
+	 * @brief Exception event callback of remote WTN media stream.
+	 * @param event
+	 * @group WTN stream
+	 * @order 42
+	 */
+	[WTNStreamEventsTypes.onWTNRemoteStatsException]: (event: onWTNRemoteStatsExceptionEvent) => void;
 }
 
 /** 
@@ -5738,11 +5934,6 @@ export interface LiveTranscodeVideoConfig {
 	 */
 	gop: number;
 	
-	/** 
-	 * @hidden
-	 * @brief Whether to push streams with low latency. The default value is `true`.
-	 */
-	
 	/** 
 	 * @brief The bitrate (Kbps) in range of [1, 10000]. The default value is self-adaptive.
 	 */
@@ -5824,6 +6015,27 @@ export interface LocalAudioStats {
 	sentSampleRate?: number;
 }
 
+/** 
+ * @brief Exception of local media stream information
+ */
+export interface LocalStatsException {
+	
+	/** 
+	 * @brief Exception of local media stream information
+	 */
+	exception: keyof typeof RTCExceptionCodeMap;
+	
+	/** 
+	 * @brief Exception code of local media stream
+	 */
+	code: typeof RTCExceptionCodeMap[keyof typeof RTCExceptionCodeMap];
+	
+	/** 
+	 * @brief Whether it is a screen-sharing stream: true-screen stream, false-main stream
+	 */
+	isScreen: boolean;
+}
+
 /** 
  * State of the local media stream
  */
@@ -6051,6 +6263,48 @@ export interface PlayerEvent {
 	playerId?: string;
 }
 
+/** 
+ * @brief Player visibility status and related information (e.g., user ID, media type, stream index, etc.).
+ */
+export interface PlayerVisibility {
+	
+	/** 
+	 * @brief Player descriptor information, which contains identification information like user ID, media type, stream index.
+	 */
+	descriptor: {
+		
+		/** 
+		 * @brief User ID that identifies the publisher of the stream.
+		 */
+		userId?: string;
+		
+		/** 
+		 * @brief Media type, currently only supports video type.
+		 */
+		mediaType: MediaType.VIDEO;
+		
+		/** 
+		 * @brief Stream index, used to distinguish between main stream and screen sharing stream.
+		 */
+		streamIndex?: StreamIndex;
+		
+		/** 
+		 * @brief Stream ID that uniquely identifies a media stream.
+		 */
+		streamId?: string;
+		
+		/** 
+		 * @brief Player ID that uniquely identifies a player instance.
+		 */
+		playerId?: string;
+	};
+	
+	/** 
+	 * @brief Array of player visibility statuses, which contains all current visibility statuses of the player.
+	 */
+	status: VisibilityStatus[];
+}
+
 /** 
  * @brief Event related to decoding or rendering the first video frame of the public stream.
  */
@@ -6160,10 +6414,6 @@ export interface PublicStreamSEIMessageEvent {
 	sei: Uint8Array;
 }
 
-/** 
- * @brief Subscription configuration of video streams
- */
-
 /** 
  * @brief Stream property.
  */
@@ -6198,7 +6448,7 @@ export interface RTCStream {
 
 /** 
  * @hidden
- * @brief Subtitle configrations.
+ * @brief Subtitle configurations.
  */
 export interface RTCSubtitleConfig {
 	
@@ -6332,6 +6582,32 @@ export interface RemoteAudioStats {
 	decDuration?: number;
 }
 
+/** 
+ * @brief Exception of remote media stream information
+ */
+export interface RemoteStatsException {
+	
+	/** 
+	 * @brief The ID of the remote user that occurred an exception
+	 */
+	userId: string;
+	
+	/** 
+	 * @brief Exception of remote media stream information
+	 */
+	exception: keyof typeof RTCExceptionCodeMap;
+	
+	/** 
+	 * @brief Exception code of remote media stream
+	 */
+	code: typeof RTCExceptionCodeMap[keyof typeof RTCExceptionCodeMap];
+	
+	/** 
+	 * @brief Whether it is a screen-sharing stream: true-screen stream, false-main stream
+	 */
+	isScreen: boolean;
+}
+
 /** 
  * @brief Information of the remote stream
  */
@@ -6622,7 +6898,7 @@ export interface RoomConfig {
 	remoteVideoConfig?: RemoteVideoConfig;
 	
 	/** 
-	 * @brief Room creation mode. Supports creating both RTC and RTS rooms (default) or only RTS rooms.
+	 * @brief Room creation mode. You can create a room that supports both RTC and RTS functions, or a room that only supports RTS functions.
 	 */
 	roomMode?: RoomMode;
 }
@@ -7042,6 +7318,7 @@ export interface VideoEncoderConfig {
 	contentHint?: "text" | "motion" | "detail";
 	
 	/** 
+	 * @hidden for internal use only
 	 * @brief The preferred codec for the video stream. The default value is `'auto'`, no preference. By default, the SDK will automatically match the best codec based on the current video resolution and device performance.
 	 */
 	preferCodecName?: VideoCodecType;
@@ -7348,6 +7625,27 @@ export interface onWTNFirstRemoteVideoFrameDecodedEvent {
 	streamId: string;
 }
 
+/** 
+ * @brief Exception event callback of local WTN media stream.
+ */
+export interface onWTNLocalStatsExceptionEvent {
+	
+	/** 
+	 * @brief Exception of local WTN media stream information.
+	 */
+	exception: keyof typeof RTCExceptionCodeMap;
+	
+	/** 
+	 * @brief Exception code of local WTN media stream.
+	 */
+	code: typeof RTCExceptionCodeMap[keyof typeof RTCExceptionCodeMap];
+	
+	/** 
+	 * @brief ID of the local WTN media stream.
+	 */
+	streamId: string;
+}
+
 /** 
  * @brief The state of the WTN stream playing.
  */
@@ -7447,6 +7745,27 @@ export interface onWTNRemoteAudioStatsEvent {
 	audioStats: RemoteAudioStats;
 }
 
+/** 
+ * @brief Exception event callback of remote WTN media stream.
+ */
+export interface onWTNRemoteStatsExceptionEvent {
+	
+	/** 
+	 * @brief Exception of remote WTN media stream information.
+	 */
+	exception: keyof typeof RTCExceptionCodeMap;
+	
+	/** 
+	 * @brief Exception code of remote WTN media stream.
+	 */
+	code: typeof RTCExceptionCodeMap[keyof typeof RTCExceptionCodeMap];
+	
+	/** 
+	 * @brief ID of the remote WTN media stream.
+	 */
+	streamId: string;
+}
+
 /** 
  * @brief The state of the WTN stream video changed.
  */