跳到主要内容

useBluetooth

蓝牙设备

何时使用​

当需要使用蓝牙功能时

API​

const [
  { devices, connectedDevices, adapter },
  {
    toggleAdapter,
    getState,
    getDevices,
    getConnected,
    makePair,
    isPaired,
    toggleDiscovery,
  },
] = useBluetooth();

参数说明​

无

返回值说明​

返回值说明类型
devices蓝牙模块生效期间所有搜索到的蓝牙设备Taro.getBluetoothDevices.SuccessCallbackResultBlueToothDevice[]
connectedDevices主服务UUID获取已连接的蓝牙设备Taro.getConnectedBluetoothDevices.BluetoothDeviceInfo[]
adapter蓝牙模块Taro.getBluetoothAdapterState.SuccessCallbackResult
toggleAdapter初始化(关闭)蓝牙模块。iOS上开启主机/从机（外围设备）模式时需分别调用一次，并指定对应的modePromiseOptionalAction<ExcludeOption<Taro.startBluetoothDevicesDiscovery.Option>, TaroGeneral.BluetoothError>
getState获取本机蓝牙适配器状态PromiseWithoutOptionAction<AdapterState>
getDevices获取在蓝牙模块生效期间所有搜索到的蓝牙设备。包括已经和本机处于连接状态的设备PromiseWithoutOptionAction<Taro.getBluetoothDevices.SuccessCallbackResult>
getConnected根据主服务UUID获取已连接的蓝牙设备PromiseWithoutOptionAction<Taro.getConnectedBluetoothDevices.SuccessCallbackResult>
toggleDiscovery开始(停止)搜寻附近的蓝牙外围设备PromiseOptionalAction<ExcludeOption<Taro.startBluetoothDevicesDiscovery.Option>, TaroGeneral.BluetoothError>
makePair通常情况下（需要指定 pin 码或者密码时）系统会接管配对流程，直接调用 wx.createBLEConnection 即可。该接口只应当在开发者不想让用户手动输入 pin 码且真机验证确认可以正常生效情况下用PromiseAction<ExcludeOption<Taro.makeBluetoothPair.Option>>
isPaired查询蓝牙设备是否配对，仅安卓支持PromiseAction<string>

代码演示​

Hook 支持度​

微信小程序H5ReactNative
✔️