减小 App 体积
- React Native
更新时间
了解实时互动 RTC 在不同平台上的减小 App 体积方式,包括接入流程、关键配置和平台差异。
App 体积是影响用户体验的重要因素之一,更小的包体积意味着用户可以消耗更少的带宽和时间下载 App。在以下场景中,减小 App 体积对提升用户体验具有重要意义:
- App 的应用场景对 App 体积有严格要求。例如运行在储存空间有限的智能穿戴设备上。
- App 的目标用户群体位于欠发达地区,网络环境较差,导致 App 下载时间过长。
本文介绍如何减少集成声网实时互动 SDK 的 App 体积。
使用音频 SDK
视频 SDK 支持音频和视频功能,包体积大。如果你只需使用音频功能,建议你集成音频 SDK,详见实现纯语音互动。
信息
目前,实时互动 SDK 在 Windows 和 macOS 平台仅提供视频 SDK 下载。
按需集成 FFmpeg 插件
自 v4.7.0 起,音频 SDK 将 FFmpeg 调整为可按需集成的插件 libagora_ffmpeg_extension.so,SDK 包中默认包含该插件。
FFmpeg 插件用于扩展 MediaPlayer 的音频文件播放能力,并依赖 libaosl.so。如果你的应用不需要 FFmpeg 提供的相关播放能力,可以在集成时移除或不链接 libagora_ffmpeg_extension.so,以减小 App 体积。移除后,MediaPlayer 将使用系统原生播放能力,实际支持的音频文件格式取决于系统支持的容器格式和音频编解码器;如需播放系统原生能力之外的音频格式,请继续集成 FFmpeg 插件。
使用 Lite SDK
自 v4.4.0 起,声网提供实时互动 Lite SDK,提供基本的音视频通话功能,包体积较小。如果你只需使用基本的音视频通话功能,建议你集成 Lite SDK,详见下载。
Lite SDK 仅包含以下插件,其他插件列表中的插件及相关功能均不支持:
- 视频编码插件
- 视频解码插件
注意
Lite SDK 默认无法与 RTC 小程序 SDK 互通。如果需要与小程序互通,请联系技术支持。
删除不需要的插件
SDK 提供了可选的插件动态库,插件的命名以 extension 为后缀,插件功能和大小等信息详见插件列表。你可以参考如下方式不集成这些插件,以减小 App 体积。
手动集成时删除插件
通过官网 SDK 下载链接集成时,你可以将不需要使用的插件文件直接删除。
Gradle 自动集成时删除插件
通过 Gradle 自动集成 Android SDK 前,请先确保已添加声网 Maven CDN 仓库。具体配置方式请参考下载 SDK。
通过 Gradle 自动集成 Android SDK 时,你可以修改 /Gradle Scripts/build.gradle(Module: <projectname>.app) 文件中的 dependencies,以指定集成你需要的动态库,排除你不需要使用的插件。Android SDK 中各文件与 dependencies 中 implementation 字段的对应关系详见 implementation 字段。
集成 4.0.1 版 Android 视频 SDK,且使用所有插件时,dependencies 如下:
dependencies {
implementation 'io.agora.rtc:full-sdk:4.0.1'
implementation 'io.agora.rtc:full-screen-sharing:4.0.1'
...
}集成 4.0.1 版 Android 视频 SDK,且不使用所有插件时,dependencies 如下:
dependencies {
implementation 'io.agora.rtc:full-rtc-basic:4.0.1'
...
}集成 4.0.1 版 Android 视频 SDK 且只需要使用插件列表中的 AI 降噪插件和美声插件时,dependencies 如下:
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}"
...
}参考信息
插件列表
本节提供实时互动 SDK 各插件简介和集成后 App 增加的体积参考。
信息
- 本节数据基于实时互动 v4.6.0 SDK。
- 自 v4.6.2 起,iOS 平台不再提供 armv7 架构的插件。
implementation 字段
通过 Gradle 自动集成 Android SDK 时,你可以修改 /Gradle Scripts/build.gradle(Module: <projectname>.app) 文件中的 dependencies 中的 implementation 字段,以指定需要集成的动态库。SDK 中各文件与 implementation 字段的对应关系详见下表:
| 文件 | 类别 | implementation 字段 |
|---|---|---|
| 必需 | 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) |
| 可选 | io.agora.rtc:full-video-codec-enc (≥ v4.2.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) |
| 文件 | 类别 | implementation 字段 |
|---|---|---|
| 必需 | 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) |
常见问题
App 体积是影响用户体验的重要因素之一,更小的包体积意味着用户可以消耗更少的带宽和时间下载 App。 在以下场景中,减小 App 体积对提升用户体验具有重要意义:
- App 的应用场景对 App 体积有严格要求。例如运行在储存空间有限的智能穿戴设备上。
- App 的目标用户群体位于欠发达地区,网络环境较差,导致 App 下载时间过长。
本文介绍如何减少集成声网实时互动 SDK 的 App 体积。
使用音频 SDK
视频 SDK 支持音频和视频功能,包体积大。如果你只需使用音频功能,建议你集成音频 SDK,详见实现纯语音互动。
信息
目前,实时互动 SDK 在 Windows 和 macOS 平台仅提供视频 SDK 下载。
按需集成 FFmpeg 插件
自 v4.7.0 起,音频 SDK 将 FFmpeg 调整为可按需集成的插件 AgoraffmpegExtension.xcframework,SDK 包中默认包含该插件。
FFmpeg 插件用于扩展 MediaPlayer 的音频文件播放能力,并依赖 aosl.xcframework。如果你的纯音频场景不需要 FFmpeg 提供的相关播放能力,可以在集成时移除或不链接 AgoraffmpegExtension.xcframework,以减小 App 体积。移除后,MediaPlayer 将使用系统原生播放能力,实际支持的音频文件格式取决于系统支持的容器格式和音频编解码器;如需播放系统原生能力之外的音频格式,请继续集成 FFmpeg 插件。
使用 Lite SDK
自 v4.4.0 起,声网提供实时互动 Lite SDK,提供基本的音视频通话功能,包体积较小。如果你只需使用基本的音视频通话功能,建议你集成 Lite SDK,详见下载。
Lite SDK 仅包含以下插件,其他插件列表中的插件及相关功能均不支持:
- 视频编码插件
- 视频解码插件
注意
Lite SDK 默认无法与 RTC 小程序 SDK 互通。如果需要与小程序互通,请联系技术支持。
删除不需要的插件
SDK 提供了可选的插件动态库,插件的命名以 extension 为后缀,插件功能和大小等信息详见插件列表。你可以参考如下方式不集成这些插件,以减小 App 体积。
手动集成时删除插件
通过官网 SDK 下载链接集成时,你可以将不需要使用的插件文件直接删除。
CocoaPods 集成时删除插件
通过 CocoaPods 集成 iOS/macOS SDK 前,请先在 Podfile 顶部配置声网 CocoaPods CDN 源。具体配置方式请参考下载 SDK。
通过 CocoaPods 集成 iOS/macOS SDK 时,你可以在 Podfile 中使用 subspecs 字段指定集成你需要的动态库,以排除你不需要使用的插件。动态库与 subspecs 字段的对应关系详见 subspecs 字段。
以下示例省略了 Podfile 顶部的 source 配置,使用时请保留对应源的声明。
集成 4.0.1 版 iOS 视频 SDK,且使用所有插件时,Podfile 如下:
# platform :ios, '9.0'
target 'Your App' do
pod 'AgoraRtcEngine_iOS', '4.0.1'
end集成 4.0.1 版 iOS 视频 SDK,且不使用所有插件时,Podfile 如下:
# platform :ios, '9.0'
target 'Your App' do
pod 'AgoraRtcEngine_iOS', '4.0.1', :subspecs => ['RtcBasic']
end集成 4.0.1 版 iOS 视频 SDK 且只需要使用插件列表中的 AI 降噪插件和美声插件时,Podfile 如下:
# platform :ios, '9.0'
target 'Your App' do
pod 'AgoraRtcEngine_iOS', '4.0.1', :subspecs => ['RtcBasic', 'AINS', 'AudioBeauty']
end注意
填写上述 pod 命令时,请确保你指定版本的 SDK 具有你指定的插件,且插件的 subspecs 字段正确,否则 pod install 时会报错。例如,填写 pod 'AgoraRtcEngine_iOS', '4.0.1', :subspecs => ['RtcBasic', 'AgoraRtcAINS'] 时,pod install 时会报错。
参考信息
插件列表
本节提供实时互动 SDK 各插件简介和集成后 App 增加的体积参考。
信息
- 本节数据基于实时互动 v4.6.0 SDK。
- 自 v4.6.2 起,iOS 平台不再提供 armv7 架构的插件。
subspecs 字段
通过 CocoaPods 集成 iOS/macOS SDK 时,你可以在 Podfile 中使用 subspecs 字段指定集成你需要的动态库,以排除你不需要使用的插件。动态库与 subspecs 字段的对应关系详见下表:
| 动态库 | 类别 | subspecs 字段 |
|---|---|---|
| 必需 | 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) |
| 可选 | VideoCodecEnc (≥ v4.2.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) |
| 动态库 | 类别 | subspecs 字段 |
|---|---|---|
| 必需 | 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) |
| 动态库 | 类别 | subspecs 字段 |
|---|---|---|
| 必需 | 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) |
| 可选 | VideoCodecEnc (≥ v4.2.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) |
常见问题
App 体积是影响用户体验的重要因素之一,更小的包体积意味着用户可以消耗更少的带宽和时间下载 App。 在以下场景中,减小 App 体积对提升用户体验具有重要意义:
- App 的应用场景对 App 体积有严格要求。例如运行在储存空间有限的智能穿戴设备上。
- App 的目标用户群体位于欠发达地区,网络环境较差,导致 App 下载时间过长。
本文介绍如何减少集成声网实时互动 SDK 的 App 体积。
使用音频 SDK
视频 SDK 支持音频和视频功能,包体积大。如果你只需使用音频功能,建议你集成音频 SDK,详见实现纯语音互动。
信息
目前,实时互动 SDK 在 Windows 和 macOS 平台仅提供视频 SDK 下载。
删除不需要的插件
SDK 提供了可选的插件动态库,插件的命名以 extension 为后缀,插件功能和大小等信息详见插件列表。你可以参考如下方式不集成这些插件,以减小 App 体积。
手动集成时删除插件
通过官网 SDK 下载链接集成时,你可以将不需要使用的插件文件直接删除。
CocoaPods 集成时删除插件
通过 CocoaPods 集成 iOS/macOS SDK 前,请先在 Podfile 顶部配置声网 CocoaPods CDN 源。具体配置方式请参考下载 SDK。
通过 CocoaPods 集成 iOS/macOS SDK 时,你可以在 Podfile 中使用 subspecs 字段指定集成你需要的动态库,以排除你不需要使用的插件。动态库与 subspecs 字段的对应关系详见 subspecs 字段。
以下示例省略了 Podfile 顶部的 source 配置,使用时请保留对应源的声明。
集成 4.0.1 版 iOS 视频 SDK,且使用所有插件时,Podfile 如下:
# platform :ios, '9.0'
target 'Your App' do
pod 'AgoraRtcEngine_iOS', '4.0.1'
end集成 4.0.1 版 iOS 视频 SDK,且不使用所有插件时,Podfile 如下:
# platform :ios, '9.0'
target 'Your App' do
pod 'AgoraRtcEngine_iOS', '4.0.1', :subspecs => ['RtcBasic']
end集成 4.0.1 版 iOS 视频 SDK 且只需要使用插件列表中的 AI 降噪插件和美声插件时,Podfile 如下:
# platform :ios, '9.0'
target 'Your App' do
pod 'AgoraRtcEngine_iOS', '4.0.1', :subspecs => ['RtcBasic', 'AINS', 'AudioBeauty']
end注意
填写上述 pod 命令时,请确保你指定版本的 SDK 具有你指定的插件,且插件的 subspecs 字段正确,否则 pod install 时会报错。例如,填写 pod 'AgoraRtcEngine_iOS', '4.0.1', :subspecs => ['RtcBasic', 'AgoraRtcAINS'] 时,pod install 时会报错。
参考信息
插件列表
本节提供实时互动 SDK 各插件简介和集成后 App 增加的体积参考。
信息
- 本节数据基于实时互动 v4.6.0 SDK。
- 自 v4.6.2 起,iOS 平台不再提供 armv7 架构的插件。
subspecs 字段
通过 CocoaPods 集成 iOS/macOS SDK 时,你可以在 Podfile 中使用 subspecs 字段指定集成你需要的动态库,以排除你不需要使用的插件。动态库与 subspecs 字段的对应关系详见下表:
| 动态库 | 类别 | subspecs 字段 |
|---|---|---|
| 必需 | 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) |
| 可选 | VideoCodecEnc (≥ v4.2.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) |
| 动态库 | 类别 | subspecs 字段 |
|---|---|---|
| 必需 | 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) |
| 动态库 | 类别 | subspecs 字段 |
|---|---|---|
| 必需 | 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) |
| 可选 | VideoCodecEnc (≥ v4.2.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) |
常见问题
App 体积是影响用户体验的重要因素之一,更小的包体积意味着用户可以消耗更少的带宽和时间下载 App。 在以下场景中,减小 App 体积对提升用户体验具有重要意义:
- App 的应用场景对 App 体积有严格要求。例如运行在储存空间有限的智能穿戴设备上。
- App 的目标用户群体位于欠发达地区,网络环境较差,导致 App 下载时间过长。
本文介绍如何减少集成声网实时互动 SDK 的 App 体积。
使用音频 SDK
视频 SDK 支持音频和视频功能,包体积大。如果你只需使用音频功能,建议你集成音频 SDK,详见实现纯语音互动。
信息
目前,实时互动 SDK 在 Windows 和 macOS 平台仅提供视频 SDK 下载。
删除不需要的插件
SDK 提供了可选的插件动态库,插件的命名以 extension 为后缀,插件功能和大小等信息详见插件列表。你可以参考如下方式不集成这些插件,以减小 App 体积。
手动集成时删除插件
通过官网 SDK 下载链接集成时,你可以将不需要使用的插件文件直接删除。
参考信息
插件列表
本节提供实时互动 SDK 各插件简介和集成后 App 增加的体积参考。
信息
- 本节数据基于实时互动 v4.6.0 SDK。
- 自 v4.6.2 起,iOS 平台不再提供 armv7 架构的插件。
常见问题
App 体积是影响用户体验的重要因素之一,更小的包体积意味着用户可以消耗更少的带宽和时间下载 App。 在以下场景中,减小 App 体积对提升用户体验具有重要意义:
- App 的应用场景对 App 体积有严格要求。例如运行在储存空间有限的智能穿戴设备上。
- App 的目标用户群体位于欠发达地区,网络环境较差,导致 App 下载时间过长。
本文介绍如何减少集成声网实时互动 SDK 的 App 体积。
使用音频 SDK
视频 SDK 支持音频和视频功能,包体积大。如果你只需使用音频功能,建议你集成音频 SDK,详见实现纯语音互动。
信息
目前,实时互动 SDK 在 Windows 和 macOS 平台仅提供视频 SDK 下载。
删除不需要的插件
SDK 提供了可选的插件动态库,插件的命名以 extension 为后缀,插件功能和大小等信息详见插件列表。你可以参考如下方式不集成这些插件,以减小 App 体积。
手动集成时删除插件
通过官网 SDK 下载链接集成时,你可以将不需要使用的插件文件直接删除。
参考信息
插件列表
本节提供实时互动 SDK 各插件简介和集成后 App 增加的体积参考。
信息
- 本节数据基于实时互动 v4.6.0 SDK。
- 自 v4.6.2 起,iOS 平台不再提供 armv7 架构的插件。
常见问题
App 体积是影响用户体验的重要因素之一,更小的包体积意味着用户可以消耗更少的带宽和时间下载 App。 在以下场景中,减小 App 体积对提升用户体验具有重要意义:
- App 的应用场景对 App 体积有严格要求。例如运行在储存空间有限的智能穿戴设备上。
- App 的目标用户群体位于欠发达地区,网络环境较差,导致 App 下载时间过长。
本文介绍如何减少集成声网实时互动 SDK 的 App 体积。
使用音频 SDK
Unity 视频 SDK 支持音频和视频功能,包体积大。如果你只需使用音频功能,建议你集成 Unity 音频 SDK,详见实现纯语音互动。
删除不需要的插件
SDK 提供了可选的插件动态库,插件的命名以 extension 为后缀,插件功能和大小等信息详见插件列表。你可以参考如下方式不集成这些插件,以减小 App 体积。
在集成 SDK 时删除
在 Unity Editor 中打开 Assets/Agora-RTC-Plugin/Agora-Unity-RTC-SDK/Plugins 文件夹。其中分别包含了 iOS、macOS、Windows 和 Android 四个平台的动态库。如下图所示:
- 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 结尾的动态库。
参考信息
插件列表
本节提供实时互动 SDK 各插件简介和集成后 App 增加的体积参考。
信息
- 本节数据基于实时互动 v4.6.0 SDK。
- 自 v4.6.2 起,iOS 平台不再提供 armv7 架构的插件。
常见问题
App 体积是影响用户体验的重要因素之一,更小的包体积意味着用户可以消耗更少的带宽和时间下载 App。 在以下场景中,减小 App 体积对提升用户体验具有重要意义:
- App 的应用场景对 App 体积有严格要求。例如运行在储存空间有限的智能穿戴设备上。
- App 的目标用户群体位于欠发达地区,网络环境较差,导致 App 下载时间过长。
本文介绍如何减少集成声网实时互动 SDK 的 App 体积。
删除不需要的插件
SDK 提供了可选的插件动态库,插件的命名以 extension 为后缀,插件功能和大小等信息详见插件列表。你可以参考如下方式不集成这些插件,以减小 App 体积。
Android 平台
当你的目标开发平台为 Android 时,你可以使用 Gradle 的 packagingOptions.exclude 属性在打包过程中将不需要的插件动态库排除在最终的 APK 或 AAR 文件中,从而减小 App 体积并提高 App 性能。
在项目根目录下的 build.gradle 文件中,找到 android 模块下的 packagingOptions 配置块,并在其中添加 exclude 属性,指定要排除的插件动态库。参考以下示例排除指定插件:
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 平台
如果你的目标开发平台为 iOS 或 macOS,请参考以下步骤减小 App 体积:
-
在项目的
Podfile文件中添加以下脚本,将agora_rtc_engine里不需要的插件标记为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 -
如下图所示,使用 Xcode 打开项目,在 Build Phases 页签中添加一个 New Run Script Phase 用于移除不需要的插件。
参考上图进行到第 5 步时,将 Shell 指定为 /usr/bin/ruby,代码部分替换为以下脚本:
$stderr.puts "Removing Unnecessary Frameworks"
# 此处 frameworks_to_weaklink 中列出的插件应与步骤 1 中相同
frameworks_to_weaklink=["AgoraAiEchoCancellationExtension", "AgoraAiNoiseSuppressionExtension", "AgoraAudioBeautyExtension", "AgoraClearVisionExtension", "AgoraContentInspectExtension", "AgoraDrmLoaderExtension", "AgoraReplayKitExtension", "AgoraSpatialAudioExtension", "AgoraSuperResolutionExtension", "AgoraVideoQualityAnalyzerExtension", "AgoraVideoSegmentationExtension"]
for framework in frameworks_to_weaklink
framework_path = "#{ENV['BUILT_PRODUCTS_DIR']}/#{ENV['FRAMEWORKS_FOLDER_PATH']}/#{framework}.framework"
`rm -Rf "#{framework_path}"`
end注意
移除指定插件的 Run Script 需放在 Build Phases 的最后一步。
参考信息
插件列表
本节提供实时互动 SDK 各插件简介和集成后 App 增加的体积参考。
信息
- 本节数据基于实时互动 v4.6.0 SDK。
- 自 v4.6.2 起,iOS 平台不再提供 armv7 架构的插件。
常见问题
App 体积是影响用户体验的重要因素之一,更小的包体积意味着用户可以消耗更少的带宽和时间下载 App。 在以下场景中,减小 App 体积对提升用户体验具有重要意义:
- App 的应用场景对 App 体积有严格要求。例如运行在储存空间有限的智能穿戴设备上。
- App 的目标用户群体位于欠发达地区,网络环境较差,导致 App 下载时间过长。
本文介绍如何减少集成声网实时互动 SDK 的 App 体积。
删除不需要的插件
SDK 提供了可选的插件动态库,插件的命名以 extension 为后缀,插件功能和大小等信息详见插件列表。你可以参考如下方式不集成这些插件,以减小 App 体积。
Android 平台
当你的目标开发平台为 Android 时,你可以使用 Gradle 的 packagingOptions.exclude 属性在打包过程中将不需要的插件动态库排除在最终的 APK 或 AAR 文件中,从而减小 App 体积并提高 App 性能。
在项目根目录下的 build.gradle 文件中,找到 android 模块下的 packagingOptions 配置块,并在其中添加 exclude 属性,指定要排除的插件动态库。参考以下示例排除指定插件:
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 平台
如果你的目标开发平台为 iOS 或 macOS,请参考以下步骤减小 App 体积:
-
在项目的
Podfile文件中添加以下脚本,将agora_rtc_engine里不需要的插件标记为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 -
如下图所示,使用 Xcode 打开项目,在 Build Phases 页签中添加一个 New Run Script Phase 用于移除不需要的插件。
参考上图进行到第 5 步时,将 Shell 指定为 /usr/bin/ruby,代码部分替换为以下脚本:
$stderr.puts "Removing Unnecessary Frameworks"
# 此处 frameworks_to_weaklink 中列出的插件应与步骤 1 中相同
frameworks_to_weaklink=["AgoraAiEchoCancellationExtension", "AgoraAiNoiseSuppressionExtension", "AgoraAudioBeautyExtension", "AgoraClearVisionExtension", "AgoraContentInspectExtension", "AgoraDrmLoaderExtension", "AgoraReplayKitExtension", "AgoraSpatialAudioExtension", "AgoraSuperResolutionExtension", "AgoraVideoQualityAnalyzerExtension", "AgoraVideoSegmentationExtension"]
for framework in frameworks_to_weaklink
framework_path = "#{ENV['BUILT_PRODUCTS_DIR']}/#{ENV['FRAMEWORKS_FOLDER_PATH']}/#{framework}.framework"
`rm -Rf "#{framework_path}"`
end注意
移除指定插件的 Run Script 需放在 Build Phases 的最后一步。
参考信息
插件列表
本节提供实时互动 SDK 各插件简介和集成后 App 增加的体积参考。
信息
- 本节数据基于实时互动 v4.6.0 SDK。
- 自 v4.6.2 起,iOS 平台不再提供 armv7 架构的插件。