Guía
Cómo usar Bluetooth Low Energy en Capacitor
Usando @capgo/capacitor-bluetooth-low-energy
Plugin de Capacitor Bluetooth Low Energy 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 tras cada actualización del plugin.
Importar
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
API de un vistazo
| Método | Descripción |
|---|---|
initialize |
Inicializa el plugin de BLE. Debe llamarse antes que cualquier otro método. |
shimWebBluetooth |
Instala el shim Web Bluetooth de Capacitor en navigator.bluetooth. Llama a esto manualmente antes de usar la API Web Bluetooth desde una app nativa de Capacitor. |
isAvailable |
Comprueba si Bluetooth está disponible en el dispositivo. |
isEnabled |
Comprueba si Bluetooth está activado en el dispositivo. |
isLocationEnabled |
Comprueba si los servicios de ubicación están activados (solo Android). |
openAppSettings |
Abre la página de ajustes de la app. |
openBluetoothSettings |
Abre la página de ajustes de Bluetooth (solo Android). |
openLocationSettings |
Abre la página de ajustes de ubicación (solo Android). |
checkPermissions |
Comprueba el estado actual de los permisos. |
requestPermissions |
Solicita permisos de Bluetooth. |
startScan |
Empieza a escanear dispositivos BLE. |
stopScan |
Detén el escaneo de dispositivos BLE. |
connect |
Conéctate a un dispositivo BLE. |
disconnect |
Desconéctate de un dispositivo BLE. |
createBond |
Crea un emparejamiento con un dispositivo BLE (solo Android). |
isBonded |
Comprueba si un dispositivo está emparejado (solo Android). |
discoverServices |
Descubre los servicios de un dispositivo conectado. |
getServices |
Obtén los servicios descubiertos de un dispositivo. |
getConnectedDevices |
Obtén una lista de dispositivos conectados. |
readCharacteristic |
Lee el valor de una característica. |
writeCharacteristic |
Escribe un valor en una característica. |
startCharacteristicNotifications |
Activa las notificaciones de una característica. |
stopCharacteristicNotifications |
Desactiva las notificaciones de una característica. |
readDescriptor |
Lee el valor de un descriptor. |
writeDescriptor |
Escribe un valor en un descriptor. |
readRssi |
Lee el RSSI (fuerza de señal) de un dispositivo conectado. |
requestMtu |
Solicita un cambio de tamaño de MTU (solo Android). |
requestConnectionPriority |
Solicita prioridad de conexión (solo Android). |
startAdvertising |
Comienza a anunciar como periférico (servidor BLE). |
stopAdvertising |
Detener el advertising. |
addGattService |
Añade un servicio GATT con características al servidor GATT local. Debe llamarse en modo periférico antes de iniciar el advertising. |
removeGattService |
Elimina un servicio GATT del servidor GATT local. |
setGattCharacteristicValue |
Establece el valor de una característica GATT local. |
notifyGattCharacteristicChanged |
Notifica a las centrales conectadas que el valor de una característica GATT local ha cambiado. |
startForegroundService |
Inicia un servicio de primer plano para mantener las conexiones BLE en segundo plano (solo Android). |
stopForegroundService |
Detener el servicio en primer plano (solo Android). |
Ejemplos
initialize()
Inicializa el plugin de BLE. Debe llamarse antes que cualquier otro método.
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
await BluetoothLowEnergy.initialize({ mode: 'central' });
shimWebBluetooth()
Instala el shim Web Bluetooth de Capacitor en navigator.bluetooth. Llama a esto manualmente antes de usar la API Web Bluetooth desde una app nativa de Capacitor.
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
BluetoothLowEnergy.shimWebBluetooth();
isAvailable()
Comprueba si Bluetooth está disponible en el dispositivo.
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
const { available } = await BluetoothLowEnergy.isAvailable();
isEnabled()
Comprueba si Bluetooth está activado en el dispositivo.
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
const { enabled } = await BluetoothLowEnergy.isEnabled();
isLocationEnabled()
Comprueba si los servicios de ubicación están activados (solo Android).
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
const { enabled } = await BluetoothLowEnergy.isLocationEnabled();
openAppSettings()
Abre la página de ajustes de la app.
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
await BluetoothLowEnergy.openAppSettings();
La tabla anterior enumera los 36 métodos principales. Los helpers de versión y listeners, así como el contrato completo de cada método, están documentados en la repositorio GitHub.
Escuchar eventos
addListener devuelve un handle. Llama handle.remove() cuando la pantalla se desmonte, o BluetoothLowEnergy.removeAllListeners() para limpiar todos los listeners.
Referencia completa
Continuar desde «Usando @capgo/capacitor-bluetooth-low-energy»
Si estás usando Usando @capgo/capacitor-bluetooth-low-energy para planificar el trabajo con plugins nativos, conéctalo con @capgo/capacitor-bluetooth-low-energy para el detalle de implementación en @capgo/capacitor-bluetooth-low-energy, Primeros pasos para los detalles de implementación en Primeros pasos, Directorio de plugins de Capgo para el flujo de trabajo del producto en Capgo Plugin Directory, Plugins de Capacitor por Capgo para los detalles de implementación en Capacitor Plugins de Capgo, y Añadir o actualizar plugins para los detalles de implementación al añadir o actualizar plugins.