更新记录

1.0.0（2023-11-12）

发布插件

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

概述

• 支持扫描蓝牙锁设备
• 支持连接蓝牙锁设备
• 支持恢复出厂
• 支持查询钥匙基本信息
• 支持设置标准时钟
• 支持设置钥匙密码
• 支持设置钥匙基本信息
• 支持授权
• 支持查找锁芯基本信息
• 支持开锁
• 支持重置锁芯密码

温馨提示 如何调用插件播放器

获取插件对象

        const plugin = uni.requireNativePlugin('uniplugin-BlueLockModule')

使用示例

<template>
    <view>
        <!-- 注意：恢复出厂之后执行一下查询钥匙基本信息接口findKeyInfo-->
        <scroll-view>
            <button @click="requestLocationPermissions">申请权限</button>
            <button @click="initBle">初始化蓝牙</button>
            <button @click="startScanBlueDevices">扫描设备</button>
            <button @click="stopScanBlueDevices">停止扫描</button>
            <button @click="connectBlueDevices">连接设备</button>
            <button @click="reset">恢复出厂</button>
            <button @click="findKeyInfo">查询钥匙基本信息</button>
            <button @click="setStandardClock">设置标准时钟</button>
            <button @click="setKeyPassword">设置钥匙密码</button>
            <button @click="setBaseInfo">设置钥匙基本信息</button>
            <button @click="setAuth">授权</button>
            <button @click="findLockBaseInfo">查找锁芯基本信息</button>
            <button @click="openLock">开锁</button>
            <button @click="resetLockPassword">重置锁芯密码</button>
            <p>回调结果：{{result}}</p>
        </scroll-view>
    </view>
</template>

<script>
    const plugin = uni.requireNativePlugin('uniplugin-BlueLockModule')

    export default {
        data() {
            return {
                result: ''
            }
        },
        onLoad() {
            const _this = this;
            //注意一定要先执行申请定位权限和初始化蓝牙          
            this.requestLocationPermissions();
            this.initBle();
            plus.globalEvent.addEventListener('bleCallBack', function(e) {
                _this.result = JSON.stringify(e);
                console.log("bleCallBack-->"+JSON.stringify(e))
                if (e.type == 1) {
                    //扫描蓝牙设备列表数据:e.data json解析

                }
                if (e.type == 2) {
                    uni.showToast({
                        title: "蓝牙连接设备成功"
                    })
                }
                if (e.type == 3) {
                    uni.showToast({
                        title: "蓝牙连接设备失败"
                    })
                }
            });

        },
        methods: {
            requestLocationPermissions() {
                const _this = this;
                plugin.requestLocationPermissions({},
                    (ret) => {
                        _this.result = JSON.stringify(ret);
                    })
            },
            initBle() {
                const _this = this;
                plugin.initBle({},
                    (ret) => {
                        _this.result = JSON.stringify(ret);
                    })
            },
            startScanBlueDevices() {
                const _this = this;
                plugin.startScanBlueDevices({},
                    (ret) => {                  
                        _this.result = JSON.stringify(ret);
                    })
            },
            stopScanBlueDevices() {
                const _this = this;
                plugin.stopScanBlueDevices({},
                    (ret) => {
                        _this.result = JSON.stringify(ret);
                        console.log("stopScanBlueDevices--->"+JSON.stringify(ret))
                    })
            },
            connectBlueDevices() {
                const _this = this;
                this.initBle();
                //回调在addEventListener监听事件中
                plugin.connectBlueDevices({
                        devMac: 'xx:xx:xx:xx:xx:xx', //蓝牙设备mac地址
                    },
                    (ret) => {
                    })
            },
            reset() {
                const _this = this;
                plugin.reset({},
                    (ret) => {
                        _this.result = JSON.stringify(ret);
                        console.log("reset--->"+JSON.stringify(ret))
                    })
            },
            setStandardClock() {
                const _this = this;
                plugin.setStandardClock({},
                    (ret) => {
                        _this.result = JSON.stringify(ret);
                        console.log("setStandardClock>"+JSON.stringify(ret))
                    })
            },
            setKeyPassword() {
                const _this = this;
                plugin.setKeyPassword({
                        password: 'rWZyvEyM' //密码
                    },
                    (ret) => {
                        console.log("setKeyPassword>"+JSON.stringify(ret))
                        _this.result = JSON.stringify(ret);
                    })
            },
            setBaseInfo() {
                const _this = this;
                plugin.setBaseInfo({
                        bleName: 'key00001', //钥匙蓝牙名称
                        keyName: '钥匙一号', //钥匙名称
                        keyModel: '智能钥匙', //钥匙型号
                        keyRemarks: '', //钥匙备注
                    },
                    (ret) => {
                        console.log("setBaseInfo-->"+JSON.stringify(ret))
                        _this.result = JSON.stringify(ret);
                    })
            },
            findKeyInfo() {
                const _this = this;
                plugin.findKeyInfo({},
                    (ret) => {
                        console.log("findKeyInfo-->"+JSON.stringify(ret))
                        _this.result = JSON.stringify(ret);
                    })
            },
            setAuth() {
                const _this = this;
                plugin.setAuth({
                        keyAuthDateStart: '2023-10-29',
                        keyAuthDateEnd: '2023-10-31',
                        keyAuthTimeStart: '00:00:00',
                        keyAuthTimeEnd: '23:59:59'
                    },
                    (ret) => {
                        console.log("setAuth-->"+JSON.stringify(ret))
                        _this.result = JSON.stringify(ret);
                    })
            },
            findLockBaseInfo() {
                const _this = this;
                uni.showToast({
                    title: "请把钥匙插入锁中"
                })
                plugin.findLockBaseInfo({},
                    (ret) => {
                        console.log("findLockBaseInfo-->"+JSON.stringify(ret))
                        _this.result = JSON.stringify(ret);
                    })
            },
            resetLockPassword() {
                const _this = this;
                plugin.resetLockPassword({
                        oldPassword: 'rWZyvEyM', //原密码
                        newPassword: 'rWZyvEyZ' //新密码
                    },
                    (ret) => {
                        _this.result = JSON.stringify(ret);
                    })
            },
            openLock() {
                const _this = this;
                uni.showToast({
                    title: "请把钥匙插入锁中"
                })
                plugin.openLock({
                        lockID: 7900, //此lockID是从findLockBaseInfo接口中获取的
                        password: 'rWZyvEyM'
                    },
                    (ret) => {
                        console.log("openLock--->"+JSON.stringify(ret))
                        _this.result = JSON.stringify(ret);
                    })
            }
        }
    }
</script>

<style>
    button {
        margin-top: 30upx;
        margin-bottom: 30upx;
    }

    .button-sp-area {
        margin: 0 auto;
        width: 100%;
    }

    .content {
        text-align: center;
        height: 400upx;
    }

    .wrapper {
        flex-direction: column;
        justify-content: center;
    }

    .button {
        width: 200px;
        margin-top: 30px;
        margin-left: 20px;
        padding-top: 20px;
        padding-bottom: 20px;
        border-width: 2px;
        border-style: solid;
        border-color: #458B00;
        background-color: #458B00;
    }
</style>