更新记录

1.0.0（2025-12-27）

初次发布

平台兼容性

uni-app(4.84)

uni-app x(4.84)

import { TGateway, TLock, TToken, TOption } from '@/uni_modules/rui-ttlock';

公共定义

export type TToken = {
    uid ?: number
    clientId ?: string
    password ?: string
    accessToken ?: string
}

通过后台获取 token 并通过setToken(token)方法绑定

通用请求参数

export type TOption = {
    onReceive ?: (res : any) => void;
    success ?: (res : UTSJSONObject) => void;
    fail ?: (res : UTSJSONObject) => void;
    params ?: UTSJSONObject
}

微信配置 manifest.json

"mp-weixin" : {
    "plugins" : {
        "ttlock" : {
            "version" : "3.1.6",
            "provider" : "wx43d5971c94455481"
        }
    }
}

网关用法

const gateway = new TGateway('ttlock'); //这里的 ttlock 是微信小程序的插件配置KEY 位于 manifest.json 中 mp-weixin.plugins
gateway.setToken(token)

搜索网关

gateway.startScanGateway({
    onReceive: (res: any) => {
        //这里处理网关数据
    },
    fail: (res: any) => {
        uni.showToast({
            title: res.message,
            icon: 'none'
        });
    }
});

停止搜索

gateway.stopScanGateway();

连接网关

gateway.connectGateway({
    params: {
        address //网关MAC地址
    },
    success: (res : any) => {
        //成功
    },
    fail: (res : any) => {
        // 失败
    }
});

初始化网关

gateway.initGateway({
    params:{
        gatewayName: '网关名称',
        gatewayVersion: '网关版本如：G2版本是 2',
        address: '网关MAC地址',     
        wifi: { //WIFI版必需
            ssid: 'WIFI名称',
            password: 'WIFI密码',
        }
    },
    success: (res : any) => {
        //这里成功后，提交到后端服务器        
    },
    fail: (res : any) => {

    }
});

搜索WIFI列表

gateway.scanWiFiByGateway({
    params: {
        address //网关MAC地址
    },
    onReceive: (res : any) => {
        //WIFI信息
    }
});

锁方法

const lock = new TLock('ttlock');  //这里的 ttlock 是微信小程序的插件配置KEY 位于 manifest.json 中 mp-weixin.plugins
lock.setToken(token)

搜索锁列表

lock.startScanLock({
    onReceive: (res : any) => {
        //处理锁列表数据
    }
});

停止搜索

lock.stopScanLock();

初始化锁

this.service.initLock({
    params: {
        name,
        address
    },
    success: (res : any) => {
    },
    fail: (res : any) => {
    }
});

连接锁

官方并没有连接锁方法，这里只是获取锁电量

lock.connectLock({
    params: {
        lockData
    },
    success: (res : any) => {

    },
    fail: (res : any) => {

    }
});

设置通过网关开锁功能

lock.setRemoteUnlockSwitchState({
    params: {
        lockData,
        lockMac,
        enable //bool true 开 false 关
    },
    success: (res : any) => {
    },
    fail: (res : any) => {
    }
});

开锁

lock.unlock({
    params: {
        lockData,
        lockMac
    },
    success: (res : any) => {
    },
    fail: (res : any) => {
    }
});

关锁

lock.lock({
    params: {
        lockData,
        lockMac
    },
    success: (res : any) => {
    },
    fail: (res : any) => {
    }
});

获取锁信息

lock.getInfo({
        params: {
            lockData,
            lockMac
        }
    })
    .then((res : any) => {
        //处理锁信息，
        //目前只有电量与 是否开启网关开锁功能
    })
    .catch((e : any) => {
    });

准备蓝牙服务 只有安卓需要，不知道有啥用

建议在 onLoad 处调用

    lock.prepareBTService();

停止蓝牙服务

建议在 onUnload 处理调用

    lock.stopBTService();