微信公众平台:高清语音素材获取接口上线

回复 星标
更多

微信公众平台:高清语音素材获取接口上线


使用JSSDK的uploadVoice接口,上传用户录音后,开发者可以通过高清语音素材获取接口,下载获得16K采样率的音频文件。该音频文件适合语音识别等对清晰度要求较高的场景。


音频格式为speex,如需转换成其他格式,可以使用我们提供的解码库自行转换。


详情可参考文档《获取临时素材》。


获取临时素材

公众号可以使用本接口获取临时素材(即下载临时的多媒体文件)。请注意,视频文件不支持https下载,调用该接口需http协议。

本接口即为原“下载多媒体文件”接口。

接口调用请求说明

参数说明

参数是否必须说明
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采样率)更加清晰,适合用作语音识别等对音质要求较高的业务。

接口调用请求说明

参数说明

参数是否必须说明
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/ ,并结合微信的解码库(含示例代码:下载地址)。

新窗口打开 关闭