# WxTTLockPluginDemo

**Repository Path**: Vancouver2017/WxTTLockPluginDemo

## Basic Information

- **Project Name**: WxTTLockPluginDemo
- **Description**: 小程序插件接口使用demo
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 8
- **Created**: 2025-09-02
- **Last Updated**: 2025-09-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 通通锁蓝牙模块通信插件接口说明文档 (version: 3.1.4 & offline-2.1.2)   

## 说明
 通通锁蓝牙模块通信插件是基于微信小程序接口开发的蓝牙模块插件，使用时需配合通通锁开放平台接口或相关本地开发包使用。  
 小程序后台可通过搜索“**通通锁**”或小程序appid进行搜索  
 在线版appid: **wx43d5971c94455481** (免费使用)  
 离线版appid: **wxc788856964635783** (付费使用)  

#### 重要说明
 **该插件仅支持企业账号添加**  
 **插件接口接口适配开放平台Cloud API V3版本接口，请配合云端接口使用**  
 **接口为蓝牙通信模块，操作时需通过蓝牙进行设备交互，操作中将向用户请求scope.bluetooth权限，安卓设备需授权微信位置权限**  
 **3.0版本兼容2.x的调用模式**
  
#### 版本信息及环境
 **在线版开发版本：3.1.4**  
 **在线版稳定版本：2.9.4**  
 **离线版开发版本：2.1.2**  
 **离线版稳定版本：1.8.7**  
 **最低支持微信基础库版本：3.0.2**  
 **最低支持微信版本：8.0.2**  

## 引用方式  
##### Ⅰ. 第一步 申请小程序使用权限  
> 1. 登录小程序后台
> 2. 点击左下角小程序头像，选择“账号设置” -> “第三方设置” -> “插件管理”
> 3. 点击“添加插件” -> 搜索小程序插件APPID -> 添加插件  
    在线版APPID: **wx43d5971c94455481** (免费使用)  
    离线版APPID: **wxc788856964635783** (付费使用)  
> 4. 等待审核通过  

##### Ⅱ. 第二步 在小程序中引入插件
> 1. 审核通过后，在app.json中添加相关代码  
```
    "plugins": {
        ...
        "ttlock-plugin": {
            "version": "{插件版本号}",
            "provider": "{APPID}"
        }
    }
```  

##### Ⅲ. 第三步 使用插件  
> 1. 在页面 x.js 中引入插件  
```
    const plugin = requirePlugin("ttlock-plugin");
    const plugin = requirePlugin("ttlock-plugin") as TTLockPlugin; // ts
```  
> 2. 使用 plugin.x 调用插件方法  
```
    plugin.setShowLog(true, (...args) => {
        ...
    })
```  

## 其它链接
1. [接口文档](./doc/接口文档/接口文档.md)  
2. [版本更新说明](./doc/版本更新说明.md)  
3. [常见问题](./doc/接口文档/常见问题.md)  
4. [离线版本更新说明](./doc/版本更新说明-离线版.md)