GitHub Demo 地址:
jh-weapp-demo
实现一些常用效果、封装通用组件和工具类
小程序码
微信小程序中如果需要使用微信的用户信息建立自己的用户体系,需拿到唯一标识
openid
,然后通过getUserProfile
(基础库2.10.4以上可用)或者getUserInfo
(基础库2.10.4以下可用)获取用户信息,进而通过微信的用户信息建立自己的用户体系。
如果不需要登录体系,只是单纯展示用户头像昵称,可直接通过开放能力的open-data获取
注意:
·5月9日发布了新的公告
小程序用户头像昵称获取规则调整公告·
1、获取openid
1.1、通过云函数获取
openid
通过云函数获取比较简单方便,我起的云函数方法名为login
,代码实现记得文件夹右击选择 “创建并部署”小程序云函数获取用户唯一标识官方文档
云函数代码
// 云函数模板// 部署:在 cloud-functions/login 文件夹右击选择 “上传并部署”const cloud = require('wx-server-sdk')// 初始化 cloudcloud.init({// API 调用都保持和云函数当前所在环境一致env: cloud.DYNAMIC_CURRENT_ENV})/*** 这个示例将经自动鉴权过的小程序用户 openid 返回给小程序端* * event 参数包含小程序端调用传入的 data* */exports.main = async (event, context) => {console.log(event)console.log(context)// 可执行其他自定义逻辑// console.log 的内容可以在云开发云函数调用日志查看// 获取 WX Context (微信调用上下文),包括 OPENID、APPID、及 UNIONID(需满足 UNIONID 获取条件)等信息const wxContext = cloud.getWXContext()return {event,openid: wxContext.OPENID,appid: wxContext.APPID,unionid: wxContext.UNIONID,env: wxContext.ENV,}}
云函数调用
res中返回
openid
,unionid
,env
等信息
//云函数登录cloudLogin() {return new Promise((resolve, reject) => {wx.cloud.callFunction({name: 'login'}).then(res => {return resolve(res)}).catch(err => {return reject(err)});})},
1.2、调用微信接口获取微信用户唯一标识
按照下面流程说明的2步骤,即可获取用户唯一标识
官方流程文档
流程说明:
1.调用
wx.login()
获取 临时登录凭证code
,并回传到开发者服务器。2.调用
auth.code2Session
接口,换取 用户唯一标识OpenID
、用户在微信开放平台帐号下的唯一标识UnionID
(若当前小程序已绑定到微信开放平台帐号) 和 会话密钥session_key
。之后开发者服务器可以根据用户标识来生成自定义登录态,用于后续业务逻辑中前后端交互时识别用户身份。
注意事项:
1.会话密钥
session_key
是对用户数据进行 加密签名 的密钥。为了应用自身的数据安全,开发者服务器不应该把会话密钥下发到小程序,也不应该对外提供这个密钥。2.临时登录凭证
code
只能使用一次
相关接口官方文档:
获取临时登录凭证code,有效期五分钟(可调用wx.checkSession检查登录态是否过期)
登录凭证校验(成功返回用户唯一标识 OpenID)
2、小程序端获取用户相关信息
获取用户信息(包含:微信名、性别、头像、省市区,国家)官方文档
04月15日,微信发布了一条公告:小程序登录、用户信息相关接口调整说明,推出了新的获取用户信息的接口
getUserProfile
(基础库2.10.4以上可用),4月28日24时后发布的小程序新版本需要进行适配
因此获取用户信息需要使用两个方法:
基础库2.10.4以上使用:getUserProfile
基础库2.10.4以下使用:getUserInfo
注意事项:
1.需要配合button按钮调用
2.需要做版本适配,基础库 2.10.4以上使用
wx.getUserProfile
,以下使用wx.getUserInfo
3.
getUserProfile
调用必须为直接调用,不能通过其他函数回调调用否则会报getUserProfile:fail can only be invoked by user TAP gesture.错误
调用时机处理:
getUserProfile
每次调用会有一个获取用户信息弹框,因此关于获取用户信息的时机,博主的做法是在需要登录时,弹出登录弹框,里面有登录按钮,用户点击按钮,调用获取openid
和用户信息的方法,然后把返回的openid
和用户信息存到数据库中,下次登录重复此操作`
wxml关键代码:
<block wx:if="{{canIUseGetUserProfile}}"><button class="loginBtn" type="primary" size="default" bindtap="getUserProfile">微信一键登录</button></block><block wx:else><button class="loginBtn" type="primary" size="default" open-type="getUserInfo" lang="zh_CN"bindgetuserinfo="getUserInfo">微信一键登录</button></block>
js关键代码:
// 页面创建时执行this.setData({canIUseGetUserProfile: wx.getUserProfile ? true : false})
//点击一键登录,基础库2.10.4 以上使用getUserProfile: function () {console.log('点击一键登录,基础库2.10.4 以上使用');let that = this;let p1 = this.cloudLogin()let p2 = this.promiseGetUserProfile()Promise.all([p1, p2]).then((res) => {if (res && res[0] && res[1]) {that.successHandle(res[0].result.openid, res[1].userInfo)} else {that.failHandle()}}).catch((err) => {that.failHandle(err)})},//获取用户的当前设置getSetting() {return new Promise((resolve, reject) => {wx.getSetting({withSubscriptions: true,success: function (res) {return resolve(res)},fail: function (err) {return reject(err)}})})},//云函数登录cloudLogin() {return new Promise((resolve, reject) => {wx.cloud.callFunction({name: 'login'}).then(res => {return resolve(res)}).catch(err => {return reject(err)});})},//获取用户信息 - 基础库2.10.4 以上使用promiseGetUserProfile() {return new Promise((resolve, reject) => {wx.getUserProfile({lang: 'zh_CN',desc: '获取您的昵称、头像、地区及性别', // 声明获取用户个人信息后的用途,后续会展示在弹窗中,请谨慎填写success: (res) => {return resolve(res)},fail: (err) => {return reject(err)},})})},//点击一键登录,基础库2.10.4 以下使用getUserInfo: function (e) {console.log('点击一键登录,基础库2.10.4 以下使用');// console.log(e.detail.userInfo);// console.log("用户信息--" + JSON.stringify(e.detail.userInfo))let that = this;that.cloudLogin().then(res => {that.getSetting().then(res2 => {if (res2.authSetting['scope.userInfo']) {that.successHandle(res.result.openid, e.detail.userInfo)} else {wx.showToast({title: '未授权',icon: 'none'})}}).catch(err => {that.failHandle(err)});}).catch(err => {that.failHandle(err)});},
然后在successHandle
中把数据存到本地和数据库中即可