Plugin BLE completo para escanear, conectar, leer, escribir y recibir notificaciones de dispositivos Bluetooth
Comienza con initialize() y los demás métodos principales detallados abajo.
Soporte de plataformas
Sección titulada “Soporte de plataformas”| Plataforma | Soporte | Notas |
|---|---|---|
| iOS | Sí | Nativo |
| Android | Sí | Nativo |
| Web | No | Protege con Capacitor.getPlatform() |
Funcionalidades principales
Sección titulada “Funcionalidades principales”initialize- Inicializa el plugin BLE. Debe llamarse antes que cualquier otro método.shimWebBluetooth- Instala el shim de Web Bluetooth de Capacitor ennavigator.bluetooth. Llama a esto manualmente antes de usar la API Web Bluetooth desde una app nativa de Capacitor.isAvailable- Comprueba si el Bluetooth está disponible en el dispositivo.isEnabled- Comprueba si el Bluetooth está activado en el dispositivo.
Público API
Sección titulada “Público API”| 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. |
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). |
getPluginVersion | Obtén la versión del plugin nativo Capacitor. |
addListener | Añadir un listener para eventos de escaneo de dispositivos. |
addListener | Añadir un listener para eventos de conexión de dispositivos. |
addListener | Añadir un listener para eventos de desconexión de dispositivos. |
addListener | Añadir un listener para eventos de cambio de característica. |
removeAllListeners | Elimina todos los listeners de este plugin. |
Fuente de verdad
Sección titulada “Fuente de verdad”Esta referencia se sincroniza desde src/definitions.ts en capacitor-bluetooth-low-energy.
Continuar desde @capgo/capacitor-bluetooth-low-energy
Sección titulada “Continuar desde @capgo/capacitor-bluetooth-low-energy”Si estás usando @capgo/capacitor-bluetooth-low-energy para planificar la migración y las operaciones enterprise, conéctalo con Usando @capgo/capacitor-bluetooth-low-energy para la capacidad nativa en Uso de @capgo/capacitor-bluetooth-low-energy Capgo Enterprise para el flujo de trabajo del producto en Capgo Enterprise, Alternativas a plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas de Plugins de Ionic Enterprise, Alternativas a Capgo para el flujo de trabajo del producto en Alternativas a Capgo, y Consultoría de Capgo para el flujo de trabajo de productos en Capgo Consulting.