# 减小 App 体积 (/zh-CN/realtime-media/rtc/build/optimize-and-operate/reduce-app-size)

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

<_PlatformTabsGroup>
<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="android" />
App 体积是影响用户体验的重要因素之一，更小的包体积意味着用户可以消耗更少的带宽和时间下载 App。在以下场景中，减小 App 体积对提升用户体验具有重要意义：

- App 的应用场景对 App 体积有严格要求。例如运行在储存空间有限的智能穿戴设备上。
- App 的目标用户群体位于欠发达地区，网络环境较差，导致 App 下载时间过长。

本文介绍如何减少集成声网实时互动 SDK 的 App 体积。

## 使用音频 SDK [#使用音频-sdk]

视频 SDK 支持音频和视频功能，包体积大。如果你只需使用音频功能，建议你集成音频 SDK，详见[实现纯语音互动](/zh-CN/realtime-media/rtc/build/audio/audio-quick-start#集成-sdk)。

:::info[信息]
目前，实时互动 SDK 在 Windows 和 macOS 平台仅提供视频 SDK 下载。
:::

### 按需集成 FFmpeg 插件 [#按需集成-ffmpeg-插件-android]

自 v4.7.0 起，音频 SDK 将 FFmpeg 调整为可按需集成的插件 `libagora_ffmpeg_extension.so`，SDK 包中默认包含该插件。

FFmpeg 插件用于扩展 MediaPlayer 的音频文件播放能力，并依赖 `libaosl.so`。如果你的应用不需要 FFmpeg 提供的相关播放能力，可以在集成时移除或不链接 `libagora_ffmpeg_extension.so`，以减小 App 体积。移除后，MediaPlayer 将使用系统原生播放能力，实际支持的音频文件格式取决于系统支持的容器格式和音频编解码器；如需播放系统原生能力之外的音频格式，请继续集成 FFmpeg 插件。

## 使用 Lite SDK [#使用-lite-sdk]

自 v4.4.0 起，声网提供实时互动 Lite SDK，提供基本的音视频通话功能，包体积较小。如果你只需使用基本的音视频通话功能，建议你集成 Lite SDK，详见[下载](/zh-CN/realtime-media/rtc/reference/downloads)。

Lite SDK 仅包含以下插件，其他[插件列表](#插件列表)中的插件及相关功能均不支持：

- 视频编码插件
- 视频解码插件

:::warning[注意]
Lite SDK 默认无法与 [RTC 小程序 SDK](/zh-CN/realtime-media/rtc) 互通。如果需要与小程序互通，请[联系技术支持](https://ticket.shengwang.cn/)。
:::

## 删除不需要的插件 [#删除不需要的插件]

SDK 提供了可选的插件动态库，插件的命名以 `extension` 为后缀，插件功能和大小等信息详见[插件列表](#插件列表)。你可以参考如下方式不集成这些插件，以减小 App 体积。

### 手动集成时删除插件 [#手动集成时删除插件]

通过官网 [SDK 下载链接](/zh-CN/realtime-media/rtc/reference/downloads)集成时，你可以将不需要使用的插件文件直接删除。

### Gradle 自动集成时删除插件 [#gradle-自动集成时删除插件]

通过 Gradle 自动集成 Android SDK 前，请先确保已添加声网 Maven CDN 仓库。具体配置方式请参考[下载 SDK](/zh-CN/realtime-media/rtc/reference/downloads/android#通过-gradle-自动集成-sdk)。

通过 Gradle 自动集成 Android SDK 时，你可以修改 `/Gradle Scripts/build.gradle(Module: <projectname>.app)` 文件中的 `dependencies`，以指定集成你需要的动态库，排除你不需要使用的插件。Android SDK 中各文件与 `dependencies` 中 `implementation` 字段的对应关系详见 [implementation 字段](#implementation-字段)。

<Tabs defaultValue="sample1" groupId="operating-systems" persist>
<TabsList>
  <TabsTrigger value="sample1">使用所有插件</TabsTrigger>
  <TabsTrigger value="sample2">不使用任何插件</TabsTrigger>
  <TabsTrigger value="sample3">使用部分插件</TabsTrigger>
</TabsList>

<TabsContent value="sample1">

集成 4.0.1 版 Android 视频 SDK，且使用所有插件时，`dependencies` 如下：

```java
dependencies {
 implementation 'io.agora.rtc:full-sdk:4.0.1'
 implementation 'io.agora.rtc:full-screen-sharing:4.0.1'
 ...
}
```

</TabsContent>

<TabsContent value="sample2">

集成 4.0.1 版 Android 视频 SDK，且不使用所有插件时，`dependencies` 如下：

```java
dependencies {
 implementation 'io.agora.rtc:full-rtc-basic:4.0.1'
 ...
}
```

</TabsContent>

<TabsContent value="sample3">

集成 4.0.1 版 Android 视频 SDK 且只需要使用插件列表中的 AI 降噪插件和美声插件时，`dependencies` 如下：

```java
dependencies {
 def agora_sdk_version = "4.0.1"
 // 下述代码中包含 $，因此你必须使用 ""，不能使用 ''
 implementation "io.agora.rtc:full-rtc-basic:${agora_sdk_version}"
 implementation "io.agora.rtc:full-ains:${agora_sdk_version}"
 implementation "io.agora.rtc:audio-beauty:${agora_sdk_version}"
 ...
}
```

</TabsContent>
</Tabs>

## 参考信息 [#参考信息]

### 插件列表 [#插件列表]

本节提供实时互动 SDK 各插件简介和集成后 App 增加的体积参考。

:::info[信息]
- 本节数据基于实时互动 v4.6.0 SDK。
- 自 v4.6.2 起，iOS 平台不再提供 armv7 架构的插件。
:::

<Accordions>
<Accordion title="AI 降噪插件">

实时互动 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                        |

</Accordion>

<Accordion title="AI 回声消除插件">

自 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                        |

</Accordion>

<Accordion title="美声插件">

美声插件提供一系列预设的人声效果，也支持通过音调、声音均衡和混响等设置自定义人声效果，广泛应用于语音连麦、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                        |

</Accordion>

<Accordion title="视频增强插件">

视频增强插件提供基础美颜、视频降噪、暗光增强、色彩增强等能力。你可以在集成视频增强插件后，调用如下方法开启你想要的视频增强功能：

- `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                        |

</Accordion>

<Accordion title="本地截图上传插件">

本地截图上传插件提供对本地用户发送的视频进行截图、上传的能力，以满足对视频内容监管的需求。集成本地截图上传插件后，你可以调用 `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                        |

</Accordion>

<Accordion title="PVC 插件">

:::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                        |

</Accordion>

<Accordion title="空间音频插件">

空间音频插件可以塑造远端用户声音的方位感和模拟声音在真实世界中的传播过程，实现本地用户听远端用户时的空间音频。

各平台插件名及集成后 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                        |

</Accordion>

<Accordion title="虚拟背景插件">

集成虚拟背景插件后，你可以调用 `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                        |

</Accordion>

<Accordion title="版权音乐插件">

自 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-android-ios-macos-windows-electron-markdown-10-1-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-1-2) | 1413 |
| Android | armeabi-v7a | [reduce-app-size-android-ios-macos-windows-electron-markdown-10-2-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-2-2) | 1014 |
| Android | x86 | [reduce-app-size-android-ios-macos-windows-electron-markdown-10-3-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-3-2) | 1403 |
| Android | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-10-4-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-4-2) | 1444 |
| iOS | arm64 & armv7 | `AgoraDrmLoaderExtension.xcframework` | 1772 |

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-1-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-10-1-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-10-2-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-3-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-10-3-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-4-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-10-4-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

</Accordion>

<Accordion title="人脸识别插件">

自 v4.1.1 起，SDK 提供人脸识别插件，通过算法识别人脸或人像，在编码过程中对 ROI（Region of Interest）区域使用更高的质量编码，达到人脸或人像更清晰的效果。如需使用该功能，请[联系技术支持](https://ticket.shengwang.cn/)。

:::warning[注意]
人脸识别插件和 [`enableFaceDetection`](/zh-CN/api-reference/rtc/android/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                       |

</Accordion>

<Accordion title="面部捕捉插件">

自 v4.3.0 起，SDK 提供面部捕捉插件，用于获取面部表情、头部旋转量、头部平移量等相关信息，可用于驱动虚拟人表情变化和头部位移等。

如需使用该功能，详见[使用面部捕捉插件](/zh-CN/realtime-media/rtc/build/extensions/face-capture)。

各平台插件名及集成后 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                       |

</Accordion>

<Accordion title="超分辨率插件">

:::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              |

</Accordion>

<Accordion title="屏幕共享插件">

屏幕共享插件提供屏幕共享功能，支持将自己的屏幕内容分享给观众或其他用户观看，以提高沟通效率。用法详见[屏幕共享](/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 |

</Accordion>

<Accordion title="视频质量评估插件">

自 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                        |

</Accordion>

<Accordion title="视频编码插件">

自 v4.2.0 起，SDK 提供视频编码插件，相比 SDK 原生编码方案，该插件提供更多编码选择，可以实现更快速、更高压缩率的视频编码。如需使用该功能，请[联系技术支持](https://ticket.shengwang.cn/)。

:::warning[注意]
使用视频编码插件必须根据目标平台同时集成下表中对应列出的两个库。
:::

| 平台 | 架构 | 库名 | 集成后 App 增加的体积 (KB) |
| --- | --- | --- | --- |
| Android | arm64-v8a | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-1-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-1-2) | 945 |
| Android | armeabi-v7a | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-2-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-2-2) | 873 |
| Android | x86 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-3-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-3-2) | 1125 |
| Android | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-4-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-4-2) | 1126 |
| iOS | arm64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-5-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-5-2) | 773 |
| iOS | armv7 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-6-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-6-2) | 788 |
| macOS | arm64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-7-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-7-2) | 1504 |
| macOS | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-8-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-8-2) | 2020 |
| Windows | x86 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-9-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-9-2) | 2501 |
| Windows | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-10-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-10-2) | 2853 |

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-1-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-1-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-2-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-3-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-3-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-4-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-4-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-5-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-5-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-6-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-6-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-7-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-7-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-8-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-8-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-9-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-9-2 details**

- `libagora_video_encoder_extension.dll`
- `video_enc.dll`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-10-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-10-2 details**

- `libagora_video_encoder_extension.dll`
- `video_enc.dll`

</Accordion>

<Accordion title="视频解码插件">

自 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-android-ios-macos-windows-electron-markdown-12-1-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-1-2) | 817 |
| Android | armeabi-v7a | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-2-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-2-2) | 763 |
| Android | x86 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-3-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-3-2) | 952 |
| Android | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-4-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-4-2) | 976 |
| iOS | arm64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-5-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-5-2) | 635 |
| iOS | armv7 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-6-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-6-2) | 662 |
| macOS | arm64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-7-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-7-2) | 1296 |
| macOS | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-8-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-8-2) | 1848 |
| Windows | x86 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-9-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-9-2) | 2115 |
| Windows | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-10-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-10-2) | 2421 |

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-1-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-1-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-2-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-3-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-3-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-4-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-4-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-5-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-5-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-6-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-6-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-7-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-7-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-8-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-8-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-9-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-9-2 details**

- `libagora_video_decoder_extension.dll`
- `video_dec.dll`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-10-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-10-2 details**

- `libagora_video_decoder_extension.dll`
- `video_dec.dll`

</Accordion>

<Accordion title="AV1 码流编码插件">

自 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                   |

</Accordion>

<Accordion title="AV1 码流解码插件">

自 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                   |

</Accordion>

<Accordion title="语音驱动插件">

:::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                        |

</Accordion>
</Accordions>

### implementation 字段 [#implementation-字段]

通过 Gradle 自动集成 Android SDK 时，你可以修改 `/Gradle Scripts/build.gradle(Module: <projectname>.app)` 文件中的 `dependencies` 中的 `implementation` 字段，以指定需要集成的动态库。SDK 中各文件与 `implementation` 字段的对应关系详见下表：

<Tabs defaultValue="android-video-sdk" groupId="operating-systems" persist>
<TabsList>
  <TabsTrigger value="android-video-sdk">Android 视频 SDK</TabsTrigger>
  <TabsTrigger value="android-audio-sdk">Android 音频 SDK</TabsTrigger>
</TabsList>

<TabsContent value="android-video-sdk">

| 文件 | 类别 | `implementation` 字段 |
| --- | --- | --- |
| [reduce-app-size-android-ios-macos-windows-electron-html-13-1-0 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-html-13-1-0) | 必需 | io.agora.rtc:full-rtc-basic |
| `libaosl.so`（自 v4.5.0 起，该模块成为 `RtcBasic` 依赖的一个底层库，集成 `RtcBasic` 时将自动集成该库） | 必需 | io.agora.infra:aosl |
| `libagora_ai_noise_suppression_extension.so` | 可选 | io.agora.rtc:ains |
| `libagora_ai_noise_suppression_ll_extension.so` | 可选 | io.agora.rtc:ains-ll (≥ v4.4.0) |
| `libagora_audio_beauty_extension.so` | 可选 | io.agora.rtc:audio-beauty |
| `libagora_clear_vision_extension.so` | 可选 | io.agora.rtc:clear-vision |
| `libagora_content_inspect_extension.so` | 可选 | io.agora.rtc:full-content-inspect |
| `libagora_screen_capture_extension.so` | 可选 | io.agora.rtc:screen-capture |
| `AgoraScreenShareExtension.aar` | 可选 | io.agora.rtc:full-screen-sharing |
| `libagora_segmentation_extension.so` | 可选 | io.agora.rtc:full-virtual-background |
| `libagora_spatial_audio_extension.so` | 可选 | io.agora.rtc:spatial-audio |
| `libagora_pvc_extension.so` | 可选 | io.agora.rtc:pvc (< v4.1.0) |
| `libagora_super_resolution_extension.so` | 可选 | io.agora.rtc:full-super-resolution (< v4.1.1) |
| `libagora_drm_loader_extension.so` | 可选 | io.agora.rtc:drm-loader (v4.1.0 至 v4.2.6) |
| `libagora_udrm3_extension.so` | 可选 | io.agora.rtc:drm (v4.1.0 至 v4.2.6) |
| `libagora_ai_echo_cancellation_extension.so` | 可选 | io.agora.rtc:aiaec (≥ v4.1.0) |
| `libagora_ai_echo_cancellation_ll_extension.so` | 可选 | io.agora.rtc:aiaec-ll (≥ v4.4.0) |
| `libagora_video_quality_analyzer_extension.so` | 可选 | io.agora.rtc:full-vqa (≥ v4.1.0) |
| `libagora_face_detection_extension.so` | 可选 | io.agora.rtc:full-face-detect (≥ v4.1.1) |
| `libagora_face_capture_extension.so` | 可选 | io.agora.rtc:full-face-capture (≥ v4.3.0) |
| [reduce-app-size-android-ios-macos-windows-electron-html-13-21-0 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-html-13-21-0) | 可选 | io.agora.rtc:full-video-codec-enc (≥ v4.2.0) |
| [reduce-app-size-android-ios-macos-windows-electron-html-13-22-0 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-html-13-22-0) | 可选 | io.agora.rtc:full-video-codec-dec (v4.2.0 至 v4.6.1) |
| `libagora_video_av1_encoder_extension.so` | 可选 | io.agora.rtc:full-video-av1-codec-enc (≥ v4.3.0) |
| `libagora_video_av1_decoder_extension.so` | 可选 | io.agora.rtc:full-video-av1-codec-dec (v4.3.0 至 v4.6.1) |
| `libagora_lip_sync_extension.so` | 可选 | io.agora.rtc:full-lip-sync (≥ v4.3.1) |

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-html-13-1-0"></a>

**reduce-app-size-android-ios-macos-windows-electron-html-13-1-0 details**

- `agora-rtc-sdk.jar`
- `libagora-rtc-sdk.so`
- `libagora-fdkaac.so`
- `libagora-ffmpeg.so`
- `libagora-soundtouch.so`
- `libvideo_dec.so`（自 v4.6.2 起新增）
- `libagora-core.so`（自 v4.3.0 起更名为 `libaosl.so`；自 v4.5.0 起成为依赖，详见下行）
- SDK 头文件

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-html-13-21-0"></a>

**reduce-app-size-android-ios-macos-windows-electron-html-13-21-0 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-html-13-22-0"></a>

**reduce-app-size-android-ios-macos-windows-electron-html-13-22-0 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

</TabsContent>

<TabsContent value="android-audio-sdk">

| 文件 | 类别 | `implementation` 字段 |
| --- | --- | --- |
| [reduce-app-size-android-ios-macos-windows-electron-html-14-1-0 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-html-14-1-0) | 必需 | io.agora.rtc:voice-rtc-basic |
| `libagora_ai_noise_suppression_extension.so` | 可选 | io.agora.rtc:ains |
| `libagora_ai_noise_suppression_ll_extension.so` | 可选 | io.agora.rtc:ains-ll (≥ v4.4.0) |
| `libagora_audio_beauty_extension.so` | 可选 | io.agora.rtc:audio-beauty |
| `libagora_spatial_audio_extension.so` | 可选 | io.agora.rtc:spatial-audio |
| `libagora_drm_loader_extension.so` | 可选 | io.agora.rtc:drm-loader (≥ v4.1.0) |
| `libagora_udrm3_extension.so` | 可选 | io.agora.rtc:drm (v4.1.0 至 v4.2.6) |
| `libagora_ai_echo_cancellation_extension.so` | 可选 | io.agora.rtc:aiaec (≥ v4.1.0) |
| `libagora_ai_echo_cancellation_ll_extension.so` | 可选 | io.agora.rtc:aiaec-ll (≥ v4.4.0) |

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-html-14-1-0"></a>

**reduce-app-size-android-ios-macos-windows-electron-html-14-1-0 details**

- `agora-rtc-sdk.jar`
- `libagora-rtc-sdk.so`
- `libagora-fdkaac.so`
- `libagora_ffmpeg_extension.so`（自 v4.7.0 起，Android 音频 SDK 默认包含；如果需要减少包体积，可按需移除或不链接，详见[按需集成 FFmpeg 插件](/zh-CN/realtime-media/rtc/build/optimize-and-operate/reduce-app-size/android#按需集成-ffmpeg-插件-android)）
- `libagora-soundtouch.so`
- `libagora-core.so`（自 v4.3.0 起更名为 `libaosl.so`；自 v4.5.0 起成为依赖，详见下行）
- SDK 头文件

</TabsContent>
</Tabs>

### 常见问题 [#常见问题]

- [为什么 SDK 中使用的是动态库而不是静态库？](/zh-CN/reference/faq/integration/dynamic_or_static_library)
<_PlatformProcessedMarker close="true" />

<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="ios" />
App 体积是影响用户体验的重要因素之一，更小的包体积意味着用户可以消耗更少的带宽和时间下载 App。
在以下场景中，减小 App 体积对提升用户体验具有重要意义：

- App 的应用场景对 App 体积有严格要求。例如运行在储存空间有限的智能穿戴设备上。
- App 的目标用户群体位于欠发达地区，网络环境较差，导致 App 下载时间过长。

本文介绍如何减少集成声网实时互动 SDK 的 App 体积。

## 使用音频 SDK [#使用音频-sdk-1]

视频 SDK 支持音频和视频功能，包体积大。如果你只需使用音频功能，建议你集成音频 SDK，详见[实现纯语音互动](/zh-CN/realtime-media/rtc/build/audio/audio-quick-start#集成-sdk)。

:::info[信息]
目前，实时互动 SDK 在 Windows 和 macOS 平台仅提供视频 SDK 下载。
:::

### 按需集成 FFmpeg 插件 [#按需集成-ffmpeg-插件-ios]

自 v4.7.0 起，音频 SDK 将 FFmpeg 调整为可按需集成的插件 `AgoraffmpegExtension.xcframework`，SDK 包中默认包含该插件。

FFmpeg 插件用于扩展 MediaPlayer 的音频文件播放能力，并依赖 `aosl.xcframework`。如果你的纯音频场景不需要 FFmpeg 提供的相关播放能力，可以在集成时移除或不链接 `AgoraffmpegExtension.xcframework`，以减小 App 体积。移除后，MediaPlayer 将使用系统原生播放能力，实际支持的音频文件格式取决于系统支持的容器格式和音频编解码器；如需播放系统原生能力之外的音频格式，请继续集成 FFmpeg 插件。

## 使用 Lite SDK [#使用-lite-sdk-1]

自 v4.4.0 起，声网提供实时互动 Lite SDK，提供基本的音视频通话功能，包体积较小。如果你只需使用基本的音视频通话功能，建议你集成 Lite SDK，详见[下载](/zh-CN/realtime-media/rtc/reference/downloads)。

Lite SDK 仅包含以下插件，其他[插件列表](#插件列表-1)中的插件及相关功能均不支持：

- 视频编码插件
- 视频解码插件

:::warning[注意]
Lite SDK 默认无法与 [RTC 小程序 SDK](/zh-CN/realtime-media/rtc) 互通。如果需要与小程序互通，请[联系技术支持](https://ticket.shengwang.cn/)。
:::

## 删除不需要的插件 [#删除不需要的插件-1]

SDK 提供了可选的插件动态库，插件的命名以 `extension` 为后缀，插件功能和大小等信息详见[插件列表](#插件列表-1)。你可以参考如下方式不集成这些插件，以减小 App 体积。

### 手动集成时删除插件 [#手动集成时删除插件-1]

通过官网 [SDK 下载链接](/zh-CN/realtime-media/rtc/reference/downloads)集成时，你可以将不需要使用的插件文件直接删除。

### CocoaPods 集成时删除插件 [#cocoapods-集成时删除插件]

通过 CocoaPods 集成 iOS/macOS SDK 时，你可以在 Podfile 中使用 `subspecs` 字段指定集成你需要的动态库，以排除你不需要使用的插件。动态库与 `subspecs` 字段的对应关系详见 [subspecs 字段](#subspecs-字段)。

<Tabs defaultValue="sample1" groupId="operating-systems" persist>
<TabsList>
  <TabsTrigger value="sample1">使用所有插件</TabsTrigger>
  <TabsTrigger value="sample2">不使用任何插件</TabsTrigger>
  <TabsTrigger value="sample3">使用部分插件</TabsTrigger>
</TabsList>

<TabsContent value="sample1">

集成 4.0.1 版 iOS 视频 SDK，且使用所有插件时，Podfile 如下：

```ruby
# platform :ios, '9.0'
target 'Your App' do
    pod 'AgoraRtcEngine_iOS', '4.0.1'
end
```

</TabsContent>

<TabsContent value="sample2">

集成 4.0.1 版 iOS 视频 SDK，且不使用所有插件时，Podfile 如下：

```ruby
# platform :ios, '9.0'
target 'Your App' do
    pod 'AgoraRtcEngine_iOS', '4.0.1', :subspecs => ['RtcBasic']
end
```

</TabsContent>

<TabsContent value="sample3">

集成 4.0.1 版 iOS 视频 SDK 且只需要使用插件列表中的 AI 降噪插件和美声插件时，Podfile 如下：

```ruby
# platform :ios, '9.0'
target 'Your App' do
    pod 'AgoraRtcEngine_iOS', '4.0.1', :subspecs => ['RtcBasic', 'AINS', 'AudioBeauty']
end
```

</TabsContent>
</Tabs>

:::warning[注意]
填写上述 pod 命令时，请确保你指定版本的 SDK 具有你指定的插件，且插件的 `subspecs` 字段正确，否则 `pod install` 时会报错。例如，填写 `pod 'AgoraRtcEngine_iOS', '4.0.0', :subspecs => ['RtcBasic', 'AgoraRtcAINS']` 时，`pod install` 时会报错。
:::

## 参考信息 [#参考信息-1]

### 插件列表 [#插件列表-1]

本节提供实时互动 SDK 各插件简介和集成后 App 增加的体积参考。

:::info[信息]
- 本节数据基于实时互动 v4.6.0 SDK。
- 自 v4.6.2 起，iOS 平台不再提供 armv7 架构的插件。
:::

<Accordions>
<Accordion title="AI 降噪插件">

实时互动 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                        |

</Accordion>

<Accordion title="AI 回声消除插件">

自 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                        |

</Accordion>

<Accordion title="美声插件">

美声插件提供一系列预设的人声效果，也支持通过音调、声音均衡和混响等设置自定义人声效果，广泛应用于语音连麦、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                        |

</Accordion>

<Accordion title="视频增强插件">

视频增强插件提供基础美颜、视频降噪、暗光增强、色彩增强等能力。你可以在集成视频增强插件后，调用如下方法开启你想要的视频增强功能：

- `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                        |

</Accordion>

<Accordion title="本地截图上传插件">

本地截图上传插件提供对本地用户发送的视频进行截图、上传的能力，以满足对视频内容监管的需求。集成本地截图上传插件后，你可以调用 `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                        |

</Accordion>

<Accordion title="PVC 插件">

:::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                        |

</Accordion>

<Accordion title="空间音频插件">

空间音频插件可以塑造远端用户声音的方位感和模拟声音在真实世界中的传播过程，实现本地用户听远端用户时的空间音频。

各平台插件名及集成后 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                        |

</Accordion>

<Accordion title="虚拟背景插件">

集成虚拟背景插件后，你可以调用 `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                        |

</Accordion>

<Accordion title="版权音乐插件">

自 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-android-ios-macos-windows-electron-markdown-10-1-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-1-2-1) | 1413 |
| Android | armeabi-v7a | [reduce-app-size-android-ios-macos-windows-electron-markdown-10-2-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-2-2-1) | 1014 |
| Android | x86 | [reduce-app-size-android-ios-macos-windows-electron-markdown-10-3-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-3-2-1) | 1403 |
| Android | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-10-4-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-4-2-1) | 1444 |
| iOS | arm64 & armv7 | `AgoraDrmLoaderExtension.xcframework` | 1772 |

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-1-2-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-10-1-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-2-2-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-10-2-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-3-2-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-10-3-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-4-2-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-10-4-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

</Accordion>

<Accordion title="人脸识别插件">

自 v4.1.1 起，SDK 提供人脸识别插件，通过算法识别人脸或人像，在编码过程中对 ROI（Region of Interest）区域使用更高的质量编码，达到人脸或人像更清晰的效果。如需使用该功能，请[联系技术支持](https://ticket.shengwang.cn/)。

:::warning[注意]
人脸识别插件和 [`enableFaceDetection`](/zh-CN/api-reference/rtc/ios/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                       |

</Accordion>

<Accordion title="面部捕捉插件">

自 v4.3.0 起，SDK 提供面部捕捉插件，用于获取面部表情、头部旋转量、头部平移量等相关信息，可用于驱动虚拟人表情变化和头部位移等。

如需使用该功能，详见[使用面部捕捉插件](/zh-CN/realtime-media/rtc/build/extensions/face-capture)。

各平台插件名及集成后 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                       |

</Accordion>

<Accordion title="超分辨率插件">

:::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              |

</Accordion>

<Accordion title="屏幕共享插件">

屏幕共享插件提供屏幕共享功能，支持将自己的屏幕内容分享给观众或其他用户观看，以提高沟通效率。用法详见[屏幕共享](/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 |

</Accordion>

<Accordion title="视频质量评估插件">

自 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                        |

</Accordion>

<Accordion title="视频编码插件">

自 v4.2.0 起，SDK 提供视频编码插件，相比 SDK 原生编码方案，该插件提供更多编码选择，可以实现更快速、更高压缩率的视频编码。如需使用该功能，请[联系技术支持](https://ticket.shengwang.cn/)。

:::warning[注意]
使用视频编码插件必须根据目标平台同时集成下表中对应列出的两个库。
:::

| 平台 | 架构 | 库名 | 集成后 App 增加的体积 (KB) |
| --- | --- | --- | --- |
| Android | arm64-v8a | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-1-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-1-2-1) | 945 |
| Android | armeabi-v7a | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-2-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-2-2-1) | 873 |
| Android | x86 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-3-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-3-2-1) | 1125 |
| Android | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-4-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-4-2-1) | 1126 |
| iOS | arm64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-5-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-5-2-1) | 773 |
| iOS | armv7 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-6-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-6-2-1) | 788 |
| macOS | arm64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-7-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-7-2-1) | 1504 |
| macOS | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-8-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-8-2-1) | 2020 |
| Windows | x86 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-9-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-9-2-1) | 2501 |
| Windows | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-10-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-10-2-1) | 2853 |

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-1-2-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-1-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-2-2-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-2-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-3-2-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-3-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-4-2-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-4-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-5-2-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-5-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-6-2-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-6-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-7-2-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-7-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-8-2-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-8-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-9-2-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-9-2 details**

- `libagora_video_encoder_extension.dll`
- `video_enc.dll`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-10-2-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-10-2 details**

- `libagora_video_encoder_extension.dll`
- `video_enc.dll`

</Accordion>

<Accordion title="视频解码插件">

自 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-android-ios-macos-windows-electron-markdown-12-1-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-1-2-1) | 817 |
| Android | armeabi-v7a | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-2-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-2-2-1) | 763 |
| Android | x86 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-3-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-3-2-1) | 952 |
| Android | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-4-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-4-2-1) | 976 |
| iOS | arm64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-5-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-5-2-1) | 635 |
| iOS | armv7 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-6-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-6-2-1) | 662 |
| macOS | arm64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-7-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-7-2-1) | 1296 |
| macOS | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-8-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-8-2-1) | 1848 |
| Windows | x86 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-9-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-9-2-1) | 2115 |
| Windows | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-10-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-10-2-1) | 2421 |

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-1-2-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-1-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-2-2-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-2-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-3-2-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-3-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-4-2-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-4-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-5-2-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-5-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-6-2-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-6-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-7-2-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-7-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-8-2-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-8-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-9-2-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-9-2 details**

- `libagora_video_decoder_extension.dll`
- `video_dec.dll`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-10-2-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-10-2 details**

- `libagora_video_decoder_extension.dll`
- `video_dec.dll`

</Accordion>

<Accordion title="AV1 码流编码插件">

自 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                   |

</Accordion>

<Accordion title="AV1 码流解码插件">

自 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                   |

</Accordion>

<Accordion title="语音驱动插件">

:::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                        |

</Accordion>
</Accordions>

### subspecs 字段 [#subspecs-字段]

通过 CocoaPods 集成 iOS/macOS SDK 时，你可以在 Podfile 中使用 `subspecs` 字段指定集成你需要的动态库，以排除你不需要使用的插件。动态库与 `subspecs` 字段的对应关系详见下表：

<Tabs defaultValue="ios-video-sdk" groupId="operating-systems" persist>
<TabsList>
  <TabsTrigger value="ios-video-sdk">iOS 视频 SDK</TabsTrigger>
  <TabsTrigger value="ios-audio-sdk">iOS 音频 SDK</TabsTrigger>
  <TabsTrigger value="mac-video-sdk">macOS 视频 SDK</TabsTrigger>
</TabsList>

<TabsContent value="ios-video-sdk">

| 动态库 | 类别 | `subspecs` 字段 |
| --- | --- | --- |
| [reduce-app-size-android-ios-macos-windows-electron-html-13-1-0 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-html-13-1-0-1) | 必需 | RtcBasic |
| `AgoraAiNoiseSuppressionExtension.xcframework` | 可选 | AINS |
| `AgoraAiNoiseSuppressionLLExtension.xcframework` | 可选 | AINSLL (≥ v4.4.0) |
| `AgoraAudioBeautyExtension.xcframework` | 可选 | AudioBeauty |
| `AgoraClearVisionExtension.xcframework` | 可选 | ClearVision |
| `AgoraContentInspectExtension.xcframework` | 可选 | ContentInspect |
| `AgoraPvcExtension.xcframework` | 可选 | PVC (< v4.1.0) |
| `AgoraSpatialAudioExtension.xcframework` | 可选 | SpatialAudio |
| `AgoraVideoSegmentationExtension.xcframework` | 可选 | VirtualBackground |
| `AgoraAiEchoCancellationExtension.xcframework` | 可选 | AIAEC (≥ v4.1.0) |
| `AgoraAiEchoCancellationLLExtension.xcframework` | 可选 | AIAECLL (≥ v4.4.0) |
| `AgoraDrmLoaderExtension.xcframework` | 可选 | DRM (≥ v4.1.0) |
| `AgoraFaceDetectionExtension.xcframework` | 可选 | FaceDetection (≥ v4.1.1) |
| `AgoraFaceCaptureExtension.xcframework` | 可选 | FaceCapture (≥ v4.3.0) |
| `AgoraVideoQualityAnalyzerExtension.xcframework` | 可选 | VQA (≥ v4.1.0) |
| `AgoraReplayKitExtension.xcframework` | 可选 | ReplayKit |
| `AgoraSuperResolutionExtension.xcframework` | 可选 | SuperResolution (< v4.1.1) |
| [reduce-app-size-android-ios-macos-windows-electron-html-13-18-0 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-html-13-18-0) | 可选 | VideoCodecEnc (≥ v4.2.0) |
| [reduce-app-size-android-ios-macos-windows-electron-html-13-19-0 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-html-13-19-0) | 可选 | VideoCodecDec (v4.2.0 至 v4.6.1) |
| `AgoraVideoAv1EncoderExtension.xcframework` | 可选 | VideoAv1CodecEnc (≥ v4.3.0) |
| `AgoraVideoAv1DecoderExtension.xcframework` | 可选 | VideoAv1CodecDec (v4.3.0 至 v4.6.1) |
| `AgoraLipSyncExtension.xcframework` | 可选 | LipSync (≥ v4.3.1) |

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-html-13-1-0-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-html-13-1-0 details**

- `AgoraRtcKit.xcframework`
- `Agorafdkaac.xcframework`
- `AgoraSoundTouch.xcframework`
- `Agoraffmpeg.xcframework`
- `video_dec.xcframework`（自 v4.6.2 起新增）
- `AgoraCore.xcframework`（自 v4.3.0 起更名为 `aosl.xcframework`；自 v4.5.0 起成为依赖，详见 [AgoraInfra_iOS](https://cocoapods.org/pods/AgoraInfra_iOS)）

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-html-13-18-0"></a>

**reduce-app-size-android-ios-macos-windows-electron-html-13-18-0 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-html-13-19-0"></a>

**reduce-app-size-android-ios-macos-windows-electron-html-13-19-0 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

</TabsContent>

<TabsContent value="ios-audio-sdk">

| 动态库 | 类别 | `subspecs` 字段 |
| --- | --- | --- |
| [reduce-app-size-android-ios-macos-windows-electron-html-14-1-0 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-html-14-1-0-1) | 必需 | RtcBasic |
| `AgoraAiNoiseSuppressionExtension.xcframework` | 可选 | AINS |
| `AgoraAiNoiseSuppressionLLExtension.xcframework` | 可选 | AINSLL (≥ v4.4.0) |
| `AgoraAudioBeautyExtension.xcframework` | 可选 | AudioBeauty |
| `AgoraSpatialAudioExtension.xcframework` | 可选 | SpatialAudio |
| `AgoraAiEchoCancellationExtension.xcframework` | 可选 | AIAEC (≥ v4.1.0) |
| `AgoraAiEchoCancellationLLExtension.xcframework` | 可选 | AIAECLL (≥ v4.4.0) |
| `AgoraDrmLoaderExtension.xcframework` | 可选 | DRM (≥ v4.1.0) |

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-html-14-1-0-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-html-14-1-0 details**

- `AgoraRtcKit.xcframework`
- `Agorafdkaac.xcframework`
- `AgoraSoundTouch.xcframework`
- `AgoraffmpegExtension.xcframework`（自 v4.7.0 起，iOS 音频 SDK 默认包含；如果需要减少包体积，可按需移除或不链接，详见[按需集成 FFmpeg 插件](/zh-CN/realtime-media/rtc/build/optimize-and-operate/reduce-app-size/ios#按需集成-ffmpeg-插件-ios)）
- `AgoraCore.xcframework`（自 v4.3.0 起更名为 `aosl.xcframework`；自 v4.5.0 起成为依赖，详见 [AgoraInfra_iOS](https://cocoapods.org/pods/AgoraInfra_iOS)）

</TabsContent>

<TabsContent value="mac-video-sdk">

| 动态库 | 类别 | `subspecs` 字段 |
| --- | --- | --- |
| [reduce-app-size-android-ios-macos-windows-electron-html-15-1-0 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-html-15-1-0) | 必需 | RtcBasic |
| `AgoraAiNoiseSuppressionExtension.xcframework` | 可选 | AINS |
| `AgoraAiNoiseSuppressionLLExtension.xcframework` | 可选 | AINSLL (≥ v4.4.0) |
| `AgoraAudioBeautyExtension.xcframework` | 可选 | AudioBeauty |
| `AgoraClearVisionExtension.xcframework` | 可选 | ClearVision |
| `AgoraContentInspectExtension.xcframework` | 可选 | ContentInspect |
| `AgoraPvcExtension.xcframework` | 可选 | PVC (< v4.1.0) |
| `AgoraSpatialAudioExtension.xcframework` | 可选 | SpatialAudio |
| `AgoraVideoSegmentationExtension.xcframework` | 可选 | VirtualBackground |
| `AgoraAiEchoCancellationExtension.xcframework` | 可选 | AIAEC (≥ v4.1.0) |
| `AgoraAiEchoCancellationLLExtension.xcframework` | 可选 | AIAECLL (≥ v4.4.0) |
| `AgoraDrmLoaderExtension.xcframework` | 可选 | DRM (≥ v4.1.0) |
| `AgoraFaceDetectionExtension.xcframework` | 可选 | FaceDetection (≥ v4.1.1) |
| `AgoraFaceCaptureExtension.xcframework` | 可选 | FaceCapture (≥ v4.3.0) |
| `AgoraVideoQualityAnalyzerExtension.xcframework` | 可选 | VQA (≥ v4.1.0) |
| `AgoraScreenCaptureExtension.xcframework` | 可选 | ScreenCapture (≥ v4.2.0) |
| [reduce-app-size-android-ios-macos-windows-electron-html-15-17-0 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-html-15-17-0) | 可选 | VideoCodecEnc (≥ v4.2.0) |
| [reduce-app-size-android-ios-macos-windows-electron-html-15-18-0 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-html-15-18-0) | 可选 | VideoCodecDec (v4.2.0 至 v4.6.1) |
| `AgoraVideoAv1EncoderExtension.xcframework` | 可选 | VideoAv1CodecEnc (≥ v4.3.0) |
| `AgoraVideoAv1DecoderExtension.xcframework` | 可选 | VideoAv1CodecDec (v4.3.0 至 v4.6.1) |
| `AgoraLipSyncExtension.xcframework` | 可选 | LipSync (≥ v4.3.1) |

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-html-15-1-0"></a>

**reduce-app-size-android-ios-macos-windows-electron-html-15-1-0 details**

- `AgoraRtcKit.xcframework`
- `Agorafdkaac.xcframework`
- `AgoraSoundTouch.xcframework`
- `Agoraffmpeg.xcframework`
- `video_dec.xcframework`（自 v4.6.2 起新增）
- `AgoraCore.xcframework`（自 v4.3.0 起更名为 `aosl.xcframework`；自 v4.5.0 起成为依赖，详见 [AgoraInfra_macOS](https://cocoapods.org/pods/AgoraInfra_macOS)）

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-html-15-17-0"></a>

**reduce-app-size-android-ios-macos-windows-electron-html-15-17-0 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-html-15-18-0"></a>

**reduce-app-size-android-ios-macos-windows-electron-html-15-18-0 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

</TabsContent>
</Tabs>

### 常见问题 [#常见问题-1]

- [为什么 SDK 中使用的是动态库而不是静态库？](/zh-CN/reference/faq/integration/dynamic_or_static_library)
<_PlatformProcessedMarker close="true" />

<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="macos" />
App 体积是影响用户体验的重要因素之一，更小的包体积意味着用户可以消耗更少的带宽和时间下载 App。
在以下场景中，减小 App 体积对提升用户体验具有重要意义：

- App 的应用场景对 App 体积有严格要求。例如运行在储存空间有限的智能穿戴设备上。
- App 的目标用户群体位于欠发达地区，网络环境较差，导致 App 下载时间过长。

本文介绍如何减少集成声网实时互动 SDK 的 App 体积。

## 使用音频 SDK [#使用音频-sdk-2]

视频 SDK 支持音频和视频功能，包体积大。如果你只需使用音频功能，建议你集成音频 SDK，详见[实现纯语音互动](/zh-CN/realtime-media/rtc/build/audio/audio-quick-start#集成-sdk)。

:::info[信息]
目前，实时互动 SDK 在 Windows 和 macOS 平台仅提供视频 SDK 下载。
:::

## 删除不需要的插件 [#删除不需要的插件-2]

SDK 提供了可选的插件动态库，插件的命名以 `extension` 为后缀，插件功能和大小等信息详见[插件列表](#插件列表-2)。你可以参考如下方式不集成这些插件，以减小 App 体积。

### 手动集成时删除插件 [#手动集成时删除插件-2]

通过官网 [SDK 下载链接](/zh-CN/realtime-media/rtc/reference/downloads)集成时，你可以将不需要使用的插件文件直接删除。

### CocoaPods 集成时删除插件 [#cocoapods-集成时删除插件-1]

通过 CocoaPods 集成 iOS/macOS SDK 时，你可以在 Podfile 中使用 `subspecs` 字段指定集成你需要的动态库，以排除你不需要使用的插件。动态库与 `subspecs` 字段的对应关系详见 [subspecs 字段](#subspecs-字段-1)。

<Tabs defaultValue="sample1" groupId="operating-systems" persist>
<TabsList>
  <TabsTrigger value="sample1">使用所有插件</TabsTrigger>
  <TabsTrigger value="sample2">不使用任何插件</TabsTrigger>
  <TabsTrigger value="sample3">使用部分插件</TabsTrigger>
</TabsList>

<TabsContent value="sample1">

集成 4.0.1 版 iOS 视频 SDK，且使用所有插件时，Podfile 如下：

```ruby
# platform :ios, '9.0'
target 'Your App' do
    pod 'AgoraRtcEngine_iOS', '4.0.1'
end
```

</TabsContent>

<TabsContent value="sample2">

集成 4.0.1 版 iOS 视频 SDK，且不使用所有插件时，Podfile 如下：

```ruby
# platform :ios, '9.0'
target 'Your App' do
    pod 'AgoraRtcEngine_iOS', '4.0.1', :subspecs => ['RtcBasic']
end
```

</TabsContent>

<TabsContent value="sample3">

集成 4.0.1 版 iOS 视频 SDK 且只需要使用插件列表中的 AI 降噪插件和美声插件时，Podfile 如下：

```ruby
# platform :ios, '9.0'
target 'Your App' do
    pod 'AgoraRtcEngine_iOS', '4.0.1', :subspecs => ['RtcBasic', 'AINS', 'AudioBeauty']
end
```

</TabsContent>
</Tabs>

:::warning[注意]
填写上述 pod 命令时，请确保你指定版本的 SDK 具有你指定的插件，且插件的 `subspecs` 字段正确，否则 `pod install` 时会报错。例如，填写 `pod 'AgoraRtcEngine_iOS', '4.0.0', :subspecs => ['RtcBasic', 'AgoraRtcAINS']` 时，`pod install` 时会报错。
:::

## 参考信息 [#参考信息-2]

### 插件列表 [#插件列表-2]

本节提供实时互动 SDK 各插件简介和集成后 App 增加的体积参考。

:::info[信息]
- 本节数据基于实时互动 v4.6.0 SDK。
- 自 v4.6.2 起，iOS 平台不再提供 armv7 架构的插件。
:::

<Accordions>
<Accordion title="AI 降噪插件">

实时互动 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                        |

</Accordion>

<Accordion title="AI 回声消除插件">

自 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                        |

</Accordion>

<Accordion title="美声插件">

美声插件提供一系列预设的人声效果，也支持通过音调、声音均衡和混响等设置自定义人声效果，广泛应用于语音连麦、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                        |

</Accordion>

<Accordion title="视频增强插件">

视频增强插件提供基础美颜、视频降噪、暗光增强、色彩增强等能力。你可以在集成视频增强插件后，调用如下方法开启你想要的视频增强功能：

- `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                        |

</Accordion>

<Accordion title="本地截图上传插件">

本地截图上传插件提供对本地用户发送的视频进行截图、上传的能力，以满足对视频内容监管的需求。集成本地截图上传插件后，你可以调用 `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                        |

</Accordion>

<Accordion title="PVC 插件">

:::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                        |

</Accordion>

<Accordion title="空间音频插件">

空间音频插件可以塑造远端用户声音的方位感和模拟声音在真实世界中的传播过程，实现本地用户听远端用户时的空间音频。

各平台插件名及集成后 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                        |

</Accordion>

<Accordion title="虚拟背景插件">

集成虚拟背景插件后，你可以调用 `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                        |

</Accordion>

<Accordion title="版权音乐插件">

自 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-android-ios-macos-windows-electron-markdown-10-1-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-1-2-2) | 1413 |
| Android | armeabi-v7a | [reduce-app-size-android-ios-macos-windows-electron-markdown-10-2-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-2-2-2) | 1014 |
| Android | x86 | [reduce-app-size-android-ios-macos-windows-electron-markdown-10-3-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-3-2-2) | 1403 |
| Android | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-10-4-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-4-2-2) | 1444 |
| iOS | arm64 & armv7 | `AgoraDrmLoaderExtension.xcframework` | 1772 |

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-1-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-10-1-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-2-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-10-2-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-3-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-10-3-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-4-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-10-4-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

</Accordion>

<Accordion title="人脸识别插件">

自 v4.1.1 起，SDK 提供人脸识别插件，通过算法识别人脸或人像，在编码过程中对 ROI（Region of Interest）区域使用更高的质量编码，达到人脸或人像更清晰的效果。如需使用该功能，请[联系技术支持](https://ticket.shengwang.cn/)。

:::warning[注意]

:::

各平台插件名及集成后 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                       |

</Accordion>

<Accordion title="面部捕捉插件">

自 v4.3.0 起，SDK 提供面部捕捉插件，用于获取面部表情、头部旋转量、头部平移量等相关信息，可用于驱动虚拟人表情变化和头部位移等。

如需使用该功能，详见[使用面部捕捉插件](/zh-CN/realtime-media/rtc/build/extensions/face-capture)。

各平台插件名及集成后 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                       |

</Accordion>

<Accordion title="超分辨率插件">

:::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              |

</Accordion>

<Accordion title="屏幕共享插件">

屏幕共享插件提供屏幕共享功能，支持将自己的屏幕内容分享给观众或其他用户观看，以提高沟通效率。用法详见[屏幕共享](/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 |

</Accordion>

<Accordion title="视频质量评估插件">

自 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                        |

</Accordion>

<Accordion title="视频编码插件">

自 v4.2.0 起，SDK 提供视频编码插件，相比 SDK 原生编码方案，该插件提供更多编码选择，可以实现更快速、更高压缩率的视频编码。如需使用该功能，请[联系技术支持](https://ticket.shengwang.cn/)。

:::warning[注意]
使用视频编码插件必须根据目标平台同时集成下表中对应列出的两个库。
:::

| 平台 | 架构 | 库名 | 集成后 App 增加的体积 (KB) |
| --- | --- | --- | --- |
| Android | arm64-v8a | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-1-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-1-2-2) | 945 |
| Android | armeabi-v7a | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-2-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-2-2-2) | 873 |
| Android | x86 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-3-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-3-2-2) | 1125 |
| Android | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-4-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-4-2-2) | 1126 |
| iOS | arm64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-5-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-5-2-2) | 773 |
| iOS | armv7 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-6-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-6-2-2) | 788 |
| macOS | arm64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-7-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-7-2-2) | 1504 |
| macOS | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-8-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-8-2-2) | 2020 |
| Windows | x86 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-9-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-9-2-2) | 2501 |
| Windows | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-10-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-10-2-2) | 2853 |

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-1-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-1-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-2-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-2-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-3-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-3-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-4-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-4-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-5-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-5-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-6-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-6-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-7-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-7-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-8-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-8-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-9-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-9-2 details**

- `libagora_video_encoder_extension.dll`
- `video_enc.dll`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-10-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-10-2 details**

- `libagora_video_encoder_extension.dll`
- `video_enc.dll`

</Accordion>

<Accordion title="视频解码插件">

自 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-android-ios-macos-windows-electron-markdown-12-1-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-1-2-2) | 817 |
| Android | armeabi-v7a | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-2-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-2-2-2) | 763 |
| Android | x86 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-3-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-3-2-2) | 952 |
| Android | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-4-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-4-2-2) | 976 |
| iOS | arm64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-5-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-5-2-2) | 635 |
| iOS | armv7 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-6-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-6-2-2) | 662 |
| macOS | arm64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-7-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-7-2-2) | 1296 |
| macOS | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-8-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-8-2-2) | 1848 |
| Windows | x86 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-9-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-9-2-2) | 2115 |
| Windows | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-10-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-10-2-2) | 2421 |

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-1-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-1-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-2-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-2-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-3-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-3-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-4-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-4-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-5-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-5-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-6-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-6-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-7-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-7-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-8-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-8-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-9-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-9-2 details**

- `libagora_video_decoder_extension.dll`
- `video_dec.dll`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-10-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-10-2 details**

- `libagora_video_decoder_extension.dll`
- `video_dec.dll`

</Accordion>

<Accordion title="AV1 码流编码插件">

自 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                   |

</Accordion>

<Accordion title="AV1 码流解码插件">

自 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                   |

</Accordion>

<Accordion title="语音驱动插件">

:::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                        |

</Accordion>
</Accordions>

### subspecs 字段 [#subspecs-字段-1]

通过 CocoaPods 集成 iOS/macOS SDK 时，你可以在 Podfile 中使用 `subspecs` 字段指定集成你需要的动态库，以排除你不需要使用的插件。动态库与 `subspecs` 字段的对应关系详见下表：

<Tabs defaultValue="ios-video-sdk" groupId="operating-systems" persist>
<TabsList>
  <TabsTrigger value="ios-video-sdk">iOS 视频 SDK</TabsTrigger>
  <TabsTrigger value="ios-audio-sdk">iOS 音频 SDK</TabsTrigger>
  <TabsTrigger value="mac-video-sdk">macOS 视频 SDK</TabsTrigger>
</TabsList>

<TabsContent value="ios-video-sdk">

| 动态库 | 类别 | `subspecs` 字段 |
| --- | --- | --- |
| [reduce-app-size-android-ios-macos-windows-electron-html-13-1-0 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-html-13-1-0-2) | 必需 | RtcBasic |
| `AgoraAiNoiseSuppressionExtension.xcframework` | 可选 | AINS |
| `AgoraAiNoiseSuppressionLLExtension.xcframework` | 可选 | AINSLL (≥ v4.4.0) |
| `AgoraAudioBeautyExtension.xcframework` | 可选 | AudioBeauty |
| `AgoraClearVisionExtension.xcframework` | 可选 | ClearVision |
| `AgoraContentInspectExtension.xcframework` | 可选 | ContentInspect |
| `AgoraPvcExtension.xcframework` | 可选 | PVC (< v4.1.0) |
| `AgoraSpatialAudioExtension.xcframework` | 可选 | SpatialAudio |
| `AgoraVideoSegmentationExtension.xcframework` | 可选 | VirtualBackground |
| `AgoraAiEchoCancellationExtension.xcframework` | 可选 | AIAEC (≥ v4.1.0) |
| `AgoraAiEchoCancellationLLExtension.xcframework` | 可选 | AIAECLL (≥ v4.4.0) |
| `AgoraDrmLoaderExtension.xcframework` | 可选 | DRM (≥ v4.1.0) |
| `AgoraFaceDetectionExtension.xcframework` | 可选 | FaceDetection (≥ v4.1.1) |
| `AgoraFaceCaptureExtension.xcframework` | 可选 | FaceCapture (≥ v4.3.0) |
| `AgoraVideoQualityAnalyzerExtension.xcframework` | 可选 | VQA (≥ v4.1.0) |
| `AgoraReplayKitExtension.xcframework` | 可选 | ReplayKit |
| `AgoraSuperResolutionExtension.xcframework` | 可选 | SuperResolution (< v4.1.1) |
| [reduce-app-size-android-ios-macos-windows-electron-html-13-18-0 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-html-13-18-0-1) | 可选 | VideoCodecEnc (≥ v4.2.0) |
| [reduce-app-size-android-ios-macos-windows-electron-html-13-19-0 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-html-13-19-0-1) | 可选 | VideoCodecDec (v4.2.0 至 v4.6.1) |
| `AgoraVideoAv1EncoderExtension.xcframework` | 可选 | VideoAv1CodecEnc (≥ v4.3.0) |
| `AgoraVideoAv1DecoderExtension.xcframework` | 可选 | VideoAv1CodecDec (v4.3.0 至 v4.6.1) |
| `AgoraLipSyncExtension.xcframework` | 可选 | LipSync (≥ v4.3.1) |

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-html-13-1-0-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-html-13-1-0 details**

- `AgoraRtcKit.xcframework`
- `Agorafdkaac.xcframework`
- `AgoraSoundTouch.xcframework`
- `Agoraffmpeg.xcframework`
- `video_dec.xcframework`（自 v4.6.2 起新增）
- `AgoraCore.xcframework`（自 v4.3.0 起更名为 `aosl.xcframework`；自 v4.5.0 起成为依赖，详见 [AgoraInfra_iOS](https://cocoapods.org/pods/AgoraInfra_iOS)）

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-html-13-18-0-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-html-13-18-0 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-html-13-19-0-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-html-13-19-0 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

</TabsContent>

<TabsContent value="ios-audio-sdk">

| 动态库 | 类别 | `subspecs` 字段 |
| --- | --- | --- |
| [reduce-app-size-android-ios-macos-windows-electron-html-14-1-0 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-html-14-1-0-2) | 必需 | RtcBasic |
| `AgoraAiNoiseSuppressionExtension.xcframework` | 可选 | AINS |
| `AgoraAiNoiseSuppressionLLExtension.xcframework` | 可选 | AINSLL (≥ v4.4.0) |
| `AgoraAudioBeautyExtension.xcframework` | 可选 | AudioBeauty |
| `AgoraSpatialAudioExtension.xcframework` | 可选 | SpatialAudio |
| `AgoraAiEchoCancellationExtension.xcframework` | 可选 | AIAEC (≥ v4.1.0) |
| `AgoraAiEchoCancellationLLExtension.xcframework` | 可选 | AIAECLL (≥ v4.4.0) |
| `AgoraDrmLoaderExtension.xcframework` | 可选 | DRM (≥ v4.1.0) |

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-html-14-1-0-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-html-14-1-0 details**

- `AgoraRtcKit.xcframework`
- `Agorafdkaac.xcframework`
- `AgoraSoundTouch.xcframework`
- `AgoraffmpegExtension.xcframework`（自 v4.7.0 起，iOS 音频 SDK 默认包含；如果需要减少包体积，可按需移除或不链接，详见[按需集成 FFmpeg 插件](/zh-CN/realtime-media/rtc/build/optimize-and-operate/reduce-app-size/ios#按需集成-ffmpeg-插件-ios)）
- `AgoraCore.xcframework`（自 v4.3.0 起更名为 `aosl.xcframework`；自 v4.5.0 起成为依赖，详见 [AgoraInfra_iOS](https://cocoapods.org/pods/AgoraInfra_iOS)）

</TabsContent>

<TabsContent value="mac-video-sdk">

| 动态库 | 类别 | `subspecs` 字段 |
| --- | --- | --- |
| [reduce-app-size-android-ios-macos-windows-electron-html-15-1-0 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-html-15-1-0-1) | 必需 | RtcBasic |
| `AgoraAiNoiseSuppressionExtension.xcframework` | 可选 | AINS |
| `AgoraAiNoiseSuppressionLLExtension.xcframework` | 可选 | AINSLL (≥ v4.4.0) |
| `AgoraAudioBeautyExtension.xcframework` | 可选 | AudioBeauty |
| `AgoraClearVisionExtension.xcframework` | 可选 | ClearVision |
| `AgoraContentInspectExtension.xcframework` | 可选 | ContentInspect |
| `AgoraPvcExtension.xcframework` | 可选 | PVC (< v4.1.0) |
| `AgoraSpatialAudioExtension.xcframework` | 可选 | SpatialAudio |
| `AgoraVideoSegmentationExtension.xcframework` | 可选 | VirtualBackground |
| `AgoraAiEchoCancellationExtension.xcframework` | 可选 | AIAEC (≥ v4.1.0) |
| `AgoraAiEchoCancellationLLExtension.xcframework` | 可选 | AIAECLL (≥ v4.4.0) |
| `AgoraDrmLoaderExtension.xcframework` | 可选 | DRM (≥ v4.1.0) |
| `AgoraFaceDetectionExtension.xcframework` | 可选 | FaceDetection (≥ v4.1.1) |
| `AgoraFaceCaptureExtension.xcframework` | 可选 | FaceCapture (≥ v4.3.0) |
| `AgoraVideoQualityAnalyzerExtension.xcframework` | 可选 | VQA (≥ v4.1.0) |
| `AgoraScreenCaptureExtension.xcframework` | 可选 | ScreenCapture (≥ v4.2.0) |
| [reduce-app-size-android-ios-macos-windows-electron-html-15-17-0 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-html-15-17-0-1) | 可选 | VideoCodecEnc (≥ v4.2.0) |
| [reduce-app-size-android-ios-macos-windows-electron-html-15-18-0 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-html-15-18-0-1) | 可选 | VideoCodecDec (v4.2.0 至 v4.6.1) |
| `AgoraVideoAv1EncoderExtension.xcframework` | 可选 | VideoAv1CodecEnc (≥ v4.3.0) |
| `AgoraVideoAv1DecoderExtension.xcframework` | 可选 | VideoAv1CodecDec (v4.3.0 至 v4.6.1) |
| `AgoraLipSyncExtension.xcframework` | 可选 | LipSync (≥ v4.3.1) |

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-html-15-1-0-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-html-15-1-0 details**

- `AgoraRtcKit.xcframework`
- `Agorafdkaac.xcframework`
- `AgoraSoundTouch.xcframework`
- `Agoraffmpeg.xcframework`
- `video_dec.xcframework`（自 v4.6.2 起新增）
- `AgoraCore.xcframework`（自 v4.3.0 起更名为 `aosl.xcframework`；自 v4.5.0 起成为依赖，详见 [AgoraInfra_macOS](https://cocoapods.org/pods/AgoraInfra_macOS)）

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-html-15-17-0-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-html-15-17-0 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-html-15-18-0-1"></a>

**reduce-app-size-android-ios-macos-windows-electron-html-15-18-0 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

</TabsContent>
</Tabs>

### 常见问题 [#常见问题-2]

- [为什么 SDK 中使用的是动态库而不是静态库？](/zh-CN/reference/faq/integration/dynamic_or_static_library)
<_PlatformProcessedMarker close="true" />

<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="windows" />
App 体积是影响用户体验的重要因素之一，更小的包体积意味着用户可以消耗更少的带宽和时间下载 App。
在以下场景中，减小 App 体积对提升用户体验具有重要意义：

- App 的应用场景对 App 体积有严格要求。例如运行在储存空间有限的智能穿戴设备上。
- App 的目标用户群体位于欠发达地区，网络环境较差，导致 App 下载时间过长。

本文介绍如何减少集成声网实时互动 SDK 的 App 体积。

## 使用音频 SDK [#使用音频-sdk-3]

视频 SDK 支持音频和视频功能，包体积大。如果你只需使用音频功能，建议你集成音频 SDK，详见[实现纯语音互动](/zh-CN/realtime-media/rtc/build/audio/audio-quick-start#集成-sdk)。

:::info[信息]
目前，实时互动 SDK 在 Windows 和 macOS 平台仅提供视频 SDK 下载。
:::

## 删除不需要的插件 [#删除不需要的插件-3]

SDK 提供了可选的插件动态库，插件的命名以 `extension` 为后缀，插件功能和大小等信息详见[插件列表](#插件列表-3)。你可以参考如下方式不集成这些插件，以减小 App 体积。

### 手动集成时删除插件 [#手动集成时删除插件-3]

通过官网 [SDK 下载链接](/zh-CN/realtime-media/rtc/reference/downloads)集成时，你可以将不需要使用的插件文件直接删除。

## 参考信息 [#参考信息-3]

### 插件列表 [#插件列表-3]

本节提供实时互动 SDK 各插件简介和集成后 App 增加的体积参考。

:::info[信息]
- 本节数据基于实时互动 v4.6.0 SDK。
- 自 v4.6.2 起，iOS 平台不再提供 armv7 架构的插件。
:::

<Accordions>
<Accordion title="AI 降噪插件">

实时互动 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                        |

</Accordion>

<Accordion title="AI 回声消除插件">

自 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                        |

</Accordion>

<Accordion title="美声插件">

美声插件提供一系列预设的人声效果，也支持通过音调、声音均衡和混响等设置自定义人声效果，广泛应用于语音连麦、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                        |

</Accordion>

<Accordion title="视频增强插件">

视频增强插件提供基础美颜、视频降噪、暗光增强、色彩增强等能力。你可以在集成视频增强插件后，调用如下方法开启你想要的视频增强功能：

- `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                        |

</Accordion>

<Accordion title="本地截图上传插件">

本地截图上传插件提供对本地用户发送的视频进行截图、上传的能力，以满足对视频内容监管的需求。集成本地截图上传插件后，你可以调用 `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                        |

</Accordion>

<Accordion title="PVC 插件">

:::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                        |

</Accordion>

<Accordion title="空间音频插件">

空间音频插件可以塑造远端用户声音的方位感和模拟声音在真实世界中的传播过程，实现本地用户听远端用户时的空间音频。

各平台插件名及集成后 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                        |

</Accordion>

<Accordion title="虚拟背景插件">

集成虚拟背景插件后，你可以调用 `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                        |

</Accordion>

<Accordion title="版权音乐插件">

自 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-android-ios-macos-windows-electron-markdown-10-1-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-1-2-3) | 1413 |
| Android | armeabi-v7a | [reduce-app-size-android-ios-macos-windows-electron-markdown-10-2-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-2-2-3) | 1014 |
| Android | x86 | [reduce-app-size-android-ios-macos-windows-electron-markdown-10-3-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-3-2-3) | 1403 |
| Android | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-10-4-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-4-2-3) | 1444 |
| iOS | arm64 & armv7 | `AgoraDrmLoaderExtension.xcframework` | 1772 |

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-1-2-3"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-10-1-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-2-2-3"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-10-2-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-3-2-3"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-10-3-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-4-2-3"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-10-4-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

</Accordion>

<Accordion title="人脸识别插件">

自 v4.1.1 起，SDK 提供人脸识别插件，通过算法识别人脸或人像，在编码过程中对 ROI（Region of Interest）区域使用更高的质量编码，达到人脸或人像更清晰的效果。如需使用该功能，请[联系技术支持](https://ticket.shengwang.cn/)。

:::warning[注意]
人脸识别插件和 [`enableFaceDetection`](/zh-CN/api-reference/rtc/cpp-all-platforms/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                       |

</Accordion>

<Accordion title="面部捕捉插件">

自 v4.3.0 起，SDK 提供面部捕捉插件，用于获取面部表情、头部旋转量、头部平移量等相关信息，可用于驱动虚拟人表情变化和头部位移等。

如需使用该功能，详见[使用面部捕捉插件](/zh-CN/realtime-media/rtc/build/extensions/face-capture)。

各平台插件名及集成后 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                       |

</Accordion>

<Accordion title="超分辨率插件">

:::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              |

</Accordion>

<Accordion title="屏幕共享插件">

屏幕共享插件提供屏幕共享功能，支持将自己的屏幕内容分享给观众或其他用户观看，以提高沟通效率。用法详见[屏幕共享](/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 |

</Accordion>

<Accordion title="视频质量评估插件">

自 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                        |

</Accordion>

<Accordion title="视频编码插件">

自 v4.2.0 起，SDK 提供视频编码插件，相比 SDK 原生编码方案，该插件提供更多编码选择，可以实现更快速、更高压缩率的视频编码。如需使用该功能，请[联系技术支持](https://ticket.shengwang.cn/)。

:::warning[注意]
使用视频编码插件必须根据目标平台同时集成下表中对应列出的两个库。
:::

| 平台 | 架构 | 库名 | 集成后 App 增加的体积 (KB) |
| --- | --- | --- | --- |
| Android | arm64-v8a | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-1-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-1-2-3) | 945 |
| Android | armeabi-v7a | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-2-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-2-2-3) | 873 |
| Android | x86 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-3-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-3-2-3) | 1125 |
| Android | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-4-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-4-2-3) | 1126 |
| iOS | arm64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-5-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-5-2-3) | 773 |
| iOS | armv7 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-6-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-6-2-3) | 788 |
| macOS | arm64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-7-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-7-2-3) | 1504 |
| macOS | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-8-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-8-2-3) | 2020 |
| Windows | x86 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-9-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-9-2-3) | 2501 |
| Windows | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-11-10-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-10-2-3) | 2853 |

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-1-2-3"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-1-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-2-2-3"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-2-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-3-2-3"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-3-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-4-2-3"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-4-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-5-2-3"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-5-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-6-2-3"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-6-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-7-2-3"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-7-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-8-2-3"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-8-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-9-2-3"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-9-2 details**

- `libagora_video_encoder_extension.dll`
- `video_enc.dll`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-11-10-2-3"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-11-10-2 details**

- `libagora_video_encoder_extension.dll`
- `video_enc.dll`

</Accordion>

<Accordion title="视频解码插件">

自 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-android-ios-macos-windows-electron-markdown-12-1-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-1-2-3) | 817 |
| Android | armeabi-v7a | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-2-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-2-2-3) | 763 |
| Android | x86 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-3-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-3-2-3) | 952 |
| Android | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-4-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-4-2-3) | 976 |
| iOS | arm64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-5-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-5-2-3) | 635 |
| iOS | armv7 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-6-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-6-2-3) | 662 |
| macOS | arm64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-7-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-7-2-3) | 1296 |
| macOS | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-8-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-8-2-3) | 1848 |
| Windows | x86 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-9-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-9-2-3) | 2115 |
| Windows | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-12-10-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-10-2-3) | 2421 |

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-1-2-3"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-1-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-2-2-3"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-2-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-3-2-3"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-3-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-4-2-3"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-4-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-5-2-3"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-5-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-6-2-3"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-6-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-7-2-3"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-7-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-8-2-3"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-8-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-9-2-3"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-9-2 details**

- `libagora_video_decoder_extension.dll`
- `video_dec.dll`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-12-10-2-3"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-12-10-2 details**

- `libagora_video_decoder_extension.dll`
- `video_dec.dll`

</Accordion>

<Accordion title="AV1 码流编码插件">

自 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                   |

</Accordion>

<Accordion title="AV1 码流解码插件">

自 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                   |

</Accordion>

<Accordion title="语音驱动插件">

:::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                        |

</Accordion>
</Accordions>

### 常见问题 [#常见问题-3]

- [为什么 SDK 中使用的是动态库而不是静态库？](/zh-CN/reference/faq/integration/dynamic_or_static_library)
<_PlatformProcessedMarker close="true" />

<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="electron" />
App 体积是影响用户体验的重要因素之一，更小的包体积意味着用户可以消耗更少的带宽和时间下载 App。
在以下场景中，减小 App 体积对提升用户体验具有重要意义：

- App 的应用场景对 App 体积有严格要求。例如运行在储存空间有限的智能穿戴设备上。
- App 的目标用户群体位于欠发达地区，网络环境较差，导致 App 下载时间过长。

本文介绍如何减少集成声网实时互动 SDK 的 App 体积。

## 使用音频 SDK [#使用音频-sdk-4]

视频 SDK 支持音频和视频功能，包体积大。如果你只需使用音频功能，建议你集成音频 SDK，详见[实现纯语音互动](/zh-CN/realtime-media/rtc/build/audio/audio-quick-start#集成-sdk)。

:::info[信息]
目前，实时互动 SDK 在 Windows 和 macOS 平台仅提供视频 SDK 下载。
:::

## 删除不需要的插件 [#删除不需要的插件-4]

SDK 提供了可选的插件动态库，插件的命名以 `extension` 为后缀，插件功能和大小等信息详见[插件列表](#插件列表-4)。你可以参考如下方式不集成这些插件，以减小 App 体积。

### 手动集成时删除插件 [#手动集成时删除插件-4]

通过官网 [SDK 下载链接](/zh-CN/realtime-media/rtc/reference/downloads)集成时，你可以将不需要使用的插件文件直接删除。

## 参考信息 [#参考信息-4]

### 插件列表 [#插件列表-4]

本节提供实时互动 SDK 各插件简介和集成后 App 增加的体积参考。

:::info[信息]
- 本节数据基于实时互动 v4.6.0 SDK。
- 自 v4.6.2 起，iOS 平台不再提供 armv7 架构的插件。
:::

<Accordions>
<Accordion title="AI 降噪插件">

实时互动 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                        |

</Accordion>

<Accordion title="AI 回声消除插件">

自 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                        |

</Accordion>

<Accordion title="美声插件">

美声插件提供一系列预设的人声效果，也支持通过音调、声音均衡和混响等设置自定义人声效果，广泛应用于语音连麦、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                        |

</Accordion>

<Accordion title="视频增强插件">

视频增强插件提供基础美颜、视频降噪、暗光增强、色彩增强等能力。你可以在集成视频增强插件后，调用如下方法开启你想要的视频增强功能：

- `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                        |

</Accordion>

<Accordion title="本地截图上传插件">

本地截图上传插件提供对本地用户发送的视频进行截图、上传的能力，以满足对视频内容监管的需求。集成本地截图上传插件后，你可以调用 `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                        |

</Accordion>

<Accordion title="PVC 插件">

:::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                        |

</Accordion>

<Accordion title="空间音频插件">

空间音频插件可以塑造远端用户声音的方位感和模拟声音在真实世界中的传播过程，实现本地用户听远端用户时的空间音频。

各平台插件名及集成后 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                        |

</Accordion>

<Accordion title="虚拟背景插件">

集成虚拟背景插件后，你可以调用 `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                        |

</Accordion>

<Accordion title="版权音乐插件">

自 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-android-ios-macos-windows-electron-markdown-10-1-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-1-2-4) | 1413 |
| Android | armeabi-v7a | [reduce-app-size-android-ios-macos-windows-electron-markdown-10-2-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-2-2-4) | 1014 |
| Android | x86 | [reduce-app-size-android-ios-macos-windows-electron-markdown-10-3-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-3-2-4) | 1403 |
| Android | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-10-4-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-4-2-4) | 1444 |
| iOS | arm64 & armv7 | `AgoraDrmLoaderExtension.xcframework` | 1772 |

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-1-2-4"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-10-1-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-2-2-4"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-10-2-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-3-2-4"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-10-3-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-10-4-2-4"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-10-4-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

</Accordion>

<Accordion title="人脸识别插件">

自 v4.1.1 起，SDK 提供人脸识别插件，通过算法识别人脸或人像，在编码过程中对 ROI（Region of Interest）区域使用更高的质量编码，达到人脸或人像更清晰的效果。如需使用该功能，请[联系技术支持](https://ticket.shengwang.cn/)。

:::warning[注意]
人脸识别插件和 `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                       |

</Accordion>

<Accordion title="面部捕捉插件">

自 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                       |

</Accordion>

<Accordion title="超分辨率插件">

:::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              |

</Accordion>

<Accordion title="屏幕共享插件">

屏幕共享插件提供屏幕共享功能，支持将自己的屏幕内容分享给观众或其他用户观看，以提高沟通效率。用法详见[屏幕共享](/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 |

</Accordion>

<Accordion title="视频质量评估插件">

自 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                        |

</Accordion>

<Accordion title="视频编码插件">

自 v4.2.0 起，SDK 提供视频编码插件，相比 SDK 原生编码方案，该插件提供更多编码选择，可以实现更快速、更高压缩率的视频编码。如需使用该功能，请[联系技术支持](https://ticket.shengwang.cn/)。

:::warning[注意]
使用视频编码插件必须根据目标平台同时集成下表中对应列出的两个库。
:::

| 平台 | 架构 | 库名 | 集成后 App 增加的体积 (KB) |
| --- | --- | --- | --- |
| Android | arm64-v8a | [reduce-app-size-android-ios-macos-windows-electron-markdown-16-1-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-16-1-2) | 945 |
| Android | armeabi-v7a | [reduce-app-size-android-ios-macos-windows-electron-markdown-16-2-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-16-2-2) | 873 |
| Android | x86 | [reduce-app-size-android-ios-macos-windows-electron-markdown-16-3-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-16-3-2) | 1125 |
| Android | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-16-4-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-16-4-2) | 1126 |
| iOS | arm64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-16-5-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-16-5-2) | 773 |
| iOS | armv7 | [reduce-app-size-android-ios-macos-windows-electron-markdown-16-6-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-16-6-2) | 788 |
| macOS | arm64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-16-7-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-16-7-2) | 1504 |
| macOS | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-16-8-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-16-8-2) | 2020 |
| Windows | x86 | [reduce-app-size-android-ios-macos-windows-electron-markdown-16-9-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-16-9-2) | 2501 |
| Windows | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-16-10-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-16-10-2) | 2853 |

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-16-1-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-16-1-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-16-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-16-2-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-16-3-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-16-3-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-16-4-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-16-4-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-16-5-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-16-5-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-16-6-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-16-6-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-16-7-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-16-7-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-16-8-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-16-8-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-16-9-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-16-9-2 details**

- `libagora_video_encoder_extension.dll`
- `video_enc.dll`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-16-10-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-16-10-2 details**

- `libagora_video_encoder_extension.dll`
- `video_enc.dll`

</Accordion>

<Accordion title="视频解码插件">

自 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-android-ios-macos-windows-electron-markdown-17-1-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-17-1-2) | 817 |
| Android | armeabi-v7a | [reduce-app-size-android-ios-macos-windows-electron-markdown-17-2-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-17-2-2) | 763 |
| Android | x86 | [reduce-app-size-android-ios-macos-windows-electron-markdown-17-3-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-17-3-2) | 952 |
| Android | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-17-4-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-17-4-2) | 976 |
| iOS | arm64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-17-5-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-17-5-2) | 635 |
| iOS | armv7 | [reduce-app-size-android-ios-macos-windows-electron-markdown-17-6-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-17-6-2) | 662 |
| macOS | arm64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-17-7-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-17-7-2) | 1296 |
| macOS | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-17-8-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-17-8-2) | 1848 |
| Windows | x86 | [reduce-app-size-android-ios-macos-windows-electron-markdown-17-9-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-17-9-2) | 2115 |
| Windows | x86_64 | [reduce-app-size-android-ios-macos-windows-electron-markdown-17-10-2 details](#table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-17-10-2) | 2421 |

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-17-1-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-17-1-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-17-2-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-17-2-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-17-3-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-17-3-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-17-4-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-17-4-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-17-5-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-17-5-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-17-6-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-17-6-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-17-7-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-17-7-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-17-8-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-17-8-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-17-9-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-17-9-2 details**

- `libagora_video_decoder_extension.dll`
- `video_dec.dll`

<a id="table-slot-reduce-app-size-android-ios-macos-windows-electron-markdown-17-10-2"></a>

**reduce-app-size-android-ios-macos-windows-electron-markdown-17-10-2 details**

- `libagora_video_decoder_extension.dll`
- `video_dec.dll`

</Accordion>

<Accordion title="AV1 码流编码插件">

自 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                   |

</Accordion>

<Accordion title="AV1 码流解码插件">

自 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                   |

</Accordion>

<Accordion title="语音驱动插件">

:::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                        |

</Accordion>
</Accordions>

### 常见问题 [#常见问题-4]

- [为什么 SDK 中使用的是动态库而不是静态库？](/zh-CN/reference/faq/integration/dynamic_or_static_library)
<_PlatformProcessedMarker close="true" />

<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="unity" />
App 体积是影响用户体验的重要因素之一，更小的包体积意味着用户可以消耗更少的带宽和时间下载 App。
在以下场景中，减小 App 体积对提升用户体验具有重要意义：

- App 的应用场景对 App 体积有严格要求。例如运行在储存空间有限的智能穿戴设备上。
- App 的目标用户群体位于欠发达地区，网络环境较差，导致 App 下载时间过长。

本文介绍如何减少集成声网实时互动 SDK 的 App 体积。

## 使用音频 SDK [#使用音频-sdk-5]

Unity 视频 SDK 支持音频和视频功能，包体积大。如果你只需使用音频功能，建议你集成 Unity 音频 SDK，详见[实现纯语音互动](/zh-CN/realtime-media/rtc/build/audio/audio-quick-start#集成-sdk)。

## 删除不需要的插件 [#删除不需要的插件-5]

SDK 提供了可选的插件动态库，插件的命名以 `extension` 为后缀，插件功能和大小等信息详见[插件列表](#插件列表-5)。你可以参考如下方式不集成这些插件，以减小 App 体积。

### 在集成 SDK 时删除 [#在集成-sdk-时删除]
在 Unity Editor 中打开 `Assets/Agora-RTC-Plugin/Agora-Unity-RTC-SDK/Plugins` 文件夹。其中分别包含了 iOS、macOS、Windows 和 Android 四个平台的动态库。如下图所示：

<DocsImage alt="unity editor" src="https://web-cdn.agora.io/docs-portal/img/rtc/unity-app-size.png" displayWidth="70%" />

- **Android**：如果你的目标平台为 Android，可以在 `Android/AgoraRtcEngineKit.plugin/libs` 路径下，根据需求删除 `arm64-v8a`、`armeabi-v7a`、`x86`、`x86_64` 文件夹中的 `_extension.so` 文件。
- **iOS**：如果你的目标平台为 iOS ，可以根据需求删除 `iOS` 文件夹中无需使用的 `***Extension.framework` 文件。
- **macOS**：如果你的目标平台为 macOS，可以在 `macOS/AgoraRtcWrapperUnity.bundle/Contents/Frameworks` 路径下，根据需求删除无需使用的 `***Extension.framework` 文件。
- **Windows**：如果你的目标平台为 Windows，可以根据需求删除 `x86` 或 `x86_64` 文件夹中无需使用的 `***extension.dll` 或 `***extension.dll.lib` 文件。

### 在导出的原生工程中删除 [#在导出的原生工程中删除]

当你导出某个目标平台的原生工程后，Unity Editor 里对应平台的动态库也会一起拷贝到原生工程中。此时你可以在导出后的原生工程中直接删除以 `extension` 结尾的动态库。

## 参考信息 [#参考信息-5]

### 插件列表 [#插件列表-5]

本节提供实时互动 SDK 各插件简介和集成后 App 增加的体积参考。

:::info[信息]
- 本节数据基于实时互动 v4.6.0 SDK。
- 自 v4.6.2 起，iOS 平台不再提供 armv7 架构的插件。
:::

<Accordions>
<Accordion title="AI 降噪插件">

实时互动 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                        |

</Accordion>

<Accordion title="AI 回声消除插件">

自 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                        |

</Accordion>

<Accordion title="美声插件">

美声插件提供一系列预设的人声效果，也支持通过音调、声音均衡和混响等设置自定义人声效果，广泛应用于语音连麦、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                        |

</Accordion>

<Accordion title="视频增强插件">

视频增强插件提供基础美颜、视频降噪、暗光增强、色彩增强等能力。你可以在集成视频增强插件后，调用如下方法开启你想要的视频增强功能：

- `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                        |

</Accordion>

<Accordion title="本地截图上传插件">

本地截图上传插件提供对本地用户发送的视频进行截图、上传的能力，以满足对视频内容监管的需求。集成本地截图上传插件后，你可以调用 `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                        |

</Accordion>

<Accordion title="PVC 插件">

:::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                        |

</Accordion>

<Accordion title="空间音频插件">

空间音频插件可以塑造远端用户声音的方位感和模拟声音在真实世界中的传播过程，实现本地用户听远端用户时的空间音频。

各平台插件名及集成后 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                        |

</Accordion>

<Accordion title="虚拟背景插件">

集成虚拟背景插件后，你可以调用 `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                        |

</Accordion>

<Accordion title="版权音乐插件">

自 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-unity-markdown-10-1-2 details](#table-slot-reduce-app-size-unity-markdown-10-1-2) | 1413 |
| Android | armeabi-v7a | [reduce-app-size-unity-markdown-10-2-2 details](#table-slot-reduce-app-size-unity-markdown-10-2-2) | 1014 |
| Android | x86 | [reduce-app-size-unity-markdown-10-3-2 details](#table-slot-reduce-app-size-unity-markdown-10-3-2) | 1403 |
| Android | x86_64 | [reduce-app-size-unity-markdown-10-4-2 details](#table-slot-reduce-app-size-unity-markdown-10-4-2) | 1444 |
| iOS | arm64 & armv7 | `AgoraDrmLoaderExtension.xcframework` | 1772 |

<a id="table-slot-reduce-app-size-unity-markdown-10-1-2"></a>

**reduce-app-size-unity-markdown-10-1-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

<a id="table-slot-reduce-app-size-unity-markdown-10-2-2"></a>

**reduce-app-size-unity-markdown-10-2-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

<a id="table-slot-reduce-app-size-unity-markdown-10-3-2"></a>

**reduce-app-size-unity-markdown-10-3-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

<a id="table-slot-reduce-app-size-unity-markdown-10-4-2"></a>

**reduce-app-size-unity-markdown-10-4-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

</Accordion>

<Accordion title="人脸识别插件">

自 v4.1.1 起，SDK 提供人脸识别插件，通过算法识别人脸或人像，在编码过程中对 ROI（Region of Interest）区域使用更高的质量编码，达到人脸或人像更清晰的效果。如需使用该功能，请[联系技术支持](https://ticket.shengwang.cn/)。

:::warning[注意]
人脸识别插件和 [`EnableFaceDetection`](/zh-CN/api-reference/rtc/unity/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                       |

</Accordion>

<Accordion title="面部捕捉插件">

自 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                       |

</Accordion>

<Accordion title="超分辨率插件">

:::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              |

</Accordion>

<Accordion title="屏幕共享插件">

屏幕共享插件提供屏幕共享功能，支持将自己的屏幕内容分享给观众或其他用户观看，以提高沟通效率。用法详见[屏幕共享](/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 |

</Accordion>

<Accordion title="视频质量评估插件">

自 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                        |

</Accordion>

<Accordion title="视频编码插件">

自 v4.2.0 起，SDK 提供视频编码插件，相比 SDK 原生编码方案，该插件提供更多编码选择，可以实现更快速、更高压缩率的视频编码。如需使用该功能，请[联系技术支持](https://ticket.shengwang.cn/)。

:::warning[注意]
使用视频编码插件必须根据目标平台同时集成下表中对应列出的两个库。
:::

| 平台 | 架构 | 库名 | 集成后 App 增加的体积 (KB) |
| --- | --- | --- | --- |
| Android | arm64-v8a | [reduce-app-size-unity-markdown-11-1-2 details](#table-slot-reduce-app-size-unity-markdown-11-1-2) | 945 |
| Android | armeabi-v7a | [reduce-app-size-unity-markdown-11-2-2 details](#table-slot-reduce-app-size-unity-markdown-11-2-2) | 873 |
| Android | x86 | [reduce-app-size-unity-markdown-11-3-2 details](#table-slot-reduce-app-size-unity-markdown-11-3-2) | 1125 |
| Android | x86_64 | [reduce-app-size-unity-markdown-11-4-2 details](#table-slot-reduce-app-size-unity-markdown-11-4-2) | 1126 |
| iOS | arm64 | [reduce-app-size-unity-markdown-11-5-2 details](#table-slot-reduce-app-size-unity-markdown-11-5-2) | 773 |
| iOS | armv7 | [reduce-app-size-unity-markdown-11-6-2 details](#table-slot-reduce-app-size-unity-markdown-11-6-2) | 788 |
| macOS | arm64 | [reduce-app-size-unity-markdown-11-7-2 details](#table-slot-reduce-app-size-unity-markdown-11-7-2) | 1504 |
| macOS | x86_64 | [reduce-app-size-unity-markdown-11-8-2 details](#table-slot-reduce-app-size-unity-markdown-11-8-2) | 2020 |
| Windows | x86 | [reduce-app-size-unity-markdown-11-9-2 details](#table-slot-reduce-app-size-unity-markdown-11-9-2) | 2501 |
| Windows | x86_64 | [reduce-app-size-unity-markdown-11-10-2 details](#table-slot-reduce-app-size-unity-markdown-11-10-2) | 2853 |

<a id="table-slot-reduce-app-size-unity-markdown-11-1-2"></a>

**reduce-app-size-unity-markdown-11-1-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-unity-markdown-11-2-2"></a>

**reduce-app-size-unity-markdown-11-2-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-unity-markdown-11-3-2"></a>

**reduce-app-size-unity-markdown-11-3-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-unity-markdown-11-4-2"></a>

**reduce-app-size-unity-markdown-11-4-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-unity-markdown-11-5-2"></a>

**reduce-app-size-unity-markdown-11-5-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-unity-markdown-11-6-2"></a>

**reduce-app-size-unity-markdown-11-6-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-unity-markdown-11-7-2"></a>

**reduce-app-size-unity-markdown-11-7-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-unity-markdown-11-8-2"></a>

**reduce-app-size-unity-markdown-11-8-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-unity-markdown-11-9-2"></a>

**reduce-app-size-unity-markdown-11-9-2 details**

- `libagora_video_encoder_extension.dll`
- `video_enc.dll`

<a id="table-slot-reduce-app-size-unity-markdown-11-10-2"></a>

**reduce-app-size-unity-markdown-11-10-2 details**

- `libagora_video_encoder_extension.dll`
- `video_enc.dll`

</Accordion>

<Accordion title="视频解码插件">

自 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-unity-markdown-12-1-2 details](#table-slot-reduce-app-size-unity-markdown-12-1-2) | 817 |
| Android | armeabi-v7a | [reduce-app-size-unity-markdown-12-2-2 details](#table-slot-reduce-app-size-unity-markdown-12-2-2) | 763 |
| Android | x86 | [reduce-app-size-unity-markdown-12-3-2 details](#table-slot-reduce-app-size-unity-markdown-12-3-2) | 952 |
| Android | x86_64 | [reduce-app-size-unity-markdown-12-4-2 details](#table-slot-reduce-app-size-unity-markdown-12-4-2) | 976 |
| iOS | arm64 | [reduce-app-size-unity-markdown-12-5-2 details](#table-slot-reduce-app-size-unity-markdown-12-5-2) | 635 |
| iOS | armv7 | [reduce-app-size-unity-markdown-12-6-2 details](#table-slot-reduce-app-size-unity-markdown-12-6-2) | 662 |
| macOS | arm64 | [reduce-app-size-unity-markdown-12-7-2 details](#table-slot-reduce-app-size-unity-markdown-12-7-2) | 1296 |
| macOS | x86_64 | [reduce-app-size-unity-markdown-12-8-2 details](#table-slot-reduce-app-size-unity-markdown-12-8-2) | 1848 |
| Windows | x86 | [reduce-app-size-unity-markdown-12-9-2 details](#table-slot-reduce-app-size-unity-markdown-12-9-2) | 2115 |
| Windows | x86_64 | [reduce-app-size-unity-markdown-12-10-2 details](#table-slot-reduce-app-size-unity-markdown-12-10-2) | 2421 |

<a id="table-slot-reduce-app-size-unity-markdown-12-1-2"></a>

**reduce-app-size-unity-markdown-12-1-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-unity-markdown-12-2-2"></a>

**reduce-app-size-unity-markdown-12-2-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-unity-markdown-12-3-2"></a>

**reduce-app-size-unity-markdown-12-3-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-unity-markdown-12-4-2"></a>

**reduce-app-size-unity-markdown-12-4-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-unity-markdown-12-5-2"></a>

**reduce-app-size-unity-markdown-12-5-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-unity-markdown-12-6-2"></a>

**reduce-app-size-unity-markdown-12-6-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-unity-markdown-12-7-2"></a>

**reduce-app-size-unity-markdown-12-7-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-unity-markdown-12-8-2"></a>

**reduce-app-size-unity-markdown-12-8-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-unity-markdown-12-9-2"></a>

**reduce-app-size-unity-markdown-12-9-2 details**

- `libagora_video_decoder_extension.dll`
- `video_dec.dll`

<a id="table-slot-reduce-app-size-unity-markdown-12-10-2"></a>

**reduce-app-size-unity-markdown-12-10-2 details**

- `libagora_video_decoder_extension.dll`
- `video_dec.dll`

</Accordion>

<Accordion title="AV1 码流编码插件">

自 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                   |

</Accordion>

<Accordion title="AV1 码流解码插件">

自 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                   |

</Accordion>

<Accordion title="语音驱动插件">

:::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                        |

</Accordion>
</Accordions>

### 常见问题 [#常见问题-5]

- [为什么 SDK 中使用的是动态库而不是静态库？](/zh-CN/reference/faq/integration/dynamic_or_static_library)
<_PlatformProcessedMarker close="true" />

<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="flutter" />
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 架构的插件。
:::

<Accordions>
<Accordion title="AI 降噪插件">

实时互动 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                        |

</Accordion>

<Accordion title="AI 回声消除插件">

自 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                        |

</Accordion>

<Accordion title="美声插件">

美声插件提供一系列预设的人声效果，也支持通过音调、声音均衡和混响等设置自定义人声效果，广泛应用于语音连麦、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                        |

</Accordion>

<Accordion title="视频增强插件">

视频增强插件提供基础美颜、视频降噪、暗光增强、色彩增强等能力。你可以在集成视频增强插件后，调用如下方法开启你想要的视频增强功能：

- `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                        |

</Accordion>

<Accordion title="本地截图上传插件">

本地截图上传插件提供对本地用户发送的视频进行截图、上传的能力，以满足对视频内容监管的需求。集成本地截图上传插件后，你可以调用 `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                        |

</Accordion>

<Accordion title="PVC 插件">

:::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                        |

</Accordion>

<Accordion title="空间音频插件">

空间音频插件可以塑造远端用户声音的方位感和模拟声音在真实世界中的传播过程，实现本地用户听远端用户时的空间音频。

各平台插件名及集成后 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                        |

</Accordion>

<Accordion title="虚拟背景插件">

集成虚拟背景插件后，你可以调用 `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                        |

</Accordion>

<Accordion title="版权音乐插件">

自 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 |

<a id="table-slot-reduce-app-size-rn-flutter-markdown-10-1-2"></a>

**reduce-app-size-rn-flutter-markdown-10-1-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-10-2-2"></a>

**reduce-app-size-rn-flutter-markdown-10-2-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-10-3-2"></a>

**reduce-app-size-rn-flutter-markdown-10-3-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-10-4-2"></a>

**reduce-app-size-rn-flutter-markdown-10-4-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

</Accordion>

<Accordion title="人脸识别插件">

自 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                       |

</Accordion>

<Accordion title="面部捕捉插件">

自 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                       |

</Accordion>

<Accordion title="超分辨率插件">

:::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              |

</Accordion>

<Accordion title="屏幕共享插件">

屏幕共享插件提供屏幕共享功能，支持将自己的屏幕内容分享给观众或其他用户观看，以提高沟通效率。用法详见[屏幕共享](/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 |

</Accordion>

<Accordion title="视频质量评估插件">

自 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                        |

</Accordion>

<Accordion title="视频编码插件">

自 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 |

<a id="table-slot-reduce-app-size-rn-flutter-markdown-11-1-2"></a>

**reduce-app-size-rn-flutter-markdown-11-1-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-11-2-2"></a>

**reduce-app-size-rn-flutter-markdown-11-2-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-11-3-2"></a>

**reduce-app-size-rn-flutter-markdown-11-3-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-11-4-2"></a>

**reduce-app-size-rn-flutter-markdown-11-4-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-11-5-2"></a>

**reduce-app-size-rn-flutter-markdown-11-5-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-11-6-2"></a>

**reduce-app-size-rn-flutter-markdown-11-6-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-11-7-2"></a>

**reduce-app-size-rn-flutter-markdown-11-7-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-11-8-2"></a>

**reduce-app-size-rn-flutter-markdown-11-8-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-11-9-2"></a>

**reduce-app-size-rn-flutter-markdown-11-9-2 details**

- `libagora_video_encoder_extension.dll`
- `video_enc.dll`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-11-10-2"></a>

**reduce-app-size-rn-flutter-markdown-11-10-2 details**

- `libagora_video_encoder_extension.dll`
- `video_enc.dll`

</Accordion>

<Accordion title="视频解码插件">

自 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 |

<a id="table-slot-reduce-app-size-rn-flutter-markdown-12-1-2"></a>

**reduce-app-size-rn-flutter-markdown-12-1-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-12-2-2"></a>

**reduce-app-size-rn-flutter-markdown-12-2-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-12-3-2"></a>

**reduce-app-size-rn-flutter-markdown-12-3-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-12-4-2"></a>

**reduce-app-size-rn-flutter-markdown-12-4-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-12-5-2"></a>

**reduce-app-size-rn-flutter-markdown-12-5-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-12-6-2"></a>

**reduce-app-size-rn-flutter-markdown-12-6-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-12-7-2"></a>

**reduce-app-size-rn-flutter-markdown-12-7-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-12-8-2"></a>

**reduce-app-size-rn-flutter-markdown-12-8-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-12-9-2"></a>

**reduce-app-size-rn-flutter-markdown-12-9-2 details**

- `libagora_video_decoder_extension.dll`
- `video_dec.dll`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-12-10-2"></a>

**reduce-app-size-rn-flutter-markdown-12-10-2 details**

- `libagora_video_decoder_extension.dll`
- `video_dec.dll`

</Accordion>

<Accordion title="AV1 码流编码插件">

自 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                   |

</Accordion>

<Accordion title="AV1 码流解码插件">

自 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                   |

</Accordion>

<Accordion title="语音驱动插件">

:::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                        |

</Accordion>
</Accordions>

### 常见问题 [#常见问题-6]

- [为什么 SDK 中使用的是动态库而不是静态库？](/zh-CN/reference/faq/integration/dynamic_or_static_library)
<_PlatformProcessedMarker close="true" />

<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="react-native" />
App 体积是影响用户体验的重要因素之一，更小的包体积意味着用户可以消耗更少的带宽和时间下载 App。
在以下场景中，减小 App 体积对提升用户体验具有重要意义：

- App 的应用场景对 App 体积有严格要求。例如运行在储存空间有限的智能穿戴设备上。
- App 的目标用户群体位于欠发达地区，网络环境较差，导致 App 下载时间过长。

本文介绍如何减少集成声网实时互动 SDK 的 App 体积。

## 删除不需要的插件 [#删除不需要的插件-7]

SDK 提供了可选的插件动态库，插件的命名以 `extension` 为后缀，插件功能和大小等信息详见[插件列表](#插件列表-7)。你可以参考如下方式不集成这些插件，以减小 App 体积。

### Android 平台 [#android-平台-1]

当你的目标开发平台为 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-平台-1]

如果你的目标开发平台为 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** 的最后一步。
    :::

## 参考信息 [#参考信息-7]

### 插件列表 [#插件列表-7]

本节提供实时互动 SDK 各插件简介和集成后 App 增加的体积参考。

:::info[信息]
- 本节数据基于实时互动 v4.6.0 SDK。
- 自 v4.6.2 起，iOS 平台不再提供 armv7 架构的插件。
:::

<Accordions>
<Accordion title="AI 降噪插件">

实时互动 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                        |

</Accordion>

<Accordion title="AI 回声消除插件">

自 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                        |

</Accordion>

<Accordion title="美声插件">

美声插件提供一系列预设的人声效果，也支持通过音调、声音均衡和混响等设置自定义人声效果，广泛应用于语音连麦、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                        |

</Accordion>

<Accordion title="视频增强插件">

视频增强插件提供基础美颜、视频降噪、暗光增强、色彩增强等能力。你可以在集成视频增强插件后，调用如下方法开启你想要的视频增强功能：

- `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                        |

</Accordion>

<Accordion title="本地截图上传插件">

本地截图上传插件提供对本地用户发送的视频进行截图、上传的能力，以满足对视频内容监管的需求。集成本地截图上传插件后，你可以调用 `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                        |

</Accordion>

<Accordion title="PVC 插件">

:::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                        |

</Accordion>

<Accordion title="空间音频插件">

空间音频插件可以塑造远端用户声音的方位感和模拟声音在真实世界中的传播过程，实现本地用户听远端用户时的空间音频。

各平台插件名及集成后 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                        |

</Accordion>

<Accordion title="虚拟背景插件">

集成虚拟背景插件后，你可以调用 `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                        |

</Accordion>

<Accordion title="版权音乐插件">

自 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-1) | 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-1) | 1014 |
| Android | x86 | [reduce-app-size-rn-flutter-markdown-10-3-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-10-3-2-1) | 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-1) | 1444 |
| iOS | arm64 & armv7 | `AgoraDrmLoaderExtension.xcframework` | 1772 |

<a id="table-slot-reduce-app-size-rn-flutter-markdown-10-1-2-1"></a>

**reduce-app-size-rn-flutter-markdown-10-1-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-10-2-2-1"></a>

**reduce-app-size-rn-flutter-markdown-10-2-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-10-3-2-1"></a>

**reduce-app-size-rn-flutter-markdown-10-3-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-10-4-2-1"></a>

**reduce-app-size-rn-flutter-markdown-10-4-2 details**

- `libagora_drm_loader_extension.so`
- `libagora_udrm3_extension.so`

</Accordion>

<Accordion title="人脸识别插件">

自 v4.1.1 起，SDK 提供人脸识别插件，通过算法识别人脸或人像，在编码过程中对 ROI（Region of Interest）区域使用更高的质量编码，达到人脸或人像更清晰的效果。如需使用该功能，请[联系技术支持](https://ticket.shengwang.cn/)。

:::warning[注意]
人脸识别插件和 [`enableFaceDetection`](/zh-CN/api-reference/rtc/react-native/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                       |

</Accordion>

<Accordion title="面部捕捉插件">

自 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                       |

</Accordion>

<Accordion title="超分辨率插件">

:::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              |

</Accordion>

<Accordion title="屏幕共享插件">

屏幕共享插件提供屏幕共享功能，支持将自己的屏幕内容分享给观众或其他用户观看，以提高沟通效率。用法详见[屏幕共享](/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 |

</Accordion>

<Accordion title="视频质量评估插件">

自 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                        |

</Accordion>

<Accordion title="视频编码插件">

自 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-1) | 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-1) | 873 |
| Android | x86 | [reduce-app-size-rn-flutter-markdown-11-3-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-11-3-2-1) | 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-1) | 1126 |
| iOS | arm64 | [reduce-app-size-rn-flutter-markdown-11-5-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-11-5-2-1) | 773 |
| iOS | armv7 | [reduce-app-size-rn-flutter-markdown-11-6-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-11-6-2-1) | 788 |
| macOS | arm64 | [reduce-app-size-rn-flutter-markdown-11-7-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-11-7-2-1) | 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-1) | 2020 |
| Windows | x86 | [reduce-app-size-rn-flutter-markdown-11-9-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-11-9-2-1) | 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-1) | 2853 |

<a id="table-slot-reduce-app-size-rn-flutter-markdown-11-1-2-1"></a>

**reduce-app-size-rn-flutter-markdown-11-1-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-11-2-2-1"></a>

**reduce-app-size-rn-flutter-markdown-11-2-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-11-3-2-1"></a>

**reduce-app-size-rn-flutter-markdown-11-3-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-11-4-2-1"></a>

**reduce-app-size-rn-flutter-markdown-11-4-2 details**

- `libagora_video_encoder_extension.so`
- `libvideo_enc.so`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-11-5-2-1"></a>

**reduce-app-size-rn-flutter-markdown-11-5-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-11-6-2-1"></a>

**reduce-app-size-rn-flutter-markdown-11-6-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-11-7-2-1"></a>

**reduce-app-size-rn-flutter-markdown-11-7-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-11-8-2-1"></a>

**reduce-app-size-rn-flutter-markdown-11-8-2 details**

- `AgoraVideoEncoderExtension.xcframework`
- `video_enc.xcframework`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-11-9-2-1"></a>

**reduce-app-size-rn-flutter-markdown-11-9-2 details**

- `libagora_video_encoder_extension.dll`
- `video_enc.dll`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-11-10-2-1"></a>

**reduce-app-size-rn-flutter-markdown-11-10-2 details**

- `libagora_video_encoder_extension.dll`
- `video_enc.dll`

</Accordion>

<Accordion title="视频解码插件">

自 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-1) | 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-1) | 763 |
| Android | x86 | [reduce-app-size-rn-flutter-markdown-12-3-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-12-3-2-1) | 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-1) | 976 |
| iOS | arm64 | [reduce-app-size-rn-flutter-markdown-12-5-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-12-5-2-1) | 635 |
| iOS | armv7 | [reduce-app-size-rn-flutter-markdown-12-6-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-12-6-2-1) | 662 |
| macOS | arm64 | [reduce-app-size-rn-flutter-markdown-12-7-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-12-7-2-1) | 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-1) | 1848 |
| Windows | x86 | [reduce-app-size-rn-flutter-markdown-12-9-2 details](#table-slot-reduce-app-size-rn-flutter-markdown-12-9-2-1) | 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-1) | 2421 |

<a id="table-slot-reduce-app-size-rn-flutter-markdown-12-1-2-1"></a>

**reduce-app-size-rn-flutter-markdown-12-1-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-12-2-2-1"></a>

**reduce-app-size-rn-flutter-markdown-12-2-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-12-3-2-1"></a>

**reduce-app-size-rn-flutter-markdown-12-3-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-12-4-2-1"></a>

**reduce-app-size-rn-flutter-markdown-12-4-2 details**

- `libagora_video_decoder_extension.so`
- `libvideo_dec.so`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-12-5-2-1"></a>

**reduce-app-size-rn-flutter-markdown-12-5-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-12-6-2-1"></a>

**reduce-app-size-rn-flutter-markdown-12-6-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-12-7-2-1"></a>

**reduce-app-size-rn-flutter-markdown-12-7-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-12-8-2-1"></a>

**reduce-app-size-rn-flutter-markdown-12-8-2 details**

- `AgoraVideoDecoderExtension.xcframework`
- `video_dec.xcframework`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-12-9-2-1"></a>

**reduce-app-size-rn-flutter-markdown-12-9-2 details**

- `libagora_video_decoder_extension.dll`
- `video_dec.dll`

<a id="table-slot-reduce-app-size-rn-flutter-markdown-12-10-2-1"></a>

**reduce-app-size-rn-flutter-markdown-12-10-2 details**

- `libagora_video_decoder_extension.dll`
- `video_dec.dll`

</Accordion>

<Accordion title="AV1 码流编码插件">

自 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                   |

</Accordion>

<Accordion title="AV1 码流解码插件">

自 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                   |

</Accordion>

<Accordion title="语音驱动插件">

:::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                        |

</Accordion>
</Accordions>

### 常见问题 [#常见问题-7]

- [为什么 SDK 中使用的是动态库而不是静态库？](/zh-CN/reference/faq/integration/dynamic_or_static_library)
<_PlatformProcessedMarker close="true" />
</_PlatformTabsGroup>