文档中心
视频通话 (Legacy)
Console Agora.io 社区 提交工单

Agora RTC SDK 支持播放哪些格式的音频文件?

分类: 产品咨询类    平台: iOS / Android / macOS / Windows   最后更新时间: 2022/08/08 22:41:29

Agora RTC SDK 提供一系列对音频文件进行管理的方法,各方法对单音轨或多音轨文件的支持情况如下:

  • startAudioMixing: 支持单音轨或多音轨文件。
  • getAudioTrackCount: 支持单音轨或多音轨文件。
  • selectAudioTrack: 支持单音轨或多音轨文件。
  • playEffect: 仅支持单音轨文件。
  • preloadEffect: 仅支持单音轨文件。
  • getEffectDuration: 仅支持单音轨文件。
  • startRhythmPlayer: 仅支持单音轨文件。
  • getAudioFileInfo: 支持单音轨或多音轨文件。

默认情况下,Agora RTC SDK 支持的音频文件格式详见基础音频文件格式。音频文件的容器格式(包括后缀名)必须与音频编解码器格式一致。

自 v3.6.2 起,Agora RTC SDK 提供全格式音频解码插件,支持更多格式的音频文件,详见扩展音频文件格式。该插件目前仅适用于调用 startAudioMixing 播放音频文件的场景。

基础音频文件格式

单音轨文件格式

Agora RTC SDK 支持如下格式的单音轨文件:

  • 在 Android 上,支持 Ogg、3GP、ASF、AV1、TS、MKV、MP4、WMA、WAV、M4A、MP3、AAC、ADTS 格式的本地和在线文件。
  • 在 iOS 和 macOS 上,支持 WAV、M4A、MP3、MP4、AAC、ADTS 格式的本地和在线文件。对于 MP4 和 M4A 格式的在线文件,媒体信息(moov)必须在媒体数据(mdat)之前。
  • 在 Windows 上,支持 MP4、TS、WMA、AAC 格式的本地和在线文件。

多音轨文件格式

Agora RTC SDK 支持如下格式的多音轨文件:

  • 在 Android 上,支持 M4A、MP4、MKV 格式的本地和在线文件。播放 MP4 格式的多音轨文件时,不支持切换至第二音轨。
  • 在 iOS 和 macOS 上,支持 M4A 和 MP4 格式的本地文件和在线文件。对于在线文件,媒体信息(moov)必须在媒体数据(mdat)之前。
  • 在 Windows 上,支持 M4A 格式的本地和在线文件。

扩展音频文件格式

如果你使用 3.6.2 或之后版本的 SDK,且集成了全格式音频解码插件,在调用 startAudioMixing 播放音频文件时,支持的文件类型如下:

平台 文件来源 文件音轨 文件容器格式 音频编解码器格式
Android、iOS、macOS、Windows 本地、在线 单音轨、多音轨 3GP、AAC、AMR、ASF、AVI、FLAC、M4A、M4V、MOV、MP3、MP4、TS、Ogg、WAV、WMA AAC、ARM、FALC、MP2、MP3、PCM、Vorbis、 WMAV2、OPUS
该插件在各平台对应的动态库名称,详见减少 App 体积

注意事项

  • 部分安卓设备(如小米)因系统兼容问题,在使用 playEffectpreloadEffect 读取 3GP 格式的文件时可能会出现问题。
  • 因为部分 Android 设备不支持 WMA 格式,所以在这些设备上使用 Agora 的 API 播放 WMA 文件时会失败。