项目介绍

BLE广播演示是一个多平台蓝牙广播解决方案，支持微信小程序、iOS和Android原生应用。本项目提供统一的API接口，帮助开发者快速实现跨平台的BLE广播功能。

主要特性

支持多平台：微信小程序、iOS原生和Android原生
统一的API接口，降低学习成本
内置权限管理，自动处理权限请求
支持自定义广播数据和参数配置
提供丰富的预设配置

快速开始

以下是快速开始使用BLE广播功能的步骤：

1. 初始化广播器

                
// 初始化广播插件
await this.initializeAdvertiser();

2. 配置广播参数

                
// 设置广播参数
this.broadcastName = 'BLE-Device';
this.serviceUuid = 'FFF0';
this.manufacturerId = '004E';
this.manufacturerData = '4E001101';
                
            

3. 开始广播

                
// 启动广播
await this.startBroadcast();

安装说明

微信小程序

                
// 在app.json中配置
{
  "plugins": {
    "BLE-Module": {
      "version": "1.0.0",
      "provider": "wx******"
    }
  }
}
                
            

iOS原生

                
// 在Info.plist中添加权限描述
NSBluetoothAlwaysUsageDescription
NSBluetoothPeripheralUsageDescription

Android原生

                
// 在AndroidManifest.xml中添加权限
<uses-permission android:name="android.permission.BLUETOOTH"/>
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
<uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE"/>

API概览

方法名	说明	平台支持
initializeAdvertiser()	初始化广播器	全平台
startBroadcast()	开始广播	全平台
stopBroadcast()	停止广播	全平台

注意： 不同平台的具体实现可能略有差异，请参考各平台具体文档。

广播控制

开始广播

调用startBroadcast()方法开始广播。该方法会根据当前平台自动选择合适的实现方式：

                
async startBroadcast() {
    // 检查初始化状态
    if (!this.isInitialized) {
        const initialized = await this.initializeAdvertiser();
        if (!initialized) {
            return;
        }
    }

    // 根据平台调用相应的广播方法
    if (this.isNativeIOS) {
        this.startIOSBroadcast();
    } else if (this.isNativeAndroid) {
        this.startAndroidBroadcast();
    } else if (this.isWechat) {
        this.startWechatBroadcast();
    }
}
                
            

提示： 建议在开始广播前检查蓝牙和定位权限是否已获取。

参数配置

可配置参数

参数名	类型	说明
broadcastName	String	广播设备名称
serviceUuid	String	服务UUID
manufacturerId	String	厂商ID（十六进制）
manufacturerData	String	厂商数据（十六进制）
powerLevel	Number	发送功率级别（0-3）