Guía
Cómo utilizar Bluetooth Low Energy en Capacitor
Prueba en dispositivo
Descarga la aplicación Capgo, luego escanea el código QR code.
Usando @capgo/capacitor-bluetooth-low-energy
Plugin de Bluetooth Low Energy de Capacitor para comunicación BLE.
Instalar
bun add @capgo/capacitor-bluetooth-low-energy
bunx cap sync
bunx cap sync copia el code nativo del plugin en tus proyectos nativos. Ejecútalo de nuevo después de cada actualización del plugin.
Importar
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
API a un vistazo
| Método | Descripción |
|---|---|
initialize |
Inicializa el plugin BLE. Debe llamarse antes de cualquier otro método. |
shimWebBluetooth |
Instala el shim de Web Bluetooth de Capacitor en navigator.bluetoothLlame a esto manualmente antes de utilizar el Bluetooth Web API desde una aplicación nativa Capacitor. |
isAvailable |
Verifica si el Bluetooth está disponible en el dispositivo. |
isEnabled |
Verifica si el Bluetooth está habilitado en el dispositivo. |
isLocationEnabled |
Verifica si los servicios de ubicación están habilitados (solo para Android). |
openAppSettings |
Abrir la página de ajustes de la aplicación. |
openBluetoothSettings |
Abrir la página de ajustes de Bluetooth (solo para Android). |
openLocationSettings |
Abrir la página de ajustes de ubicación (solo para Android). |
checkPermissions |
Verificar el estado actual de permisos. |
requestPermissions |
Solicitar permisos de Bluetooth. |
startScan |
Iniciar la búsqueda de dispositivos BLE. |
stopScan |
Detener la búsqueda de dispositivos BLE. |
connect |
Conectar a un dispositivo BLE. |
disconnect |
Desconectar de un dispositivo BLE. |
createBond |
Crear un vínculo con un dispositivo BLE (solo para Android). |
isBonded |
Verificar si un dispositivo está vinculado (solo para Android). |
discoverServices |
Descubrir servicios en un dispositivo conectado. |
getServices |
Obtener servicios descubiertos para un dispositivo. |
getConnectedDevices |
Obtenga una lista de dispositivos conectados. |
readCharacteristic |
Lea el valor de un carácter. |
writeCharacteristic |
Escriba un valor en un carácter. |
startCharacteristicNotifications |
Inicie las notificaciones para un carácter. |
stopCharacteristicNotifications |
Detenga las notificaciones para un carácter. |
readDescriptor |
Lea el valor de un descriptor. |
writeDescriptor |
Escriba un valor en un descriptor. |
readRssi |
Lea la intensidad del señal (RSSI) de un dispositivo conectado. |
requestMtu |
Cambiar tamaño de MTU de solicitud (solo Android). |
requestConnectionPriority |
Solicite prioridad de conexión (solo para Android). |
startAdvertising |
Inicie la publicidad como periférico (servidor BLE). |
stopAdvertising |
Detenga la publicidad. |
addGattService |
Agregar un servicio GATT con características al servidor GATT local. Debe llamarse en modo periférico antes de iniciar la publicidad. |
removeGattService |
Eliminar un servicio GATT del servidor GATT local. |
setGattCharacteristicValue |
Establecer el valor de una característica GATT local. |
notifyGattCharacteristicChanged |
Notificar a los centrales conectados que el valor de una característica GATT local cambió. |
startForegroundService |
Inicia un servicio de fondo para mantener las conexiones BLE en segundo plano (solo para Android). |
stopForegroundService |
Detener el servicio de primer plano (solo para Android). |
Ejemplos
initialize()
Inicializar el plugin BLE. Debe llamarse antes de cualquier otro método.
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
await BluetoothLowEnergy.initialize({ mode: 'central' });
shimWebBluetooth()
Instalar el shim de Web Bluetooth Capacitor en navigator.bluetooth . Llame a esto manualmente antes de usar el Web Bluetooth API desde una aplicación nativa Capacitor.
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
BluetoothLowEnergy.shimWebBluetooth();
isAvailable()
Comprobar si el Bluetooth está disponible en el dispositivo.
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
const { available } = await BluetoothLowEnergy.isAvailable();
isEnabled()
Comprobar si el Bluetooth está habilitado en el dispositivo.
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
const { enabled } = await BluetoothLowEnergy.isEnabled();
isLocationEnabled()
Verificar si los servicios de ubicación están habilitados (solo para Android).
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
const { enabled } = await BluetoothLowEnergy.isLocationEnabled();
openAppSettings()
Abre la página de ajustes de la aplicación.
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
await BluetoothLowEnergy.openAppSettings();
La tabla anterior enumera los 36 métodos básicos. Los ayudantes de escucha y versión, así como el contrato completo de cada método, se documentan en el GitHub repositorio.
Escuchar eventos
addListener devuelve un manejador. Llame a handle.remove() cuando se desmonta la pantalla, o BluetoothLowEnergy.removeAllListeners() para eliminar todos los escuchadores.
Referencia completa
Continuar desde @capgo/capacitor-bluetooth-low-energy
Si estás utilizando Usando @capgo/capacitor-bluetooth-low-energy para planificar el trabajo de plugin nativo, conectarlo con @capgo/capacitor-energía-baja-del-bluetooth para los detalles de implementación en @capgo/capacitor-bluetooth-low-energy, Getting Started para los detalles de implementación en Inicio, Directorio de Plugins de Capgo para el flujo de trabajo del producto en el Directorio de Plugins Capgo Plugins de Capacitor por Capgo para los detalles de implementación en Plugins de Capacitor por Capgo, y Agregar o Actualizar Plugins para los detalles de implementación en Agregar o Actualizar Plugins.