# API sunset notice (/en/api-reference/api-ref/rtc/api-sunset/macos) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). This page lists the deprecated and removed APIs in the SDK and their suggested alternatives. ## Deprecated APIs A deprecated API is expected to be officially removed in about one year from deprecation. Agora recommends using the alternate API as soon as possible to avoid impacting your online business. | Deprecated API | Description | Alternate API | Deprecating version | | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------ | | [`pushExternalAudioFrameSampleBuffer(_:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/pushexternalaudioframesamplebuffer%28_:%29) | Push external CMSampleBuffer audio frames. | [`pushExternalAudioFrameSampleBuffer(_:sampleRate:channels:trackId:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/pushexternalaudioframesamplebuffer%28_\:samplerate\:channels\:trackid:%29) | v4.3.1 | | [`enableDualStreamMode(_:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/enabledualstreammode%28_:%29) | Sets the dual-stream mode on the sender side. | [`setDualStreamMode(_:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/setdualstreammode%28_:%29) | v4.2.0 | | [`enableDualStreamMode(_:streamConfig:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/enabledualstreammode%28_\:streamconfig:%29) | Sets dual-stream mode configuration on the sender side. | [`setDualStreamMode(_:streamConfig:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/setdualstreammode%28_\:streamconfig:%29) | v4.2.0 | | [`enableDualStreamModeEx(_:streamConfig:connection:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/enabledualstreammodeex%28_\:streamconfig\:connection:%29) | Sets the dual-stream mode on the sender side. | [`setDualStreamModeEx(_:streamConfig:connection:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/setdualstreammodeex%28_\:streamconfig\:connection:%29) | v4.2.0 | | [`enableWebSdkInteroperability(_:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/enablewebsdkinteroperability%28_:%29) | Enables interoperability with the Agora Web SDK (applicable only in the live streaming use-cases). | - | v4.0.0 | | [`setLogFileSize(_:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/setlogfilesize%28_:%29) | Set the size of the log file output by the SDK. | Use the `logConfig` parameter in [`sharedEngine(with:delegate:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/sharedengine%28with\:delegate:%29) | v4.0.0 | | [`setExternalAudioSource(_:sampleRate:channels:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/setexternalaudiosource%28_\:samplerate\:channels:%29) | Set external audio acquisition parameters. | [`createCustomAudioTrack(_:config:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/createcustomaudiotrack%28_\:config:%29) | v4.0.0 | | [`setExternalAudioSource(_:sampleRate:channels:localPlayback:publish:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/setexternalaudiosource%28_\:samplerate\:channels\:localplayback\:publish:%29) | Set external audio acquisition parameters. | [`createCustomAudioTrack(_:config:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/createcustomaudiotrack%28_\:config:%29) | v4.0.0 | | [`createDataStreamEx(_:reliable:ordered:connection:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/createdatastreamex%28_\:reliable\:ordered\:connection:%29) | Create a data flow. | [`createDataStreamEx(_:config:connection:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/createdatastreamex%28_\:config\:connection:%29) | v4.0.0 | | [`setLocalVideoMirrorMode(_:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/setlocalvideomirrormode%28_:%29) | Set up local video mirroring. | [`setupLocalVideo(_:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/setuplocalvideo%28_:%29) or [`setLocalRenderMode(_:mirror:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/setlocalrendermode%28_\:mirror:%29) | v4.0.0 | | [`setLogFile(_:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/setlogfile%28_:%29) | Setting up log files. | Use the `logConfig` parameter in [`sharedEngine(with:delegate:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/sharedengine%28with\:delegate:%29) | v4.0.0 | | [`setAudioProfile(_:scenario:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/setaudioprofile%28_\:scenario:%29) | Set audio encoding properties and audio scene. | [`setAudioProfile(_:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/setaudioprofile%28_:%29) or [`setAudioScenario(_:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/setaudioscenario%28_:%29) | v4.0.0 | | [`preload(songCode:jsonOption:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agoramusiccontentcenter/preload%28songcode\:jsonoption:%29) | Preload music resources. | [`preload(songCode:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agoramusiccontentcenter/preload%28songcode:%29) | v4.0.0 | | [`addVideoWatermark(_:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/addvideowatermark%28_:%29) | Add local video watermark. | [`addVideoWatermark(_:options:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/addvideowatermark%28_\:options:%29) | v4.0.0 | ## Removed APIs The following APIs have been removed from the SDK. Please use the recommended alternative to implement related functions. | Removed API | Description | Alternate API | Deleting version | | :----------------------------------------------------------------------- | :------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------- | | `setVideoProfile(_:swapWidthAndHeight:)` | Set the video encoding configuration. | [`setVideoEncoderConfiguration(_:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/setvideoencoderconfiguration%28_:%29) | v4.4.0 | | `setRemoteRenderMode(_:mode:)` | Set the remote view display mode. | [`setRemoteRenderMode(_:mode:mirror:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/setremoterendermode%28_\:mode\:mirror:%29) | v4.4.0 | | `openWithCustomSource(atStartPos:withPlayerOnReadData:andPlayerOnSeek:)` | Open the custom media resource file. | [`open(with:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcmediaplayerprotocol/open%28with:%29) | v4.4.0 | | `setVideoQualityParameters(_:preferFrameRateOverImageQuality:)` | Set video optimization options (only available for live streaming). | Use the `degradationPreference` parameter in the [`AgoraVideoEncoderConfiguration`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agoravideoencoderconfiguration) class. | v4.4.0 | | `startEchoTest(_:)` | Start the voice call loop test. | [`startEchoTest(withConfig:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/startechotest%28withconfig:%29) | v4.4.0 | | `startEchoTestWithInterval(_:successBlock:)` | Start the voice call loop test. | [`startEchoTest(withConfig:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/startechotest%28withconfig:%29) | v4.4.0 | | `setEncryptionMode(_:)` | Enable the built-in encryption scheme. | [`enableEncryption(_:encryptionConfig:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/enableencryption%28_\:encryptionconfig:%29) | v4.4.0 | | `setEncryptionSecret(_:)` | Enable built-in encryption, and set a data encryption password. | [`enableEncryption(_:encryptionConfig:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agorartcenginekit/enableencryption%28_\:encryptionconfig:%29) | v4.4.0 | | `onEvent(provider:extension:key:value:)` | Plugin event callback. | [`onEventWithContext(_:key:value:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agoramediafiltereventdelegate/oneventwithcontext%28_\:key\:value:%29) | v4.4.0 | | `onExtensionStarted(provider:extension:)` | Plugin enable callback. | [`onExtensionStartedWithContext(_:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agoramediafiltereventdelegate/onextensionstartedwithcontext%28_:%29) | v4.4.0 | | `onExtensionStopped(provider:extension:)` | Plugin disable callback. | [`onExtensionStoppedWithContext(_:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agoramediafiltereventdelegate/onextensionstoppedwithcontext%28_:%29) | v4.4.0 | | `onExtensionError(provider:extension:error:message:)` | Plugin error callback. | [`onExtensionErrorWithContext(_:error:message:)`](https://api-ref.agora.io/en/video-sdk/macos/4.x/documentation/agorartckit/agoramediafiltereventdelegate/onextensionerrorwithcontext%28_\:error\:message:%29) | v4.4.0 |