小程序 获取群聊openGid(前端+koa - 附源码)
文章目录
实现原理:使用小程序转发功能,以卡片的形式转发至群聊,群聊成员点击卡片,跳转至卡片中指定的小程序页,跳转同时,小程序获取群聊加密信息,与后端配合,解密后获得openGid。
1. 涉及API
- wx.showShareMenu # 设置本页转发按钮功能
- wx.onShareAppMessage # 设置转发卡片内容
- App.onShow # 小程序生命周期,在这里获取
shareTicket - wx.getShareInfo # 获取群聊(加密)
- wx.login # 获取用户信息(加密)
- wx.request # 将加密信息交给后端以解码
2. 流程示意
流程从左至右

文字与代码详解 - 前端
1. 定义分享卡片样式 - wx.onShareAppMessage
创建两个Page,一个命名detail,另一个命名demo,在demo.js的Page.onShareAppMessage书写
// demo.js
onShareAppMessage(opts): WechatMiniprogram.Page.ICustomShareContent {
return {
title: '加入我的项目组吧!',
path: '/pages/detail/detail',
imageUrl: 'https://s1.ax1x.com/2020/04/02/GYkFpR.jpg'
}
}
onShareAppMessage作用是定义分享卡片样式,title:卡片文字内容,建议尽量少path:点击卡片跳转的页面imgUrl:卡片展示的图片,项目内图片、网图https的url,都可以。
我这里的写法样式如下
2. 让卡片携带shareTicket - wx.showShareMenu
创建Page命名demo,在demo.js的Page.onLoad中写
// demo.js
onLoad(){
wx.showShareMenu({
withShareTicket: true
})
}
wx.showShareMenu作用是定义本页转发的具体功能,此处withshareTicket:true表示,其他人在点击卡片后App.onShow(options)额外获取一个shareTicket,把这个shareTicket传给wx.getShareInfo可以获取加密后的群聊信息,具体实现请往下看
3. 接收shareTicket并获取群聊信息(加密) - wx.getShareInfo
// app.js
getShareTicket(cb:Function) {
wx.getShareInfo({
shareTicket: this.globalData.shareTicket,
success: (getShareInfoRes) => { // 传入shareTicket后在success回调中获取群聊信息(加密)
console.log('wx.getShareInfo rereive',getShareInfoRes);
const js_encryptedData = getShareInfoRes.encryptedData; // 加密群聊数据
const js_iv = getShareInfoRes.iv; // 密文串
//步骤4的代码写在这里
}
})
}
encryptedData的解码需要session_key用户签名和iv密文串
4. 获取用户code - wx.login
// 代码位置见步骤3
wx.login({
success: (loginRes) => {
const js_code = loginRes.code
console.log(getShareInfoRes, loginRes);
// 步骤5的代码写在这里
}
})
这里的code相当于一把钥匙,将钥匙交给微信的服务器(需要后端操作),我们可以取到用户的openid - 用户唯一识别标志和session_key - 用户签名
到目前,我们拥有的字段分别为
js_encryptedData : 加密的群聊详情
js_iv : 密文串
js_code : 用户code
下一步,我们需要把这些字段交给后端,后端处理后,可以获取群聊详情。
5. 将已有字段交给后端 - wx.request
wx.request({
url: `http://${config.server.host}:${config.server.port}/api/getShareInfo`,
method: 'POST',
data: {
code: js_code,
appId: config.app.appId,
encryptedData: js_encryptedData,
iv: js_iv
},
success: (res) => {
console.log(res); // 这里可以在控制台打印后端传回来的群聊openGid
},
fail: function (err) {
console.log('传输失败,错误信息' + err)
}
})
文字与代码详解 - 后端
本文使用koa搭建后端服务器,为方便操作,使用http传输,请自行开启小程序开发工具的
1. koa + typescript 环境搭建
mkdir miniprogram-server-koa # 创建文件夹
cd miniprogram-server-koa # 进入文件夹
npm install -g yarn typescript # 已安装这俩的同学跳过这步
npm init -y # npm 初始化
tsc -init # tsconfig.json 初始化
yarn add koa koa-router koa-bodyparser axios nodemon # 一些必须的npm包
yarn add concurrently typescript @types/koa @types/koa-router # ts环境必须的npm包
2. 配置package.json、tsconfig.json
// package.json
"scripts": {
"start:compile": "tsc -w",
"start:nodemon": "nodemon build/app.js",
"start": "tsc && concurrently yarn:start:*"
},
// tsconfig.json 这里只需要取消allowJs的备注
"allowJs": true,
3. 创建目录结构如下
+ src
- app.ts
- routers
* model.ts
- service
* Wechat.ts
- utils
* WXBizDataCrypt.js
+ tsconfig.json
+ package.json
4. 代码
// app.ts
import Koa from 'koa';
import parser from 'koa-bodyparser';
import model from './routers/login';
const app = new Koa();
app.use(parser());
app.use(model.routes());
app.listen(8001, () => {
console.log('listen port 8001...');
})
// model.ts
import Router from 'koa-router';
import Wechat from '../service/Wechat';
const router = new Router();
router.post('/api/groupInfo', async (ctx, next) => {
const loginReqData = ctx.request.body;
const shareInfo = await Wechat.codeToSession(loginReqData);
ctx.body = {
...shareInfo
}
})
export default router;
// Wechat.ts
import axios from 'axios';
import config from '../config/config';
import WXBizDataCrypt from '../utils/WXBizDataCrypt';
interface LoginReqData {
code: string;
appId: string;
encryptedData: string;
iv: string;
}
class Wechat {
static async codeToSession(data: LoginReqData) {
const { appId, encryptedData, code, iv } = data;
try {
const res = await axios({
url: 'https://api.weixin.qq.com/sns/jscode2session',
method: 'GET',
params: {
appid: config.app.appID,
secret: config.app.appSecret,
js_code: code,
grant_type: 'authorization_code'
}
});
const { session_key } = res.data;
var pc = new WXBizDataCrypt(appId, session_key)
var shareInfo: Object = pc.decryptData(encryptedData, iv);
return shareInfo;
} catch(err){
console.log(err);
return {};
}
}
}
export default Wechat;
import crypto from 'crypto';
function WXBizDataCrypt(appId, sessionKey) {
this.appId = appId
this.sessionKey = sessionKey
}
WXBizDataCrypt.prototype.decryptData = function (encryptedData, iv) {
// base64 decode
var sessionKey = Buffer.from(this.sessionKey, 'base64')
encryptedData = Buffer.from(encryptedData, 'base64')
iv = Buffer.from(iv, 'base64')
try {
// 解密
var decipher = crypto.createDecipheriv('aes-128-cbc', sessionKey, iv)
// 设置自动 padding 为 true,删除填充补位
decipher.setAutoPadding(true)
var decoded = decipher.update(encryptedData, 'binary', 'utf8')
decoded += decipher.final('utf8')
decoded = JSON.parse(decoded)
} catch (err) {
throw new Error('Illegal Buffer')
}
if (decoded.watermark.appid !== this.appId) {
throw new Error('Illegal Buffer')
}
return decoded
}
export default WXBizDataCrypt;
5. 启动后端
yarn start
6. 小程序补充
本文的代码,在前端步骤5中success的res.data中可获取openGid,这是群聊唯一标志,可用小程序自带的<open-type>标签展示内容。可存储在App.globalData,在detail页app.globalData获取,更具体实现请看我的仓库吧!
仓库
前端仓库 - https://github.com/CregskiN/h...
后端仓库 - https://github.com/CregskiN/m...
觉得有用 点赞👍 + 关注 可好?
评论
登录后参与技术讨论,分享你的经验与见解。
登录 / 注册暂无评论