备案控制台
文档
产品文档
输入文档关键字查找
首页 对象存储 操作指南 数据处理 媒体处理 媒体处理参数 音频转码

音频转码

更新时间：
一键部署
产品详情
相关技术圈
我的收藏

您可以通过音频转码功能，将音频转换为需要的格式。本文介绍音频转码处理功能参数及示例。

使用场景

  • 音乐文件格式转换：用户从网络下载的音乐可能不是其设备或播放器支持的格式，需要转换音频格式才能进行播放。

  • 存储空间优化：高品质无损音频（如FLAC）占用大量存储空间，为了在移动设备上节省空间，用户会选择将其转码为有损但压缩率高的格式，如MP3。

  • 在线流媒体服务：在线音乐平台或广播电台会将原始音频文件转码成多种比特率版本，以适应不同网络条件下的传输需求，保证用户在低带宽环境下也能流畅收听。

  • 视频制作与后期处理：视频编辑时，原始音频素材可能需要根据项目要求进行转码，比如调整采样率、位深度以匹配影片的音轨规格，或者转换成适合于网络传播的压缩格式。

注意事项

  • 音频转码仅支持异步处理（x-oss-async-process处理方式）。

  • 使用音频转码前，需要先绑定IMM Project。关于控制台和API如何绑定，请参见快速入门和AttachOSSBucket。

  • 不支持匿名访问。

  • 必须拥有IMM处理所需的相关权限。更多信息，请参见权限。

  • 当使用默认采样率或声道数进行转码时，转码可能由于目标音频容器的兼容性而失败。

参数说明

操作名称：audio/convert

具体参数如下表所示。

参数

类型

是否必须

描述

ss

int

否

起始时间，单位为毫秒。取值：

  • 0（默认值）：从起始位置开始。

  • 大于0：从第ss毫秒开始。

t

int

否

转码时长，单位为毫秒。取值：

  • 0（默认值）：持续到结束位置。

  • 大于0：持续t毫秒。

f

string

是

音频容器：

  • mp3

  • aac

  • flac

  • oga

  • ac3

  • opus

  • amr

ar

int

否

音频采样率。默认与源音频一致，取值：

  • 8000

  • 11025

  • 12000

  • 16000

  • 22050

  • 24000

  • 32000

  • 44100

  • 48000

  • 64000

  • 88200

  • 96000

说明

不同格式支持的采样率有所不同，mp3仅支持48kHz及以下；opus支持8kHz、12kHz、16kHz、24kHz与48kHz；ac3支持32kHz、44.1kHz与48kHz；amr仅支持8kHz与16kHz。

ac

int

否

音频声道数。默认与源音频一致，取值范围：1~8。

说明

不同格式支持的声道数有所不同，mp3仅支持单、双声道；ac3最大支持6声道（5.1）；amr仅支持单声道。

aq

int

否

音频压缩质量。与参数ab互斥。取值范围：0~100。

ab

int

否

音频比特率（码率）。与参数aq互斥，单位为比特/秒（bps）。取值范围：1000~10000000。

abopt

string

否

音频码率选项。取值：

  • 0（默认值）：始终使用目标音频码率。

  • 1：源音频码率小于ab时使用源音频码率。

  • 2：源音频码率小于ab时返回失败。

说明

音频转码时也会用到sys/saveas和notify参数。更多信息，请参见另存为和消息通知。

使用REST API

将MP3格式转换为AAC格式

转码信息

  • 转码前

    • 音频格式：mp3

    • 音频名称：example.mp3

  • 处理方式

    • 转码时长：从输入媒体文件的第1000毫秒开始并持续60000毫秒进行音频转码

    • 转码完成消息通知：发送MNS消息

  • 转码后

    • 音频信息

      • 音频格式：aac

      • 音频配置：保持原有采样率与声道数

      • 音频码率：96 Kbps

    • 文件存储路径

      • aac文件：oss://outbucket/outobjprefix.aac

处理示例

// 对文件example.mp3进行音频转码。
POST /exmaple.mp3?x-oss-async-process HTTP/1.1
Host: video-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS qn6qrrqxo2oawuk53otf****:UNQDb7GapEgJkcde6OhZ9J****
 
x-oss-async-process=audio/convert,ss_10000,t_60000,f_aac,ab_96000|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQo/notify,topic_QXVkaW9Db252ZXJ0

将WAV格式转换为OPUS格式

转码信息

  • 转码前

    • 音频格式：wav

    • 音频名称：example.wav

  • 处理方式

    • 转码时长：全部音频

    • 转码完成消息通知：发送MNS消息

  • 转码后

    • 音频信息

      • 音频格式：opus

      • 音频配置：采样率为48kHz，声道为双声道

      • 音频码率：96 Kbps

    • 文件存储路径

      • opus文件：oss://outbucket/outobject.opus

处理示例

// 对文件example.wav进行音频转码。
POST /exmaple.wav?x-oss-async-process HTTP/1.1
Host: video-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS qn6qrrqxo2oawuk53otf****:UNQDb7GapEgJkcde6OhZ9J****
 
x-oss-async-process=audio/convert,f_opus,ab_96000,ar_48000,ac_2|sys/saveas,b_b3V0YnVja2V0, o_b3V0b2JqLnthdXRvZXh0fQo/notify,topic_QXVkaW9Db252ZXJ0

使用SDK

音频转码仅支持异步处理，SDK使用方法请参见使用SDK。

文档推荐
  • 本页导读 （1）
文档反馈