# API 下架说明 (/zh-CN/api-reference/rtc/android/rtc-api-sunset)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

## 已废弃 API [#已废弃-api]

废弃后的 API 预计会在 1 年左右正式下架。声网建议你尽快使用推荐的 API 进行替换，以免影响线上业务。

| API | 描述 | 替代 API | 废弃版本 |
| --- | --- | --- | --- |
| setDirectCdnStreamingAudioConfiguration | 设置直接向 CDN 推流的音频配置。 | 请改用[服务端旁路推流功能](/zh-CN/realtime-media/media-push)。 | v4.6.0 |
| setDirectCdnStreamingVideoConfiguration | 设置直接向 CDN 推流的视频配置。 | 请改用[服务端旁路推流功能](/zh-CN/realtime-media/media-push)。 | v4.6.0 |
| startDirectCdnStreaming | 开始直接向 CDN 推流。 | 请改用[服务端旁路推流功能](/zh-CN/realtime-media/media-push)。 | v4.6.0 |
| stopDirectCdnStreaming | 停止直接向 CDN 推流。 | 请改用[服务端旁路推流功能](/zh-CN/realtime-media/media-push)。 | v4.6.0 |
| DirectCdnStreamingMediaOptions | 直接向 CDN 推流的媒体选项。 | 请改用[服务端旁路推流功能](/zh-CN/realtime-media/media-push)。 | v4.6.0 |
| DirectCdnStreamingStats | 直接向 CDN 推流的统计信息。 | 请改用[服务端旁路推流功能](/zh-CN/realtime-media/media-push)。 | v4.6.0 |
| DirectCdnStreamingState | 直接向 CDN 推流的状态。 | 请改用[服务端旁路推流功能](/zh-CN/realtime-media/media-push)。 | v4.6.0 |
| DirectCdnStreamingReason | 直接向 CDN 推流状态变化的原因。 | 请改用[服务端旁路推流功能](/zh-CN/realtime-media/media-push)。 | v4.6.0 |
| [startRhythmPlayer](/zh-CN/api-reference/rtc/android/play/rhythmplayer#api_irtcengine_startrhythmplayer) | 启用虚拟节拍器。 | - | v4.6.0 |
| [configRhythmPlayer](/zh-CN/api-reference/rtc/android/play/rhythmplayer#api_irtcengine_configrhythmplayer) | 配置虚拟节拍器。 | - | v4.6.0 |
| [onRhythmPlayerStateChanged](/zh-CN/api-reference/rtc/android/play/rhythmplayer#callback_irtcengineeventhandler_onrhythmplayerstatechanged) | 虚拟节拍器状态发生变化回调。 | - | v4.6.0 |
| [addVideoWatermarkEx [1/2]](/zh-CN/api-reference/rtc/android/video/video-prenpro/watermark#api_irtcengineex_addvideowatermarkex) | 向本地视频添加水印图像。 | 请改用 [addVideoWatermarkEx [2/2]](/zh-CN/api-reference/rtc/android/video/video-prenpro/watermark#api_irtcengineex_addvideowatermarkex1) | v4.6.0 |
| [setRemoteSubscribeFallbackOption [1/2]](/zh-CN/api-reference/rtc/android/network#api_irtcengine_setremotesubscribefallbackoption) | 根据网络状况设置订阅端的视频流回退选项。 | [setRemoteSubscribeFallbackOption [2/2]](/zh-CN/api-reference/rtc/android/network#api_irtcengine_setremotesubscribefallbackoption2) | v4.4.0 |
| [setRemoteVideoStreamType [1/2]](/zh-CN/api-reference/rtc/android/publishnsubscribe#api_irtcengine_setremotevideostreamtype) | 设置要订阅的视频流类型。 | [setRemoteVideoStreamType [2/2]](/zh-CN/api-reference/rtc/android/publishnsubscribe#api_irtcengine_setremotevideostreamtype2) | v4.4.0 |
| [setRemoteDefaultVideoStreamType [1/2]](/zh-CN/api-reference/rtc/android/publishnsubscribe#api_irtcengine_setremotedefaultvideostreamtype) | 设置默认订阅的视频流类型。 | [setRemoteDefaultVideoStreamType [2/2]](/zh-CN/api-reference/rtc/android/publishnsubscribe#api_irtcengine_setremotedefaultvideostreamtype2) | v4.4.0 |
| [setRemoteVideoStreamTypeEx [1/2]](/zh-CN/api-reference/rtc/android/publishnsubscribe#api_irtcengineex_setremotevideostreamtypeex) | 设置要订阅的视频流类型。 | [setRemoteVideoStreamTypeEx [2/2]](/zh-CN/api-reference/rtc/android/publishnsubscribe#api_irtcengineex_setremotevideostreamtypeex2) | v4.4.0 |
| [destroy](/zh-CN/api-reference/rtc/android/play/drm#api_imusicplayer_destroy_imusicplayer) | 销毁音乐播放器。 | [destroyMusicPlayer](/zh-CN/api-reference/rtc/android/play/drm#api_imusiccontentcenter_destroymusicplayer) | v4.4.0 |
| [enableDualStreamMode [1/2]](/zh-CN/api-reference/rtc/android/publishnsubscribe#api_irtcengine_enabledualstreammode) | 在发送端启用或禁用双流模式。 | [setDualStreamMode [1/2]](/zh-CN/api-reference/rtc/android/publishnsubscribe#api_irtcengine_setdualstreammode) | v4.2.0 |
| [enableDualStreamMode [2/2]](/zh-CN/api-reference/rtc/android/publishnsubscribe#api_irtcengine_enabledualstreammode3) | 设置发送端的双流模式和视频小流。 | [setDualStreamMode [2/2]](/zh-CN/api-reference/rtc/android/publishnsubscribe#api_irtcengine_setdualstreammode2) | v4.2.0 |
| [enableDualStreamModeEx](/zh-CN/api-reference/rtc/android/publishnsubscribe#api_irtcengineex_enabledualstreammodeex) | 在发送端启用或关闭双流模式。 | [setDualStreamModeEx](/zh-CN/api-reference/rtc/android/publishnsubscribe#api_irtcengineex_setdualstreammodeex) | v4.2.0 |
| [enableWebSdkInteroperability](/zh-CN/api-reference/rtc/android/network#api_irtcengine_enablewebsdkinteroperability) | 启用或关闭与声网 Web SDK 的互通功能，仅适用于直播场景。 | - | v4.0.0 |
| [setExternalAudioSource [1/2]](/zh-CN/api-reference/rtc/android/audio/audio-custom-capturenrendering#api_irtcengine_setexternalaudiosource) | 设置外部音频源。 | [createCustomAudioTrack](/zh-CN/api-reference/rtc/android/audio/audio-custom-capturenrendering#api_irtcengine_createcustomaudiotrack) | v4.0.0 |
| [setExternalAudioSource [2/2]](/zh-CN/api-reference/rtc/android/audio/audio-custom-capturenrendering#api_irtcengine_setexternalaudiosource2) | 设置外部音频源参数。 | [createCustomAudioTrack](/zh-CN/api-reference/rtc/android/audio/audio-custom-capturenrendering#api_irtcengine_createcustomaudiotrack) | v4.0.0 |
| [createDataStreamEx [1/2]](/zh-CN/api-reference/rtc/android/metadata/datastream#api_irtcengineex_createdatastreamex1) | 创建数据流以提升数据传输的可靠性和顺序性。 | [createDataStreamEx [2/2]](/zh-CN/api-reference/rtc/android/metadata/datastream#api_irtcengineex_createdatastreamex2) | v4.0.0 |
| [pushExternalVideoFrameById [1/2]](/zh-CN/api-reference/rtc/android/video/video-custom-capturenrendering#api_irtcengine_pushvideoframe) | 通过视频轨道向 SDK 推送外部原始视频帧。 | [pushExternalVideoFrameById [2/2]](/zh-CN/api-reference/rtc/android/video/video-custom-capturenrendering#api_irtcengine_pushvideoframe3) | v4.0.0 |
| [pushExternalVideoFrame [1/2]](/zh-CN/api-reference/rtc/android/video/video-custom-capturenrendering#api_irtcengine_pushvideoframe2) | 将外部原始视频帧推送至 SDK。 | [pushExternalVideoFrame [2/2]](/zh-CN/api-reference/rtc/android/video/video-custom-capturenrendering#api_irtcengine_pushvideoframe4) | v4.0.0 |
| [setLocalVideoMirrorMode](/zh-CN/api-reference/rtc/android/video/video-rendering#api_irtcengine_setlocalvideomirrormode) | 设置本地视频镜像模式。 | [setupLocalVideo](/zh-CN/api-reference/rtc/android/video/video-rendering#api_irtcengine_setuplocalvideo) 或 [setLocalRenderMode [2/2]](/zh-CN/api-reference/rtc/android/video/video-rendering#api_irtcengine_setlocalrendermode2) | v4.0.0 |
| [setLocalRenderMode [1/2]](/zh-CN/api-reference/rtc/android/video/video-rendering#api_irtcengine_setlocalrendermode1) | 设置本地视频的显示模式。 | [setLocalRenderMode [2/2]](/zh-CN/api-reference/rtc/android/video/video-rendering#api_irtcengine_setlocalrendermode2) | v4.0.0 |
| [setLogFileSize](/zh-CN/api-reference/rtc/android/network#api_irtcengine_setlogfilesize) | 设置 SDK 日志文件的大小。 | 使用 [create [2/2]](/zh-CN/api-reference/rtc/android/initialize#api_irtcengine_initialize) 中的 config 参数 | v4.0.0 |
| [setLogFilter](/zh-CN/api-reference/rtc/android/network#api_irtcengine_setlogfilter) | 设置 SDK 的日志输出等级。 | 使用 [create [2/2]](/zh-CN/api-reference/rtc/android/initialize#api_irtcengine_initialize) 中的 config 参数 | v4.0.0 |
| [setLogFile](/zh-CN/api-reference/rtc/android/network#api_irtcengine_setlogfile) | 设置 SDK 输出日志文件。 | 使用 [create [2/2]](/zh-CN/api-reference/rtc/android/initialize#api_irtcengine_initialize) 中的 config 参数 | v4.0.0 |
| [setLogLevel](/zh-CN/api-reference/rtc/android/network#api_irtcengine_setloglevel) | 设置 SDK 的输出日志等级。 | 使用 [create [2/2]](/zh-CN/api-reference/rtc/android/initialize#api_irtcengine_initialize) 中的 config 参数 | v4.0.0 |
| [setAudioProfile [1/2]](/zh-CN/api-reference/rtc/android/audio/audio-basic#api_irtcengine_setaudioprofile) | 设置音频配置和音频场景。 | [setAudioProfile [2/2]](/zh-CN/api-reference/rtc/android/audio/audio-basic#api_irtcengine_setaudioprofile2) 或 [setAudioScenario](/zh-CN/api-reference/rtc/android/audio/audio-basic#api_irtcengine_setaudioscenario) | v4.0.0 |
| [startAudioMixing [1/2]](/zh-CN/api-reference/rtc/android/play/audio-mixing#api_irtcengine_startaudiomixing) | 开始播放音乐文件。 | [startAudioMixing [2/2]](/zh-CN/api-reference/rtc/android/play/audio-mixing#api_irtcengine_startaudiomixing2) | v4.0.0 |
| [preload [1/2]](/zh-CN/api-reference/rtc/android/play/drm#api_imusiccontentcenter_preload) | 预加载音乐资源。 | [preload [2/2]](/zh-CN/api-reference/rtc/android/play/drm#api_imusiccontentcenter_preload2) | v4.0.0 |
| [addVideoWatermark [1/3]](/zh-CN/api-reference/rtc/android/video/video-prenpro/watermark#api_irtcengine_addvideowatermark1) | 向本地视频添加水印图像。 | [addVideoWatermark [2/3]](/zh-CN/api-reference/rtc/android/video/video-prenpro/watermark#api_irtcengine_addvideowatermark2) | v4.0.0 |
| [getBlue](/zh-CN/api-reference/rtc/android/api-livetranscoding-getblue) | 获取背景颜色的蓝色分量。 | - | v4.0.0 |
| [getGreen](/zh-CN/api-reference/rtc/android/api-livetranscoding-getgreen) | 获取背景颜色的绿色分量。 | - | v4.0.0 |
| [getRed](/zh-CN/api-reference/rtc/android/api-livetranscoding-getred) | 获取背景颜色的红色分量。 | - | v4.0.0 |
| [setBlue](/zh-CN/api-reference/rtc/android/api-livetranscoding-setblue) | 设置背景颜色的蓝色分量。 | - | v4.0.0 |
| [setGreen](/zh-CN/api-reference/rtc/android/api-livetranscoding-setgreen) | 设置背景颜色的绿色分量。 | - | v4.0.0 |
| [setRed](/zh-CN/api-reference/rtc/android/api-livetranscoding-setred) | 设置背景颜色中红色分量的值。 | - | v4.0.0 |
| [onAudioMixingFinished](/zh-CN/api-reference/rtc/android/play/audio-mixing#callback_irtcengineeventhandler_onaudiomixingfinished) | 本地音乐文件播放结束回调。 | [onAudioMixingStateChanged](/zh-CN/api-reference/rtc/android/play/audio-mixing#callback_irtcengineeventhandler_onaudiomixingstatechanged) | v4.0.0 |
| [onAudioQuality](/zh-CN/api-reference/rtc/android/audio/audio-basic#callback_irtcengineeventhandler_onaudioquality) | 报告每个远端用户发送的音频流的统计信息回调。 | [onRemoteAudioStats](/zh-CN/api-reference/rtc/android/audio/audio-basic#callback_irtcengineeventhandler_onremoteaudiostats) | v4.0.0 |
| [onConnectionBanned](/zh-CN/api-reference/rtc/android/network#callback_irtcengineeventhandler_onconnectionbanned) | 连接被声网服务器封禁时触发的回调。 | [onConnectionStateChanged](/zh-CN/api-reference/rtc/android/network#callback_irtcengineeventhandler_onconnectionstatechanged) | v4.0.0 |
| [onConnectionInterrupted](/zh-CN/api-reference/rtc/android/network#callback_irtcengineeventhandler_onconnectioninterrupted) | [onConnectionInterrupted](/zh-CN/api-reference/rtc/android/network#callback_irtcengineeventhandler_onconnectioninterrupted) 回调。 | [onConnectionStateChanged](/zh-CN/api-reference/rtc/android/network#callback_irtcengineeventhandler_onconnectionstatechanged) | v4.0.0 |
| [onFirstRemoteAudioFrame](/zh-CN/api-reference/rtc/android/audio/audio-basic#callback_irtcengineeventhandler_onfirstremoteaudioframe) | 远端用户音频首帧已接收回调。 | [onRemoteAudioStateChanged](/zh-CN/api-reference/rtc/android/audio/audio-basic#callback_irtcengineeventhandler_onremoteaudiostatechanged) | v4.0.0 |
| [onFirstRemoteAudioDecoded](/zh-CN/api-reference/rtc/android/audio/audio-basic#callback_irtcengineeventhandler_onfirstremoteaudiodecoded) | 首帧远端音频解码完成回调。 | [onRemoteAudioStateChanged](/zh-CN/api-reference/rtc/android/audio/audio-basic#callback_irtcengineeventhandler_onremoteaudiostatechanged) | v4.0.0 |
| [onRemoteAudioTransportStats](/zh-CN/api-reference/rtc/android/audio/audio-basic#callback_irtcengineeventhandler_onremoteaudiotransportstats) | 上报每个远端音频流的传输层统计信息。 | [onRemoteAudioStats](/zh-CN/api-reference/rtc/android/audio/audio-basic#callback_irtcengineeventhandler_onremoteaudiostats) | v4.0.0 |
| [onRemoteVideoTransportStats](/zh-CN/api-reference/rtc/android/video/video-basic#callback_irtcengineeventhandler_onremotevideotransportstats) | 远端视频流传输层统计信息回调。 | [onRemoteVideoStats](/zh-CN/api-reference/rtc/android/video/video-basic#callback_irtcengineeventhandler_onremotevideostats) | v4.0.0 |
| [onUserEnableLocalVideo](/zh-CN/api-reference/rtc/android/video/video-basic#callback_irtcengineeventhandler_onuserenablelocalvideo) | 指定远端用户启用或关闭本地视频采集功能时触发的回调。 | [onRemoteVideoStateChanged](/zh-CN/api-reference/rtc/android/video/video-basic#callback_irtcengineeventhandler_onremotevideostatechanged) | v4.0.0 |
| [onVideoStopped](/zh-CN/api-reference/rtc/android/video/video-basic#callback_irtcengineeventhandler_onvideostopped) | 视频停止播放时触发的回调。 | [onLocalVideoStateChanged](/zh-CN/api-reference/rtc/android/video/video-basic#callback_irtcengineeventhandler_onlocalvideostatechanged) | v4.0.0 |

## 已删除 API [#已删除-api]

API 已在 SDK 中删除。请使用推荐的替代 API 实现相关功能。

| API | 描述 | 替代 API | 删除版本 |
| --- | --- | --- | --- |
| setLocalPublishFallbackOption | 设置弱网条件下发布的音视频流回退选项。 | - | v4.6.0 |
| onLocalPublishFallbackToAudioOnly | 本地发布流已回退为音频流回调。 | - | v4.6.0 |
| onDownlinkNetworkInfoUpdated | 下行网络信息变化回调。 | - | v4.6.0 |
| enableWirelessAccelerate | 开启或关闭 Wi-Fi 加速功能。 | - | v4.6.0 |
| onWlAccStats | 报告 Wi-Fi 加速效果。 | - | v4.6.0 |
| onWlAccMessage | 报告 Wi-Fi 加速消息。 | - | v4.6.0 |
| WlAccStats | Wi-Fi 加速统计信息。 | - | v4.6.0 |
| setVideoProfile | 设置视频编码配置。 | [setVideoEncoderConfiguration](/zh-CN/api-reference/rtc/android/video/video-basic#api_irtcengine_setvideoencoderconfiguration) | v4.4.0 |
| setRemoteRenderMode(userId, renderMode) | 设置远端视图显示模式。 | [setRemoteRenderMode](/zh-CN/api-reference/rtc/android/video/video-rendering#api_irtcengine_setremoterendermode2) | v4.4.0 |
| CreateRendererView | 创建 RendererView。 | Android 原生的 [SurfaceView](https://developer.android.com/reference/android/view/SurfaceView) 方法 | v4.4.0 |
| CreateTextureView | 创建 TextureView。 | Android 原生的 [TextureView](https://developer.android.com/reference/android/view/TextureView)。 | v4.4.0 |
| openWithCustomSource | 打开自定义媒体资源文件。 | [openWithMediaSource](/zh-CN/api-reference/rtc/android/play/mediaplayer/mediaplayer-open#api_imediaplayer_openwithmediasource) | v4.4.0 |
| startEchoTest() | 开始语音通话回路测试。 | [startEchoTest](/zh-CN/api-reference/rtc/android/network#api_irtcengine_startechotest3) | v4.4.0 |
| startEchoTest(intervalInSeconds) | 开始语音通话回路测试。 | [startEchoTest](/zh-CN/api-reference/rtc/android/network#api_irtcengine_startechotest3) | v4.4.0 |
| setEncryptionMode | 启用内置的加密方案。 | [enableEncryption](/zh-CN/api-reference/rtc/android/network#api_irtcengine_enableencryption) | v4.4.0 |
| setEncryptionSecret | 启用内置加密，并设置数据加密密码。 | [enableEncryption](/zh-CN/api-reference/rtc/android/network#api_irtcengine_enableencryption) | v4.4.0 |
| onEvent | 插件事件回调。 | [onEventWithContext](/zh-CN/api-reference/rtc/android/extension#callback_irtcengineeventhandler_onextensioneventwithcontext) | v4.4.0 |
| onStarted | 插件启用回调。 | [onStartedWithContext](/zh-CN/api-reference/rtc/android/extension#callback_irtcengineeventhandler_onextensionstartedwithcontext) | v4.4.0 |
| onStopped | 插件禁用回调。 | [onStoppedWithContext](/zh-CN/api-reference/rtc/android/extension#callback_irtcengineeventhandler_onextensionstoppedwithcontext) | v4.4.0 |
| onError | 插件出错回调。 | [onErrorWithContext](/zh-CN/api-reference/rtc/android/extension#callback_irtcengineeventhandler_onextensionerrorwithcontext) | v4.4.0 |