小程序 获取群聊openGid(前端+koa - 附源码)

实现原理:使用小程序转发功能,以卡片的形式转发至群聊,群聊成员点击卡片,跳转至卡片中指定的小程序页,跳转同时,小程序获取群聊加密信息,与后端配合,解密后获得openGid。

1. 涉及API

  • wx.showShareMenu # 设置本页转发按钮功能
  • wx.onShareAppMessage # 设置转发卡片内容
  • App.onShow # 小程序生命周期,在这里获取shareTicket
  • wx.getShareInfo # 获取群聊(加密)
  • wx.login # 获取用户信息(加密)
  • wx.request # 将加密信息交给后端以解码

2. 流程示意

流程从左至右

image.png

文字与代码详解 - 前端

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,都可以。
我这里的写法样式如下
IMG_20200405_155514.jpg

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传输,请自行开启小程序开发工具的
截屏2020-04-0516.41.57.png

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...


觉得有用 点赞👍 + 关注 可好?

评论

暂无评论