详解nodejs微信公众号开发――5.素材管理接口
上一篇文章：nodejs微信公众号开发――4.自动回复各种消息，我们实现了被动回复文字和图文，回复图片失败，因为需要先获取通过素材管理接口上传多媒体文件而得到的MediaId，这一节们就来实现素材管理的接口。可参看：公众平台开发者文档
1. 新增临时素材
临时素材顾名思义是临时的，上传后一定时间就被清理掉，适用于一些有时效性的图文链接。关于临时素材需要注意的点：
- 对于临时素材，每个素材（media_id）会在开发者上传或粉丝发送到微信服务器3天后自动删除（所以用户发送给开发者的素材，若开发者需要，应尽快下载到本地），以节省服务器资源。
- media_id是可复用的。
- 素材的格式大小等要求与公众平台官网一致。具体是，图片大小不超过2M，支持bmp/png/jpeg/jpg/gif格式，语音大小不超过5M，长度不超过60秒，支持mp3/wma/wav/amr格式
- 需使用https调用本接口。
请求地址：https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE
1.1 实现uploadTempMaterial方法
uploadTempMaterial是用来上传临时素材，直接在Wechat的原型链上添加：
Wechat.prototype.uploadTempMaterial = function(type,filepath){
var that = this;
var form = { //构造表单
media:fs.createReadStream(filepath)
}
return new Promise(function(resolve,reject){
that.fetchAccessToken().then(function(data){
var url = api.uploadMaterial + 'access_token=' + data.access_token + '&type=' + type;
request({url:url,method:'POST',formData:form,json:true}).then(function(response){
var _data = response.body;
if(_data){
resolve(_data)
}else{
throw new Error('upload material failed!');
}
}).catch(function(err){
reject(err);
});
});
});
}代码中的fetchAccessToken用以获取access_token，修改回复数字2的代码：
else if(content === '2'){
var data = yield wechatApi.uploadTempMaterial('image',__dirname+'/public/king.jpg');
reply = {
type:'image',
mediaId:data.media_id
}
}先将本地的一张图片上传到临时素材接口，获取media_id，封装到回复消息里面去。同样的方法适用于语音，视频等：
2. 新增永久素材
永久素材回永远存储在微信后台服务器上，永不失效。关于永久素材有一下几个特点：
- 新增的永久素材也可以在公众平台官网素材管理模块中看到
- 永久素材的数量是有上限的，请谨慎新增。图文消息素材和图片素材的上限为5000，其他类型为1000
- 素材的格式大小等要求与公众平台官网一致。具体是，图片大小不超过2M，支持bmp/png/jpeg/jpg/gif格式，语音大小不超过5M，长度不超过60秒，支持mp3/wma/wav/amr格式
- 调用该接口需https协议
新增永久图文素材请求地址：https://api.weixin.qq.com/cgi-bin/material/add_news?access_token=ACCESS_TOKEN
新增永久图片请求地址：https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN
新增其他类型永久素材请求地址：https://api.weixin.qq.com/cgi-bin/material/add_material?access_token=ACCESS_TOKEN
2.1 实现uploadPermMaterial方法
uploadPermMaterial和uploadTempMaterial方法基本是类似的，只是永久素材的的上传分为三类，需要判断一下传入的类型。
Wechat.prototype.uploadPermMaterial = function(type,material){
var that = this;
var form = {}
var uploadUrl = '';
if(type === 'pic') uploadUrl = api.uploadPermPics;
if(type === 'other') uploadUrl = api.uploadPermOther;
if(type === 'news'){
uploadUrl = api.uploadPermNews;
form = material
}else{
form.media = fs.createReadStream(material);
}
return new Promise(function(resolve,reject){
that.fetchAccessToken().then(function(data){
var url = uploadUrl + 'access_token=' + data.access_token;
var opts = {
method:'POST',
url:url,
json:true
}
(type == 'news') ? (opts.body = form) : (opts.formData = form); //上传数据的方式不同
request(opts).then(function(response){
var _data = response.body;
if(_data){
resolve(_data)
}else{
throw new Error('upload permanent material failed!');
}
}).catch(function(err){
reject(err);
});
});
});
}注：虽然实现了永久素材上传，但是测试账号也不是每一次都能测试成功，未经过认证的订阅号也不支持永久素材的上传。
3. 获取素材链接
由于获取临时素材和获取永久素材的差异性不大，直接放在一个函数里完成。
Wechat.prototype.getMaterial = function(mediaId,permanent){
var that = this;
var getUrl = permanent ? api.getPermMaterial : api.getTempMaterial;
return new Promise(function(resolve,reject){
that.fetchAccessToken().then(function(data){
var url = getUrl + 'access_token=' + data.access_token;
if(!permanent) url += '&media_id=' + mediaId;
resolve(url)
});
});
}4. 删除永久素材
删除永久素材就比较简单了，只需传入一个mediaId即可：
Wechat.prototype.delMaterial = function(mediaId){
var that = this;
return new Promise(function(resolve,reject){
that.fetchAccessToken().then(function(data){
var url = api.delPermMaterial + 'access_token=' + data.access_token;
var form = {media_id:mediaId}
request({url:url,method:'POST',formData:form,json:true}).then(function(response){
var _data = response.body;
if(_data.errcode === '0'){
resolve();
}else{
throw new Error('delete permanent material failed!');
}
}).catch(function(err){
reject(err);
});
});
});
}5.其他
还有修改永久图文素材、获取素材总数、获取素材列表功能由于本项目中不会用到，就不一一实现了。