agora-electron-sdk 4.4.0 → 4.5.0-dev.1

package/CHANGELOG.md

@@ -1,5 +1,7 @@
 
 
+# [4.5.0-dev.1](https://github.com/AgoraIO-Extensions/Electron-SDK/compare/v4.4.0...v4.5.0-dev.1) (2024-11-06)
+
 # [4.4.0](https://github.com/AgoraIO-Extensions/Electron-SDK/compare/v4.3.2...v4.4.0) (2024-08-29)
 
 

package/js/Private/AgoraBase.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SimulcastConfig = exports.StreamLayerConfig = exports.StreamLayerIndex = exports.SimulcastStreamConfig = exports.SimulcastStreamMode = exports.DataStreamConfig = exports.VideoEncoderConfiguration = exports.FocalLengthInfo = exports.CodecCapInfo = exports.CodecCapLevels = exports.CodecCapMask = exports.CameraFormatType = 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.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 = exports.RtcStats = exports.WatermarkOptions = exports.WatermarkRatio = exports.Rectangle = void 0;
-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.VoiceAiTunerType = 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.FaceShapeBeautyOptions = exports.FaceShapeBeautyStyle = exports.FaceShapeAreaOptions = exports.FaceShapeArea = exports.BeautyOptions = exports.LighteningContrastLevel = exports.VideoCanvas = exports.VideoViewSetupMode = exports.NetworkType = exports.WlAccStats = exports.WlaccSuggestAction = exports.WlaccMessageReason = exports.ClientRoleChangeFailedReason = exports.ConnectionChangedReasonType = exports.LastmileProbeResult = exports.LastmileProbeOneWayResult = exports.LastmileProbeResultState = exports.LastmileProbeConfig = 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 = exports.StreamPublishState = exports.StreamSubscribeState = exports.PermissionType = exports.UploadErrorReason = exports.EncryptionErrorType = exports.EncryptionConfig = exports.EncryptionMode = exports.DownlinkNetworkInfo = exports.PeerDownlinkInfo = void 0;
+exports.StreamLayerIndex = exports.SimulcastStreamConfig = exports.SimulcastStreamMode = exports.DataStreamConfig = exports.VideoEncoderConfiguration = exports.FocalLengthInfo = exports.CodecCapInfo = exports.CodecCapLevels = exports.CodecCapMask = exports.HdrCapability = exports.VideoModuleType = exports.CameraFormatType = 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.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 = exports.RtcStats = exports.WatermarkOptions = exports.WatermarkRatio = exports.Rectangle = exports.SimulcastConfig = exports.StreamLayerConfig = void 0;
+exports.AreaCodeEx = exports.AreaCode = exports.AudioEncodedFrameObserverConfig = exports.AudioRecordingConfiguration = exports.AudioEncodedFrameObserverPosition = exports.AudioFileRecordingType = exports.AudioRecordingQualityType = exports.ScreenCaptureParameters = exports.VoiceAiTunerType = 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.FilterEffectOptions = exports.FaceShapeBeautyOptions = exports.FaceShapeBeautyStyle = exports.FaceShapeAreaOptions = exports.FaceShapeArea = exports.BeautyOptions = exports.LighteningContrastLevel = exports.VideoCanvas = exports.VideoViewSetupMode = exports.NetworkType = exports.WlAccStats = exports.WlaccSuggestAction = exports.WlaccMessageReason = exports.ClientRoleChangeFailedReason = exports.ConnectionChangedReasonType = exports.LastmileProbeResult = exports.LastmileProbeOneWayResult = exports.LastmileProbeResultState = exports.LastmileProbeConfig = exports.LocalAudioMixerConfiguration = exports.MixedAudioStream = exports.VideoTranscoderError = exports.LocalTranscoderConfiguration = void 0;
+exports.VideoLayout = exports.SpatialAudioParams = exports.RecorderStreamInfo = exports.RecorderStreamType = 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 = 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 = void 0;
 require("./extension/AgoraBaseExtension");
 /**
  * The channel profile.
@@ -622,7 +622,7 @@ var QualityType;
      */
     QualityType[QualityType["QualityUnsupported"] = 7] = "QualityUnsupported";
     /**
-     * 8: Detecting the network quality.
+     * 8: The last-mile network probe test is in progress.
      */
     QualityType[QualityType["QualityDetecting"] = 8] = "QualityDetecting";
 })(QualityType = exports.QualityType || (exports.QualityType = {}));
@@ -771,6 +771,10 @@ var OrientationMode;
  */
 var DegradationPreference;
 (function (DegradationPreference) {
+    /**
+     * @ignore
+     */
+    DegradationPreference[DegradationPreference["MaintainAuto"] = -1] = "MaintainAuto";
     /**
      * 0: (Default) Prefers to reduce the video frame rate while maintaining video resolution during video encoding under limited bandwidth. This degradation preference is suitable for scenarios where video quality is prioritized.
      */
@@ -1133,6 +1137,10 @@ exports.EncodedVideoFrameInfo = EncodedVideoFrameInfo;
  */
 var CompressionPreference;
 (function (CompressionPreference) {
+    /**
+     * @ignore
+     */
+    CompressionPreference[CompressionPreference["PreferCompressionAuto"] = -1] = "PreferCompressionAuto";
     /**
      * 0: Low latency preference. The SDK compresses video frames to reduce latency. This preference is suitable for scenarios where smoothness is prioritized and reduced video quality is acceptable.
      */
@@ -1200,6 +1208,54 @@ var CameraFormatType;
      */
     CameraFormatType[CameraFormatType["CameraFormatBgra"] = 1] = "CameraFormatBgra";
 })(CameraFormatType = exports.CameraFormatType || (exports.CameraFormatType = {}));
+/**
+ * @ignore
+ */
+var VideoModuleType;
+(function (VideoModuleType) {
+    /**
+     * @ignore
+     */
+    VideoModuleType[VideoModuleType["VideoModuleCapturer"] = 0] = "VideoModuleCapturer";
+    /**
+     * @ignore
+     */
+    VideoModuleType[VideoModuleType["VideoModuleSoftwareEncoder"] = 1] = "VideoModuleSoftwareEncoder";
+    /**
+     * @ignore
+     */
+    VideoModuleType[VideoModuleType["VideoModuleHardwareEncoder"] = 2] = "VideoModuleHardwareEncoder";
+    /**
+     * @ignore
+     */
+    VideoModuleType[VideoModuleType["VideoModuleSoftwareDecoder"] = 3] = "VideoModuleSoftwareDecoder";
+    /**
+     * @ignore
+     */
+    VideoModuleType[VideoModuleType["VideoModuleHardwareDecoder"] = 4] = "VideoModuleHardwareDecoder";
+    /**
+     * @ignore
+     */
+    VideoModuleType[VideoModuleType["VideoModuleRenderer"] = 5] = "VideoModuleRenderer";
+})(VideoModuleType = exports.VideoModuleType || (exports.VideoModuleType = {}));
+/**
+ * @ignore
+ */
+var HdrCapability;
+(function (HdrCapability) {
+    /**
+     * @ignore
+     */
+    HdrCapability[HdrCapability["HdrCapabilityUnknown"] = -1] = "HdrCapabilityUnknown";
+    /**
+     * @ignore
+     */
+    HdrCapability[HdrCapability["HdrCapabilityUnsupported"] = 0] = "HdrCapabilityUnsupported";
+    /**
+     * @ignore
+     */
+    HdrCapability[HdrCapability["HdrCapabilitySupported"] = 1] = "HdrCapabilitySupported";
+})(HdrCapability = exports.HdrCapability || (exports.HdrCapability = {}));
 /**
  * The bit mask of the codec type.
  */
@@ -1617,6 +1673,10 @@ var VideoApplicationScenarioType;
      * ApplicationScenario1v1 (2) is suitable for 1v1 video call scenarios. To meet the requirements for low latency and high-quality video in this scenario, the SDK optimizes its strategies, improving performance in terms of video quality, first frame rendering, latency on mid-to-low-end devices, and smoothness under weak network conditions. 2: 1v1 video call scenario.
      */
     VideoApplicationScenarioType[VideoApplicationScenarioType["ApplicationScenario1v1"] = 2] = "ApplicationScenario1v1";
+    /**
+     * @ignore
+     */
+    VideoApplicationScenarioType[VideoApplicationScenarioType["ApplicationScenarioLiveshow"] = 3] = "ApplicationScenarioLiveshow";
 })(VideoApplicationScenarioType = exports.VideoApplicationScenarioType || (exports.VideoApplicationScenarioType = {}));
 /**
  * @ignore
@@ -2441,6 +2501,18 @@ var VideoTranscoderError;
      */
     VideoTranscoderError[VideoTranscoderError["VtErrInternal"] = 20] = "VtErrInternal";
 })(VideoTranscoderError = exports.VideoTranscoderError || (exports.VideoTranscoderError = {}));
+/**
+ * @ignore
+ */
+class MixedAudioStream {
+}
+exports.MixedAudioStream = MixedAudioStream;
+/**
+ * @ignore
+ */
+class LocalAudioMixerConfiguration {
+}
+exports.LocalAudioMixerConfiguration = LocalAudioMixerConfiguration;
 /**
  * Configurations of the last-mile network test.
  */
@@ -2829,6 +2901,12 @@ var FaceShapeBeautyStyle;
 class FaceShapeBeautyOptions {
 }
 exports.FaceShapeBeautyOptions = FaceShapeBeautyOptions;
+/**
+ * @ignore
+ */
+class FilterEffectOptions {
+}
+exports.FilterEffectOptions = FilterEffectOptions;
 /**
  * The low-light enhancement mode.
  */
@@ -2890,10 +2968,6 @@ var VideoDenoiserLevel;
      * 1: Promotes reducing performance consumption during video noise reduction. prioritizes reducing performance consumption over video noise reduction quality. The performance consumption is lower, and the video noise reduction speed is faster. To avoid a noticeable shadowing effect (shadows trailing behind moving objects) in the processed video, Agora recommends that you use this settinging when the camera is fixed.
      */
     VideoDenoiserLevel[VideoDenoiserLevel["VideoDenoiserLevelFast"] = 1] = "VideoDenoiserLevelFast";
-    /**
-     * 2: Enhanced video noise reduction. prioritizes video noise reduction quality over reducing performance consumption. The performance consumption is higher, the video noise reduction speed is slower, and the video noise reduction quality is better. If VideoDenoiserLevelHighQuality is not enough for your video noise reduction needs, you can use this enumerator.
-     */
-    VideoDenoiserLevel[VideoDenoiserLevel["VideoDenoiserLevelStrength"] = 2] = "VideoDenoiserLevelStrength";
 })(VideoDenoiserLevel = exports.VideoDenoiserLevel || (exports.VideoDenoiserLevel = {}));
 /**
  * Video noise reduction options.
@@ -2913,7 +2987,7 @@ exports.ColorEnhanceOptions = ColorEnhanceOptions;
 var BackgroundSourceType;
 (function (BackgroundSourceType) {
     /**
-     * 0: Process the background as alpha data without replacement, only separating the portrait and the background. After setting this value, you can call startLocalVideoTranscoder to implement the picture-in-picture effect.
+     * @ignore
      */
     BackgroundSourceType[BackgroundSourceType["BackgroundNone"] = 0] = "BackgroundNone";
     /**
@@ -3865,6 +3939,20 @@ exports.AdvancedConfigInfo = AdvancedConfigInfo;
 class LocalAccessPointConfiguration {
 }
 exports.LocalAccessPointConfiguration = LocalAccessPointConfiguration;
+/**
+ * @ignore
+ */
+var RecorderStreamType;
+(function (RecorderStreamType) {
+    /**
+     * @ignore
+     */
+    RecorderStreamType[RecorderStreamType["Rtc"] = 0] = "Rtc";
+    /**
+     * @ignore
+     */
+    RecorderStreamType[RecorderStreamType["Preview"] = 1] = "Preview";
+})(RecorderStreamType = exports.RecorderStreamType || (exports.RecorderStreamType = {}));
 /**
  * @ignore
  */

package/js/Private/AgoraMediaBase.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RecorderInfo = exports.MediaRecorderConfiguration = exports.RecorderReasonCode = exports.RecorderState = exports.MediaRecorderStreamType = exports.MediaRecorderContainerFormat = exports.ExternalVideoSourceType = exports.VideoFrameProcessMode = exports.UserAudioSpectrumInfo = exports.AudioSpectrumData = exports.AudioParams = exports.AudioFramePosition = exports.AudioFrame = exports.AudioFrameType = exports.VideoModulePosition = exports.MediaPlayerSourceType = exports.VideoFrame = exports.ExternalVideoFrame = exports.VideoBufferType = exports.EglContextType = exports.AlphaStitchMode = exports.Hdr10MetadataInfo = exports.ColorSpace = exports.TransferID = exports.MatrixID = exports.RangeID = exports.PrimaryID = exports.IVideoFrameMetaInfo = exports.MetaInfoKey = exports.CameraVideoSourceType = exports.RenderModeType = exports.VideoPixelFormat = exports.AudioDualMonoMode = exports.AudioPcmFrame = exports.AudioEncodedFrameInfo = exports.PacketOptions = exports.ContentInspectConfig = exports.ContentInspectModule = exports.ContentInspectType = exports.ContentInspectResult = exports.MediaSourceType = exports.RawAudioFrameOpModeType = exports.AudioParameters = exports.BytesPerSample = exports.AudioRoute = exports.VideoSourceType = exports.ExtensionContext = void 0;
+exports.RecorderInfo = exports.MediaRecorderConfiguration = exports.RecorderReasonCode = exports.RecorderState = exports.MediaRecorderStreamType = exports.MediaRecorderContainerFormat = exports.ExternalVideoSourceType = exports.VideoFrameProcessMode = exports.UserAudioSpectrumInfo = exports.AudioSpectrumData = exports.AudioParams = exports.AudioFramePosition = exports.AudioFrame = exports.AudioFrameType = exports.SnapshotConfig = exports.VideoModulePosition = exports.MediaPlayerSourceType = exports.VideoFrame = exports.ExternalVideoFrame = exports.VideoBufferType = exports.EglContextType = exports.AlphaStitchMode = exports.Hdr10MetadataInfo = exports.ColorSpace = exports.TransferID = exports.MatrixID = exports.RangeID = exports.PrimaryID = exports.IVideoFrameMetaInfo = exports.MetaInfoKey = exports.CameraVideoSourceType = exports.RenderModeType = exports.VideoPixelFormat = exports.AudioDualMonoMode = exports.AudioPcmFrame = exports.AudioEncodedFrameInfo = exports.PacketOptions = exports.ContentInspectConfig = exports.ContentInspectModule = exports.ContentInspectType = exports.ContentInspectResult = exports.MediaSourceType = exports.RawAudioFrameOpModeType = exports.AudioParameters = exports.BytesPerSample = exports.AudioRoute = exports.AudioSourceType = exports.VideoSourceType = exports.ExtensionContext = void 0;
 require("./extension/AgoraMediaBaseExtension");
 /**
  * The context information of the extension.
@@ -90,6 +90,44 @@ var VideoSourceType;
      */
     VideoSourceType[VideoSourceType["VideoSourceUnknown"] = 100] = "VideoSourceUnknown";
 })(VideoSourceType = exports.VideoSourceType || (exports.VideoSourceType = {}));
+/**
+ * @ignore
+ */
+var AudioSourceType;
+(function (AudioSourceType) {
+    /**
+     * @ignore
+     */
+    AudioSourceType[AudioSourceType["AudioSourceMicrophone"] = 0] = "AudioSourceMicrophone";
+    /**
+     * @ignore
+     */
+    AudioSourceType[AudioSourceType["AudioSourceCustom"] = 1] = "AudioSourceCustom";
+    /**
+     * @ignore
+     */
+    AudioSourceType[AudioSourceType["AudioSourceMediaPlayer"] = 2] = "AudioSourceMediaPlayer";
+    /**
+     * @ignore
+     */
+    AudioSourceType[AudioSourceType["AudioSourceLoopbackRecording"] = 3] = "AudioSourceLoopbackRecording";
+    /**
+     * @ignore
+     */
+    AudioSourceType[AudioSourceType["AudioSourceMixedStream"] = 4] = "AudioSourceMixedStream";
+    /**
+     * @ignore
+     */
+    AudioSourceType[AudioSourceType["AudioSourceRemoteUser"] = 5] = "AudioSourceRemoteUser";
+    /**
+     * @ignore
+     */
+    AudioSourceType[AudioSourceType["AudioSourceRemoteChannel"] = 6] = "AudioSourceRemoteChannel";
+    /**
+     * @ignore
+     */
+    AudioSourceType[AudioSourceType["AudioSourceUnknown"] = 100] = "AudioSourceUnknown";
+})(AudioSourceType = exports.AudioSourceType || (exports.AudioSourceType = {}));
 /**
  * The type of the audio route.
  */
@@ -788,6 +826,12 @@ var VideoModulePosition;
      */
     VideoModulePosition[VideoModulePosition["PositionPostCapturerOrigin"] = 8] = "PositionPostCapturerOrigin";
 })(VideoModulePosition = exports.VideoModulePosition || (exports.VideoModulePosition = {}));
+/**
+ * @ignore
+ */
+class SnapshotConfig {
+}
+exports.SnapshotConfig = SnapshotConfig;
 /**
  * Audio frame type.
  */

package/js/Private/IAgoraRtcEngine.js

@@ -91,6 +91,10 @@ var AudioMixingReasonType;
      * 724: Successfully call stopAudioMixing to stop playing the music file.
      */
     AudioMixingReasonType[AudioMixingReasonType["AudioMixingReasonStoppedByUser"] = 724] = "AudioMixingReasonStoppedByUser";
+    /**
+     * @ignore
+     */
+    AudioMixingReasonType[AudioMixingReasonType["AudioMixingReasonResumedByUser"] = 726] = "AudioMixingReasonResumedByUser";
     /**
      * 0: The SDK opens music file successfully.
      */
@@ -655,6 +659,10 @@ var MediaDeviceStateType;
      * 2: The device is disabled.
      */
     MediaDeviceStateType[MediaDeviceStateType["MediaDeviceStateDisabled"] = 2] = "MediaDeviceStateDisabled";
+    /**
+     * @ignore
+     */
+    MediaDeviceStateType[MediaDeviceStateType["MediaDeviceStatePluggedIn"] = 3] = "MediaDeviceStatePluggedIn";
     /**
      * 4: The device is not found.
      */

package/js/Private/impl/IAgoraMediaEngineImpl.js

@@ -117,6 +117,22 @@ class IMediaEngineImpl {
     getApiTypeFromSetExternalVideoSource(enabled, useTexture, sourceType = AgoraMediaBase_1.ExternalVideoSourceType.VideoFrame, encodedVideoOption = new AgoraBase_1.SenderOptions()) {
         return 'MediaEngine_setExternalVideoSource_fff99b6';
     }
+    setExternalRemoteEglContext(eglContext) {
+        const apiType = this.getApiTypeFromSetExternalRemoteEglContext(eglContext);
+        const jsonParams = {
+            eglContext: eglContext,
+            toJSON: () => {
+                return {
+                    eglContext: eglContext,
+                };
+            },
+        };
+        const jsonResults = IrisApiEngine_1.callIrisApi.call(this, apiType, jsonParams);
+        return jsonResults.result;
+    }
+    getApiTypeFromSetExternalRemoteEglContext(eglContext) {
+        return 'MediaEngine_setExternalRemoteEglContext_f337cbf';
+    }
     setExternalAudioSource(enabled, sampleRate, channels, localPlayback = false, publish = true) {
         const apiType = this.getApiTypeFromSetExternalAudioSource(enabled, sampleRate, channels, localPlayback, publish);
         const jsonParams = {

package/js/Private/impl/IAgoraRtcEngineExImpl.js

@@ -42,6 +42,26 @@ class IRtcEngineExImpl extends IAgoraRtcEngineImpl_1.IRtcEngineImpl {
     getApiTypeFromLeaveChannelEx(connection, options) {
         return 'RtcEngineEx_leaveChannelEx_b03ee9a';
     }
+    leaveChannelWithUserAccountEx(channelId, userAccount, options) {
+        const apiType = this.getApiTypeFromLeaveChannelWithUserAccountEx(channelId, userAccount, options);
+        const jsonParams = {
+            channelId: channelId,
+            userAccount: userAccount,
+            options: options,
+            toJSON: () => {
+                return {
+                    channelId: channelId,
+                    userAccount: userAccount,
+                    options: options,
+                };
+            },
+        };
+        const jsonResults = IrisApiEngine_1.callIrisApi.call(this, apiType, jsonParams);
+        return jsonResults.result;
+    }
+    getApiTypeFromLeaveChannelWithUserAccountEx(channelId, userAccount, options) {
+        return 'RtcEngineEx_leaveChannelWithUserAccountEx_8bbe372';
+    }
     updateChannelMediaOptionsEx(options, connection) {
         const apiType = this.getApiTypeFromUpdateChannelMediaOptionsEx(options, connection);
         const jsonParams = {
@@ -997,6 +1017,26 @@ class IRtcEngineExImpl extends IAgoraRtcEngineImpl_1.IRtcEngineImpl {
     getApiTypeFromSendAudioMetadataEx(connection, metadata, length) {
         return 'RtcEngineEx_sendAudioMetadataEx_e2bf1c4';
     }
+    takeSnapshotWithConfigEx(connection, uid, config) {
+        const apiType = this.getApiTypeFromTakeSnapshotWithConfigEx(connection, uid, config);
+        const jsonParams = {
+            connection: connection,
+            uid: uid,
+            config: config,
+            toJSON: () => {
+                return {
+                    connection: connection,
+                    uid: uid,
+                    config: config,
+                };
+            },
+        };
+        const jsonResults = IrisApiEngine_1.callIrisApi.call(this, apiType, jsonParams);
+        return jsonResults.result;
+    }
+    getApiTypeFromTakeSnapshotWithConfigEx(connection, uid, config) {
+        return 'RtcEngineEx_takeSnapshotEx_b856417';
+    }
 }
 exports.IRtcEngineExImpl = IRtcEngineExImpl;
 const IrisApiEngine_1 = require("../internal/IrisApiEngine");

package/js/Private/impl/IAgoraRtcEngineImpl.js

@@ -107,7 +107,7 @@ function processIRtcEngineEventHandler(handler, event, jsonParams) {
             break;
         case 'onFirstLocalVideoFramePublished':
             if (handler.onFirstLocalVideoFramePublished !== undefined) {
-                handler.onFirstLocalVideoFramePublished(jsonParams.source, jsonParams.elapsed);
+                handler.onFirstLocalVideoFramePublished(jsonParams.connection, jsonParams.elapsed);
             }
             break;
         case 'onFirstRemoteVideoDecoded':
@@ -1069,6 +1069,26 @@ class IRtcEngineImpl {
     getApiTypeFromGetFaceShapeAreaOptions(shapeArea, type = AgoraMediaBase_1.MediaSourceType.PrimaryCameraSource) {
         return 'RtcEngine_getFaceShapeAreaOptions_0783e2c';
     }
+    setFilterEffectOptions(enabled, options, type = AgoraMediaBase_1.MediaSourceType.PrimaryCameraSource) {
+        const apiType = this.getApiTypeFromSetFilterEffectOptions(enabled, options, type);
+        const jsonParams = {
+            enabled: enabled,
+            options: options,
+            type: type,
+            toJSON: () => {
+                return {
+                    enabled: enabled,
+                    options: options,
+                    type: type,
+                };
+            },
+        };
+        const jsonResults = IrisApiEngine_1.callIrisApi.call(this, apiType, jsonParams);
+        return jsonResults.result;
+    }
+    getApiTypeFromSetFilterEffectOptions(enabled, options, type = AgoraMediaBase_1.MediaSourceType.PrimaryCameraSource) {
+        return 'RtcEngine_setFilterEffectOptions_53b4be3';
+    }
     setLowlightEnhanceOptions(enabled, options, type = AgoraMediaBase_1.MediaSourceType.PrimaryCameraSource) {
         const apiType = this.getApiTypeFromSetLowlightEnhanceOptions(enabled, options, type);
         const jsonParams = {
@@ -2571,6 +2591,40 @@ class IRtcEngineImpl {
     getApiTypeFromSetRemoteRenderMode(uid, renderMode, mirrorMode) {
         return 'RtcEngine_setRemoteRenderMode_6771ce0';
     }
+    setLocalRenderTargetFps(sourceType, targetFps) {
+        const apiType = this.getApiTypeFromSetLocalRenderTargetFps(sourceType, targetFps);
+        const jsonParams = {
+            sourceType: sourceType,
+            targetFps: targetFps,
+            toJSON: () => {
+                return {
+                    sourceType: sourceType,
+                    targetFps: targetFps,
+                };
+            },
+        };
+        const jsonResults = IrisApiEngine_1.callIrisApi.call(this, apiType, jsonParams);
+        return jsonResults.result;
+    }
+    getApiTypeFromSetLocalRenderTargetFps(sourceType, targetFps) {
+        return 'RtcEngine_setLocalRenderTargetFps_2ad83d8';
+    }
+    setRemoteRenderTargetFps(targetFps) {
+        const apiType = this.getApiTypeFromSetRemoteRenderTargetFps(targetFps);
+        const jsonParams = {
+            targetFps: targetFps,
+            toJSON: () => {
+                return {
+                    targetFps: targetFps,
+                };
+            },
+        };
+        const jsonResults = IrisApiEngine_1.callIrisApi.call(this, apiType, jsonParams);
+        return jsonResults.result;
+    }
+    getApiTypeFromSetRemoteRenderTargetFps(targetFps) {
+        return 'RtcEngine_setRemoteRenderTargetFps_46f8ab7';
+    }
     setLocalVideoMirrorMode(mirrorMode) {
         const apiType = this.getApiTypeFromSetLocalVideoMirrorMode(mirrorMode);
         const jsonParams = {
@@ -3585,7 +3639,7 @@ class IRtcEngineImpl {
         return jsonResults.result;
     }
     getApiTypeFromStartScreenCaptureByDisplayId(displayId, regionRect, captureParams) {
-        return 'RtcEngine_startScreenCaptureByDisplayId_7cf6800';
+        return 'RtcEngine_startScreenCaptureByDisplayId_ce89867';
     }
     startScreenCaptureByScreenRect(screenRect, regionRect, captureParams) {
         const apiType = this.getApiTypeFromStartScreenCaptureByScreenRect(screenRect, regionRect, captureParams);
@@ -3635,7 +3689,7 @@ class IRtcEngineImpl {
         return jsonResults.result;
     }
     getApiTypeFromStartScreenCaptureByWindowId(windowId, regionRect, captureParams) {
-        return 'RtcEngine_startScreenCaptureByWindowId_5ab7e59';
+        return 'RtcEngine_startScreenCaptureByWindowId_ce89867';
     }
     setScreenCaptureContentHint(contentHint) {
         const apiType = this.getApiTypeFromSetScreenCaptureContentHint(contentHint);
@@ -3740,6 +3794,22 @@ class IRtcEngineImpl {
     getApiTypeFromQueryCameraFocalLengthCapability() {
         return 'RtcEngine_queryCameraFocalLengthCapability_2dee6af';
     }
+    setExternalMediaProjection(mediaProjection) {
+        const apiType = this.getApiTypeFromSetExternalMediaProjection(mediaProjection);
+        const jsonParams = {
+            mediaProjection: mediaProjection,
+            toJSON: () => {
+                return {
+                    mediaProjection: mediaProjection,
+                };
+            },
+        };
+        const jsonResults = IrisApiEngine_1.callIrisApi.call(this, apiType, jsonParams);
+        return jsonResults.result;
+    }
+    getApiTypeFromSetExternalMediaProjection(mediaProjection) {
+        return 'RtcEngine_setExternalMediaProjection_f337cbf';
+    }
     setScreenCaptureScenario(screenScenario) {
         const apiType = this.getApiTypeFromSetScreenCaptureScenario(screenScenario);
         const jsonParams = {
@@ -3920,6 +3990,47 @@ class IRtcEngineImpl {
     getApiTypeFromStopLocalVideoTranscoder() {
         return 'RtcEngine_stopLocalVideoTranscoder';
     }
+    startLocalAudioMixer(config) {
+        const apiType = this.getApiTypeFromStartLocalAudioMixer(config);
+        const jsonParams = {
+            config: config,
+            toJSON: () => {
+                return {
+                    config: config,
+                };
+            },
+        };
+        const jsonResults = IrisApiEngine_1.callIrisApi.call(this, apiType, jsonParams);
+        return jsonResults.result;
+    }
+    getApiTypeFromStartLocalAudioMixer(config) {
+        return 'RtcEngine_startLocalAudioMixer_a7ff78e';
+    }
+    updateLocalAudioMixerConfiguration(config) {
+        const apiType = this.getApiTypeFromUpdateLocalAudioMixerConfiguration(config);
+        const jsonParams = {
+            config: config,
+            toJSON: () => {
+                return {
+                    config: config,
+                };
+            },
+        };
+        const jsonResults = IrisApiEngine_1.callIrisApi.call(this, apiType, jsonParams);
+        return jsonResults.result;
+    }
+    getApiTypeFromUpdateLocalAudioMixerConfiguration(config) {
+        return 'RtcEngine_updateLocalAudioMixerConfiguration_a7ff78e';
+    }
+    stopLocalAudioMixer() {
+        const apiType = this.getApiTypeFromStopLocalAudioMixer();
+        const jsonParams = {};
+        const jsonResults = IrisApiEngine_1.callIrisApi.call(this, apiType, jsonParams);
+        return jsonResults.result;
+    }
+    getApiTypeFromStopLocalAudioMixer() {
+        return 'RtcEngine_stopLocalAudioMixer';
+    }
     startCameraCapture(sourceType, config) {
         const apiType = this.getApiTypeFromStartCameraCapture(sourceType, config);
         const jsonParams = {
@@ -4813,6 +4924,23 @@ class IRtcEngineImpl {
     getApiTypeFromSendAudioMetadata(metadata, length) {
         return 'RtcEngine_sendAudioMetadata_878f309';
     }
+    queryHDRCapability(videoModule) {
+        const apiType = this.getApiTypeFromQueryHDRCapability(videoModule);
+        const jsonParams = {
+            videoModule: videoModule,
+            toJSON: () => {
+                return {
+                    videoModule: videoModule,
+                };
+            },
+        };
+        const jsonResults = IrisApiEngine_1.callIrisApi.call(this, apiType, jsonParams);
+        const capability = jsonResults.capability;
+        return capability;
+    }
+    getApiTypeFromQueryHDRCapability(videoModule) {
+        return 'RtcEngine_queryHDRCapability_bebdacb';
+    }
     startScreenCaptureBySourceType(sourceType, config) {
         const apiType = this.getApiTypeFromStartScreenCaptureBySourceType(sourceType, config);
         const jsonParams = {
@@ -5016,6 +5144,24 @@ class IRtcEngineImpl {
     getApiTypeFromGetNativeHandle() {
         return 'RtcEngine_getNativeHandle';
     }
+    takeSnapshotWithConfig(uid, config) {
+        const apiType = this.getApiTypeFromTakeSnapshotWithConfig(uid, config);
+        const jsonParams = {
+            uid: uid,
+            config: config,
+            toJSON: () => {
+                return {
+                    uid: uid,
+                    config: config,
+                };
+            },
+        };
+        const jsonResults = IrisApiEngine_1.callIrisApi.call(this, apiType, jsonParams);
+        return jsonResults.result;
+    }
+    getApiTypeFromTakeSnapshotWithConfig(uid, config) {
+        return 'RtcEngine_takeSnapshot_5669ea6';
+    }
 }
 exports.IRtcEngineImpl = IRtcEngineImpl;
 const IrisApiEngine_1 = require("../internal/IrisApiEngine");

package/js/Private/ti/IAgoraRtcEngine-ti.js

@@ -50,7 +50,7 @@ exports.IRtcEngineEventHandler = t.iface([], {
     "onDownlinkNetworkInfoUpdated": t.opt(t.func("void", t.param("info", "DownlinkNetworkInfo"))),
     "onLastmileQuality": t.opt(t.func("void", t.param("quality", "QualityType"))),
     "onFirstLocalVideoFrame": t.opt(t.func("void", t.param("source", "VideoSourceType"), t.param("width", "number"), t.param("height", "number"), t.param("elapsed", "number"))),
-    "onFirstLocalVideoFramePublished": t.opt(t.func("void", t.param("source", "VideoSourceType"), t.param("elapsed", "number"))),
+    "onFirstLocalVideoFramePublished": t.opt(t.func("void", t.param("connection", "RtcConnection"), t.param("elapsed", "number"))),
     "onFirstRemoteVideoDecoded": t.opt(t.func("void", t.param("connection", "RtcConnection"), t.param("remoteUid", "number"), t.param("width", "number"), t.param("height", "number"), t.param("elapsed", "number"))),
     "onVideoSizeChanged": t.opt(t.func("void", t.param("connection", "RtcConnection"), t.param("sourceType", "VideoSourceType"), t.param("uid", "number"), t.param("width", "number"), t.param("height", "number"), t.param("rotation", "number"))),
     "onLocalVideoStateChanged": t.opt(t.func("void", t.param("source", "VideoSourceType"), t.param("state", "LocalVideoStreamState"), t.param("reason", "LocalVideoStreamReason"))),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agora-electron-sdk",
-  "version": "4.4.0",
+  "version": "4.5.0-dev.1",
   "description": "agora-electron-sdk",
   "main": "js/AgoraSdk",
   "types": "types/AgoraSdk.d.ts",
@@ -16,7 +16,7 @@
     "!**/__tests__"
   ],
   "scripts": {
-    "postinstall": "yarn checkElectron",
+    "postinstall": "npm run checkElectron",
     "totalBuild": "cross-env-shell gulp totalBuild \\\"--INIT_CWD=$INIT_CWD\\\"",
     "build": "cross-env-shell gulp build \\\"--INIT_CWD=$INIT_CWD\\\"",
     "clean": "cross-env-shell gulp clean \\\"--INIT_CWD=$INIT_CWD\\\"",
@@ -142,9 +142,9 @@
     "yuv-canvas": "1.2.6"
   },
   "agora_electron": {
-    "iris_sdk_win": "https://download.agora.io/sdk/release/iris_4.4.0-build.6_DCG_Windows_Video_Standalone_20240823_1146_504.zip",
-    "iris_sdk_mac": "https://download.agora.io/sdk/release/iris_4.4.0-build.6_DCG_Mac_Video_Standalone_20240823_1146_468.zip",
-    "native_sdk_win": "https://download.agora.io/sdk/release/Agora_Native_SDK_for_Windows_v4.4.0_FULL.zip",
-    "native_sdk_mac": "https://download.agora.io/sdk/release/Agora_Native_SDK_for_Mac_v4.4.0_FULL.zip"
+    "iris_sdk_win": "https://download.agora.io/sdk/release/iris_4.5.0-dev.12_DCG_Windows_Video_Standalone_20241106_1153_560.zip",
+    "iris_sdk_mac": "https://download.agora.io/sdk/release/iris_4.5.0-dev.12_DCG_Mac_Video_Standalone_20241106_1153_521.zip",
+    "native_sdk_win": "https://download.agora.io/sdk/release/AgoraRtcEngine_windows_Preview_4.5.0-dev.12.zip",
+    "native_sdk_mac": "https://download.agora.io/sdk/release/AgoraRtcEngine_macOS_Preview_4.5.0-dev.12.zip"
   }
 }