agora-electron-sdk 4.3.0 → 4.3.1-dev.1

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 
 
+## [4.3.1-dev.1](https://github.com/AgoraIO-Extensions/Electron-SDK/compare/v4.3.0...v4.3.1-dev.1) (2024-04-29)
+
+
+### Features
+
+* allow unregister event handler by specific eventHandler ([87843c0](https://github.com/AgoraIO-Extensions/Electron-SDK/commit/87843c04d0d291a4993539f4c96cb6408cf2ea3a))
+* bump example electron version to 22.0.0 ([a8256c0](https://github.com/AgoraIO-Extensions/Electron-SDK/commit/a8256c0f985431de48b6a2faad6a932b64c34382))
+* support native 4.3.1 ([1526048](https://github.com/AgoraIO-Extensions/Electron-SDK/commit/15260486de4ab4bc959a16071f81df7dcbbae989))
+
 # [4.3.0](https://github.com/AgoraIO-Extensions/Electron-SDK/compare/v4.2.6...v4.3.0) (2024-02-28)
 
 

package/gulpfile.js

@@ -2,7 +2,13 @@ const gulp = require('gulp');
 
 const build = require('./scripts/build');
 const buildJS = require('./scripts/buildJS');
-const { cleanBuildDir, cleanJSDir, cleanIrisDir } = require('./scripts/clean');
+const {
+  buildDir,
+  jsDir,
+  cleanDir,
+  destIrisSDKDir,
+  destNativeSDKDir,
+} = require('./scripts/clean');
 const downloadPrebuild = require('./scripts/downloadPrebuild');
 const getConfig = require('./scripts/getConfig');
 const logger = require('./scripts/logger');
@@ -13,9 +19,10 @@ const config = getConfig();
 logger.info(`Get Config: \n${JSON.stringify(config, undefined, 4)}`);
 
 const clean = async (cb) => {
-  await cleanIrisDir();
-  await cleanBuildDir();
-  await cleanJSDir();
+  await cleanDir(destIrisSDKDir);
+  await cleanDir(destNativeSDKDir);
+  await cleanDir(buildDir);
+  await cleanDir(jsDir);
   cb();
 };
 

package/js/Private/AgoraBase.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.QualityAdaptIndication = exports.ClientRoleType = exports.RtcStats = exports.WatermarkOptions = exports.WatermarkRatio = exports.Rectangle = exports.SimulcastStreamConfig = exports.SimulcastStreamMode = exports.DataStreamConfig = exports.VideoEncoderConfiguration = exports.CodecCapInfo = exports.CodecCapLevels = exports.CodecCapMask = exports.VideoMirrorModeType = exports.AdvanceOptions = exports.EncodingPreference = exports.CompressionPreference = exports.EncodedVideoFrameInfo = exports.MaxUserAccountLengthType = exports.VideoSubscriptionOptions = exports.VideoStreamType = exports.H264PacketizeMode = exports.AudioPcmDataInfo = exports.EncodedAudioFrameInfo = exports.EncodedAudioFrameAdvancedSettings = exports.WatermarkFitMode = exports.AudioEncodingType = exports.AudioCodecType = exports.SenderOptions = exports.TCcMode = exports.VideoCodecType = exports.VideoCodecCapabilityLevel = exports.ScreenCaptureFramerateCapability = exports.VideoDimensions = exports.DegradationPreference = exports.OrientationMode = exports.VideoFrameType = exports.FrameHeight = exports.FrameWidth = exports.FrameRate = exports.VideoOrientation = exports.FitModeType = exports.QualityType = exports.InterfaceIdType = exports.UserOfflineReasonType = exports.AudioSessionOperationRestriction = exports.LicenseErrorType = exports.ErrorCodeType = exports.WarnCodeType = exports.ChannelProfileType = void 0;
-exports.WlaccMessageReason = exports.ClientRoleChangeFailedReason = exports.ConnectionChangedReasonType = exports.LastmileProbeResult = exports.LastmileProbeOneWayResult = exports.LastmileProbeResultState = exports.LastmileProbeConfig = exports.VideoTranscoderError = exports.LocalTranscoderConfiguration = exports.TranscodingVideoStream = exports.LiveTranscoding = exports.TranscodingUser = exports.ConnectionStateType = exports.LiveStreamAdvancedFeature = exports.RtcImage = exports.RtmpStreamingEvent = exports.RtmpStreamPublishReason = exports.RtmpStreamPublishState = exports.LocalAudioStats = exports.AudioCodecProfileType = exports.VideoCodecProfileType = exports.VideoCodecTypeForStream = exports.AudioSampleRateType = exports.Packet = exports.DeviceInfo = exports.AudioVolumeInfo = exports.RemoteVideoDownscaleLevel = exports.VideoTrackInfo = exports.RemoteUserState = exports.RemoteVideoStateReason = exports.RemoteVideoState = exports.RemoteAudioStateReason = exports.RemoteAudioState = exports.LocalVideoStreamReason = exports.LocalVideoStreamState = exports.LocalAudioStreamReason = exports.LocalAudioStreamState = exports.CaptureBrightnessLevelType = exports.VideoQoePreferenceType = exports.VideoApplicationScenarioType = exports.ScreenScenarioType = exports.VideoContentHint = exports.VideoFormat = exports.AudioScenarioType = exports.AudioProfileType = exports.AudioAinsMode = exports.ExperiencePoorReason = exports.ExperienceQualityType = exports.ClientRoleOptions = exports.AudienceLatencyLevelType = void 0;
-exports.EarMonitoringFilterType = exports.UserInfo = exports.EchoTestConfiguration = exports.StreamPublishState = exports.StreamSubscribeState = exports.PermissionType = exports.UploadErrorReason = exports.EncryptionErrorType = exports.EncryptionConfig = exports.EncryptionMode = exports.DownlinkNetworkInfo = exports.PeerDownlinkInfo = exports.UplinkNetworkInfo = exports.ChannelMediaRelayConfiguration = exports.ChannelMediaInfo = exports.ChannelMediaRelayState = exports.ChannelMediaRelayError = exports.AreaCodeEx = exports.AreaCode = exports.AudioEncodedFrameObserverConfig = exports.AudioRecordingConfiguration = exports.AudioEncodedFrameObserverPosition = exports.AudioFileRecordingType = exports.AudioRecordingQualityType = exports.ScreenCaptureParameters = exports.HeadphoneEqualizerPreset = exports.VoiceConversionPreset = exports.AudioEffectPreset = exports.VoiceBeautifierPreset = exports.AudioTrackConfig = exports.AudioTrackType = exports.SegmentationProperty = exports.SegModelType = exports.VirtualBackgroundSource = exports.BackgroundBlurDegree = exports.BackgroundSourceType = exports.ColorEnhanceOptions = exports.VideoDenoiserOptions = exports.VideoDenoiserLevel = exports.VideoDenoiserMode = exports.LowlightEnhanceOptions = exports.LowLightEnhanceLevel = exports.LowLightEnhanceMode = exports.BeautyOptions = exports.LighteningContrastLevel = exports.VideoCanvas = exports.VideoViewSetupMode = exports.NetworkType = exports.WlAccStats = exports.WlaccSuggestAction = void 0;
-exports.VideoLayout = exports.SpatialAudioParams = exports.RecorderStreamInfo = exports.LocalAccessPointConfiguration = exports.AdvancedConfigInfo = exports.LogUploadServerInfo = exports.LocalProxyMode = exports.ConfigFetchType = exports.VideoRenderingTracingInfo = exports.MediaTraceEvent = exports.ScreenCaptureParameters2 = exports.ScreenAudioParameters = exports.ScreenVideoParameters = exports.ThreadPriorityType = void 0;
+exports.RtcStats = exports.WatermarkOptions = exports.WatermarkRatio = exports.Rectangle = exports.SimulcastStreamConfig = exports.SimulcastStreamMode = exports.DataStreamConfig = exports.VideoEncoderConfiguration = exports.FocalLengthInfo = exports.CodecCapInfo = exports.CodecCapLevels = exports.CodecCapMask = exports.VideoMirrorModeType = exports.AdvanceOptions = exports.EncodingPreference = exports.CompressionPreference = exports.EncodedVideoFrameInfo = exports.MaxUserAccountLengthType = exports.VideoSubscriptionOptions = exports.VideoStreamType = exports.H264PacketizeMode = exports.AudioPcmDataInfo = exports.EncodedAudioFrameInfo = exports.EncodedAudioFrameAdvancedSettings = exports.WatermarkFitMode = exports.AudioEncodingType = exports.AudioCodecType = exports.SenderOptions = exports.TCcMode = exports.CameraFocalLengthType = exports.VideoCodecType = exports.VideoCodecCapabilityLevel = exports.ScreenCaptureFramerateCapability = exports.VideoDimensions = exports.DegradationPreference = exports.OrientationMode = exports.VideoFrameType = exports.FrameHeight = exports.FrameWidth = exports.FrameRate = exports.VideoOrientation = exports.FitModeType = exports.QualityType = exports.InterfaceIdType = exports.UserOfflineReasonType = exports.AudioSessionOperationRestriction = exports.LicenseErrorType = exports.ErrorCodeType = exports.WarnCodeType = exports.ChannelProfileType = void 0;
+exports.LastmileProbeResult = exports.LastmileProbeOneWayResult = exports.LastmileProbeResultState = exports.LastmileProbeConfig = exports.VideoTranscoderError = exports.LocalTranscoderConfiguration = exports.TranscodingVideoStream = exports.LiveTranscoding = exports.TranscodingUser = exports.ConnectionStateType = exports.LiveStreamAdvancedFeature = exports.RtcImage = exports.RtmpStreamingEvent = exports.RtmpStreamPublishReason = exports.RtmpStreamPublishState = exports.LocalAudioStats = exports.AudioCodecProfileType = exports.VideoCodecProfileType = exports.VideoCodecTypeForStream = exports.AudioSampleRateType = exports.Packet = exports.DeviceInfo = exports.AudioVolumeInfo = exports.RemoteVideoDownscaleLevel = exports.VideoTrackInfo = exports.RemoteUserState = exports.RemoteVideoStateReason = exports.RemoteVideoState = exports.RemoteAudioStateReason = exports.RemoteAudioState = exports.LocalVideoStreamReason = exports.LocalVideoStreamState = exports.LocalAudioStreamReason = exports.LocalAudioStreamState = exports.CameraStabilizationMode = exports.CaptureBrightnessLevelType = exports.VideoQoePreferenceType = exports.VideoApplicationScenarioType = exports.ScreenScenarioType = exports.VideoContentHint = exports.VideoFormat = exports.AudioScenarioType = exports.AudioProfileType = exports.AudioAinsMode = exports.ExperiencePoorReason = exports.ExperienceQualityType = exports.ClientRoleOptions = exports.AudienceLatencyLevelType = exports.QualityAdaptIndication = exports.ClientRoleType = void 0;
+exports.StreamPublishState = exports.StreamSubscribeState = exports.PermissionType = exports.UploadErrorReason = exports.EncryptionErrorType = exports.EncryptionConfig = exports.EncryptionMode = exports.DownlinkNetworkInfo = exports.PeerDownlinkInfo = exports.UplinkNetworkInfo = exports.ChannelMediaRelayConfiguration = exports.ChannelMediaInfo = exports.ChannelMediaRelayState = exports.ChannelMediaRelayError = exports.AreaCodeEx = exports.AreaCode = exports.AudioEncodedFrameObserverConfig = exports.AudioRecordingConfiguration = exports.AudioEncodedFrameObserverPosition = exports.AudioFileRecordingType = exports.AudioRecordingQualityType = exports.ScreenCaptureParameters = exports.HeadphoneEqualizerPreset = exports.VoiceConversionPreset = exports.AudioEffectPreset = exports.VoiceBeautifierPreset = exports.AudioTrackConfig = exports.AudioTrackType = exports.SegmentationProperty = exports.SegModelType = exports.VirtualBackgroundSource = exports.BackgroundBlurDegree = exports.BackgroundSourceType = exports.ColorEnhanceOptions = exports.VideoDenoiserOptions = exports.VideoDenoiserLevel = exports.VideoDenoiserMode = exports.LowlightEnhanceOptions = exports.LowLightEnhanceLevel = exports.LowLightEnhanceMode = exports.BeautyOptions = exports.LighteningContrastLevel = exports.VideoCanvas = exports.VideoViewSetupMode = exports.NetworkType = exports.WlAccStats = exports.WlaccSuggestAction = exports.WlaccMessageReason = exports.ClientRoleChangeFailedReason = exports.ConnectionChangedReasonType = void 0;
+exports.VideoLayout = exports.SpatialAudioParams = exports.RecorderStreamInfo = exports.LocalAccessPointConfiguration = exports.AdvancedConfigInfo = exports.LogUploadServerInfo = exports.LocalProxyMode = exports.ConfigFetchType = exports.VideoRenderingTracingInfo = exports.MediaTraceEvent = exports.ScreenCaptureParameters2 = exports.ScreenAudioParameters = exports.ScreenVideoParameters = exports.ThreadPriorityType = exports.EarMonitoringFilterType = exports.UserInfo = exports.EchoTestConfiguration = void 0;
 require("./extension/AgoraBaseExtension");
 /**
  * The channel profile.
@@ -320,13 +320,17 @@ var ErrorCodeType;
      */
     ErrorCodeType[ErrorCodeType["ErrSetClientRoleNotAuthorized"] = 119] = "ErrSetClientRoleNotAuthorized";
     /**
-     * 120: Decryption fails. The user might have entered an incorrect password to join the channel. Check the entered password, or tell the user to try rejoining the channel.
+     * 120: Media streams decryption fails. The user might use an incorrect password to join the channel. Check the entered password, or tell the user to try rejoining the channel.
      */
     ErrorCodeType[ErrorCodeType["ErrDecryptionFailed"] = 120] = "ErrDecryptionFailed";
     /**
      * 121: The user ID is invalid.
      */
     ErrorCodeType[ErrorCodeType["ErrInvalidUserId"] = 121] = "ErrInvalidUserId";
+    /**
+     * 122: Data streams decryption fails. The user might use an incorrect password to join the channel. Check the entered password, or tell the user to try rejoining the channel.
+     */
+    ErrorCodeType[ErrorCodeType["ErrDatastreamDecryptionFailed"] = 122] = "ErrDatastreamDecryptionFailed";
     /**
      * 123: The user is banned from the server.
      */
@@ -883,6 +887,28 @@ var VideoCodecType;
      */
     VideoCodecType[VideoCodecType["VideoCodecGenericJpeg"] = 20] = "VideoCodecGenericJpeg";
 })(VideoCodecType = exports.VideoCodecType || (exports.VideoCodecType = {}));
+/**
+ * @ignore
+ */
+var CameraFocalLengthType;
+(function (CameraFocalLengthType) {
+    /**
+     * @ignore
+     */
+    CameraFocalLengthType[CameraFocalLengthType["CameraFocalLengthDefault"] = 0] = "CameraFocalLengthDefault";
+    /**
+     * @ignore
+     */
+    CameraFocalLengthType[CameraFocalLengthType["CameraFocalLengthWideAngle"] = 1] = "CameraFocalLengthWideAngle";
+    /**
+     * @ignore
+     */
+    CameraFocalLengthType[CameraFocalLengthType["CameraFocalLengthUltraWide"] = 2] = "CameraFocalLengthUltraWide";
+    /**
+     * @ignore
+     */
+    CameraFocalLengthType[CameraFocalLengthType["CameraFocalLengthTelephoto"] = 3] = "CameraFocalLengthTelephoto";
+})(CameraFocalLengthType = exports.CameraFocalLengthType || (exports.CameraFocalLengthType = {}));
 /**
  * @ignore
  */
@@ -1200,6 +1226,15 @@ var CodecCapInfo = /** @class */ (function () {
     return CodecCapInfo;
 }());
 exports.CodecCapInfo = CodecCapInfo;
+/**
+ * @ignore
+ */
+var FocalLengthInfo = /** @class */ (function () {
+    function FocalLengthInfo() {
+    }
+    return FocalLengthInfo;
+}());
+exports.FocalLengthInfo = FocalLengthInfo;
 /**
  * Video encoder configurations.
  */
@@ -1591,6 +1626,36 @@ var CaptureBrightnessLevelType;
      */
     CaptureBrightnessLevelType[CaptureBrightnessLevelType["CaptureBrightnessLevelDark"] = 2] = "CaptureBrightnessLevelDark";
 })(CaptureBrightnessLevelType = exports.CaptureBrightnessLevelType || (exports.CaptureBrightnessLevelType = {}));
+/**
+ * @ignore
+ */
+var CameraStabilizationMode;
+(function (CameraStabilizationMode) {
+    /**
+     * @ignore
+     */
+    CameraStabilizationMode[CameraStabilizationMode["CameraStabilizationModeOff"] = -1] = "CameraStabilizationModeOff";
+    /**
+     * @ignore
+     */
+    CameraStabilizationMode[CameraStabilizationMode["CameraStabilizationModeAuto"] = 0] = "CameraStabilizationModeAuto";
+    /**
+     * @ignore
+     */
+    CameraStabilizationMode[CameraStabilizationMode["CameraStabilizationModeLevel1"] = 1] = "CameraStabilizationModeLevel1";
+    /**
+     * @ignore
+     */
+    CameraStabilizationMode[CameraStabilizationMode["CameraStabilizationModeLevel2"] = 2] = "CameraStabilizationModeLevel2";
+    /**
+     * @ignore
+     */
+    CameraStabilizationMode[CameraStabilizationMode["CameraStabilizationModeLevel3"] = 3] = "CameraStabilizationModeLevel3";
+    /**
+     * @ignore
+     */
+    CameraStabilizationMode[CameraStabilizationMode["CameraStabilizationModeMaxLevel"] = 3] = "CameraStabilizationModeMaxLevel";
+})(CameraStabilizationMode = exports.CameraStabilizationMode || (exports.CameraStabilizationMode = {}));
 /**
  * The state of the local audio.
  */
@@ -1643,11 +1708,11 @@ var LocalAudioStreamReason;
      */
     LocalAudioStreamReason[LocalAudioStreamReason["LocalAudioStreamReasonEncodeFailure"] = 5] = "LocalAudioStreamReasonEncodeFailure";
     /**
-     * 6: No local audio capture device. Remind your users to check whether the microphone is connected to the device properly in the control plane of the device or if the microphone is working properly.
+     * 6: No local audio capture device. Remind your users to check whether the microphone is connected to the device properly in the control panel of the device or if the microphone is working properly.
      */
     LocalAudioStreamReason[LocalAudioStreamReason["LocalAudioStreamReasonNoRecordingDevice"] = 6] = "LocalAudioStreamReasonNoRecordingDevice";
     /**
-     * 7: No local audio capture device. Remind your users to check whether the speaker is connected to the device properly in the control plane of the device or if the speaker is working properly.
+     * 7: No local audio capture device. Remind your users to check whether the speaker is connected to the device properly in the control panel of the device or if the speaker is working properly.
      */
     LocalAudioStreamReason[LocalAudioStreamReason["LocalAudioStreamReasonNoPlayoutDevice"] = 7] = "LocalAudioStreamReasonNoPlayoutDevice";
     /**
@@ -1655,11 +1720,11 @@ var LocalAudioStreamReason;
      */
     LocalAudioStreamReason[LocalAudioStreamReason["LocalAudioStreamReasonInterrupted"] = 8] = "LocalAudioStreamReasonInterrupted";
     /**
-     * 9: (Windows only) The ID of the local audio-capture device is invalid. Check the audio capture device ID.
+     * 9: (Windows only) The ID of the local audio-capture device is invalid. Prompt the user to check the audio capture device ID.
      */
     LocalAudioStreamReason[LocalAudioStreamReason["LocalAudioStreamReasonRecordInvalidId"] = 9] = "LocalAudioStreamReasonRecordInvalidId";
     /**
-     * 10: (Windows only) The ID of the local audio-playback device is invalid. Check the audio playback device ID.
+     * 10: (Windows only) The ID of the local audio-playback device is invalid. Prompt the user to check the audio playback device ID.
      */
     LocalAudioStreamReason[LocalAudioStreamReason["LocalAudioStreamReasonPlayoutInvalidId"] = 10] = "LocalAudioStreamReasonPlayoutInvalidId";
 })(LocalAudioStreamReason = exports.LocalAudioStreamReason || (exports.LocalAudioStreamReason = {}));
@@ -1699,15 +1764,15 @@ var LocalVideoStreamReason;
      */
     LocalVideoStreamReason[LocalVideoStreamReason["LocalVideoStreamReasonFailure"] = 1] = "LocalVideoStreamReasonFailure";
     /**
-     * 2: No permission to use the local video capturing device. Remind the user to grant permissions and rejoin the channel. Deprecated: This enumerator is deprecated. Please use CAMERA in the onPermissionError callback instead.
+     * 2: No permission to use the local video capturing device. Prompt the user to grant permissions and rejoin the channel. Deprecated: This enumerator is deprecated. Please use CAMERA in the onPermissionError callback instead.
      */
     LocalVideoStreamReason[LocalVideoStreamReason["LocalVideoStreamReasonDeviceNoPermission"] = 2] = "LocalVideoStreamReasonDeviceNoPermission";
     /**
-     * 3: The local video capturing device is in use. Remind the user to check whether another application occupies the camera.
+     * 3: The local video capturing device is in use. Prompt the user to check if the camera is being used by another app, or try to rejoin the channel.
      */
     LocalVideoStreamReason[LocalVideoStreamReason["LocalVideoStreamReasonDeviceBusy"] = 3] = "LocalVideoStreamReasonDeviceBusy";
     /**
-     * 4: The local video capture fails. Remind your user to check whether the video capture device is working properly, whether the camera is occupied by another application, or try to rejoin the channel.
+     * 4: The local video capture fails. Prompt the user to check whether the video capture device is working properly, whether the camera is used by another app, or try to rejoin the channel.
      */
     LocalVideoStreamReason[LocalVideoStreamReason["LocalVideoStreamReasonCaptureFailure"] = 4] = "LocalVideoStreamReasonCaptureFailure";
     /**
@@ -1734,17 +1799,25 @@ var LocalVideoStreamReason;
      * 10: (macOS and Windows only) The SDK cannot find the video device in the video device list. Check whether the ID of the video device is valid.
      */
     LocalVideoStreamReason[LocalVideoStreamReason["LocalVideoStreamReasonDeviceInvalidId"] = 10] = "LocalVideoStreamReasonDeviceInvalidId";
+    /**
+     * @ignore
+     */
+    LocalVideoStreamReason[LocalVideoStreamReason["LocalVideoStreamReasonDeviceInterrupt"] = 14] = "LocalVideoStreamReasonDeviceInterrupt";
+    /**
+     * @ignore
+     */
+    LocalVideoStreamReason[LocalVideoStreamReason["LocalVideoStreamReasonDeviceFatalError"] = 15] = "LocalVideoStreamReasonDeviceFatalError";
     /**
      * 101: The current video capture device is unavailable due to excessive system pressure.
      */
     LocalVideoStreamReason[LocalVideoStreamReason["LocalVideoStreamReasonDeviceSystemPressure"] = 101] = "LocalVideoStreamReasonDeviceSystemPressure";
     /**
-     * 11: (macOS and Windows only) The shared windows is minimized when you call the startScreenCaptureByWindowId method to share a window. The SDK cannot share a minimized window. You can cancel the minimization of this window at the application layer, for example by maximizing this window.
+     * 11: (macOS and Windows only) The shared window is minimized when you call the startScreenCaptureByWindowId method to share a window. The SDK cannot share a minimized window. Please prompt the user to unminimize the shared window.
      */
     LocalVideoStreamReason[LocalVideoStreamReason["LocalVideoStreamReasonScreenCaptureWindowMinimized"] = 11] = "LocalVideoStreamReasonScreenCaptureWindowMinimized";
     /**
      * 12: (macOS and Windows only) The error code indicates that a window shared by the window ID has been closed or a full-screen window shared by the window ID has exited full-screen mode. After exiting full-screen mode, remote users cannot see the shared window. To prevent remote users from seeing a black screen, Agora recommends that you immediately stop screen sharing. Common scenarios reporting this error code:
-     *  When the local user closes the shared window, the SDK reports this error code.
+     *  The local user closes the shared window.
      *  The local user shows some slides in full-screen mode first, and then shares the windows of the slides. After the user exits full-screen mode, the SDK reports this error code.
      *  The local user watches a web video or reads a web document in full-screen mode first, and then shares the window of the web video or document. After the user exits full-screen mode, the SDK reports this error code.
      */
@@ -1778,7 +1851,7 @@ var LocalVideoStreamReason;
      */
     LocalVideoStreamReason[LocalVideoStreamReason["LocalVideoStreamReasonScreenCaptureWindowRecoverFromHidden"] = 26] = "LocalVideoStreamReasonScreenCaptureWindowRecoverFromHidden";
     /**
-     * @ignore
+     * 27: The window for screen capture has been restored from the minimized state.
      */
     LocalVideoStreamReason[LocalVideoStreamReason["LocalVideoStreamReasonScreenCaptureWindowRecoverFromMinimized"] = 27] = "LocalVideoStreamReasonScreenCaptureWindowRecoverFromMinimized";
     /**
@@ -1853,6 +1926,14 @@ var RemoteAudioStateReason;
      * 7: The remote user leaves the channel.
      */
     RemoteAudioStateReason[RemoteAudioStateReason["RemoteAudioReasonRemoteOffline"] = 7] = "RemoteAudioReasonRemoteOffline";
+    /**
+     * @ignore
+     */
+    RemoteAudioStateReason[RemoteAudioStateReason["RemoteAudioReasonNoPacketReceive"] = 8] = "RemoteAudioReasonNoPacketReceive";
+    /**
+     * @ignore
+     */
+    RemoteAudioStateReason[RemoteAudioStateReason["RemoteAudioReasonLocalPlayFailed"] = 9] = "RemoteAudioReasonLocalPlayFailed";
 })(RemoteAudioStateReason = exports.RemoteAudioStateReason || (exports.RemoteAudioStateReason = {}));
 /**
  * The state of the remote video stream.
@@ -2201,7 +2282,7 @@ var RtmpStreamPublishReason;
      */
     RtmpStreamPublishReason[RtmpStreamPublishReason["RtmpStreamPublishReasonInvalidAppid"] = 15] = "RtmpStreamPublishReasonInvalidAppid";
     /**
-     * 16: Your project does not have permission to use streaming services. Refer to Media Push to enable the Media Push permission.
+     * 16: Your project does not have permission to use streaming services.
      */
     RtmpStreamPublishReason[RtmpStreamPublishReason["RtmpStreamPublishReasonInvalidPrivilege"] = 16] = "RtmpStreamPublishReasonInvalidPrivilege";
     /**
@@ -2646,7 +2727,7 @@ exports.VideoCanvas = VideoCanvas;
 var LighteningContrastLevel;
 (function (LighteningContrastLevel) {
     /**
-     * @ignore
+     * 0: Low contrast level.
      */
     LighteningContrastLevel[LighteningContrastLevel["LighteningContrastLow"] = 0] = "LighteningContrastLow";
     /**
@@ -2970,6 +3051,10 @@ var AudioEffectPreset;
      * Virtual surround sound, that is, the SDK generates a simulated surround sound field on the basis of stereo channels, thereby creating a surround sound effect. If the virtual surround sound is enabled, users need to use stereo audio playback devices to hear the anticipated audio effect.
      */
     AudioEffectPreset[AudioEffectPreset["RoomAcousticsVirtualSurroundSound"] = 33622272] = "RoomAcousticsVirtualSurroundSound";
+    /**
+     * The audio effect of chorus. Agora recommends using this effect in chorus scenarios to enhance the sense of depth and dimension in the vocals.
+     */
+    AudioEffectPreset[AudioEffectPreset["RoomAcousticsChorus"] = 33623296] = "RoomAcousticsChorus";
     /**
      * A middle-aged man's voice. Agora recommends using this preset to process a male-sounding voice; otherwise, you may not hear the anticipated voice effect.
      */
@@ -3266,7 +3351,7 @@ var ChannelMediaRelayError;
      */
     ChannelMediaRelayError[ChannelMediaRelayError["RelayErrorServerErrorResponse"] = 1] = "RelayErrorServerErrorResponse";
     /**
-     * 2: No server response. You can call leaveChannel to leave the channel. This error can also occur if your project has not enabled co-host token authentication. You can to enable the service for cohosting across channels before starting a channel media relay.
+     * 2: No server response. This error may be caused by poor network connections. If this error occurs when initiating a channel media relay, you can try again later; if this error occurs during channel media relay, you can call leaveChannel to leave the channel. This error can also occur if the channel media relay service is not enabled in the project. You can contact to enable the service.
      */
     ChannelMediaRelayError[ChannelMediaRelayError["RelayErrorServerNoResponse"] = 2] = "RelayErrorServerNoResponse";
     /**
@@ -3436,13 +3521,21 @@ var EncryptionErrorType;
      */
     EncryptionErrorType[EncryptionErrorType["EncryptionErrorInternalFailure"] = 0] = "EncryptionErrorInternalFailure";
     /**
-     * 1: Decryption errors. Ensure that the receiver and the sender use the same encryption mode and key.
+     * 1: Media stream decryption error. Ensure that the receiver and the sender use the same encryption mode and key.
      */
     EncryptionErrorType[EncryptionErrorType["EncryptionErrorDecryptionFailure"] = 1] = "EncryptionErrorDecryptionFailure";
     /**
-     * 2: Encryption errors.
+     * 2: Media stream encryption error.
      */
     EncryptionErrorType[EncryptionErrorType["EncryptionErrorEncryptionFailure"] = 2] = "EncryptionErrorEncryptionFailure";
+    /**
+     * 3: Data stream decryption error. Ensure that the receiver and the sender use the same encryption mode and key.
+     */
+    EncryptionErrorType[EncryptionErrorType["EncryptionErrorDatastreamDecryptionFailure"] = 3] = "EncryptionErrorDatastreamDecryptionFailure";
+    /**
+     * 4: Data stream encryption error.
+     */
+    EncryptionErrorType[EncryptionErrorType["EncryptionErrorDatastreamEncryptionFailure"] = 4] = "EncryptionErrorDatastreamEncryptionFailure";
 })(EncryptionErrorType = exports.EncryptionErrorType || (exports.EncryptionErrorType = {}));
 /**
  * @ignore
@@ -3555,22 +3648,26 @@ var UserInfo = /** @class */ (function () {
 }());
 exports.UserInfo = UserInfo;
 /**
- * The audio filter of in-ear monitoring.
+ * The audio filter types of in-ear monitoring.
  */
 var EarMonitoringFilterType;
 (function (EarMonitoringFilterType) {
     /**
-     * 1<<0: Do not add an audio filter to the in-ear monitor.
+     * 1<<0: No audio filter added to in-ear monitoring.
      */
     EarMonitoringFilterType[EarMonitoringFilterType["EarMonitoringFilterNone"] = 1] = "EarMonitoringFilterNone";
     /**
-     * 1<<1: Add an audio filter to the in-ear monitor. If you implement functions such as voice beautifier and audio effect, users can hear the voice after adding these effects.
+     * 1<<1: Add vocal effects audio filter to in-ear monitoring. If you implement functions such as voice beautifier and audio effect, users can hear the voice after adding these effects.
      */
     EarMonitoringFilterType[EarMonitoringFilterType["EarMonitoringFilterBuiltInAudioFilters"] = 2] = "EarMonitoringFilterBuiltInAudioFilters";
     /**
-     * 1<<2: Enable noise suppression to the in-ear monitor.
+     * 1<<2: Add noise suppression audio filter to in-ear monitoring.
      */
     EarMonitoringFilterType[EarMonitoringFilterType["EarMonitoringFilterNoiseSuppression"] = 4] = "EarMonitoringFilterNoiseSuppression";
+    /**
+     * 1<<15: Reuse the audio filter that has been processed on the sending end for in-ear monitoring. This enumerator reduces CPU usage while increasing in-ear monitoring latency, which is suitable for latency-tolerant scenarios requiring low CPU consumption.
+     */
+    EarMonitoringFilterType[EarMonitoringFilterType["EarMonitoringFilterReusePostProcessingFilter"] = 32768] = "EarMonitoringFilterReusePostProcessingFilter";
 })(EarMonitoringFilterType = exports.EarMonitoringFilterType || (exports.EarMonitoringFilterType = {}));
 /**
  * @ignore

package/js/Private/AgoraMediaBase.js

@@ -75,6 +75,10 @@ var VideoSourceType;
      * 14: The fourth screen.
      */
     VideoSourceType[VideoSourceType["VideoSourceScreenFourth"] = 14] = "VideoSourceScreenFourth";
+    /**
+     * @ignore
+     */
+    VideoSourceType[VideoSourceType["VideoSourceSpeechDriven"] = 15] = "VideoSourceSpeechDriven";
     /**
      * 100: An unknown video source.
      */
@@ -114,11 +118,11 @@ var AudioRoute;
      */
     AudioRoute[AudioRoute["RouteBluetoothDeviceHfp"] = 5] = "RouteBluetoothDeviceHfp";
     /**
-     * 7: The audio route is a USB peripheral device. (For macOS only)
+     * 6: The audio route is a USB peripheral device. (For macOS only)
      */
     AudioRoute[AudioRoute["RouteUsb"] = 6] = "RouteUsb";
     /**
-     * 6: The audio route is an HDMI peripheral device. (For macOS only)
+     * 7: The audio route is an HDMI peripheral device. (For macOS only)
      */
     AudioRoute[AudioRoute["RouteHdmi"] = 7] = "RouteHdmi";
     /**
@@ -197,7 +201,7 @@ var MediaSourceType;
      */
     MediaSourceType[MediaSourceType["SecondaryScreenSource"] = 5] = "SecondaryScreenSource";
     /**
-     * 6. Custom video source.
+     * 6: Custom video source.
      */
     MediaSourceType[MediaSourceType["CustomVideoSource"] = 6] = "CustomVideoSource";
     /**
@@ -224,6 +228,10 @@ var MediaSourceType;
      * @ignore
      */
     MediaSourceType[MediaSourceType["TranscodedVideoSource"] = 12] = "TranscodedVideoSource";
+    /**
+     * @ignore
+     */
+    MediaSourceType[MediaSourceType["SpeechDrivenVideoSource"] = 13] = "SpeechDrivenVideoSource";
     /**
      * 100: Unknown media source.
      */
@@ -393,6 +401,10 @@ var VideoPixelFormat;
      * @ignore
      */
     VideoPixelFormat[VideoPixelFormat["VideoTextureId3d11texture2d"] = 17] = "VideoTextureId3d11texture2d";
+    /**
+     * @ignore
+     */
+    VideoPixelFormat[VideoPixelFormat["VideoPixelI010"] = 18] = "VideoPixelI010";
 })(VideoPixelFormat = exports.VideoPixelFormat || (exports.VideoPixelFormat = {}));
 /**
  * Video display modes.

package/js/Private/IAgoraRtcEngine.js

@@ -335,11 +335,11 @@ exports.PublisherConfiguration = PublisherConfiguration;
 var CameraDirection;
 (function (CameraDirection) {
     /**
-     * The rear camera.
+     * 0: The rear camera.
      */
     CameraDirection[CameraDirection["CameraRear"] = 0] = "CameraRear";
     /**
-     * The front camera.
+     * 1: (Default) The front camera.
      */
     CameraDirection[CameraDirection["CameraFront"] = 1] = "CameraFront";
 })(CameraDirection = exports.CameraDirection || (exports.CameraDirection = {}));
@@ -1018,7 +1018,7 @@ var VideoDeviceInfo = /** @class */ (function () {
 }());
 exports.VideoDeviceInfo = VideoDeviceInfo;
 /**
- * The AudioDeviceInfo class that contains the ID and device name of the audio devices.
+ * The AudioDeviceInfo class that contains the ID, name and type of the audio devices.
  */
 var AudioDeviceInfo = /** @class */ (function () {
     function AudioDeviceInfo() {

package/js/Private/impl/AgoraMediaBaseImpl.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.processIMediaRecorderObserver = exports.processIVideoFrameObserver = exports.processIVideoEncodedFrameObserver = exports.processIAudioSpectrumObserver = exports.processIAudioFrameObserver = exports.processIAudioFrameObserverBase = exports.processIAudioPcmFrameSink = exports.IVideoFrameMetaInfoImpl = void 0;
+exports.processIMediaRecorderObserver = exports.processIFaceInfoObserver = exports.processIVideoFrameObserver = exports.processIVideoEncodedFrameObserver = exports.processIAudioSpectrumObserver = exports.processIAudioFrameObserver = exports.processIAudioFrameObserverBase = exports.processIAudioPcmFrameSink = exports.IVideoFrameMetaInfoImpl = void 0;
 // @ts-ignore
 var IVideoFrameMetaInfoImpl = /** @class */ (function () {
     function IVideoFrameMetaInfoImpl() {
@@ -124,6 +124,16 @@ function processIVideoFrameObserver(handler, event, jsonParams) {
     }
 }
 exports.processIVideoFrameObserver = processIVideoFrameObserver;
+function processIFaceInfoObserver(handler, event, jsonParams) {
+    switch (event) {
+        case 'onFaceInfo':
+            if (handler.onFaceInfo !== undefined) {
+                handler.onFaceInfo(jsonParams.outFaceInfo);
+            }
+            break;
+    }
+}
+exports.processIFaceInfoObserver = processIFaceInfoObserver;
 function processIMediaRecorderObserver(handler, event, jsonParams) {
     switch (event) {
         case 'onRecorderStateChanged':

package/js/Private/impl/IAgoraMediaEngineImpl.js

@@ -49,6 +49,20 @@ var IMediaEngineImpl = /** @class */ (function () {
     IMediaEngineImpl.prototype.getApiTypeFromRegisterVideoEncodedFrameObserver = function (observer) {
         return 'MediaEngine_registerVideoEncodedFrameObserver_d45d579';
     };
+    IMediaEngineImpl.prototype.registerFaceInfoObserver = function (observer) {
+        var apiType = this.getApiTypeFromRegisterFaceInfoObserver(observer);
+        var jsonParams = {
+            observer: observer,
+            toJSON: function () {
+                return {};
+            },
+        };
+        var jsonResults = IrisApiEngine_1.callIrisApi.call(this, apiType, jsonParams);
+        return jsonResults.result;
+    };
+    IMediaEngineImpl.prototype.getApiTypeFromRegisterFaceInfoObserver = function (observer) {
+        return 'MediaEngine_registerFaceInfoObserver_0303ed6';
+    };
     IMediaEngineImpl.prototype.pushAudioFrame = function (frame, trackId) {
         if (trackId === void 0) { trackId = 0; }
         var apiType = this.getApiTypeFromPushAudioFrame(frame, trackId);
@@ -304,6 +318,20 @@ var IMediaEngineImpl = /** @class */ (function () {
     IMediaEngineImpl.prototype.getApiTypeFromUnregisterVideoEncodedFrameObserver = function (observer) {
         return 'MediaEngine_unregisterVideoEncodedFrameObserver';
     };
+    IMediaEngineImpl.prototype.unregisterFaceInfoObserver = function (observer) {
+        var apiType = this.getApiTypeFromUnregisterFaceInfoObserver(observer);
+        var jsonParams = {
+            observer: observer,
+            toJSON: function () {
+                return {};
+            },
+        };
+        var jsonResults = IrisApiEngine_1.callIrisApi.call(this, apiType, jsonParams);
+        return jsonResults.result;
+    };
+    IMediaEngineImpl.prototype.getApiTypeFromUnregisterFaceInfoObserver = function (observer) {
+        return 'MediaEngine_unregisterFaceInfoObserver';
+    };
     return IMediaEngineImpl;
 }());
 exports.IMediaEngineImpl = IMediaEngineImpl;

package/js/Private/impl/IAgoraMediaPlayerImpl.js

@@ -777,7 +777,7 @@ var IMediaPlayerImpl = /** @class */ (function () {
         return jsonResults.result;
     };
     IMediaPlayerImpl.prototype.getApiTypeFromSetPlayerOptionInInt = function (key, value) {
-        return 'MediaPlayer_setPlayerOptionInInt';
+        return 'MediaPlayer_setPlayerOption_4d05d29';
     };
     IMediaPlayerImpl.prototype.setPlayerOptionInString = function (key, value) {
         var apiType = this.getApiTypeFromSetPlayerOptionInString(key, value);
@@ -795,7 +795,7 @@ var IMediaPlayerImpl = /** @class */ (function () {
         return jsonResults.result;
     };
     IMediaPlayerImpl.prototype.getApiTypeFromSetPlayerOptionInString = function (key, value) {
-        return 'MediaPlayer_setPlayerOptionInString';
+        return 'MediaPlayer_setPlayerOption_ccad422';
     };
     return IMediaPlayerImpl;
 }());

package/js/Private/impl/IAgoraMusicContentCenterImpl.js

@@ -162,7 +162,7 @@ var IMusicPlayerImpl = /** @class */ (function (_super) {
     };
     IMusicPlayerImpl.prototype.getApiTypeFromOpenWithSongCode = function (songCode, startPos) {
         if (startPos === void 0) { startPos = 0; }
-        return 'MusicPlayer_openWithSongCode';
+        return 'MusicPlayer_open_303b92e';
     };
     return IMusicPlayerImpl;
 }(IAgoraMediaPlayerImpl_1.IMediaPlayerImpl));

package/js/Private/impl/IAgoraRtcEngineExImpl.js

@@ -961,6 +961,43 @@ var IRtcEngineExImpl = /** @class */ (function (_super) {
     IRtcEngineExImpl.prototype.getApiTypeFromSetParametersEx = function (connection, parameters) {
         return 'RtcEngineEx_setParametersEx_8225ea3';
     };
+    IRtcEngineExImpl.prototype.getCallIdEx = function (connection) {
+        var apiType = this.getApiTypeFromGetCallIdEx(connection);
+        var jsonParams = {
+            connection: connection,
+            toJSON: function () {
+                return {
+                    connection: connection,
+                };
+            },
+        };
+        var jsonResults = IrisApiEngine_1.callIrisApi.call(this, apiType, jsonParams);
+        var callId = jsonResults.callId;
+        return callId;
+    };
+    IRtcEngineExImpl.prototype.getApiTypeFromGetCallIdEx = function (connection) {
+        return 'RtcEngineEx_getCallIdEx_b13f7c4';
+    };
+    IRtcEngineExImpl.prototype.sendAudioMetadataEx = function (connection, metadata, length) {
+        var apiType = this.getApiTypeFromSendAudioMetadataEx(connection, metadata, length);
+        var jsonParams = {
+            connection: connection,
+            metadata: metadata,
+            length: length,
+            toJSON: function () {
+                return {
+                    connection: connection,
+                    metadata: metadata,
+                    length: length,
+                };
+            },
+        };
+        var jsonResults = IrisApiEngine_1.callIrisApi.call(this, apiType, jsonParams);
+        return jsonResults.result;
+    };
+    IRtcEngineExImpl.prototype.getApiTypeFromSendAudioMetadataEx = function (connection, metadata, length) {
+        return 'RtcEngineEx_sendAudioMetadataEx_e2bf1c4';
+    };
     return IRtcEngineExImpl;
 }(IAgoraRtcEngineImpl_1.IRtcEngineImpl));
 exports.IRtcEngineExImpl = IRtcEngineExImpl;