🏆作者简介,黑夜开发者,CSDN领军人物,全栈领域优质创作者✌,阿里云社区专家博主,2023年6月csdn上海赛道top4。
🏆数年电商行业从业经验,历任核心研发工程师,项目技术负责人。
🏆本文已收录于专栏:100个JavaScript的小应用,微信公众号开发。
🎉欢迎 👍点赞✍评论⭐收藏
文章目录
- 🚀一、前言
- 🚀二、开发流程概述
- 🚀三、配置微信公众号
- 🔎3.1 AppId和AppSecret获取
- 🔎3.1 添加网页授权域名
- 🔎3.3 白名单设置
- 🚀四、功能开发
- 🔎4.1 获取用户微信头像
- 🍁4.1.1 引导用户进入授权页面
- 🍁4.1.2 获取授权code并换取access_token
- 🍁4.1.3 获取用户基本信息
- 🔎4.2 JavaScript实现用户换头像
- 🍁4.2.1 创建HTML结构(index.php)
- 🍁4.2.2 拼接头像和相框
- 🍁4.2.3 生成头像为一个图片
- 🚀五、总结
🚀一、前言
中秋节是我国的重要传统节日,今年直接和国庆节凑到了一起,放一个8天的小长假,是不是很兴奋呢。为了增加节日气氛,许多人会更换自己的社交媒体头像,如微信头像。使用与中秋或者国庆主题相关的图片。本篇博文将介绍如何使用PHP通过微信公众号获取用户头像,并且将头像传递给JavaScript开发一个实现换中秋头像的功能。
通过本篇文章的阅读,您将获取如下的实战知识:
- 熟悉了解微信公众号的基本开发流程。
- 学习到微信公众号网页授权获取用户基本信息这个板块的开发。
- 基本掌握html,css等网页前端的组成与基本开发流程。
- Javascript, canvas用于图片合成,头像生成的场景使用。
- 学习到一部分PHP相关的后端知识
🚀二、开发流程概述
首先我们得通过微信公众号开发获取到用户的头像,然后我们需要准备一些素材。这个图片素材需要是镂空图 PNG
,用来镶嵌在用的真实头像上面。接下来,我们需要创建一个HTML页面,并在其中引入一个JavaScript文件。我们将使用JavaScript
来操作DOM
元素和Canvas
元素,实现换装功能。如果您熟悉HTML
和JavaScript
的基本知识那就更好了。
🚀三、配置微信公众号
🔎3.1 AppId和AppSecret获取
AppId
和AppSecret
得先获取到,请看下图,记得一定要保存好AppSecret
。
🔎3.1 添加网页授权域名
网页授权域名是必须要添加的,否则公众号是不回允许在没有通过的域名下面进行授权。如果你遇到了一些问题,可以排查一下是不是这个地方的配置。在公众号设置>功能设置
里面添加,加域名就行。
这里可能要传文件验证,如果传了文件还是有问题,可以检查一下文件权限啥的,或者看看能不能手动访问。
🔎3.3 白名单设置
白名单主要是添加自己服务器所在的IP地址到公众号后台,这样只有指定的服务器才允许与公众号接口通信。如果白名单没有设置,获取access_token
的时候可能会报如下错误。
{"errcode":40164,"errmsg":"invalid ip xxx ipv6 ::ffff:xxxx, not in whitelist rid: 6503251e-14033bf0-774d3d3e"}
在安全中心>IP白名单处进行设置,白名单设置了可能会有短暂的延时生效,如果当时不能访问,可以等会再试一下。
🚀四、功能开发
🔎4.1 获取用户微信头像
这个部分主要通过PHP进行开发,核心是如何与公众号进行API交互。
🍁4.1.1 引导用户进入授权页面
构建一个URL,用户点击后将跳转到微信授权页面,同时携带着您设置的回调URL。
$redirect_uri = urlencode('http://your-domain.com/callback.php'); // 回调URL,需要urlencode
$appid = 'Your Appid'; // 公众号AppID
$scope = 'snsapi_userinfo'; // snsapi_base或snsapi_userinfo
$state = 'STATE'; // 自定义参数,可不填
$auth_url = "https://open.weixin.qq.com/connect/oauth2/authorize?appid={$appid}&redirect_uri={$redirect_uri}&response_type=code&scope={$scope}&state={$state}#wechat_redirect";
header('Location: ' . $auth_url); // 跳转到授权页面
在到达callback.php之前,如果已经关注了公众号的用户,可以直接获取到用户头像,否则则会提示授权,用户同意之后才能获取头像,这便是网页授权获取用户头像的核心功能。授权的情况可以见下图真实案例。
🍁4.1.2 获取授权code并换取access_token
用户同意授权后,微信会重定向到您设置的回调URL,并携带一个code
参数。在回调页面(callback.php
)中获取到该code
,并使用它来换取access_token
和openid
。
$code = $_GET["code"]; // 授权code
$appid = 'Your Appid'; // 公众号AppID
$secret = 'Your App Secret'; // 公众号App Secret
// 通过code换取access_token
$token_url = "https://api.weixin.qq.com/sns/oauth2/access_token?appid={$appid}&secret={$secret}&code={$code}&grant_type=authorization_code";
$token_data = json_decode(file_get_contents($token_url), true);
$access_token = $token_data['access_token']; // 获取到的access_token
$openid = $token_data['openid']; // 用户的openid
🍁4.1.3 获取用户基本信息
使用获取到的access_token
和openid
,可以调用以下API
来获取用户基本信息:
$userinfo_url = "https://api.weixin.qq.com/sns/userinfo?access_token={$access_token}&openid={$openid}&lang=zh_CN";
$userinfo_data = json_decode(file_get_contents($userinfo_url), true);
$nickname = $userinfo_data['nickname']; // 用户昵称
$headimgurl = $userinfo_data['headimgurl']; // 用户头像链接
// 可以根据需要获取其他用户信息字段
header('Location: https://www.xxx.wang/index.html?avatar_url=' . $headimgurl
上面代码的最后一句是重点,将获取到的微信头像传递给index.html,后面javascript会用到。
🔎4.2 JavaScript实现用户换头像
🍁4.2.1 创建HTML结构(index.php)
在HTML文件中,我们可以使用<input type="file">
元素来让用户选择要上传的头像文件。同时,我们还需要一个<canvas></canvas>
元素来绘制新的头像。
<!DOCTYPE html>
<html>
<head>
<title>头像换装</title>
</head>
<body>
<h1>头像换装</h1>
<div id="avatar">
<img src="./img/head0.png" alt="0" id="avatar_template" style="z-index: 1000;pointer-events: none;">
<img src="" alt="" id="avatar_img" class="pinch-zoom">
</div>
<p class="hide">
<canvas style="width:500px;height:500px;" id="cvs"></canvas>
</p>
<div style="display: none;" class="avatar-final">
<div class="finished-img">
<img id="finishedImg" src=""/>
<br>
</div>
<p class="control">
<a class="css_btn_create" id="download">生成</a>
</p>
</div>
<script src="main.js"></script>
<script>loadImage()</script>
</body>
</html>
这里我用photoshop
制作这么一个相框图片,里面加载头像,就是上面的head0.png
。
🍁4.2.2 拼接头像和相框
其中avatar_template
就是我们的头像相框,avatar_img
就是我们的微信头像,通过下面的方式来讲头像放到img
标签里面。并且将拼接好的图片放到finishedImg
里面。
// 将url的图片加载到页面
function loadImage() {
let imgUrl = getQueryString('avatar_url');
// 通过路径解析处高清图像
imgUrl = headImgHD(imgUrl);
$('#avatar_img').attr('src', imgUrl);
$('#avatar_img').attr('crossOrigin', 'anonymous');
curImage = $('#avatar_template').attr('src');
drawToCanvas(imgUrl, curImage, $('#finishedImg'));
}
// 开始整合绘制图片到finishedImg里面
function drawToCanvas(img1, img2, showObj) {
let cvs = document.getElementById('cvs');
let showSize = 230;
let size = 800;
cvs.width = size;
cvs.height = size;
let ctx = cvs.getContext('2d');
let image1 = new Image;
image1.setAttribute('crossOrigin', 'anonymous');
image1.src = img1;
image1.onload = function () {
let width = image1.width < image1.height ? size : size * (image1.width / image1.height);
let height = image1.width > image1.height ? size : size * (image1.height / image1.width);
let x = image1.width < image1.height ? 0 : (size * (image1.width / image1.height) - size) / 2;
let y = image1.width > image1.height ? 0 : (size * (image1.height / image1.width) - size) / 2;
document.getElementById('avatar_img').style.showSize = width + 'px';
document.getElementById('avatar_img').style.showSize = height + 'px';
document.getElementById('avatar_img').style.marginLeft = -x + 'px';
document.getElementById('avatar_img').style.marginTop = -y + 'px';
ctx.drawImage(image1, -x, -y, width, height);
let image2 = new Image;
image2.setAttribute('crossOrigin', 'anonymous');
image2.src = img2;
image2.onload = function () {
ctx.drawImage(image2, 0, 0, size, size);
let canvas = document.getElementById('cvs');
//获取二维码中的图片地址
let src_xp = canvas.toDataURL('image/jpeg');
$(showObj).attr('src', src_xp)
}
}
}
🍁4.2.3 生成头像为一个图片
当用户完成头像换装后,我们可以提供一个按钮来让用户生成新的头像。这里,我们可以使用html2canvas
方法将页面元素转化为一个整体的图片,并将其显示在页面中。这个时候我们可以长按图片保存,然后上传到我的头像就完成了换头像的功能。
$('#download').click(function (ev) {
takeScreenShot();
});
function takeScreenShot() {
html2canvas(document.getElementById('avatar'), {
allowTaint:false,
dpi: 400,
useCORS: true,
onrendered: function(canvas) {
document.body.appendChild(canvas);
var canvas = $('canvas')[1];
//获取二维码中的图片地址
let src_xp = canvas.toDataURL('image/jpeg');
console.log(src_xp);
$('#finishedImg').attr('src', src_xp)
$('.avatar-final').show();
$('#avatar-control').hide();
$(canvas).hide();
},
});
}
最后,一起来看看最终的头像效果。
🚀五、总结
本篇博文介绍了如何使用JavaScript
开发一个实现换中秋头像功能的应用程序。我们通过与微信公众号头像打通,并使用Html
进行页面绘制。最后,通过Canvas
进行图片整合,并提供一个生成按钮让用户一键生成新的头像。
如果你想直接体验换头像的功能,可以关注下面公众号回复【换头像】。今天的内容就到这里,我们下次见。