微信公众平台:高清语音素材获取接口上线
使用JSSDK的uploadVoice接口,上传用户录音后,开发者可以通过高清语音素材获取接口,下载获得16K采样率的音频文件。该音频文件适合语音识别等对清晰度要求较高的场景。
音频格式为speex,如需转换成其他格式,可以使用我们提供的解码库自行转换。
详情可参考文档《获取临时素材》。
获取临时素材
公众号可以使用本接口获取临时素材(即下载临时的多媒体文件)。请注意,视频文件不支持https下载,调用该接口需http协议。
本接口即为原“下载多媒体文件”接口。
接口调用请求说明
http请求方式: GET,https调用
https://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID
请求示例(示例为通过curl命令获取多媒体文件)
curl -I -G "https://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID"
参数说明
参数 | 是否必须 | 说明 |
access_token | 是 | 调用接口凭证 |
media_id | 是 | 媒体文件ID |
返回说明
正确情况下的返回HTTP头如下:
HTTP/1.1 200 OK
Connection: close
Content-Type: image/jpeg
Content-disposition: attachment; filename="MEDIA_ID.jpg"
Date: Sun, 06 Jan 2013 10:20:18 GMT
Cache-Control: no-cache, must-revalidate
Content-Length: 339721
curl -G "https://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID"
如果返回的是视频消息素材,则内容如下:
"video_url":DOWN_URL
}
错误情况下的返回JSON数据包示例如下(示例为无效媒体ID错误):
{"errcode":40007,"errmsg":"invalid media_id"}
附录:高清语音素材获取接口
公众号可以使用本接口获取从JSSDK的uploadVoice接口上传的临时语音素材,格式为speex,16K采样率。该音频比上文的临时素材获取接口(格式为amr,8K采样率)更加清晰,适合用作语音识别等对音质要求较高的业务。
接口调用请求说明
http请求方式: GET,https调用
https://api.weixin.qq.com/cgi-bin/media/get/jssdk?access_token=ACCESS_TOKEN&media_id=MEDIA_ID
请求示例(示例为通过curl命令获取多媒体文件)
curl -I -G "https://api.weixin.qq.com/cgi-bin/media/get/jssdk?access_token=ACCESS_TOKEN&media_id=MEDIA_ID"
参数说明
参数 | 是否必须 | 说明 |
access_token | 是 | 调用接口凭证 |
media_id | 是 | 媒体文件ID,即uploadVoice接口返回的serverID |
返回说明
正确情况下的返回HTTP头如下:
HTTP/1.1 200 OK
Connection: close
Content-Type: voice/speex
Content-disposition: attachment; filename="MEDIA_ID.speex"
Date: Sun, 06 Jan 2016 10:20:18 GMT
Cache-Control: no-cache, must-revalidate
Content-Length: 339721
curl -G "https://api.weixin.qq.com/cgi-bin/media/get/jssdk?access_token=ACCESS_TOKEN&media_id=MEDIA_ID"
错误情况下的返回JSON数据包示例如下(示例为无效媒体ID错误):
{"errcode":40007,"errmsg":"invalid media_id"}
如果speex音频格式不符合业务需求,开发者可在获取后,再自行于本地对该语音素材进行转码。
转码请使用speex的官方解码库 http://speex.org/downloads/ ,并结合微信的解码库(含示例代码:下载地址)。