微信公众号原创分享样式(微信公众号开发之新增临时素材)

一、新增临时素材

公众号经常有需要用到一些临时性的多媒体素材的场景,例如在使用接口特别是发送消息时,对多媒体文件、多媒体消息的获取和调用等操作,是通过media_id来进行的。素材管理接口对所有认证的订阅号和服务号开放。通过本接口,公众号可以新增临时素材(即上传临时多媒体文件)。

注意点:

1、临时素材media_id是可复用的。

2、媒体文件在微信后台保存时间为3天,即3天后media_id失效。

3、上传临时素材的格式、大小限制与公众平台官网一致。

图片(image): 2M,支持PNG\JPEG\JPG\GIF格式

语音(voice):2M,播放长度不超过60s,支持AMR\MP3格式

视频(video):10MB,支持MP4格式

缩略图(thumb):64KB,支持JPG格式

4、需使用https调用本接口。

接口调用请求说明

http请求方式:POST/FORM,使用https https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE 调用示例(使用curl命令,用FORM表单方式上传一个多媒体文件): curl -F media=@test.jpg "https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE"

参数说明

参数是否必须说明access_token是调用接口凭证type是媒体文件类型,分别有图片(image)、语音(voice)、视频(video)和缩略图(thumb)media是form-data中媒体文件标识,有filename、filelength、content-type等信息

返回说明

正确情况下的返回JSON数据包结果如下:

{"type":"TYPE","media_id":"MEDIA_ID","created_at":123456789}

参数描述type媒体文件类型,分别有图片(image)、语音(voice)、视频(video)和缩略图(thumb,主要用于视频与音乐格式的缩略图)media_id媒体文件上传后,获取标识created_at媒体文件上传时间戳

错误情况下的返回JSON数据包示例如下(示例为无效媒体类型错误):

{"errcode":40004,"errmsg":"invalid media type"}

根据上面的接口,我们定义了一个上传临时素材的方法,包含文件目录和文件类型这两个参数,我们这里依然采用RestTemplate工具类进行文件上传

微信公众号原创分享样式(微信公众号开发之新增临时素材)(1)

/** * 上传临时素菜 * 1、临时素材media_id是可复用的。 * 2、媒体文件在微信后台保存时间为3天,即3天后media_id失效。 * 3、上传临时素材的格式、大小限制与公众平台官网一致。 * @param filePath * @param type * @return */ public String uploadFile(String filePath,String type) { String accessToken = accessTokenUtil.getAccessToken(); if (accessToken != null) { String url = URIConstant.MEDIA_UPLOAD_URL.replace("ACCESS_TOKEN", accessToken) .replace("TYPE", type); log.info("MEDIA_UPLOAD_URL:{}",url); //设置请求体,注意是LinkedMultiValueMap MultiValueMap<String, Object> form = new LinkedMultiValueMap<>(); FileSystemResource fileSystemResource = new FileSystemResource(filePath); form.add("media", fileSystemResource); //设置请求头 HttpHeaders headers = new HttpHeaders(); headers.setContentType(MediaType.MULTIPART_FORM_DATA); //用HttpEntity封装整个请求报文 HttpEntity<MultiValueMap<String, Object>> data = new HttpEntity<>(form, headers); try{ //这里RestTemplate请求返回的字符串直接转换成JSONObject会报异常,后续深入找一下原因 String resultString = restTemplate.postForObject(url, data, String.class); log.info("上传返回的信息是:{}",resultString); if(!StringUtils.isEmpty(resultString)){ JSONObject jsonObject = JSONObject.parseObject(resultString); return jsonObject.getString("media_id"); } }catch (Exception e){ log.error(e.getMessage()); } } return null; }

我们在swagger中新建一个Controller用以提交我们的上传请求,并测试我们的代码是否正确

微信公众号原创分享样式(微信公众号开发之新增临时素材)(2)

@ApiOperation(value = "上传临时素材") @RequestMapping(value = "/uploadFile", method = RequestMethod.POST) @ApiImplicitParams({ @ApiImplicitParam(name="filePath",value="文件位置", paramType="query",dataType="String"), @ApiImplicitParam(name="type",value="媒体文件类型,分别有图片(image)、语音(voice)、视频(video)和缩略图(thumb)", paramType="query",dataType="String"), }) public Object upload(String filePath, String type) throws Exception{ String result = uploadUtil.uploadFile(filePath,type); return result; }

启动我们的项目,在swagger中输入一个有效的文件路径(这里假如是图片类型),type设置为image

微信公众号原创分享样式(微信公众号开发之新增临时素材)(3)

可以看到,我们成功上传了临时文件,并获取到了该文件的media_id(这个后续很重要!!!)

微信公众号原创分享样式(微信公众号开发之新增临时素材)(4)

二、获取临时素材

临时素材主要分为三类(图片、音频,视频),图片和音频文件支持下载到本地,视频文件支持获取视频的URL地址

(1)获取临时图片

微信公众号原创分享样式(微信公众号开发之新增临时素材)(5)

/** * 公众号可以使用本接口获取临时素材(即下载临时的多媒体文件) * 1、如果是图片,则下载图片 */ public ResponseEntity<byte[]> getImage(String mediaId){ String accessToken = accessTokenUtil.getAccessToken(); if(accessToken != null) { String url = URIConstant.MEDIA_GET_URL.replace("ACCESS_TOKEN", accessToken) .replace("MEDIA_ID", mediaId); log.info("MEDIA_GET_URL:{}", url); String fileName = mediaId ".jpg"; HttpHeaders headers = new HttpHeaders(); try { fileName = new String(fileName.getBytes("GBK"), "ISO-8859-1"); } catch (UnsupportedEncodingException e) { e.printStackTrace(); } headers.setContentDispositionFormData("attachment", fileName);// 文件名称 ResponseEntity<byte[]> responseEntity = restTemplate.exchange(url, HttpMethod.GET, new HttpEntity<>(headers), byte[].class); return responseEntity; } return null; }

(2)获取临时音频

/** * 公众号可以使用本接口获取临时素材(即下载临时的多媒体文件) * 1、如果是声音,则下载声音 */ public ResponseEntity<byte[]> getVoice(String mediaId){ String accessToken = accessTokenUtil.getAccessToken(); if(accessToken != null) { String url = URIConstant.MEDIA_GET_URL.replace("ACCESS_TOKEN", accessToken) .replace("MEDIA_ID", mediaId); log.info("MEDIA_GET_URL:{}", url); String fileName = mediaId ".speex"; HttpHeaders headers = new HttpHeaders(); try { fileName = new String(fileName.getBytes("GBK"), "ISO-8859-1"); } catch (UnsupportedEncodingException e) { e.printStackTrace(); } headers.setContentDispositionFormData("attachment", fileName);// 文件名称 ResponseEntity<byte[]> responseEntity = restTemplate.exchange(url, HttpMethod.GET, new HttpEntity<>(headers), byte[].class); return responseEntity; } return null; }

(3)获取视频素材地址

/** * 公众号可以使用本接口获取临时素材(即下载临时的多媒体文件) * 2、如果是视频,则返回视频的地址 */ public String getVedio(String mediaId){ String accessToken = accessTokenUtil.getAccessToken(); if(accessToken != null) { String url = URIConstant.MEDIA_GET_URL.replace("ACCESS_TOKEN", accessToken) .replace("MEDIA_ID", mediaId); log.info("MEDIA_GET_URL:{}", url); String responseString = restTemplate.getForObject(url,String.class); return responseString; } return null; }

三、测试

这里我们仅以上传临时图片素材并下载临时图片素材为例,我们在我们的Controller中新增一个根据media_id获取临时图片类型素材的方法

微信公众号原创分享样式(微信公众号开发之新增临时素材)(6)

我们把我们刚才上传临时素材成功返回的media_id传给我们的方法

微信公众号原创分享样式(微信公众号开发之新增临时素材)(7)

可以看到我们的swagger返回带有Download file的超级链接,点击即可下载我们的图片,当然我们可以直接在浏览器直接输入我们的完整请求地址

package com.xu.wemall.components.weixin; import com.alibaba.fastjson.JSONObject; import com.xu.wemall.commons.constants.URIConstant; import lombok.extern.slf4j.Slf4j; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.core.io.FileSystemResource; import org.springframework.http.*; import org.springframework.stereotype.Component; import org.springframework.util.LinkedMultiValueMap; import org.springframework.util.MultiValueMap; import org.springframework.util.StringUtils; import org.springframework.web.client.RestTemplate; import java.io.UnsupportedEncodingException; /** * 功能:临时素材工具类 */ @Slf4j @Component public class UploadUtil { @Autowired private RestTemplate restTemplate; @Autowired private AccessTokenUtil accessTokenUtil; /** * 上传临时素菜 * 1、临时素材media_id是可复用的。 * 2、媒体文件在微信后台保存时间为3天,即3天后media_id失效。 * 3、上传临时素材的格式、大小限制与公众平台官网一致。 * @param filePath * @param type * @return */ public String uploadFile(String filePath,String type) { String accessToken = accessTokenUtil.getAccessToken(); if (accessToken != null) { String url = URIConstant.MEDIA_UPLOAD_URL.replace("ACCESS_TOKEN", accessToken) .replace("TYPE", type); log.info("MEDIA_UPLOAD_URL:{}",url); //设置请求体,注意是LinkedMultiValueMap MultiValueMap<String, Object> form = new LinkedMultiValueMap<>(); FileSystemResource fileSystemResource = new FileSystemResource(filePath); form.add("media", fileSystemResource); //设置请求头 HttpHeaders headers = new HttpHeaders(); headers.setContentType(MediaType.MULTIPART_FORM_DATA); //用HttpEntity封装整个请求报文 HttpEntity<MultiValueMap<String, Object>> data = new HttpEntity<>(form, headers); try{ //这里RestTemplate请求返回的字符串直接转换成JSONObject会报异常,后续深入找一下原因 String resultString = restTemplate.postForObject(url, data, String.class); log.info("上传返回的信息是:{}",resultString); if(!StringUtils.isEmpty(resultString)){ JSONObject jsonObject = JSONObject.parseObject(resultString); return jsonObject.getString("media_id"); } }catch (Exception e){ log.error(e.getMessage()); } } return null; } /** * 公众号可以使用本接口获取临时素材(即下载临时的多媒体文件) * 1、如果是图片,则下载图片 */ public ResponseEntity<byte[]> getImage(String mediaId){ String accessToken = accessTokenUtil.getAccessToken(); if(accessToken != null) { String url = URIConstant.MEDIA_GET_URL.replace("ACCESS_TOKEN", accessToken) .replace("MEDIA_ID", mediaId); log.info("MEDIA_GET_URL:{}", url); String fileName = mediaId ".jpg"; HttpHeaders headers = new HttpHeaders(); try { fileName = new String(fileName.getBytes("GBK"), "ISO-8859-1"); } catch (UnsupportedEncodingException e) { e.printStackTrace(); } headers.setContentDispositionFormData("attachment", fileName);// 文件名称 ResponseEntity<byte[]> responseEntity = restTemplate.exchange(url, HttpMethod.GET, new HttpEntity<>(headers), byte[].class); return responseEntity; } return null; } /** * 公众号可以使用本接口获取临时素材(即下载临时的多媒体文件) * 1、如果是声音,则下载声音 */ public ResponseEntity<byte[]> getVoice(String mediaId){ String accessToken = accessTokenUtil.getAccessToken(); if(accessToken != null) { String url = URIConstant.MEDIA_GET_URL.replace("ACCESS_TOKEN", accessToken) .replace("MEDIA_ID", mediaId); log.info("MEDIA_GET_URL:{}", url); String fileName = mediaId ".speex"; HttpHeaders headers = new HttpHeaders(); try { fileName = new String(fileName.getBytes("GBK"), "ISO-8859-1"); } catch (UnsupportedEncodingException e) { e.printStackTrace(); } headers.setContentDispositionFormData("attachment", fileName);// 文件名称 ResponseEntity<byte[]> responseEntity = restTemplate.exchange(url, HttpMethod.GET, new HttpEntity<>(headers), byte[].class); return responseEntity; } return null; } /** * 公众号可以使用本接口获取临时素材(即下载临时的多媒体文件) * 2、如果是视频,则返回视频的地址 */ public String getVedio(String mediaId){ String accessToken = accessTokenUtil.getAccessToken(); if(accessToken != null) { String url = URIConstant.MEDIA_GET_URL.replace("ACCESS_TOKEN", accessToken) .replace("MEDIA_ID", mediaId); log.info("MEDIA_GET_URL:{}", url); String responseString = restTemplate.getForObject(url,String.class); return responseString; } return null; } }

微信公众号原创分享样式(微信公众号开发之新增临时素材)(8)

点击这个Download File,我们成功的下载到这个上传的临时图片

微信公众号原创分享样式(微信公众号开发之新增临时素材)(9)

​ 试着打开这个文件,我们可以看到,这个确实是我们上传的图片

微信公众号原创分享样式(微信公众号开发之新增临时素材)(10)

这里贴出完整的代码,自行修改以获得其他类型的临时文件,不做赘述

UploadUtil.java

package com.xu.wemall.components.weixin; import com.alibaba.fastjson.JSONObject; import com.xu.wemall.commons.constants.URIConstant; import lombok.extern.slf4j.Slf4j; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.core.io.FileSystemResource; import org.springframework.http.*; import org.springframework.stereotype.Component; import org.springframework.util.LinkedMultiValueMap; import org.springframework.util.MultiValueMap; import org.springframework.util.StringUtils; import org.springframework.web.client.RestTemplate; import java.io.UnsupportedEncodingException; /** * 功能:临时素材工具类 */ @Slf4j @Component public class UploadUtil { @Autowired private RestTemplate restTemplate; @Autowired private AccessTokenUtil accessTokenUtil; /** * 上传临时素菜 * 1、临时素材media_id是可复用的。 * 2、媒体文件在微信后台保存时间为3天,即3天后media_id失效。 * 3、上传临时素材的格式、大小限制与公众平台官网一致。 * @param filePath * @param type * @return */ public String uploadFile(String filePath,String type) { String accessToken = accessTokenUtil.getAccessToken(); if (accessToken != null) { String url = URIConstant.MEDIA_UPLOAD_URL.replace("ACCESS_TOKEN", accessToken) .replace("TYPE", type); log.info("MEDIA_UPLOAD_URL:{}",url); //设置请求体,注意是LinkedMultiValueMap MultiValueMap<String, Object> form = new LinkedMultiValueMap<>(); FileSystemResource fileSystemResource = new FileSystemResource(filePath); form.add("media", fileSystemResource); //设置请求头 HttpHeaders headers = new HttpHeaders(); headers.setContentType(MediaType.MULTIPART_FORM_DATA); //用HttpEntity封装整个请求报文 HttpEntity<MultiValueMap<String, Object>> data = new HttpEntity<>(form, headers); try{ //这里RestTemplate请求返回的字符串直接转换成JSONObject会报异常,后续深入找一下原因 String resultString = restTemplate.postForObject(url, data, String.class); log.info("上传返回的信息是:{}",resultString); if(!StringUtils.isEmpty(resultString)){ JSONObject jsonObject = JSONObject.parseObject(resultString); return jsonObject.getString("media_id"); } }catch (Exception e){ log.error(e.getMessage()); } } return null; } /** * 公众号可以使用本接口获取临时素材(即下载临时的多媒体文件) * 1、如果是图片,则下载图片 */ public ResponseEntity<byte[]> getImage(String mediaId){ String accessToken = accessTokenUtil.getAccessToken(); if(accessToken != null) { String url = URIConstant.MEDIA_GET_URL.replace("ACCESS_TOKEN", accessToken) .replace("MEDIA_ID", mediaId); log.info("MEDIA_GET_URL:{}", url); String fileName = mediaId ".jpg"; HttpHeaders headers = new HttpHeaders(); try { fileName = new String(fileName.getBytes("GBK"), "ISO-8859-1"); } catch (UnsupportedEncodingException e) { e.printStackTrace(); } headers.setContentDispositionFormData("attachment", fileName);// 文件名称 ResponseEntity<byte[]> responseEntity = restTemplate.exchange(url, HttpMethod.GET, new HttpEntity<>(headers), byte[].class); return responseEntity; } return null; } /** * 公众号可以使用本接口获取临时素材(即下载临时的多媒体文件) * 1、如果是声音,则下载声音 */ public ResponseEntity<byte[]> getVoice(String mediaId){ String accessToken = accessTokenUtil.getAccessToken(); if(accessToken != null) { String url = URIConstant.MEDIA_GET_URL.replace("ACCESS_TOKEN", accessToken) .replace("MEDIA_ID", mediaId); log.info("MEDIA_GET_URL:{}", url); String fileName = mediaId ".speex"; HttpHeaders headers = new HttpHeaders(); try { fileName = new String(fileName.getBytes("GBK"), "ISO-8859-1"); } catch (UnsupportedEncodingException e) { e.printStackTrace(); } headers.setContentDispositionFormData("attachment", fileName);// 文件名称 ResponseEntity<byte[]> responseEntity = restTemplate.exchange(url, HttpMethod.GET, new HttpEntity<>(headers), byte[].class); return responseEntity; } return null; } /** * 公众号可以使用本接口获取临时素材(即下载临时的多媒体文件) * 2、如果是视频,则返回视频的地址 */ public String getVedio(String mediaId){ String accessToken = accessTokenUtil.getAccessToken(); if(accessToken != null) { String url = URIConstant.MEDIA_GET_URL.replace("ACCESS_TOKEN", accessToken) .replace("MEDIA_ID", mediaId); log.info("MEDIA_GET_URL:{}", url); String responseString = restTemplate.getForObject(url,String.class); return responseString; } return null; } }

谢谢各位,我们下回继续再说!

,

免责声明:本文仅代表文章作者的个人观点,与本站无关。其原创性、真实性以及文中陈述文字和内容未经本站证实,对本文以及其中全部或者部分内容文字的真实性、完整性和原创性本站不作任何保证或承诺,请读者仅作参考,并自行核实相关内容。文章投诉邮箱:anhduc.ph@yahoo.com

    分享
    投诉
    首页