@byteplus/rtc 4.41.2 → 4.42.0

package/index.d.ts

@@ -15,16 +15,28 @@ declare enum ErrorCode {
 	INVALID_PARAMS = "INVALID_PARAMS",
 	
 	/** 
-	 * @brief Token is invalid or has expired.
+	 * @brief Invalid Token
 	 */
 	INVALID_TOKEN = "INVALID_TOKEN",
+	
+	/** 
+	 * @brief Token expired.
+	 */
 	EXPIRED_TOKEN = "EXPIRED_TOKEN",
 	
 	/** 
 	 * @brief Failure of joining room
 	 */
 	JOIN_ROOM_FAILED = "JOIN_ROOM_FAILED",
+	
+	/** 
+	 * @brief Fail to update Token failed because the Token is invalid.
+	 */
 	UPDATE_TOKEN_WITH_INVALID_TOKEN = "UPDATE_TOKEN_WITH_INVALID_TOKEN",
+	
+	/** 
+	 * @brief Fail to update Token failed because the user has not joined any room.
+	 */
 	UPDATE_TOKEN_BEFORE_JOIN = "UPDATE_TOKEN_BEFORE_JOIN",
 	
 	/** 
@@ -247,6 +259,16 @@ declare enum ErrorCode {
 	 */
 	UNEXPECTED_ERROR = "UNEXPECTED_ERROR",
 	
+	/** 
+	 * @brief You have started another device test while the current one is still ongoing.
+	 */
+	REPEAT_DEVICE_TEST = "REPEAT_DEVICE_TEST",
+	
+	/** 
+	 * @brief The audio device test failed.
+	 */
+	AUDIO_DEVICE_TEST_FAILED = "AUDIO_DEVICE_RECORD_FAILED",
+	
 	/** 
 	 * @brief The user has already logged in.
 	 */
@@ -1376,6 +1398,8 @@ declare enum EngineEventsTypes {
 	 * @brief Indication of audio volume
 	 */
 	onAudioVolumeIndication = "onAudioVolumeIndication",
+	onLocalAudioPropertiesReport = "onLocalAudioPropertiesReport",
+	onRemoteAudioPropertiesReport = "onRemoteAudioPropertiesReport",
 	
 	/** 
 	 * @brief Callback of the state changing of audio playback devices
@@ -1408,6 +1432,7 @@ declare enum EngineEventsTypes {
 	 * @brief The state of pushing streams to CDN
 	 */
 	onLiveTranscodingResult = "onLiveTranscodingResult",
+	onAudioPlaybackDeviceTestVolume = "onAudioPlaybackDeviceTestVolume",
 	onSEIMessageReceived = "onSEIMessageReceived",
 	onError = "onError",
 	onAudioMixingStateChanged = "onAudioMixingStateChanged",
@@ -1547,6 +1572,84 @@ export interface AudioMixingStateChangedEvent {
 	error: AudioMixingError;
 }
 
+/** 
+ * @brief Information about local audio   <br>
+ */
+export interface LocalAudioPropertiesInfo {
+	
+	/** 
+	 * @brief Indicates whether the audio is captured by microphone or from screen sharing.  <br>
+	 */
+	streamIndex: StreamIndex;
+	
+	/** 
+	 * @type keytype
+	 * @brief Audio information  <br>
+	 */
+	audioPropertiesInfo: AudioPropertiesInfo;
+}
+
+/** 
+ * @brief Information about remote audio   <br>
+ */
+export interface RemoteAudioPropertiesInfo {
+	
+	/** 
+	 * @brief Information about remote stream  <br>
+	 */
+	streamKey: StreamKey;
+	
+	/** 
+	 * @brief Information about remote audio properties  <br>
+	 */
+	audioPropertiesInfo: AudioPropertiesInfo;
+}
+
+/** 
+ * @brief Audio information   <br>
+ */
+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]: Silence <br>
+	 *        - [26, 75]: Low volume <br>
+	 *        - [76, 204]: Medium volume <br>
+	 *        - [205, 255]: High volume <br>
+	 */
+	linearVolume: number;
+	
+	/** 
+	 * @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]: Silence <br>
+	 *        - [-59, -40]: Low volume <br>
+	 *        - [-39, -20]: Medium volume <br>
+	 *        - [-19, 0]: High volume <br>
+	 */
+	nonlinearVolume: number;
+}
+
+/** 
+ * @brief Information about the remote stream
+ */
+export interface StreamKey {
+	
+	/** 
+	 * @brief ID of the room from which the stream is published.
+	 */
+	roomId: string;
+	
+	/** 
+	 * @brief ID of the user who publishes the stream.
+	 */
+	userId: string;
+	
+	/** 
+	 * @brief Indicates whether the audio is captured by microphone or from screen sharing.  <br>
+	 */
+	streamIndex: StreamIndex;
+}
+
 /** 
  * @list 104477
  * @detail 104479
@@ -1714,6 +1817,8 @@ export interface IEngineEvents {
 	[EngineEventsTypes.onPublicStreamStats]: (stats: PublicStreamStats) => void;
 	
 	/** 
+	 * @hidden
+	 * @deprecated since 4.42, use onLocalAudioPropertiesReport and onRemoteAudioPropertiesReport instead.
 	 * @brief Volume of each of the users in the room
 	 * If the user has not joined a room, the list will only include volume of `local_user`.
 	 * @param event Active user in the room and his/her volume.
@@ -1723,6 +1828,22 @@ export interface IEngineEvents {
 		speakers: AudioVolumeInfo[];
 	}) => void;
 	
+	/** 
+	 * @brief After calling [enableAudioPropertiesReport](104478#enableAudioPropertiesReport), you will periodically receive this callback for the information about local audio. <br>
+	 *        Local audio includes the microphone audio and the screen audio captured using RTC SDK internal mechanisms.  <br>
+	 * @param event Information about local audio.  <br>
+	 * @region Audio Managment  <br>
+	 */
+	[EngineEventsTypes.onLocalAudioPropertiesReport]: (event: LocalAudioPropertiesInfo[]) => void;
+	
+	/** 
+	 * @brief After calling [enableAudioPropertiesReport](104478#enableAudioPropertiesReport), you will periodically receive this callback for the information about the subscribed remote audio streams. <br>
+	 *        The remote audio streams includes the microphone audio and screen audio collected using the RTC SDK internal mechanism/custom mechanism.  <br>
+	 * @param event Information about remote audio.  <br>
+	 * @region Audio Management
+	 */
+	[EngineEventsTypes.onRemoteAudioPropertiesReport]: (event: RemoteAudioPropertiesInfo[]) => void;
+	
 	/** 
 	 * @brief The current playback device has been changed successfully by calling [setAudioPlaybackDevice](104478#setAudioPlaybackDevice).
 	 * @param event Information of the media devices. Refer to the [official documentation](https://developer.mozilla.org/en-US/docs/Web/API/MediaDeviceInfo) for more details.
@@ -1837,6 +1958,11 @@ export interface IEngineEvents {
 	 * @region Message Event
 	 */
 	[EngineEventsTypes.onUserBinaryMessageReceivedOutsideRoom]: (event: UserBinaryMessageEvent) => void;
+	
+	/** 
+	 * @brief You will receive this callback 30 s before the Token expires.
+	 * Call [updateToken](104478#updatetoken) to submit a new Token。The user will be removed from the room when the Token expires.
+	 */
 	[EngineEventsTypes.onTokenWillExpire]: () => void;
 	
 	/** 
@@ -1847,7 +1973,7 @@ export interface IEngineEvents {
 	
 	/** 
 	 * @brief Callback of the result of publishing the public stream.
-	 *        After calling [startPushPublicStream](#startpushpublicstream), you will be informed of the result through this callback.
+	 *        After calling [startPushPublicStream](104478#startpushpublicstream), you will be informed of the result through this callback.
 	 * @param event
 	 */
 	[EngineEventsTypes.onPushPublicStreamResult]: (event: PublicStreamResultEvent) => void;
@@ -1855,7 +1981,7 @@ export interface IEngineEvents {
 	/** 
 	 * @hidden
 	 * @brief Callback of the SEI carried by the public video stream.
-	 *        You will receive SEI by this callback if the public stream you subscribed to by calling [startPlayPublicStream](#startplaypublicstream) is carrying SEI.
+	 *        You will receive SEI by this callback if the public stream you subscribed to by calling [startPlayPublicStream](104478#startplaypublicstream) is carrying SEI.
 	 * @param event
 	 * @notes When multiple streams in the public stream contain SEI:
 	 *        + You will receive SEI from all the video frames if the SEI do not have conflicts.
@@ -1865,14 +1991,14 @@ export interface IEngineEvents {
 	
 	/** 
 	 * @brief Callback of the successful decoding of the first video frame of the public stream.
-	 *        Refer to [startPlayPublicStream](#startplaypublicstream) for details about subsribing to a public stream.
+	 *        Refer to [startPlayPublicStream](104478#startplaypublicstream) for details about subscribing to a public stream.
 	 * @param event
 	 */
 	[EngineEventsTypes.onFirstPublicStreamVideoFrameDecoded]: (event: PublicStreamVideoFirstFrameDecodedEvent) => void;
 	
 	/** 
 	 * @brief Callback of the successful decoding of the first audio frame of the public stream.
-	 *        Refer to [startPlayPublicStream](#startplaypublicstream) for details about subsribing to a public stream.
+	 *        Refer to [startPlayPublicStream](104478#startplaypublicstream) for details about subscribing to a public stream.
 	 * @param event
 	 */
 	[EngineEventsTypes.onFirstPublicStreamAudioFrameDecoded]: (event: PublicStreamAudioFirstFrameDecodedEvent) => void;
@@ -1882,6 +2008,13 @@ export interface IEngineEvents {
 	 * @param event
 	 */
 	[EngineEventsTypes.onFirstPublicStreamVideoFrameRendered]: (event: PublicStreamAudioFirstFrameDecodedEvent) => void;
+	
+	/** 
+	 * @brief Notification on the playing volume during the test for the local audio devices
+	 * @param volume playing volume during the test for the local audio devices in milliseconds. We recommend to set it to 200 ms.The range is [0,255].
+	 * @notes Start an audio-device test by calling [startAudioPlaybackDeviceTest](104478#startaudioplaybackdevicetest) or [startAudioDeviceRecordTest](104478#startaudiodevicerecordtest) will register this callback for regular notification on playing volume. You can set the time interval between each callback by passing a proper value when calling the API above.
+	 */
+	[EngineEventsTypes.onAudioPlaybackDeviceTestVolume]: (volume: number) => void;
 }
 
 /** 
@@ -2001,11 +2134,11 @@ export interface IRTCEngine extends EnhancedEventEmitter<IEngineEvents> {
 	
 	/** 
 	 * @brief Update Token. <br>
-	 * Call this API to update the Token information of the room when the Token expires <br>
+	 * You will receive [onTokenWillExpire](104479#ontokenwillexpire) 30 s before the Token expires. Call this API to submit a new Token.
 	 * @param token A valid token <br>
 	 * @notes + If you call [joinRoom](#joinroom) with an expired token, the joining will fail with an error code `INVALID_TOKEN`. And you need to obtain a valid token and call this API to update the token. <br>
 	 *      + If joining a room failed because the token expired, call this API with an updated token. And then RTC SDK will automatically rejoin the room without calling [joinRoom](#joinroom) again.  <br>
-	 *      + You have no need to worry about the token expiration after the user joining successfully. Because RTC SDK only verifies the token when the user joins.
+	 *      + The user will be removed from the room when the Token expires.
 	 * @region Room Management
 	 */
 	updateToken(token: string): void;
@@ -2029,17 +2162,17 @@ export interface IRTCEngine extends EnhancedEventEmitter<IEngineEvents> {
 	switchCamera(deviceId: string): Promise<void>;
 	
 	/** 
-	 * @brief Enable internal video capture. The default state is off.   <br>
+	 * @brief Enable internal video capture. The default state is off.
 	 * Internal video capture refers to: capturing video using the built-in module.
-	 * The remote clients in the room will be informed of the state change via [onUserStartVideoCapture](104479#onuserstartvideocapture) after the publisher starts video capture by calling this API.<br>
+	 * The remote clients in the room will be informed of the state change via [onUserStartVideoCapture](104479#onuserstartvideocapture) after the publisher starts video capture by calling this API.
 	 * @param deviceId ID of the device need to enable which you can call [getDevices](#getdevices) to obtain.
-	 * @return
+	 * @return The actual effective video capture parameters. See [MediaTrackSettings](https://developer.mozilla.org/en-US/docs/Web/API/MediaTrackConstraints). Pay attention to the properties: `frameRate`, `height`, and `width`.
 	 * @notes + Call [stopVideoCapture](#stopvideocapture) to stop the internal video capture. Otherwise, the internal video capture will sustain until you destroy the engine instance.<br>
 	 *     + Once you create the engine instance, you can start internal video capture regardless of the video publishing state. The video stream will start publishing only after the video capture starts. <br>
 	 *     + Call [switchCamera](#switchcamera) to switch the camera used by the internal video capture module.<br>
 	 * @region Video Management
 	 */
-	startVideoCapture(deviceId?: string): Promise<void>;
+	startVideoCapture(deviceId?: string): Promise<MediaTrackSettings>;
 	
 	/** 
 	 * @brief Enable internal video capture immediately. The default setting is off.   <br>
@@ -2058,7 +2191,7 @@ export interface IRTCEngine extends EnhancedEventEmitter<IEngineEvents> {
 	 * The remote clients in the room will be informed of the state change via [onUserStartAudioCapture](104479#onuserstartaudiocapture) after the publisher starts audio capture by calling this API.
 	 * @param deviceId ID of the device need to enable which you can call [getDevices](#getdevices) to obtain.
 	 * @return
-	 * @notes + Call [stopVideoCapture](#stopvideocapture) to stop the internal audio capture. Otherwise, the internal audio capture will sustain until you destroy the engine instance. <br>
+	 * @notes + Call [stopAudioCapture](#stopaudiocapture) to stop the internal audio capture. Otherwise, the internal audio capture will sustain until you destroy the engine instance. <br>
 	 *     + Once you create the engine instance, you can start internal audio capture regardless of the audio publishing state. The audio stream will start publishing only after the audio capture starts. <br>
 	 * @region Audio Management
 	 */
@@ -2259,17 +2392,28 @@ export interface IRTCEngine extends EnhancedEventEmitter<IEngineEvents> {
 	sendSEIMessage(streamIndex: StreamIndex, message: Uint8Array | string, repeatCount: number): void;
 	
 	/** 
-	 * @brief Sets the video encoder configuration of each individual stream for simulcasting, including resolution, frame rate, bitrate, scale mode, fallback strategy under poor network conditions.
+	 * @region Video Management
+	 * @brief Sets the video encoder configuration of the publishing streams.
 	 * @param streamIndex
-	 * @param descriptions Video parameters of each individual stream for simulcasting.
-	 *                     The length of `VideoEncoderConfig` is no more than 3. The resolutions must be in descending sort.
-	 * @notes + The video streams are encoded by default with a bitrate of 500bps. <br>
-	 *        + The screen stream takes the first set of parameters. <br>
-	 * @region Media Transmission
+	 * @param descriptions The max parameters of the video stream.
+	 *         When you call [enableSimulcastMode](#enableSimulcastMode) and enable simulcasting, you can call this API to set the parameters of the multiple video streams. The length of `descriptions` is no more than 3. The code rate of the parameters must be in descending order.
+	 *        When the resolution of the max stream is in [540P, 1080P], you can simulcast 3 streams; when in [270P, 450P], you can simulcast 2 streams; when in [0, 180P], you can not enable simulcast.
+	 * @notes For the video stream captured by the camera, the default value is 360P, 15FPS; for the screen-sharing stream, the default value is 1080P, 15FPS.
+	 */
+	setVideoEncoderConfig(streamIndex: StreamIndex, descriptions: VideoEncoderConfig | VideoEncoderConfig[]): Promise<void>;
+	
+	/** 
+	 * @region Video Management
+	 * @brief Enables the simulcast mode of the video stream captured by the camera at the publishing end.imulcasting, including resolution, frame rate, bitrate, scale mode, fallback strategy under poor network conditions.
+	 * @param enabled
+	 * @param + You must call this API before publishing the video streams. <br>
+	 *    + After enabling the simulcast mode, SDK automatically sets the encoding parameters for the video streams. For manual setting, call [setVideoEncoderConfig](#setVideoEncoderConfig).
 	 */
-	setVideoEncoderConfig(streamIndex: StreamIndex, descriptions: VideoEncoderConfig[]): Promise<void>;
+	enableSimulcastMode(enabled: boolean): boolean;
 	
 	/** 
+	 * @hidden
+	 * @deprecated since 4.42, use enableAudioPropertiesReport instead
 	 * @brief Turn on/off volume prompts. Off by default. <br>
 	 * Call this API to set the report period of the volume information of local user and each subscribed user.
 	 * Local client will get informed of the the volume of local user and each subscribed users via [onAudioVolumeIndication](104479#onaudiovolumeindication).
@@ -2281,6 +2425,16 @@ export interface IRTCEngine extends EnhancedEventEmitter<IEngineEvents> {
 	 */
 	setAudioVolumeIndicationInterval(interval?: number): void;
 	
+	/** 
+	 * @brief Enable audio information prompts.   <br>
+	 * @param config Audio information prompts-related configurations.  <br>
+	 * @notes With the prompt on, you can:  <br>
+	 *       + Get the information of the audio stream captured by the local microphone and screen audio stream through [onLocalAudioPropertiesReport](104479#onLocalAudioPropertiesReport).  <br>
+	 *       + Get the information of the subscribed remote audio streams through [onRemoteAudioPropertiesReport](104479#onRemoteAudioPropertiesReport).
+	 * @region Audio Management
+	 */
+	enableAudioPropertiesReport(config?: AudioPropertiesConfig): void;
+	
 	/** 
 	 * @brief Starts pushing media streams to CDN and sets the relevant configurations.
 	 * @param transcode configuration for push media streams to CDN.
@@ -2403,7 +2557,7 @@ export interface IRTCEngine extends EnhancedEventEmitter<IEngineEvents> {
 	 * @param userInfo  User information.
 	 * @return
 	 * @notes
-	 *        + Call logout{@link #logout} to log out the IM server.
+	 *        + Call [logout](104478@#logout) to log out the IM server.
 	 *        + In the same App ID, the user ID of each user must be unique. The user will be logged out when a user with the same userID joins the room because of the error of `RTM_DUPLICATE_LOGIN`.
 	 * @region Room Management
 	 */
@@ -2419,7 +2573,7 @@ export interface IRTCEngine extends EnhancedEventEmitter<IEngineEvents> {
 	 * @brief Update the Token used to login. Since all tokens have a limited time-to-live, call this API to refresh the token.
 	 * @param token updated token
 	 * @return
-	 * @notes + Call this API to refresh the token after the token has expired with no need for calling login{@link #login}.
+	 * @notes + Call this API to refresh the token after the token has expired with no need for calling [login](#login).
 	 *  + You will be informed of the expiration of the token if you tried to login with an expired token or during a reconnection. If the token expired after the user has logged in, no actions need to be taken.
 	 */
 	updateLoginToken(token: string | null): Promise<void>;
@@ -2428,7 +2582,7 @@ export interface IRTCEngine extends EnhancedEventEmitter<IEngineEvents> {
 	 * @brief Get the status of a user before sending him/her a P2P message. You can also call this API to check the status of the current user.
 	 * @param userId ID of the user whose status intended to know
 	 * @return
-	 * @notes Call login{@link #login} before calling this API.
+	 * @notes Call [login](104478@#login) before calling this API.
 	 */
 	getPeerOnlineStatus(userId: string): Promise<USER_ONLINE_STATUS>;
 	
@@ -2437,8 +2591,8 @@ export interface IRTCEngine extends EnhancedEventEmitter<IEngineEvents> {
 	 * @param userId ID of the recipient
 	 * @param message Text message within 62 KB.
 	 * @return
-	 * @notes + Call login{@link #login} before calling this API.
-	 * + The recipient must be logged into the server and will receive the text message via [EngineEventsTypes.onUserMessageReceivedOutsideRoom]{@link #[EngineEventsTypes.onUserMessageReceivedOutsideRoom]} if the message has been sent successfully.
+	 * @notes + Call [login](104478@#login) before calling this API.
+	 * + The recipient must be logged into the server and will receive the text message via [EngineEventsTypes.onUserMessageReceivedOutsideRoom](104479#onUserMessageReceivedOutsideRoom) if the message has been sent successfully.
 	 */
 	sendUserMessageOutsideRoom(userId: string, message: string): Promise<any>;
 	
@@ -2446,8 +2600,8 @@ export interface IRTCEngine extends EnhancedEventEmitter<IEngineEvents> {
 	 * @brief Send point-to-point (P2P) binary message to a user.
 	 * @param userId ID of the recipient
 	 * @param message Binary message within 46 KB
-	 * @return + Call login{@link #login} before calling this API.
-	 *  + The recipient must be logged into the server and will receive the text message via [EngineEventsTypes.onUserBinaryMessageReceivedOutsideRoom]{@link #[EngineEventsTypes.onUserBinaryMessageReceivedOutsideRoom]} if the message has been sent successfully.
+	 * @return + Call [login](#login) before calling this API.
+	 *  + The recipient must be logged into the server and will receive the text message via [EngineEventsTypes.onUserBinaryMessageReceivedOutsideRoom](104479#onuserbinarymessagereceivedoutsideroom) if the message has been sent successfully.
 	 * @notes
 	 */
 	sendUserBinaryMessageOutsideRoom(userId: string, message: ArrayBuffer): Promise<any>;
@@ -2457,7 +2611,7 @@ export interface IRTCEngine extends EnhancedEventEmitter<IEngineEvents> {
 	 * @param signature Dynamic signature.
 	 * @param url Address of the IM server
 	 * @return
-	 * @notes Call login{@link #login} before calling this API.
+	 * @notes Call [login](#login) before calling this API.
 	 */
 	setServerParams(signature: string, url: string): Promise<any>;
 	
@@ -2480,8 +2634,7 @@ export interface IRTCEngine extends EnhancedEventEmitter<IEngineEvents> {
 	/** 
 	 * @brief  Start cloud proxy
 	 * @param  cloudProxyInfo cloud proxy informarion list.
-	 * @notes   <br>
-	 *         + Call this API before joining the room.<br>
+	 * @notes  + Call this API before joining the room.<br>
 	 *         + Start pre-call network detection after starting cloud proxy. <br>
 	 *         + After starting cloud proxy and connects the cloud proxy server successfully, receives [onCloudProxyConnected](104479#onCloudProxyConnected). <br>
 	 *         + To stop cloud proxy, call [stopCloudProxy](#stopCloudProxy).
@@ -2536,7 +2689,7 @@ export interface IRTCEngine extends EnhancedEventEmitter<IEngineEvents> {
 	 *                       If the designated stream is not published when you call this API, you will receive the public stream once it is published.
 	 * @return
 	 * @notes + Before calling this API, we recommend that you call [setPublicStreamVideoPlayer](#setpublicstreamvideoplayer) first to set the player information and rendering mode for the public stream.
-	 *        + After calling this API, you will receive [onFirstPublicStreamVideoFrameDecoded](#onfirstpublicstreamvideoframedecoded) and [onFirstPublicStreamAudioFrameDecoded](#onfirstpublicstreamaudioframedecoded) once the first frame has been decoded.
+	 *        + After calling this API, you will receive [onFirstPublicStreamVideoFrameDecoded](104479#onfirstpublicstreamvideoframedecoded) and [onFirstPublicStreamAudioFrameDecoded](104479#onfirstpublicstreamaudioframedecoded) once the first frame has been decoded.
 	 *        + Call [stopPlayPublicStream](#stopplaypublicstream) to unsubscribing from the public stream.
 	 */
 	startPlayPublicStream(publicStreamId: string): Promise<void>;
@@ -2556,11 +2709,64 @@ export interface IRTCEngine extends EnhancedEventEmitter<IEngineEvents> {
 	 */
 	setPublicStreamVideoPlayer(publicStreamId: string, videoPlayerOption: Omit<VideoPlayerOption, "userId">): void;
 	
+	/** 
+	 * @region Video Management
+	 * @brief Set the placeholder image during local video capture pause
+	 * @param index
+	 * @param filePath Image path in Http protocal; 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.
+	 * @return + It's recommended to call this API before stopping video capture to avoid blank frame in video recording. <br>
+	 *    + You cannot see the image during local preview.
+	 */
+	setDummyCaptureImagePath(index: StreamIndex, filePath: string): Promise<void>;
+	
 	/** 
 	 * @brief Get the default parameters of `LiveTranscodeConfig`.
 	 * @return The default parameters of `LiveTranscodeConfig`
 	 */
 	defaultTranscoding(): Required<LiveTranscodeConfig>;
+	
+	/** 
+	 * @brief Start the playback test for the local audio device. RTC will start playing the audio file specified. And RTC will notify the audio volume via the [onAudioPlaybackDeviceTestVolume](104479#onaudioplaybackdevicetestvolume) periodically.
+	 * @param filePath Specify the path of the audio file for the playback test, including *.wav and *.mp3.
+	 * @param indicationInterval The time interval between each callback in milliseconds. We recommend setting it to 200 ms. The minimal value is 100 ms.
+	 * @return Resolve when the test ends.
+	 * @notes + You can call this API whether the user is in the room.
+	 * + Call [stopAudioPlaybackDeviceTest](#stopaudioplaybackdevicetest) to stop the playback test before moving on to the other device tests.
+	 */
+	startAudioPlaybackDeviceTest(filePath: string, indicationInterval: number): Promise<void>;
+	
+	/** 
+	 * @brief Stop the playback test for the local audio device.
+	 * @notes Call this API to stop the playback test started by calling [startAudioPlaybackDeviceTest](#startaudioplaybackdevicetest) before moving on to the other device tests.
+	 */
+	stopAudioPlaybackDeviceTest(): void;
+	
+	/** 
+	 * @brief Start the capture and playback test for local audio devices.
+	 * We recommend to register [onLocalAudioPropertiesReport](104479#onlocalaudiopropertiesreport) callback via [enableAudioPropertiesReport](enableaudiopropertiesreport). Once the test starts, you can get the volume of the capturing audio by this callback.
+	 * @param indicationInterval The time interval between each callback of [onAudioPlaybackDeviceTestVolume](104479#onaudioplaybackdevicetestvolume) via which you get informed of the playback volume during the test.  We recommend setting it to 200 ms. The minimal value is 100 ms.
+	 * @return Resolve when the test ends.
+	 * @notes + You can call this API whether the user is in a room.
+	 * + The audio capturing will stop and begins to play the recording in 30 s after calling this API. Before that, call [stopAudioDeviceRecordAndPlayTest](#stopaudiodevicerecordandplayTest) to stop capturing and start playing the recording.
+	 * + You must stop the test before starting another test for audio devices.
+	 * + Call [stopAudioDeviceRecordTest](#stopaudiodevicerecordtest) to stop the test, including capturing and playing the recording.
+	 * + This test performs locally and does not involve network connection testing.
+	 */
+	startAudioDeviceRecordTest(indicationInterval: number): Promise<void>;
+	
+	/** 
+	 * @brief Call this API to stop recording in the test and start to play the recording.
+	 * @notes After calling this API, the recording starts playing during which you can call [stopAudioDeviceRecordTest](#stopaudiodevicerecordtest) to stop playing.
+	*/
+	stopAudioDeviceRecordAndPlayTest(): void;
+	
+	/** 
+	 * @brief Stop the capture and playback test for local audio devices which is started by calling [startAudioDeviceRecordTest](#startaudiodevicerecordtest).
+	 * Before the test ends by itself, you can call this API to stop the recording or playing.
+	 */
+	stopAudioDevicePlayTest(): void;
 }
 
 /** 
@@ -2657,6 +2863,7 @@ export interface RoomConfig {
 	
 	/** 
 	 * @brief Enable/disable auto-subscribe audio. Enable by default.
+	 *        Call publish[104481#publish] to publish media streams if you disable `isAutoPublish`.
 	 */
 	isAutoPublish: boolean;
 	
@@ -2806,7 +3013,7 @@ export interface VideoPlayerOption {
 	renderDom?: string | HTMLElement;
 	
 	/** 
-	 * @brief Rendering modes: optional  `RENDER_MODE_HIDDEN`, `RENDER_MODE_FIT` and `RENDER_MODE_ADAPTIVE`.
+	 * @brief Rendering modes: optional  `RENDER_MODE_HIDDEN` and `RENDER_MODE_FIT` .
 	 */
 	renderMode?: VideoRenderMode;
 	
@@ -3071,6 +3278,21 @@ export interface ScreenConfig {
  */
 export interface VideoEncoderConfig {
 	
+	/** 
+	 * @brief width in px
+	 */
+	width: number;
+	
+	/** 
+	 * @brief height in px
+	 */
+	height: number;
+	
+	/** 
+	 * @brief frame rate
+	 */
+	frameRate: number;
+	
 	/** 
 	 * @brief The max bitrate, unit: kbps
 	 */
@@ -3098,6 +3320,27 @@ export declare enum MirrorType {
 	MIRROR_TYPE_RENDER = 1
 }
 
+/** 
+ * @brief Configuration related to audio information prompt.   <br>
+ */
+export interface AudioPropertiesConfig {
+	
+	/** 
+	 * @brief Prompt interval in ms, the default value is 100. <br>
+	 *        + `<= 0`: Turn off prompt <br>
+	 *        + `(0,100]`: Invalid interval value, and will be automatically reset to 100ms. <br>
+	 *        + `> 100`: The actual value of interval  <br>
+	 */
+	interval?: number;
+	
+	/** 
+	 * @brief Whether to keep audio information prompt on when you are not on the video/audio call webpage. The default setting is `true`.  <br>
+	 *        + true: Keep the prompt on  <br>
+	 *        + false: Disable the prompt  <br>
+	 */
+	enableInBackground?: boolean;
+}
+
 /** 
  * @brief Configurations to be set when pushing media streams to CDN
  */