devbox
小小林熬夜学编程
这个屌丝很懒，什么也没留下！
关注作者
热门标签
热门文章
当前位置:   article > 正文

项目记录：uni-app+vue3项目，门锁小程序：使用蓝牙插件，对接电子门锁各项功能。_vue-bluetooth

作者：小小林熬夜学编程 | 2024-04-24 20:20:29

赞

踩

vue-bluetooth

1、项目需求：

  使用uni-app开发门锁小程序，主要功能有：门锁添加、远程开锁、蓝牙开锁、密码管理、指纹管理。

2、项目重点：

  前端需要调用厂家提供的设备文档来进行设备的添加、设备钥匙（密码、指纹）的添加、设备的开锁。

3、项目前期配置

  微信平台配置好插件：在项目的manifest.json导入该插件：

4、具体页面流程：

设备api进行二次封装方便使用：

创建detectingBluetooth.ts文件，使用class创建对象并将设备api二次封装方便后续使用。

  1. declare const wx: any;
  2.  
  3. // 门锁各类方法
  4. export class HandlerBluetooth {
  5.   /**
  6.    *@function 处理检测蓝牙开启
  7.    * @returns true为开启 fsle为关闭
  8.    */
  9.   async handleGetSetting() {
  10.     return new Promise<boolean>((resolve, reject) => {
  11.       uni.getSetting({
  12.         success(res) {
  13.           if (!res.authSetting['scope.bluetooth']) {
  14.             uni.showModal({
  15.               title: '提示',
  16.               content: '当前小程序未开启蓝牙授权，是否前往授权？',
  17.               success(res) {
  18.                 if (res.confirm) {
  19.                   wx.openBluetoothAdapter();
  20.                   resolve(true);
  21.                 } else if (res.cancel) {
  22.                   resolve(false);
  23.                 }
  24.               },
  25.             });
  26.           } else {
  27.             uni.openBluetoothAdapter({
  28.               success: (res) => {
  29.                 resolve(true);
  30.               },
  31.               fail: (res) => {
  32.                 //如果手机上的蓝牙没有打开，可以提醒用户
  33.                 resolve(false);
  34.                 uni.showModal({
  35.                   title: '提示',
  36.                   content: '请打开手机蓝牙',
  37.                   showCancel: false,
  38.                 });
  39.                 uni.closeBluetoothAdapter({});
  40.               },
  41.             });
  42.           }
  43.         },
  44.       });
  45.     });
  46.   }
  47.  
  48.   /**
  49.    * @function 处理添加蓝牙设备
  50.    * @param plugin plugin对象
  51.    * @returns 成功返回蓝牙对象，失败返回失败对象
  52.    */
  53.   async handleAddBluetoothDevice(plugin: any) {
  54.     return new Promise<any>((resolve, reject) => {
  55.       // 监听“初始化完成”事件
  56.       plugin.on('ready', function (plugin) {
  57.         console.info('plugin is on ready', plugin);
  58.         plugin
  59.           .addBluetoothDevice()
  60.           .then(function (res) {
  61.             uni.hideLoading();
  62.             resolve(res);
  63.           })
  64.           .catch(function (err) {
  65.             uni.hideLoading();
  66.             reject(err);
  67.           });
  68.       });
  69.       // 监听“运行错误”事件
  70.       plugin.on('error', function (err) {
  71.         console.info('plugin is on error -->', err);
  72.       });
  73.     });
  74.   }
  75.  
  76.   /**
  77.    * @function 处理蓝牙开锁
  78.    * @param plugin  plugin对象
  79.    * @returns            开锁成功或者失败
  80.    */
  81.   async handleOpenLock(plugin: any) {
  82.     return new Promise<any>((resolve, reject) => {
  83.       plugin
  84.         .openLock()
  85.         .then((res) => {
  86.           resolve(res);
  87.         })
  88.         .catch((err) => {
  89.           reject(err);
  90.         });
  91.     });
  92.   }
  93.  
  94.   /**
  95.    * @function 添加蓝牙钥匙
  96.    * @param type            添加方式	：0：按指定的钥匙类型添加；1：按内容添加
  97.    * @param keyType      钥匙类型：0: 指纹  1:密码  2:卡片  3:遥控  4:二维码  5:机械钥匙  6:人脸  7:App
  98.    * @param keyGroupId 用户组 ID：901
  99.    * @param plugin           plugin对象
  100.    */
  101.   async handleAddkeyKey(type: number, keyType: number, keyGroupId: number, plugin: any, key?: string) {
  102.     return new Promise<any>((resolve, reject) => {
  103.       let params: any = {
  104.         type,
  105.         keyType,
  106.         keyGroupId,
  107.         lockKeyId: 0,
  108.         validEndTime: '',
  109.         validStartTime: '',
  110.         usageCount: 255,
  111.         validTimeMode: 0, // 时间模式为有效期类型
  112.       };
  113.       if (key) {
  114.         params.key = key;
  115.       }
  116.       console.log('params--->', params);
  117.       plugin
  118.         .addKey(params)
  119.         .then((res) => {
  120.           resolve(res);
  121.         })
  122.         .catch((err) => {
  123.           console.log('err--->', err);
  124.           resolve(err);
  125.           uni.hideLoading();
  126.         });
  127.     });
  128.   }
  129.  
  130.   /**
  131.    * @function 更新钥匙
  132.    * @param newPassword 新密码
  133.    * @param lockKeyId 门锁中钥匙的唯一 Id
  134.    * @param plugin plugin对象
  135.    * @returns
  136.    */
  137.   async handleUpdateKey(newPassword: string, lockKeyId: number, plugin: any) {
  138.     return new Promise<any>((resolve, reject) => {
  139.       plugin
  140.         .updatePassword({ newPassword, lockKeyId })
  141.         .then((res) => {
  142.           resolve(res);
  143.         })
  144.         .catch((err) => {
  145.           reject(err);
  146.         });
  147.     });
  148.   }
  149.  
  150.   /**
  151.    * @function 校验门锁初始信息
  152.    * @param plugin plugin对象
  153.    * @returns           返回成功或失败对象
  154.    */
  155.   async handleValidateLockInitialInfo(plugin: any) {
  156.     return new Promise<any>((resolve, reject) => {
  157.       plugin.validateLockInitialInfo({ isSuccess: true }).then((res) => {
  158.         const options = {
  159.           openMode: 2,
  160.           volumeEnable: 1,
  161.           antiLockEnable: 2,
  162.         };
  163.         plugin
  164.           .setSystemInfo(options)
  165.           .then((res) => {
  166.             resolve(res);
  167.           })
  168.           .catch((err) => {
  169.             resolve(err);
  170.           });
  171.       });
  172.     });
  173.   }
  174. }

添加设备：

初始化设备并连接：

  1. import { HandlerBluetooth } from '../../utils/detectingBluetooth';
  2.  
  3. declare const requirePlugin: any;
  4. const detectingBluetoothObj = new HandlerBluetooth();
  5. const createPlugin = requirePlugin('BLELockSDK'); // 使用蓝牙插件
  6. const Plugin = createPlugin();
  7. let plugin: any;
  8. // 定义数据
  9. var config = {
  10.   keyGroupId: ‘’, // 由业务服务器返回
  11. };
  12.  
  13. // 添加门锁
  14. function insertDoorLock() {
  15.   detectingBluetoothObj.handleGetSetting().then((res) => {
  16.     if (res) {
  17.       uni.showLoading({
  18.         title: '连接中...',
  19.         mask: true,
  20.       });
  21.       // 初始化时调用方式
  22.       plugin = new Plugin({
  23.         keyGroupId: config.keyGroupId,
  24.       });
  25.       detectingBluetoothObj.handleAddBluetoothDevice(plugin).then((res) => {
  26.         const data = JSON.parse(JSON.stringify(res));
  27.         Object.assign(options.form.extAttrMap, data.data.DNAInfo);    // 后面对接后端需要的数据
  28.         options.form.deviceInfo.deviceCode = data.data.DNAInfo.lockMac;// 后面对接后端需要的数据
  29.         isShow.value = true;
  30.       });
  31.     }
  32.   });
  33. }

校验门锁初始信息、设置设备参数、对接后端新增设备：

  1. function submitInsert() {
  2.   const submitData = {
  3.     spaceId: options.form.spaceId,
  4.     deviceInfo: options.form.deviceInfo,
  5.     extAttrMap: options.form.extAttrMap,
  6.   };
  7.   //校验门锁初始信息、设置设备参数
  8.   detectingBluetoothObj.handleValidateLockInitialInfo(plugin).then((res) => {
  9.     if (res) {
  10.       const data = JSON.parse(JSON.stringify(res));
  11.       if (data.errCode === '01') {
  12.         iotAccess.insert4LockDevice(submitData).then((res) => {
  13.         // 对接后端
  14.           if (res) {
  15.             uni.hideLoading();
  16.             util.showToast('添加设备成功', 'success');
  17.             setTimeout(() => {
  18.               uni.navigateBack({
  19.                 delta: 1,
  20.               });
  21.             }, 1500);
  22.           }
  23.         });
  24.       }
  25.     }
  26.   });
  27. }

 设备详情：

 蓝牙开锁 远程开锁：

  1. import util from '../../utils/util';
  2. import { HandlerBluetooth } from '../../utils/detectingBluetooth';
  3.  
  4.  
  5. // #region 蓝牙所需参数
  6. declare const requirePlugin: any;
  7.  
  8. const detectingBluetoothObj = new HandlerBluetooth();
  9. const createPlugin = requirePlugin('BLELockSDK');
  10. const Plugin = createPlugin();
  11. let plugin: any;
  12. // 定义数据
  13. var config = {
  14.   keyGroupId: '', // 由业务服务器返回
  15.   lockMac: '',
  16.   aesKey: '',
  17.   authCode: '',
  18. };
  19. // #endregion
  20.  
  21. // #region 蓝牙开锁+远程开锁
  22. function handleOpenDoor(type: 'bluetooth' | 'remote') {
  23.   switch (type) {
  24.     // 蓝牙
  25.     case 'bluetooth':
  26.       uni.showLoading({
  27.         title: '蓝牙开锁中...',
  28.         mask: true,
  29.       });
  30.       handle();
  31.       break;
  32.     // 远程
  33.     case 'remote':
  34.       uni.showLoading({
  35.         title: '远程开锁中...',
  36.         mask: true,
  37.       });
  38.       iotAccess.openDoor(doorInfo.id).then((res) => {
  39.         if (res) {
  40.           uni.hideLoading();
  41.           util.showToast('开锁成功', 'success');
  42.         }
  43.       });
  44.       break;
  45.   }
  46. }
  47.  
  48. function handle() {
  49.   if (options.flag) {
  50.     return;
  51.   }
  52.   options.flag = true;
  53.   setTimeout(() => {
  54.     options.flag = false;
  55.   }, 1000); // 防止开锁连点
  56.   detectingBluetoothObj.handleGetSetting().then((res) => {
  57.     if (res) {
  58.       if (options.isFirst) { // 第一次开锁需要初始化设备速度会慢，后面开锁速度就会
  59.         plugin = new Plugin({
  60.           authCode: config.authCode,
  61.           aesKey: config.aesKey,
  62.           lockMac: config.lockMac,
  63.           keyGroupId: config.keyGroupId,
  64.         });
  65.         plugin.on('ready', function () {
  66.           openLock();
  67.         });
  68.         options.isFirst = false; 
  69.       } else {
  70.         openLock();
  71.       }
  72.     }
  73.   });
  74. }
  75.  
  76. function openLock() {
  77.   detectingBluetoothObj
  78.     .handleOpenLock(plugin)
  79.     .then(() => {
  80.       const params = {
  81.         device: { id: doorInfo.id },
  82.         user: { id: authorInfo.userId },
  83.         identifyMode: 'Bluetooth',
  84.         status: 'Success',
  85.       };
  86.       iotAccess
  87.         .insertAcessRecordPage(params)
  88.         .then((res) => {
  89.           uni.hideLoading();
  90.           if (res) {
  91.             util.showToast('开锁成功', 'success');
  92.           }
  93.         })
  94.         .catch(() => {
  95.           uni.hideLoading();
  96.           util.showToast('开锁失败', 'none');
  97.         });
  98.     })
  99.     .catch(() => {
  100.       uni.hideLoading();
  101.       util.showToast('开锁失败', 'success');
  102.     });
  103. }

密码管理：

  1. import { HandlerBluetooth } from '../../utils/detectingBluetooth';
  2.  
  3. // #region 蓝牙所需参数
  4. declare const requirePlugin: any;
  5.  
  6. const detectingBluetoothObj = new HandlerBluetooth();
  7. const createPlugin = requirePlugin('BLELockSDK');
  8. const Plugin = createPlugin();
  9. let plugin: any;
  10. // 定义数据
  11. var config = {
  12.   keyGroupId: '', // 由业务服务器返回
  13.   lockMac: '',
  14.   aesKey: '',
  15.   authCode: '',
  16. };
  17. // #endregion
  18. function handleConfirmSearch() {
  19.   uni.showLoading({
  20.     title: '加载中....',
  21.     mask: true,
  22.   });
  23.   handlerBluetooth.handleGetSetting().then((res) => {
  24.     if (res) {
  25.       if (options.isFirst) {
  26.         plugin = new Plugin({
  27.           authCode: config.authCode,
  28.           aesKey: config.aesKey,
  29.           lockMac: config.lockMac,
  30.           keyGroupId: config.keyGroupId,
  31.         });
  32.         plugin.on('ready', function () {
  33.           console.log('ready====>');
  34.           handleAddkeyOrUpdateKey();
  35.         });
  36.         options.isFirst = false;
  37.       } else {
  38.         handleAddkeyOrUpdateKey();
  39.       }
  40.     }
  41.   });
  42. }
  43.  
  44. // 不存在密码时添加钥匙、存在密码时修改密码
  45. function handleAddkeyOrUpdateKey() {
  46.   if (options.isPassword) { // 页面初始化根据id查询设备是否有密码，存在则调用修改，不存在则调用添加
  47.     console.log('添加密码');
  48.     handlerBluetooth
  49.       .handleAddkeyKey(1, 1, config.keyGroupId, plugin, form.submitPassword)
  50.       .then((res) => {
  51.         handleUpdateLockPassword(doorInfo.id, form.submitPassword, res.data.lockKeyId);
  52.       })
  53.       .catch((err) => {
  54.         handleShowToast('失败，请重试', 'none');
  55.       });
  56.   } else {
  57.     console.log('修改密码');
  58.     handlerBluetooth
  59.       .handleUpdateKey(form.submitPassword, Number(doorInfo.passwordLockKeyId), plugin)
  60.       .then((res) => {
  61.         handleUpdateLockPassword(doorInfo.id, form.submitPassword, res.data.lockKeyId);
  62.       })
  63.       .catch(() => {
  64.         uni.hideLoading();
  65.         handleShowToast('失败，请重试', 'none');
  66.       });
  67.   }
  68. }
  69.  
  70. function handleUpdateLockPassword(deviceId: string, password: string, passwordLockKeyId: number) {
  71.   iotAccess
  72.     .updateLockPassword(deviceId, password, passwordLockKeyId)
  73.     .then((res) => {
  74.       if (res) {
  75.         uni.hideLoading();
  76.         handleShowToast('密码修改成功', 'success');
  77.         setTimeout(() => {
  78.           uni.navigateBack();
  79.         }, 1500);
  80.       }
  81.     })
  82.     .catch((err) => {
  83.       uni.hideLoading();
  84.       handleShowToast(err.description, 'none');
  85.     });
  86. }

指纹管理：

  1. import { HandlerBluetooth } from '../../utils/detectingBluetooth';
  2.  
  3. // #region 蓝牙所需参数
  4. declare const requirePlugin: any;
  5.  
  6. const detectingBluetoothObj = new HandlerBluetooth();
  7. const createPlugin = requirePlugin('BLELockSDK');
  8. const Plugin = createPlugin();
  9. let plugin: any;
  10. // 定义数据
  11. var config = {
  12.   keyGroupId: '', // 由业务服务器返回
  13.   lockMac: '',
  14.   aesKey: '',
  15.   authCode: '',
  16. };
  17. // #endregion
  18.  
  19.  
  20. // #region 方法
  21. function handleGetDeviceInfo() {
  22.   //根据id查询设备详细信息
  23.   iotAccess.getDevice(doorInfo.id).then((res) => {
  24.     if (res) {
  25.       const data = JSON.parse(JSON.stringify(res.data.data));
  26.       config.lockMac = data.device.extAttrMap.lockMac;
  27.       config.aesKey = data.device.extAttrMap.aesKey;
  28.       config.authCode = data.device.extAttrMap.generalAuthCode;
  29.       handleGetSetting();
  30.     }
  31.   });
  32. }
  33.  
  34. function handleGetSetting() {
  35.   if (!options.isOpen) { // 标识符判断手机蓝牙是否开启
  36.     detectingBluetoothObj.handleGetSetting().then((res) => {
  37.       options.isOpen = res;
  38.       if (res) {
  39.         uni.showLoading({
  40.           title: '正在读取设备...',
  41.           mask: true,
  42.         });
  43.         handleSetPlugin();
  44.       }
  45.     });
  46.   } else {
  47.     handleSetPlugin();
  48.   }
  49. }
  50.  
  51. function handleSetPlugin() {
  52.   if (options.isFirst) {
  53.     plugin = new Plugin({
  54.       authCode: config.authCode,
  55.       aesKey: config.aesKey,
  56.       lockMac: config.lockMac,
  57.       keyGroupId: config.keyGroupId,
  58.     });
  59.     plugin.on('ready', function (ready) {
  60.       console.log('ready--->', ready);
  61.       detectingBluetoothObj.handleAddkeyKey(0, 0, config.keyGroupId, plugin);
  62.     });
  63.     plugin.on('report:addKey', (res) => {
  64.     // 监听设备指纹的添加
  65.       console.log('监听指纹---->');
  66.  
  67.       if (res.errCode == '01') {
  68.         const params = {
  69.           deviceInfo: { id: doorInfo.id },
  70.           lockKeyId: res.data.lockKeyId,
  71.           lockKeyName: '未命名',
  72.           lockKeyType: '1',
  73.         };
  74.         iotAccess.addLockUserKey(params).then((res) => {
  75.           if (res) {
  76.             const data = JSON.parse(JSON.stringify(res.data.data));
  77.             uni.redirectTo({
  78.               url: '', // 跳转页面对接后端将指纹添加到该设备上
  79.             });
  80.           }
  81.         });
  82.       }
  83.     });
  84.     options.isFirst = false;
  85.   } else {
  86.     detectingBluetoothObj.handleAddkeyKey(0, 0, config.keyGroupId, plugin);
  87.   }
  88. }
  89. // #endregion

声明：本文内容由网友自发贡献，不代表【wpsshop博客】立场，版权归原作者所有，本站不承担相应法律责任。如您发现有侵权的内容，请联系我们。转载请注明出处：https://www.wpsshop.cn/w/小小林熬夜学编程/article/detail/481400
推荐阅读
相关标签

Copyright © 2003-2013 www.wpsshop.cn 版权所有，并保留所有权利。

  

闽ICP备14008679号