前言
对于小程序大家可能都非常熟悉了,随着小程序的不断普及越来越多的公司都开始推广使用起来了。今天接到一个需求就是生成小程序码,并且与运营给的推广图片合并在一起做成一张漂亮美观的推广二维码,扫码这种二维码就可以进入小程序。为了节省服务器内存资源,我想的就是成功调用通微信生成小程序码的接口后直接把微信返回过来的图片二进制内容(返回的图片 Buffer)转化为二进制byte[]文件流,然后再转成Image这样就不需要在保存到本地直接读取本地的背景图片通过GDI+(Graphics)绘制图片。
选择小程序码生成方式
首先微信小程序官方文档提供了三种生成小程序码的方法,如下所示(本文采用的是第三种,需要的码数量极多的业务场景):
文档详情地址:https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/qrcode-link/qr-code/getQRCode.html
1、createwxaqrcode获取小程序二维码,适用于需要的码数量较少的业务场景。通过该接口生成的小程序码,永久有效,有数量限制。
2、getwxacode获取小程序码,适用于需要的码数量较少的业务场景。通过该接口生成的小程序码,永久有效,有数量限制。
3、getwxacodeunlimit获取小程序码,适用于需要的码数量极多的业务场景。通过该接口生成的小程序码,永久有效,数量暂无限制。
获取全局唯一后台接口调用凭据
对接开发过微信相关的业务的同学应该都清楚,调用微信接口很多情况下都会需要使用到access_token接口调用凭证。一般来说access_token的有效时长为2小时,为了不频繁调用该接口我们可以通过缓存的方法把调用凭证存起来并设置合理的过期时间(redis,cookie,memorycache都是非常不错的选择)。
文档详情地址:https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/mp-access-token/getAccessToken.html
请求接口
GET https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
请求参数
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
grant_type | string | 是 | 填写 client_credential |
appid | string | 是 | 小程序唯一凭证,即 AppID,可在「微信公众平台 – 设置 – 开发设置」页中获得。(需要已经成为开发者,且账号没有异常状态) |
secret | string | 是 | 小程序唯一凭证密钥,即 AppSecret,获取方式同 appid |
返回参数
属性 | 类型 | 说明 |
---|---|---|
access_token | string | 获取到的凭证 |
expires_in | number | 凭证有效时间,单位:秒。目前是7200秒之内的值。 |
access_token 的存储与更新
-
access_token
的存储至少要保留 512 个字符空间; -
access_token
的有效期目前为2 个小时,需定时刷新,重复获取将导致上次获取的access_token
失效; - 建议开发者使用中控服务器统一获取和刷新
access_token
,其他业务逻辑服务器所使用的access_token
均来自于该中控服务器,不应该各自去刷新,否则容易造成冲突,导致access_token
覆盖而影响业务; -
access_token
的有效期通过返回的expires_in
来传达,目前是7200秒之内的值,中控服务器需要根据这个有效时间提前去刷新。在刷新过程中,中控服务器可对外继续输出的老access_token
,此时公众平台后台会保证在5分钟内,新老access_token
都可用,这保证了第三方业务的平滑过渡; -
access_token
的有效时间可能会在未来有调整,所以中控服务器不仅需要内部定时主动刷新,还需要提供被动刷新access_token
的接口,这样便于业务服务器在API调用获知access_token
已超时的情况下,可以触发access_token
的刷新流程。
详情可参考微信公众平台文档《获取access_token》
请求示例代码
///
///获取小程序全局唯一后台接口调用凭据(access_token)
///
///
publicstringGetWechatAccessToken()
{
varappId="你的小程序AppID";//小程序唯一凭证,即AppID
varsecret="你的小程序AppSecret";//小程序唯一凭证密钥,即AppSecret
stringUrl=string.Format("https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={0}&secret={1}",appId,secret);
stringResult=HttpWebRequest(Url,"GET","",Encoding.UTF8);
varobj=JsonConvert.DeserializeObject(Result);
if(obj!=null&&obj.access_token!=null)
{
returnobj.access_token;
}
else
{
return"";
}
}
///
///WebRequest网络请求
///
///请求地址
///请求方式(GET/POST)
///请求参数(method="POST"需要携带)
///字符编码
///请求数据的内容类型
///
publicstringHttpWebRequest(stringrequestUrl,stringmethod,stringdata,Encodingencoding,stringcontentType="application/json;charset=UTF-8")
{
WebRequestwebRequest=WebRequest.Create(requestUrl);
webRequest.Method=method;
if(method=="POST")
{
byte[]bytes=Encoding.Default.GetBytes(data);
webRequest.ContentType=contentType;
webRequest.ContentLength=bytes.Length;
StreamrequestStream=webRequest.GetRequestStream();
requestStream.Write(bytes,0,bytes.Length);
requestStream.Close();
}
WebResponseresponse=webRequest.GetResponse();
StreamresponseStream=response.GetResponseStream();
if(responseStream==null)
{
return"";
}
StreamReaderstreamReader=newStreamReader(responseStream,encoding);
stringresult=streamReader.ReadToEnd();
responseStream.Close();
streamReader.Close();
returnresult;
}
///
///响应模型
///
publicclassAccessToken
{
///
///获取到的凭证
///
publicstringaccess_token{get;set;}
///
///凭证有效时间,单位:秒。目前是7200秒之内的值
///
publicintexpires_in{get;set;}
///
///错误码
///
publicinterrcode{get;set;}
///
///错误信息
///
publicstringerrmsg{get;set;}
}
小程序码获取
请求地址
POST https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=ACCESS_TOKEN
请求参数
属性 | 类型 | 必填 | 说明 | |
---|---|---|---|---|
access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用getAccessToken或者authorizer_access_token | |
scene | string | 是 | 最大32个可见字符,只支持数字,大小写英文以及部分特殊字符:!#$&'()*+,/:;=?@-._~,其它字符请自行编码为合法字符(因不支持%,中文无法使用 urlencode 处理,请使用其他编码方式) | |
page | string | 否 | 默认是主页,页面 page,例如 pages/index/index,根路径前不要填加 /,不能携带参数(参数请放在scene字段里),如果不填写这个字段,默认跳主页面。scancode_time为系统保留参数,不允许配置 | |
check_path | bool | 否 | 默认是true,检查page 是否存在,为 true 时 page 必须是已经发布的小程序存在的页面(否则报错);为 false 时允许小程序未发布或者 page 不存在, 但page 有数量上限(60000个)请勿滥用。 | |
env_version | string | 否 | 要打开的小程序版本。正式版为 “release”,体验版为 “trial”,开发版为 “develop”。默认是正式版。 | |
width | number | 否 | 默认430,二维码的宽度,单位 px,最小 280px,最大 1280px | |
auto_color | bool | 否 | 自动配置线条颜色,如果颜色依然是黑色,则说明不建议配置主色调,默认 false | |
line_color | object | 否 | 默认是{“r”:0,”g”:0,”b”:0} 。auto_color 为 false 时生效,使用 rgb 设置颜色 例如 {“r”:”xxx”,”g”:”xxx”,”b”:”xxx”} 十进制表示 | |
is_hyaline | bool | 否 | 默认是false,是否需要透明底色,为 true 时,生成透明底色的小程序 |
返回参数
属性 | 类型 | 说明 |
---|---|---|
buffer | buffer | 图片 Buffer |
errcode | number | 错误码 |
errmsg | string | 错误信息 |
接口请求成功会返回的图片 Buffer(如果调用成功,会直接返回图片二进制内容(图片文件流),如果请求失败,会返回 JSON 格式的数据。)
请求代码
注意:这个与前面获取授权凭证的网络请求不同的是因为要接收请求返回过来的图片二进制内容(buffer),然后需要把二进制文件流转化为byte[]二进制字节流,然后在转化Image。
///
///获取小程序码图片
///
///接口调用凭据
///携带参数
privateImageGetWetchatAppletQRCodeImage(stringaccess_token,stringparam)
{
stringrequestData="{"scene":""+param+""}";
stringrequestUrl="https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token="+access_token;
HttpWebRequestrequest=(HttpWebRequest)WebRequest.Create(requestUrl);
request.Method="POST";
request.ContentType="application/json;charset=UTF-8";
byte[]payload=System.Text.Encoding.UTF8.GetBytes(requestData);
request.ContentLength=payload.Length;
Streamwriter=request.GetRequestStream();
writer.Write(payload,0,payload.Length);
writer.Close();
HttpWebResponseresponse;
response=(HttpWebResponse)request.GetResponse();
Streamstream=response.GetResponseStream();//获取返回的图片Buffer(文件流)
byte[]imageBuffer=StreamToBytes(stream);
returnByteArrayConvertToImage(imageBuffer);
}
///
///将文件数据流转为二进制byte[]字节流
///
///文件流
///
privatebyte[]StreamToBytes(Streamstream)
{
Listbytes=newList();
inttemp=stream.ReadByte();
while(temp!=-1)
{
bytes.Add((byte)temp);
temp=stream.ReadByte();
}
returnbytes.ToArray();
}
///
///byte[]转化为Iamge
///
///
///
publicstaticImageByteArrayConvertToImage(byte[]buffer)
{
using(MemoryStreamms=newMemoryStream(buffer))
{
//直接调用Image库类中自带的方法使用MemoryStream实例对象获取Image
returnImage.FromStream(ms);
}
}
小程序码和背景图合并
///
///小程序推广二维码获取
///
///小程序码携带的用户参数
///
publicJsonResultGetCompositePictureUrl(intuserId)
{
//图片存放物理路径
varsavePhysicalPath=HttpContext.Request.MapPath("~/qrcode/");
varimgBack=Image.FromFile(savePhysicalPath+"ewm.jpg");//合成背景图片
varwechatQrcodeImg=GetWetchatAppletQRCodeImage(GetWechatAccessToken(),userId.ToString());//获取小程序码图片
varcompositePictureUrl=CompositePicture(imgBack,wechatQrcodeImg,savePhysicalPath,232,719,290,290);
returnJson(new{code=0,compositePictureUrl=compositePictureUrl});
}
///
///合成图片
///
///背景图
///二维码图片
///图片存放物理路径
///绘制图像X轴偏差
///绘制图像Y轴偏差
///绘制图像宽
///绘制图像高
///
publicstringCompositePicture(ImagebackgroundImage,ImageqrCodeImg,stringsavePhysicalPath,intx服务器托管网Deviation=0,inty服务器托管网Deviation=0,intwidth=0,intheight=0)
{
Bitmapbitmap=newBitmap(backgroundImage.Width,backgroundImage.Height);
Graphicsgraphics=Graphics.FromImage(bitmap);//绘图
graphics.Clear(Color.White);
SolidBrushsurush=newSolidBrush(Color.White);
graphics.DrawImage(backgroundImage,0,0,backgroundImage.Width,backgroundImage.Height);
graphics.DrawImage(qrCodeImg,xDeviation,yDeviation,width,height);
GC.Collect();//垃圾清理
stringcompositePictureUrl=savePhysicalPath+Guid.NewGuid().ToString()+".jpg";
//合成图片保存
bitmap.Save(compositePictureUrl,System.Drawing.Imaging.ImageFormat.Jpeg);
returncompositePictureUrl;
}
合成效果图
DotNetGuide技术社区交流群
- DotNetGuide技术社区是一个面向.NET开发者的开源技术社区,旨在为开发者们提供全面的C#/.NET/.NET Core相关学习资料、技术分享和咨询、项目推荐、招聘资讯和解决问题的平台。
- 在这个社区中,开发者们可以分享自己的技术文章、项目经验、遇到的疑难技术问题以及解决方案,并且还有机会结识志同道合的开发者。
- 我们致力于构建一个积极向上、和谐友善的.NET技术交流平台,为广大.NET开发者带来更多的价值和成长机会。
欢迎加入DotNetGuide技术社区微信交流群
服务器托管,北京服务器托管,服务器租用 http://www.fwqtg.net
机房租用,北京机房租用,IDC机房托管, http://www.fwqtg.net