文档中心
全部产品
Console Agora.io 社区 提交工单

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

分类: 产品咨询类    平台: iOS / Android / macOS / Windows   最后更新时间: 2022/02/22 18:14:23

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

  • startAudioMixing: 支持单音轨或多音轨文件。
  • getAudioTrackCount: 支持单音轨或多音轨文件。
  • selectAudioTrack: 支持单音轨或多音轨文件。
  • getAudioFileInfo: 支持单音轨或多音轨文件。
  • 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 播放音频文件时,可播放如下格式的单、双音轨的本地或在线文件:

3GP、AAC、AMR、ASF、AVI、FLAC、M4A、M4V、MOV、MP3、MP4、TS、Ogg、WAV、WMA

该插件在各平台对应的动态库名称,详见 减少 App 体积