# 减小 App 体积 (/zh-CN/realtime-media/rtc/build/optimize-and-operate/reduce-app-size/flutter) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). App 体积是影响用户体验的重要因素之一,更小的包体积意味着用户可以消耗更少的带宽和时间下载 App。 在以下场景中,减小 App 体积对提升用户体验具有重要意义: - App 的应用场景对 App 体积有严格要求。例如运行在储存空间有限的智能穿戴设备上。 - App 的目标用户群体位于欠发达地区,网络环境较差,导致 App 下载时间过长。 本文介绍如何减少集成声网实时互动 SDK 的 App 体积。 ## 删除不需要的插件 [#删除不需要的插件-6] SDK 提供了可选的插件动态库,插件的命名以 `extension` 为后缀,插件功能和大小等信息详见[插件列表](#插件列表-6)。你可以参考如下方式不集成这些插件,以减小 App 体积。 ### Android 平台 [#android-平台] 当你的目标开发平台为 Android 时,你可以使用 Gradle 的 `packagingOptions.exclude` 属性在打包过程中将不需要的插件动态库排除在最终的 APK 或 AAR 文件中,从而减小 App 体积并提高 App 性能。 在项目根目录下的 `build.gradle` 文件中,找到 `android` 模块下的 `packagingOptions` 配置块,并在其中添加 `exclude` 属性,指定要排除的插件动态库。参考以下示例排除指定插件: ```groovy android { ... packagingOptions { // 排除 armeabi-v7a 架构的 AI 降噪插件 exclude 'lib/armeabi-v7a/libagora_ai_denoise_extension.so' // 排除 arm64-v8a 架构的 AI 降噪插件 exclude 'lib/arm64-v8a/libagora_ai_denoise_extension.so' // 排除 armeabi-v7a 架构的空间音频插件 exclude 'lib/armeabi-v7a/libagora_spatial_audio_extension.so' // 排除 arm64-v8a 架构的空间音频插件 exclude 'lib/arm64-v8a/libagora_spatial_audio_extension.so' } } ``` ### iOS/macOS 平台 [#iosmacos-平台] 如果你的目标开发平台为 iOS 或 macOS,请参考以下步骤减小 App 体积: 1. 在项目的 `Podfile` 文件中添加以下脚本,将 `agora_rtc_engine` 里不需要的插件标记为 [`weak_frameworks`](https://guides.cocoapods.org/syntax/podspec.html#weak_frameworks)。 ```ruby # 在已有的 post_install 中添加以下内容 # 如果你的 Podfile 已经有 post_install,请将此内容整合到现有块中,而不是创建新的 post_install do |installer| installer.pods_project.targets.each do |target| # 保留原有的 build 设置 additional_ios_build_settings(target) # 需要标记弱链接的目标,请根据你的项目名称修改 # 如果你的项目名不是"Runner",请将"Pods-Runner"改为"Pods-你的项目名" targets_to_weaklink=['Pods-Runner', "agora_rtc_engine"] # 将 frameworks_to_weaklink 中列出的插件按需替换为你想标记为弱链接的插件 # 你可以根据自己的需求删除不需要的插件 frameworks_to_weaklink=["AgoraAiEchoCancellationExtension", "AgoraAiNoiseSuppressionExtension", "AgoraAudioBeautyExtension", "AgoraClearVisionExtension", "AgoraContentInspectExtension", "AgoraDrmLoaderExtension", "AgoraReplayKitExtension", "AgoraSpatialAudioExtension", "AgoraSuperResolutionExtension", "AgoraVideoQualityAnalyzerExtension", "AgoraVideoSegmentationExtension"] # 仅对指定目标应用更改 next unless targets_to_weaklink.include?(target.name) # 执行弱链接设置 target.build_configurations.each do |config| base_config_reference = config.base_configuration_reference unless base_config_reference.nil? xcconfig_path = base_config_reference.real_path xcconfig = File.read(xcconfig_path) frameworks_to_weaklink.each do |framework| xcconfig = xcconfig.gsub(/-framework "#{framework}"/, "-weak_framework \"#{framework}\"") end File.open(xcconfig_path, "w") { |file| file << xcconfig } end end end end ``` 2. 如下图所示,使用 Xcode 打开项目,在 [**Build Phases**](https://developer.apple.com/documentation/xcode/customizing-the-build-phases-of-a-target) 页签中添加一个 **New Run Script Phase** 用于移除不需要的插件。 ![在 Xcode 的 Build Phases 中添加 New Run Script Phase](https://web-cdn.agora.io/docs-portal/img/rtc/reduce-app-size.png) 参考上图进行到第 5 步时,将 **Shell** 指定为 `/usr/bin/ruby`,代码部分替换为以下脚本: ```shell $stderr.puts "Removing Unnecessary Frameworks" // highlight-start # 此处 frameworks_to_weaklink 中列出的插件应与步骤 1 中相同 frameworks_to_weaklink=["AgoraAiEchoCancellationExtension", "AgoraAiNoiseSuppressionExtension", "AgoraAudioBeautyExtension", "AgoraClearVisionExtension", "AgoraContentInspectExtension", "AgoraDrmLoaderExtension", "AgoraReplayKitExtension", "AgoraSpatialAudioExtension", "AgoraSuperResolutionExtension", "AgoraVideoQualityAnalyzerExtension", "AgoraVideoSegmentationExtension"] // highlight-end for framework in frameworks_to_weaklink framework_path = "#{ENV['BUILT_PRODUCTS_DIR']}/#{ENV['FRAMEWORKS_FOLDER_PATH']}/#{framework}.framework" `rm -Rf "#{framework_path}"` end ``` :::warning[注意] 移除指定插件的 **Run Script** 需放在 **Build Phases** 的最后一步。 ::: ## 参考信息 [#参考信息-6] ### 插件列表 [#插件列表-6] 本节提供实时互动 SDK 各插件简介和集成后 App 增加的体积参考。 :::info[信息] - 本节数据基于实时互动 v4.6.0 SDK。 - 自 v4.6.2 起,iOS 平台不再提供 armv7 架构的插件。 ::: 实时互动 SDK 支持新版 AI 降噪功能,新版 AI 降噪具有更好的人声保真度、更干净的噪声抑制,并新增了去混响 (Dereverberation) 能力。集成 AI 降噪插件后,你可以调用 `setAINSMode` 方法设置是否开启 AI 降噪功能并设置降噪模式。 各平台插件名及集成后 App 增加的体积见下表: | 平台 | 架构 | 库名 | 集成后 App 增加的体积 (KB) | | :------ | :---------- | :------------------------------------ | :-------------------------- | | Android | arm64-v8a | `libagora_ai_noise_suppression_extension.so` | 196 | | Android | armeabi-v7a | `libagora_ai_noise_suppression_extension.so` | 113 | | Android | x86_64 | `libagora_ai_noise_suppression_extension.so` | 58 | | Android | x86 | `libagora_ai_noise_suppression_extension.so` | 57 | | iOS | arm64 | `AgoraAiNoiseSuppressionExtension.xcframework` | 165 | | iOS | armv7 | `AgoraAiNoiseSuppressionExtension.xcframework` | 10 | | macOS | arm64 | `AgoraAiNoiseSuppressionExtension.xcframework` | 336 | | macOS | x86_64 | `AgoraAiNoiseSuppressionExtension.xcframework` | 272 | | Windows | x86 | `libagora_ai_noise_suppression_extension.dll` | 372 | | Windows | x86_64 | `libagora_ai_noise_suppression_extension.dll` | 459 | 自 v4.4.0 起,SDK 提供低延迟版 AI 降噪插件,能够在保持一定降噪效果的前提下降低处理的延迟。如需使用该功能,请[联系技术支持](https://ticket.shengwang.cn/)。 :::info[信息] 低延迟版与普通版 AI 降噪插件相互独立,你可以根据实际场景需求选择集成合适的版本。调用 `setAINSMode` 方法启用 AI 降噪时默认使用普通版插件,如需切换为低延迟版,请[联系技术支持](https://ticket.shengwang.cn/)。 ::: 各平台插件名及集成后 App 增加的体积见下表: | 平台 | 架构 | 库名 | 集成后 App 增加的体积 (KB) | | :------ | :---------- | :------------------------------------ | :-------------------------- | | Android | arm64-v8a | `libagora_ai_noise_suppression_ll_extension.so` | 188 | | Android | armeabi-v7a | `libagora_ai_noise_suppression_ll_extension.so` | 111 | | Android | x86_64 | `libagora_ai_noise_suppression_ll_extension.so` | 58 | | Android | x86 | `libagora_ai_noise_suppression_ll_extension.so` | 57 | | iOS | arm64 | `AgoraAiNoiseSuppressionLLExtension.xcframework` | 156 | | iOS | armv7 | `AgoraAiNoiseSuppressionLLExtension.xcframework` | 44 | | macOS | arm64 | `AgoraAiNoiseSuppressionLLExtension.xcframework` | 320 | | macOS | x86_64 | `AgoraAiNoiseSuppressionLLExtension.xcframework` | 272 | | Windows | x86 | `libagora_ai_noise_suppression_ll_extension.dll` | 374 | | Windows | x86_64 | `libagora_ai_noise_suppression_ll_extension.dll` | 462 | 自 v4.1.0 起,SDK 提供 AI 回声消除插件,该插件可以在较恶劣的回信比 (echo-to-signal) 条件下保存完整、清晰、流畅的近端人声,显著提高系统的回声消除和双讲性能,带给用户更舒适的通话和直播体验,广泛应用于会议、语聊、K 歌等场景。如需使用该功能,请[联系技术支持](https://ticket.shengwang.cn/)。 :::warning[注意] 如果你同时集成了[声网对话式 AI 引擎](/zh-CN/ai)以实现 AI 对话场景,声网建议你保留 AI 回声消除插件,否则会导致与 AI 对话时产生回声。 ::: 各平台插件名及集成后 App 增加的体积见下表: | 平台 | 架构 | 库名 | 集成后 App 增加的体积 (KB) | | :------ | :---------- | :-------------------------------------------- | :-------------------------- | | Android | arm64-v8a | `libagora_ai_echo_cancellation_extension.so` | 322 | | Android | armeabi-v7a | `libagora_ai_echo_cancellation_extension.so` | 169 | | Android | x86 | `libagora_ai_echo_cancellation_extension.so` | 58 | | Android | x86_64 | `libagora_ai_echo_cancellation_extension.so` | 56 | | iOS | arm64 | `AgoraAiEchoCancellationExtension.xcframework` | 287 | | iOS | armv7 | `AgoraAiEchoCancellationExtension.xcframework` | 10 | | macOS | arm64 | `AgoraAiEchoCancellationExtension.xcframework` | 576 | | macOS | x86_64 | `AgoraAiEchoCancellationExtension.xcframework` | 496 | | Windows | x86 | `libagora_ai_echo_cancellation_extension.dll` | 562 | | Windows | x86_64 | `libagora_ai_echo_cancellation_extension.dll` | 738 | 自 v4.4.0 起,SDK 提供低延迟版 AI 回声消除插件,能够在保持一定回声消除效果的前提下降低处理的延迟。如需使用该功能,请[联系技术支持](https://ticket.shengwang.cn/)。 :::info[信息] 低延迟版与普通版 AI 回声消除插件相互独立,你可以根据实际场景需求选择集成合适的版本。启用 AI 回声消除时默认使用普通版插件,如需切换为低延迟版,请[联系技术支持](https://ticket.shengwang.cn/)。 ::: 各平台插件名及集成后 App 增加的体积见下表: | 平台 | 架构 | 库名 | 集成后 App 增加的体积 (KB) | | :------ | :---------- | :-------------------------------------------- | :-------------------------- | | Android | arm64-v8a | `libagora_ai_echo_cancellation_ll_extension.so` | 322 | | Android | armeabi-v7a | `libagora_ai_echo_cancellation_ll_extension.so` | 169 | | Android | x86 | `libagora_ai_echo_cancellation_ll_extension.so` | 58 | | Android | x86_64 | `libagora_ai_echo_cancellation_ll_extension.so` | 56 | | iOS | arm64 | `AgoraAiEchoCancellationLLExtension.xcframework` | 287 | | iOS | armv7 | `AgoraAiEchoCancellationLLExtension.xcframework` | 10 | | macOS | arm64 | `AgoraAiEchoCancellationLLExtension.xcframework` | 576 | | macOS | x86_64 | `AgoraAiEchoCancellationLLExtension.xcframework` | 480 | | Windows | x86 | `libagora_ai_echo_cancellation_ll_extension.dll` | 560 | | Windows | x86_64 | `libagora_ai_echo_cancellation_ll_extension.dll` | 734 | 美声插件提供一系列预设的人声效果,也支持通过音调、声音均衡和混响等设置自定义人声效果,广泛应用于语音连麦、PK 直播、K 歌房、音乐电台等场景中。你可以在集成美声插件后,调用如下方法开启你想要的美声效果: - `setVoiceBeautifierPreset`: 语聊美声、歌唱美声、音色变换。 - `setAudioEffectPreset`: 变声音效、曲风音效、空间塑造、电音音效。 - `setVoiceConversionPreset`: 基础变声。 - `setLocalVoicePitch`, `setLocalVoiceEqualization`, `setLocalVoiceReverb`: 自行调整音调、均衡和混响效果,获取想要的人声效果。 各平台插件名及集成后 App 增加的体积见下表: | 平台 | 架构 | 库名 | 集成后 App 增加的体积 (KB) | | :------ | :---------- | :------------------------------------ | :-------------------------- | | Android | arm64-v8a | `libagora_audio_beauty_extension.so` | 839 | | Android | armeabi-v7a | `libagora_audio_beauty_extension.so` | 749 | | Android | x86 | `libagora_audio_beauty_extension.so` | 753 | | Android | x86_64 | `libagora_audio_beauty_extension.so` | 754 | | iOS | arm64 | `AgoraAudioBeautyExtension.xcframework` | 650 | | iOS | armv7 | `AgoraAudioBeautyExtension.xcframework` | 650 | | macOS | arm64 | `AgoraAudioBeautyExtension.xcframework` | 1424 | | macOS | x86_64 | `AgoraAudioBeautyExtension.xcframework` | 1440 | | Windows | x86 | `libagora_audio_beauty_extension.dll` | 1756 | | Windows | x86_64 | `libagora_audio_beauty_extension.dll` | 1893 | 视频增强插件提供基础美颜、视频降噪、暗光增强、色彩增强等能力。你可以在集成视频增强插件后,调用如下方法开启你想要的视频增强功能: - `setBeautyEffectOptions`: 设置基础美颜功能。 - `setVideoDenoiserOptions`: 设置视频降噪功能。 - `setLowlightEnhanceOptions`: 设置暗光增强功能。 - `setColorEnhanceOptions`: 设置色彩增强功能。 各平台插件名及集成后 App 增加的体积见下表: | 平台 | 架构 | 库名 | 集成后 App 增加的体积 (KB) | | :------ | :---------- | :------------------------------------ | :-------------------------- | | Android | arm64-v8a | `libagora_clear_vision_extension.so` | 2133 | | Android | armeabi-v7a | `libagora_clear_vision_extension.so` | 1740 | | Android | x86 | `libagora_clear_vision_extension.so` | 852 | | Android | x86_64 | `libagora_clear_vision_extension.so` | 868 | | iOS | arm64 | `AgoraClearVisionExtension.xcframework` | 2070 | | iOS | armv7 | `AgoraClearVisionExtension.xcframework` | 1903 | | macOS | arm64 | `AgoraClearVisionExtension.xcframework` | 3200 | | macOS | x86_64 | `AgoraClearVisionExtension.xcframework` | 3264 | | Windows | x86 | `libagora_clear_vision_extension.dll` | 3002 | | Windows | x86_64 | `libagora_clear_vision_extension.dll` | 3327 | 本地截图上传插件提供对本地用户发送的视频进行截图、上传的能力,以满足对视频内容监管的需求。集成本地截图上传插件后,你可以调用 `enableContentInspect` 开启本地截图上传。 各平台插件名及集成后 App 增加的体积见下表: | 平台 | 架构 | 库名 | 集成后 App 增加的体积 (KB) | | :------ | :---------- | :------------------------------------ | :-------------------------- | | Android | arm64-v8a | `libagora_content_inspect_extension.so` | 1078 | | Android | armeabi-v7a | `libagora_content_inspect_extension.so` | 971 | | Android | x86 | `libagora_content_inspect_extension.so` | 57 | | Android | x86_64 | `libagora_content_inspect_extension.so` | 56 | | iOS | arm64 | `AgoraContentInspectExtension.xcframework` | 988 | | iOS | armv7 | `AgoraContentInspectExtension.xcframework` | 932 | | macOS | arm64 | `AgoraContentInspectExtension.xcframework` | 1296 | | macOS | x86_64 | `AgoraContentInspectExtension.xcframework` | 1264 | | Windows | x86 | `libagora_content_inspect_extension.dll` | 1386 | | Windows | x86_64 | `libagora_content_inspect_extension.dll` | 1542 | :::error[警告] 自 v4.1.0 起,SDK 默认静态编译 PVC 库,不再提供插件的方式。如果你已集成 PVC 插件,需要在升级后从项目依赖中删除 PVC 插件并重新编译项目。 ::: PVC(Perceptual Video Coding,视频感知编码),是一种在保障同等画质的前提下降低带宽消耗的视频编码方式。例如,在带宽受限场景下提升视频流畅性,在移动网络场景下降低流量消耗。如需使用该功能,请[联系技术支持](https://ticket.shengwang.cn/)。 各平台插件名及集成后 App 增加的体积见下表: | 平台 | 架构 | 库名 | 集成后 App 增加的体积 (KB) | | :------ | :---------- | :------------------------------------ | :-------------------------- | | Android | arm64-v8a | `libagora_pvc_extension.so` | 170 | | Android | armeabi-v7a | `libagora_pvc_extension.so` | 120 | | iOS | arm64 | `AgoraPvcExtension.xcframework` | 60 | | iOS | armv7 | `AgoraPvcExtension.xcframework` | 60 | | macOS | arm64 | `AgoraPvcExtension.xcframework` | 643 | | macOS | x86_64 | `AgoraPvcExtension.xcframework` | 530 | | Windows | x86 | `libagora_pvc_extension.dll` | 814 | | Windows | x86_64 | `libagora_pvc_extension.dll` | 974 | 空间音频插件可以塑造远端用户声音的方位感和模拟声音在真实世界中的传播过程,实现本地用户听远端用户时的空间音频。 各平台插件名及集成后 App 增加的体积见下表: | 平台 | 架构 | 库名 | 集成后 App 增加的体积 (KB) | | :------ | :---------- | :------------------------------------ | :-------------------------- | | Android | arm64-v8a | `libagora_spatial_audio_extension.so` | 3120 | | Android | armeabi-v7a | `libagora_spatial_audio_extension.so` | 3037 | | Android | x86 | `libagora_spatial_audio_extension.so` | 3032 | | Android | x86_64 | `libagora_spatial_audio_extension.so` | 3028 | | iOS | arm64 | `AgoraSpatialAudioExtension.xcframework` | 2956 | | iOS | armv7 | `AgoraSpatialAudioExtension.xcframework` | 2957 | | macOS | arm64 | `AgoraSpatialAudioExtension.xcframework` | 4960 | | macOS | x86_64 | `AgoraSpatialAudioExtension.xcframework` | 4960 | | Windows | x86 | `libagora_spatial_audio_extension.dll` | 4279 | | Windows | x86_64 | `libagora_spatial_audio_extension.dll` | 4389 | 集成虚拟背景插件后,你可以调用 `enableVirtualBackground` 开启虚拟背景,使用自定义的背景图或绿幕替代本地用户原来的背景图,或者将背景虚化处理。 各平台插件名及集成后 App 增加的体积见下表: | 平台 | 架构 | 库名 | 集成后 App 增加的体积 (KB) | | :------ | :---------- | :-------------------------------------------- | :-------------------------- | | Android | arm64-v8a | `libagora_segmentation_extension.so` | 1729 | | Android | armeabi-v7a | `libagora_segmentation_extension.so` | 1454 | | iOS | arm64 | `AgoraVideoSegmentationExtension.xcframework` | 1720 | | iOS | armv7 | `AgoraVideoSegmentationExtension.xcframework` | 1616 | | macOS | arm64 | `AgoraVideoSegmentationExtension.xcframework` | 2560 | | macOS | x86_64 | `AgoraVideoSegmentationExtension.xcframework` | 2768 | | Windows | x86 | `libagora_segmentation_extension.dll` | 2159 | | Windows | x86_64 | `libagora_segmentation_extension.dll` | 2488 | 自 v4.1.0 起,SDK 提供版权音乐插件(DRM, Data Rights Management),实现实时互动场景中播放版权音乐相关功能,例如检索音乐资源、获取音乐榜单及榜单详情、预加载及播放音乐资源、下载歌词及海报等。详见 [v4.1.0 发版说明](/zh-CN/realtime-media/rtc/reference/release-notes#v410)。 :::warning[注意] - 对于 4.3.0 之前的 Android SDK,使用版权音乐插件必须同时集成 `libagora_drm_loader_extension.so` 和 `libagora_udrm3_extension.so`。 - 自 v4.3.0 起,SDK 移除了版权音乐动态库,App 使用版权音乐功能时,不再需要引入版权音乐动态库。 ::: 各平台插件名及集成后 App 增加的体积见下表: | 平台 | 架构 | 库名 | 集成后 App 增加的体积 (KB) | | --- | --- | --- | --- | | Android | arm64-v8a | [reduce-app-size-rn-flutter-markdown-10-1-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-10-1-2) | 1413 | | Android | armeabi-v7a | [reduce-app-size-rn-flutter-markdown-10-2-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-10-2-2) | 1014 | | Android | x86 | [reduce-app-size-rn-flutter-markdown-10-3-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-10-3-2) | 1403 | | Android | x86_64 | [reduce-app-size-rn-flutter-markdown-10-4-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-10-4-2) | 1444 | | iOS | arm64 & armv7 | `AgoraDrmLoaderExtension.xcframework` | 1772 | **reduce-app-size-rn-flutter-markdown-10-1-2 details** - `libagora_drm_loader_extension.so` - `libagora_udrm3_extension.so` **reduce-app-size-rn-flutter-markdown-10-2-2 details** - `libagora_drm_loader_extension.so` - `libagora_udrm3_extension.so` **reduce-app-size-rn-flutter-markdown-10-3-2 details** - `libagora_drm_loader_extension.so` - `libagora_udrm3_extension.so` **reduce-app-size-rn-flutter-markdown-10-4-2 details** - `libagora_drm_loader_extension.so` - `libagora_udrm3_extension.so` 自 v4.1.1 起,SDK 提供人脸识别插件,通过算法识别人脸或人像,在编码过程中对 ROI(Region of Interest)区域使用更高的质量编码,达到人脸或人像更清晰的效果。如需使用该功能,请[联系技术支持](https://ticket.shengwang.cn/)。 :::warning[注意] 人脸识别插件和 [`enableFaceDetection`](/zh-CN/api-reference/rtc/flutter/video/video-prenpro/face-detection#api_irtcengine_enablefacedetection) 方法不存在依赖关系,后者使用的是系统自带功能,调用时无需集成人脸识别插件。 ::: 各平台插件名及集成后 App 增加的体积见下表: | 平台 | 架构 | 库名 | 集成后 App 增加的体积 (KB) | | :------ | :---------- | :----------------------------- | :------------------------- | | Android | arm64-v8a | `libagora_face_detection_extension.so` | 497 | | Android | armeabi-v7a | `libagora_face_detection_extension.so` | 332 | | Android | x86 | `libagora_face_detection_extension.so` | 133 | | Android | x86_64 | `libagora_face_detection_extension.so` | 131 | | iOS | arm64 | `AgoraFaceDetectionExtension.xcframework` | 411 | | iOS | armv7 | `AgoraFaceDetectionExtension.xcframework` | 15 | | macOS | arm64 | `AgoraFaceDetectionExtension.xcframework` | 864 | | macOS | x86_64 | `AgoraFaceDetectionExtension.xcframework` | 848 | | Windows | x86 | `libagora_face_detection_extension.dll` | 867 | | Windows | x86_64 | `libagora_face_detection_extension.dll` | 1060 | 自 v4.3.0 起,SDK 提供面部捕捉插件,用于获取面部表情、头部旋转量、头部平移量等相关信息,可用于驱动虚拟人表情变化和头部位移等。 各平台插件名及集成后 App 增加的体积见下表: | 平台 | 架构 | 库名 | 集成后 App 增加的体积 (KB) | | :------ | :---------- | :----------------------------- | :------------------------- | | Android | arm64-v8a | `libagora_face_capture_extension.so` | 1377 | | Android | armeabi-v7a | `libagora_face_capture_extension.so` | 1082 | | iOS | armv7 | `AgoraFaceCaptureExtension.xcframework` | 1145 | | iOS | arm64 | `AgoraFaceCaptureExtension.xcframework` | 1306 | | macOS | arm64 | `AgoraFaceCaptureExtension.xcframework` | 2304 | | macOS | x86_64 | `AgoraFaceCaptureExtension.xcframework` | 2480 | | Windows | x86 | `libagora_face_capture_extension.dll` | 2322 | | Windows | x86_64 | `libagora_face_capture_extension.dll` | 2701 | :::error[警告] 自 v4.1.1 起,SDK 默认静态编译超分辨率库,不再提供插件的方式,且 SDK 删除了 `enableRemoteSuperResolution`,超分辨率不再需要调用 API 开启。如果你已集成超分辨率插件,需要在升级后从项目依赖中删除超分辨率插件并重新编译项目。 ::: v4.1.1 版本以前,集成超分辨率插件后,你可以调用 `enableRemoteSuperResolution` 开启超分辨率,以提升远端视频的画面分辨率。 各平台插件名及集成后 App 增加的体积见下表: | 平台 | 架构 | 库名 | 集成后 App 增加的体积 (KB) | | ------- | ----------- | ---------------------------------------- | ----------------- | | Android | arm64-v8a | `libagora_super_resolution_extension.so` | 214 | | Android | armeabi-v7a | `libagora_super_resolution_extension.so` | 161 | | iOS | arm64 | `AgoraSuperResolutionExtension.xcframework` | 161 | | iOS | armv7 | `AgoraSuperResolutionExtension.xcframework` | 165 | 屏幕共享插件提供屏幕共享功能,支持将自己的屏幕内容分享给观众或其他用户观看,以提高沟通效率。用法详见[屏幕共享](/zh-CN/realtime-media/rtc/build/video/screen-share)。 :::warning[注意] 在 Android 平台使用屏幕共享插件必须同时集成 `libagora_screen_capture_extension.so` 和 `AgoraScreenShareExtension.aar`。 ::: 库名以及集成后 App 增加的体积见下表: | 平台 | 架构 | 库名 | 集成后 App 增加的体积 (KB) | | ------- | ----------- | ------------------------------------ | ----------------- | | Android | arm64 | `libagora_screen_capture_extension.so` | 132 | | Android | armv7 | `libagora_screen_capture_extension.so` | 93 | | Android | arm64 & armv7 | `AgoraScreenShareExtension.aar` | 69 | | iOS | arm64 | `AgoraReplayKitExtension.xcframework` | 67 | | iOS | armv7 | `AgoraReplayKitExtension.xcframework` | 66 | | macOS | arm64 | `AgoraScreenCaptureExtension.xcframework` | 736 | | macOS | x86_64 | `AgoraScreenCaptureExtension.xcframework` | 912 | | Windows | x86 | `libagora_screen_capture_extension.dll` | 1080 | | Windows | x86_64 | `libagora_screen_capture_extension.dll` | 1244 | 自 v4.1.0 起,SDK 提供视频质量评估(VQA, Video Quality Assessment)插件,该插件可以模拟真人主观感受对视频质量打分,是一种高效的视频画质评估工具。如需使用该功能,请[联系技术支持](https://ticket.shengwang.cn/)。 各平台插件名及集成后 App 增加的体积见下表: | 平台 | 架构 | 库名 | 集成后 App 增加的体积 (KB) | | :------ | :---------- | :-------------------------------------------- | :-------------------------- | | Android | arm64-v8a | `libagora_video_quality_analyzer_extension.so` | 575 | | Android | armeabi-v7a | `libagora_video_quality_analyzer_extension.so` | 458 | | Android | x86 | `libagora_video_quality_analyzer_extension.so` | 58 | | Android | x86_64 | `libagora_video_quality_analyzer_extension.so` | 57 | | iOS | arm64 | `AgoraVideoQualityAnalyzerExtension.xcframework` | 547 | | iOS | armv7 | `AgoraVideoQualityAnalyzerExtension.xcframework` | 480 | | macOS | arm64 | `AgoraVideoQualityAnalyzerExtension.xcframework` | 880 | | macOS | x86_64 | `AgoraVideoQualityAnalyzerExtension.xcframework` | 976 | | Windows | x86 | `libagora_video_quality_analyzer_extension.dll` | 873 | | Windows | x86_64 | `libagora_video_quality_analyzer_extension.dll` | 1046 | 自 v4.2.0 起,SDK 提供视频编码插件,相比 SDK 原生编码方案,该插件提供更多编码选择,可以实现更快速、更高压缩率的视频编码。如需使用该功能,请[联系技术支持](https://ticket.shengwang.cn/)。 :::warning[注意] 使用视频编码插件必须根据目标平台同时集成下表中对应列出的两个库。 ::: | 平台 | 架构 | 库名 | 集成后 App 增加的体积 (KB) | | --- | --- | --- | --- | | Android | arm64-v8a | [reduce-app-size-rn-flutter-markdown-11-1-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-11-1-2) | 945 | | Android | armeabi-v7a | [reduce-app-size-rn-flutter-markdown-11-2-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-11-2-2) | 873 | | Android | x86 | [reduce-app-size-rn-flutter-markdown-11-3-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-11-3-2) | 1125 | | Android | x86_64 | [reduce-app-size-rn-flutter-markdown-11-4-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-11-4-2) | 1126 | | iOS | arm64 | [reduce-app-size-rn-flutter-markdown-11-5-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-11-5-2) | 773 | | iOS | armv7 | [reduce-app-size-rn-flutter-markdown-11-6-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-11-6-2) | 788 | | macOS | arm64 | [reduce-app-size-rn-flutter-markdown-11-7-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-11-7-2) | 1504 | | macOS | x86_64 | [reduce-app-size-rn-flutter-markdown-11-8-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-11-8-2) | 2020 | | Windows | x86 | [reduce-app-size-rn-flutter-markdown-11-9-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-11-9-2) | 2501 | | Windows | x86_64 | [reduce-app-size-rn-flutter-markdown-11-10-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-11-10-2) | 2853 | **reduce-app-size-rn-flutter-markdown-11-1-2 details** - `libagora_video_encoder_extension.so` - `libvideo_enc.so` **reduce-app-size-rn-flutter-markdown-11-2-2 details** - `libagora_video_encoder_extension.so` - `libvideo_enc.so` **reduce-app-size-rn-flutter-markdown-11-3-2 details** - `libagora_video_encoder_extension.so` - `libvideo_enc.so` **reduce-app-size-rn-flutter-markdown-11-4-2 details** - `libagora_video_encoder_extension.so` - `libvideo_enc.so` **reduce-app-size-rn-flutter-markdown-11-5-2 details** - `AgoraVideoEncoderExtension.xcframework` - `video_enc.xcframework` **reduce-app-size-rn-flutter-markdown-11-6-2 details** - `AgoraVideoEncoderExtension.xcframework` - `video_enc.xcframework` **reduce-app-size-rn-flutter-markdown-11-7-2 details** - `AgoraVideoEncoderExtension.xcframework` - `video_enc.xcframework` **reduce-app-size-rn-flutter-markdown-11-8-2 details** - `AgoraVideoEncoderExtension.xcframework` - `video_enc.xcframework` **reduce-app-size-rn-flutter-markdown-11-9-2 details** - `libagora_video_encoder_extension.dll` - `video_enc.dll` **reduce-app-size-rn-flutter-markdown-11-10-2 details** - `libagora_video_encoder_extension.dll` - `video_enc.dll` 自 v4.2.0 起,SDK 提供视频解码插件,相比 SDK 原生编码方案,该插件提供更多解码选择,可以实现更快速、更高压缩率的视频解码。如需使用该功能,请[联系技术支持](https://ticket.shengwang.cn/)。 :::warning[注意] - 使用视频解码插件必须根据目标平台同时集成下表中对应列出的两个库。 - 自 v4.6.2 起,为提升视频解码体验,`video_decoder` 库改为 SDK 内置,`video_dec` 库并入基础库 (`full-rtc-basic`),视频解码插件不再支持裁剪。 ::: | 平台 | 架构 | 库名 | 集成后 App 增加的体积 (KB) | | --- | --- | --- | --- | | Android | arm64-v8a | [reduce-app-size-rn-flutter-markdown-12-1-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-12-1-2) | 817 | | Android | armeabi-v7a | [reduce-app-size-rn-flutter-markdown-12-2-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-12-2-2) | 763 | | Android | x86 | [reduce-app-size-rn-flutter-markdown-12-3-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-12-3-2) | 952 | | Android | x86_64 | [reduce-app-size-rn-flutter-markdown-12-4-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-12-4-2) | 976 | | iOS | arm64 | [reduce-app-size-rn-flutter-markdown-12-5-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-12-5-2) | 635 | | iOS | armv7 | [reduce-app-size-rn-flutter-markdown-12-6-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-12-6-2) | 662 | | macOS | arm64 | [reduce-app-size-rn-flutter-markdown-12-7-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-12-7-2) | 1296 | | macOS | x86_64 | [reduce-app-size-rn-flutter-markdown-12-8-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-12-8-2) | 1848 | | Windows | x86 | [reduce-app-size-rn-flutter-markdown-12-9-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-12-9-2) | 2115 | | Windows | x86_64 | [reduce-app-size-rn-flutter-markdown-12-10-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-12-10-2) | 2421 | **reduce-app-size-rn-flutter-markdown-12-1-2 details** - `libagora_video_decoder_extension.so` - `libvideo_dec.so` **reduce-app-size-rn-flutter-markdown-12-2-2 details** - `libagora_video_decoder_extension.so` - `libvideo_dec.so` **reduce-app-size-rn-flutter-markdown-12-3-2 details** - `libagora_video_decoder_extension.so` - `libvideo_dec.so` **reduce-app-size-rn-flutter-markdown-12-4-2 details** - `libagora_video_decoder_extension.so` - `libvideo_dec.so` **reduce-app-size-rn-flutter-markdown-12-5-2 details** - `AgoraVideoDecoderExtension.xcframework` - `video_dec.xcframework` **reduce-app-size-rn-flutter-markdown-12-6-2 details** - `AgoraVideoDecoderExtension.xcframework` - `video_dec.xcframework` **reduce-app-size-rn-flutter-markdown-12-7-2 details** - `AgoraVideoDecoderExtension.xcframework` - `video_dec.xcframework` **reduce-app-size-rn-flutter-markdown-12-8-2 details** - `AgoraVideoDecoderExtension.xcframework` - `video_dec.xcframework` **reduce-app-size-rn-flutter-markdown-12-9-2 details** - `libagora_video_decoder_extension.dll` - `video_dec.dll` **reduce-app-size-rn-flutter-markdown-12-10-2 details** - `libagora_video_decoder_extension.dll` - `video_dec.dll` 自 v4.3.0 起,SDK 提供 AV1 码流编码插件,支持编码 AV1 编码的视频流。如需使用该功能,请[联系技术支持](https://ticket.shengwang.cn/)。 | 平台 | 架构 | 库名 | 集成后 App 增加的体积 (KB) | | :------ | :---------- | :-------------------------------------------- | :-------------------------- | | Android | arm64-v8a | `libagora_video_av1_encoder_extension.so` | 726 | | Android | armeabi-v7a | `libagora_video_av1_encoder_extension.so` | 586 | | Android | x86 | `libagora_video_av1_encoder_extension.so` | 922 | | Android | x86_64 | `libagora_video_av1_encoder_extension.so` | 929 | | iOS | arm64 | `AgoraVideoAv1EncoderExtension.xcframework` | 579 | | iOS | armv7 | `AgoraVideoAv1EncoderExtension.xcframework` | 586 | | macOS | arm64 | `AgoraVideoAv1EncoderExtension.xcframework` | 944 | | macOS | x86_64 | `AgoraVideoAv1EncoderExtension.xcframework` | 1616 | | Windows | x86 | `libagora_video_av1_encoder_extension.dll` | 1877 | | Windows | x86_64 | `libagora_video_av1_encoder_extension.dll` | 2064 | 自 v4.3.0 起,SDK 提供 AV1 码流解码插件,支持解码 AV1 编码的视频流。如需使用该功能,请[联系技术支持](https://ticket.shengwang.cn/)。 :::warning[注意] 自 v4.6.2 起,为提升视频解码体验,`av1_decoder` 库改为 SDK 内置,AV1 码流解码插件不再支持裁剪。 ::: | 平台 | 架构 | 库名 | 集成后 App 增加的体积 (KB) | | :------ | :---------- | :-------------------------------------------- | :-------------------------- | | Android | arm64-v8a | `libagora_video_av1_decoder_extension.so` | 528 | | Android | armeabi-v7a | `libagora_video_av1_decoder_extension.so` | 492 | | Android | x86 | `libagora_video_av1_decoder_extension.so` | 606 | | Android | x86_64 | `libagora_video_av1_decoder_extension.so` | 584 | | iOS | arm64 | `AgoraVideoAv1DecoderExtension.xcframework` | 376 | | iOS | armv7 | `AgoraVideoAv1DecoderExtension.xcframework` | 368 | | macOS | arm64 | `AgoraVideoAv1DecoderExtension.xcframework` | 1040 | | macOS | x86_64 | `AgoraVideoAv1DecoderExtension.xcframework` | 2016 | | Windows | x86 | `libagora_video_av1_decoder_extension.dll` | 1449 | | Windows | x86_64 | `libagora_video_av1_decoder_extension.dll` | 2289 | :::error[警告] 自 v4.3.1 起,SDK 包中提供语音驱动插件。该插件暂不可用。 ::: | 平台 | 架构 | 库名 | 集成后 App 增加的体积 (KB) | | :------ | :---------- | :-------------------------------------------- | :-------------------------- | | Android | arm64-v8a | `libagora_lip_sync_extension.so` | 5719 | | Android | armeabi-v7a | `libagora_lip_sync_extension.so` | 5644 | | iOS | arm64 | `AgoraLipSyncExtension.xcframework` | 5679 | | iOS | armv7 | `AgoraLipSyncExtension.xcframework` | 5654 | | macOS | arm64 | `AgoraLipSyncExtension.xcframework` | 6416 | | macOS | x86_64 | `AgoraLipSyncExtension.xcframework` | 6528 | | Windows | x86 | `libagora_lip_sync_extension.dll` | 6826 | | Windows | x86_64 | `libagora_lip_sync_extension.dll` | 7038 | ### 常见问题 [#常见问题-6] - [为什么 SDK 中使用的是动态库而不是静态库?](/zh-CN/reference/faq/integration/dynamic_or_static_library)