Guía
Cómo usar Low Energy de Bluetooth en Capacitor
Usando @capgo/capacitor-low-energy-de-bajo-potencia
Capacitor Plugin de Low Energy de Bluetooth para comunicación BLE
Instalar
bun add @capgo/capacitor-bluetooth-low-energy
bunx cap sync
bunx cap sync copia el plugin de code nativo en tus proyectos nativos. Correlo de nuevo después de cada actualización del plugin.
Importar
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
API a la vista
| Método | Descripción |
|---|---|
initialize |
Inicialice el plugin BLE. Debe llamarse antes de cualquier otro método. |
shimWebBluetooth |
Instale el Capacitor shim de Web Bluetooth en navigator.bluetoothLlame a este manualmente antes de usar el API de Web Bluetooth desde una aplicación nativa Capacitor. |
isAvailable |
Verifique si el Bluetooth está disponible en el dispositivo. |
isEnabled |
Verifique si el Bluetooth está habilitado en el dispositivo. |
isLocationEnabled |
Verifique si los servicios de ubicación están habilitados (solo Android). |
openAppSettings |
Abra la página de ajustes de la aplicación. |
openBluetoothSettings |
Abra la página de ajustes de Bluetooth (solo Android). |
openLocationSettings |
Abra la página de ajustes de ubicación (solo para Android). |
checkPermissions |
Verifique el estado actual de permisos. |
requestPermissions |
Solicite permisos de Bluetooth. |
startScan |
Inicie la búsqueda de dispositivos BLE. |
stopScan |
Detenga la búsqueda de dispositivos BLE. |
connect |
Conecte a un dispositivo BLE. |
disconnect |
Desconecte de un dispositivo BLE. |
createBond |
Establezca una unión con un dispositivo BLE (solo para Android). |
isBonded |
Verifique si un dispositivo está unido (solo para Android). |
discoverServices |
Descubra servicios en un dispositivo conectado. |
getServices |
Obtenga servicios descubiertos para un dispositivo. |
getConnectedDevices |
Obtenga una lista de dispositivos conectados. |
readCharacteristic |
Leer un valor de característica. |
writeCharacteristic |
Escribir un valor en una característica. |
startCharacteristicNotifications |
Iniciar notificaciones para una característica. |
stopCharacteristicNotifications |
Detener notificaciones para una característica. |
readDescriptor |
Leer un valor de descriptor. |
writeDescriptor |
Escribir un valor en un descriptor. |
readRssi |
Leer la intensidad del señal (RSSI) de un dispositivo conectado. |
requestMtu |
Cambiar tamaño de MTU de solicitud (solo Android). |
requestConnectionPriority |
Solicitar prioridad de conexión (solo para Android). |
startAdvertising |
Iniciar publicidad como periférico (servidor BLE). |
stopAdvertising |
Detener 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 de la GATT local. |
setGattCharacteristicValue |
Establecer el valor de un carácterístico GATT local. |
notifyGattCharacteristicChanged |
Notificar centrales conectadas que un valor de característica GATT local cambió. |
startForegroundService |
Iniciar un servicio de fondo para mantener las conexiones BLE en segundo plano (solo Android). |
stopForegroundService |
Detener el servicio de fondo (solo Android). |
Examples
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()
Comprobar si los servicios de ubicación están habilitados (solo Android).
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
const { enabled } = await BluetoothLowEnergy.isLocationEnabled();
openAppSettings()
Abra 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 repositorio GitHub.
Escuchar eventos
addListener devuelve un manejador. Llame a handle.remove() cuando la pantalla se desmonte, o BluetoothLowEnergy.removeAllListeners() para eliminar todos los escuchadores.
Referencia completa
Sigue adelante desde Usando @capgo/capacitor-bluetooth-low-energy
If estás utilizando Usando @capgo/capacitor-bajo consumo de energía de Bluetooth para planificar el trabajo de plugin nativo, conecta con @capgo/capacitor-energía-baja-del-bluetooth Para la implementación detallada en @capgo/capacitor-bajo consumo de energía del Bluetooth. Getting Started para obtener 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 obtener detalles de implementación en Plugins de Capacitor por Capgo, y Agregar o Actualizar Plugins Para la implementación de detalles en la adición o actualización de plugins.