自定义微信分享样式

5次阅读

共计 3611 个字符，预计需要花费 10 分钟才能阅读完成。

博客地址
Preface
产品希望我们在微信分享出去的链接，有自己的样式，而不是仅仅一个链接。用产品的话来说，你发给客户一个链接，客户敢点么？？？
听着比较有意思，不过也不能说完全没有道理，毕竟各种各样的诈骗大家也是有所耳闻，经确认，产品想要：

而我们当前分享是：

Main
总监给我提示说，微信有 js-sdk，可以在 js 里设置这个样式。
于是，我找到了微信 JS-SDK 说明文档，基本上就是根据文档走些配置，这个要和产品那边要些账号密码，改些东西之类，根据文档来，没什么好说的。
大体流程如下：

步骤一：绑定域名
步骤二：引入 JS 文件
步骤三：通过 config 接口注入权限验证配置

wx.config({}) // 传入一些初始化参数
步骤四：通过 ready 接口处理成功验证
wx.ready(function() {}) // 传入成功回调
步骤五：通过 error 接口处理失败验证
wx.error(function() {}) // 传入失败回调
实际操作的时候，遇到了几点麻烦，这里需要提一下：
测试的时候，注意开启 debug 模式，方便定位问题。
wx.config({debug: true /* 其他参数 */})
出于安全考虑，开发者必须在服务器端实现签名的逻辑。
这个是文档说的，反正就是给后台处理了，最终前端初始化需要的几个字段，除了 debug 和 jsApiList，都是从后台拿的。
wx.config({
debug: true, // 开启调试模式, 调用的所有 api 的返回值会在客户端 alert 出来，若要查看传入的参数，可以在 pc 端打开，参数信息会通过 log 打出，仅在 pc 端时才会打印。
appId: ”, // 必填，公众号的唯一标识
timestamp: , // 必填，生成签名的时间戳
nonceStr: ”, // 必填，生成签名的随机串
signature: ”,// 必填，签名
jsApiList: [] // 必填，需要使用的 JS 接口列表
});
后台在实现的时候，可能需要注意文档提示的两点：

access_token（有效期 7200 秒，开发者必须在自己的服务全局缓存 access_token）
jsapi_ticket（有效期 7200 秒，开发者必须在自己的服务全局缓存 jsapi_ticket）

因为这会导致一开始生成的签名没错，但是两个小时后就失效了。
代码逻辑
通常的逻辑都是前端从后台拿到上面的几个字段，在前端完成初始化，然后添加初始化成功和失败的回调。
示例：
var link = location.href
$.ajax({
url: ‘your_url’, // 后台给你提供的接口
type: ‘GET’,
data: {url: link},
async: true,
dataType: ‘json’,
success: function(data) {
wx.config({
debug: false, // 开启调试模式, 调用的所有 api 的返回值会在客户端 alert 出来
appId: data.configMap.appId, // 必填，公众号的唯一标识
timestamp: data.configMap.timestamp, // 必填，生成签名的时间戳
nonceStr: data.configMap.nonceStr, // 必填，生成签名的随机串
signature: data.configMap.signature, // 必填，签名，见附录 1
jsApiList: [‘onMenuShareTimeline’, ‘onMenuShareAppMessage’] // 必填，需要使用的 JS 接口列表，所有 JS 接口列表见附录 2
})
wx.ready(function(res) {
wx.onMenuShareAppMessage({
title: document.title,
desc: document.title,
link: link,
imgUrl: Imgurl,
trigger: function(res) {},
success: function(res) {},
cancel: function(res) {},
fail: function(res) {}
})
wx.onMenuShareTimeline({
title: document.title,
link: link,
imgUrl: Imgurl,
trigger: function(res) {},
success: function(res) {},
cancel: function(res) {},
fail: function(res) {}
})
})
wx.error(function(res) {
alert(res)
})
},
error: function(error) {
alert(error)
}
})
我司稍微特殊些，直接把初始化的代码放在前面需要引入微信的 js 文件后面了，所以我直接引入这个文件就完成了初始化操作。不过，我还是需要在引入后监听初始化成功和失败的回调。
我司代码：
<script src=”./js/shareInWeChat.js?debug=1″></script>
<!– 里面包含了 wx.config({}) 的代码 –>
<!– 通过 debug 参数来切换调试模式 –>
setWeChatShareStyle(product, imgUrl)
function setWeChatShareStyle(product, imgUrl) {
var success = function(res) {}
var fail = function(res) {}
var desc =
product.description && product.description !== ”
? product.description
: ‘ 后备描述 ’
wx.ready(function() {
var eventConf = {
title: product.name,
desc: desc,
imgUrl: imgUrl,
link: window.location.href,
success: success
}
if (pubMethods.isAndroid()) {
// 安卓适用于老接口，新接口不行
wx.onMenuShareAppMessage(eventConf)
wx.onMenuShareTimeline(eventConf)
wx.onMenuShareQQ(eventConf)
wx.onMenuShareQZone(eventConf)
}
if (pubMethods.isIOS()) {
// iOS 适用于新接口，老接口不行
wx.updateAppMessageShareData(eventConf, success)
wx.updateTimelineShareData(eventConf, success)
}
})
wx.error(fail)
}
最初我担心，这样可能会监听不到 wx.config 初始化的结果，结果发现还是可以监听到的，说明 wx.config 里面的操作是个异步操作。
代码兼容性
统一传参
如上面代码所示，虽然根据微信的文档，对于不同的接口，传的参数稍有区别，但是我为了方便，都放在 eventConf 里面了，事实证明也是可以的（不可以我就要吐槽了，毕竟传入的是对象）。
接口更新的 bug
虽然微信文档上有接口更新的说明：
请注意，原有的 wx.onMenuShareTimeline、wx.onMenuShareAppMessage、wx.onMenuShareQQ、wx.onMenuShareQZone 接口，即将废弃。请尽快迁移使用客户端 6.7.2 及 JSSDK 1.4.0 以上版本支持的 wx.updateAppMessageShareData、updateTimelineShareData 接口。
但我实际上测试的结果是，安卓不支持新接口，iOS 支持，但是我如果把新老接口全用上，有一端会失败，所以最终才有上面那个机型判断的结果，对于不同的机型采用了不同的接口。
if (pubMethods.isAndroid()) {
// 安卓适用于老接口，新接口不行
wx.onMenuShareAppMessage(eventConf)
wx.onMenuShareTimeline(eventConf)
wx.onMenuShareQQ(eventConf)
wx.onMenuShareQZone(eventConf)
}
if (pubMethods.isIOS()) {
// iOS 适用于新接口，老接口不行
wx.updateAppMessageShareData(eventConf, success)
wx.updateTimelineShareData(eventConf, success)
}
分享的图片不能是 base64
由于我司需要对图片进行处理再去分享，所以当我用 canvas 导出 base64 作为 imgUrl 的时候，我发现是没有效果的。
Ending
Reference