Vai al contenuto

@capgo/capacitor-bluetooth-low-energy

Plugin BLE completo per scansionare, connettersi, leggere, scrivere e ricevere notifiche da dispositivi Bluetooth

Plugin BLE completo per scansionare, connettersi, leggere, scrivere e ricevere notifiche da dispositivi Bluetooth

Inizia con initialize() e gli altri metodi core elencati di seguito.

PiattaformaSupportoNote
iOSSìNativo
AndroidSìNativo
WebNoProteggi con Capacitor.getPlatform()
  • initialize - Inizializza il plugin BLE. Deve essere chiamato prima di ogni altro metodo.
  • shimWebBluetooth - Installa lo shim Capacitor Web Bluetooth su navigator.bluetooth. Chiama questo comando manualmente prima di usare API Web Bluetooth da un'app nativa Capacitor.
  • isAvailable - Controlla se il Bluetooth è disponibile sul dispositivo.
  • isEnabled - Controlla se il Bluetooth è abilitato sul dispositivo.
MetodoDescrizione
initializeInizializza il plugin BLE. Deve essere chiamato prima di ogni altro metodo.
shimWebBluetoothInstalla lo shim Capacitor Web Bluetooth su navigator.bluetooth. Chiama questo metodo manualmente prima di usare API Web Bluetooth da un'app nativa Capacitor.
isAvailableControlla se il Bluetooth è disponibile sul dispositivo.
isEnabledVerifica se il Bluetooth è abilitato sul dispositivo.
isLocationEnabledControlla se i servizi di localizzazione sono attivi (solo Android).
openAppSettingsApri la pagina delle impostazioni dell'app.
openBluetoothSettingsApri la pagina delle impostazioni Bluetooth (solo Android).
openLocationSettingsApri la pagina delle impostazioni di localizzazione (solo Android).
checkPermissionsControlla lo stato attuale dei permessi.
requestPermissionsRichiedi i permessi Bluetooth.
startScanAvvia la scansione dei dispositivi BLE.
stopScanFerma la scansione dei dispositivi BLE.
connectConnettiti a un dispositivo BLE.
disconnectDisconnettiti da un dispositivo BLE.
createBondCrea un bond con un dispositivo BLE (solo Android).
isBondedVerifica se un dispositivo è bonded (solo Android).
discoverServicesScopri i servizi su un dispositivo connesso.
getServicesOttieni i servizi scoperti per un dispositivo.
getConnectedDevicesOttieni l'elenco dei dispositivi connessi.
readCharacteristicLeggi il valore di una caratteristica.
writeCharacteristicScrivi un valore in una caratteristica.
startCharacteristicNotificationsAvvia le notifiche per una caratteristica.
stopCharacteristicNotificationsFerma le notifiche per una caratteristica.
readDescriptorLeggi il valore di un descrittore.
writeDescriptorScrivi un valore in un descrittore.
readRssiLeggi l'RSSI (intensità del segnale) di un dispositivo connesso.
requestMtuRichiedi il cambio della dimensione MTU (solo Android).
requestConnectionPriorityRichiedi la priorità di connessione (solo Android).
startAdvertisingAvvia l'advertising come peripheral (BLE server).
stopAdvertisingFerma l'advertising.
startForegroundServiceAvvia un foreground service per mantenere le connessioni BLE in background (solo Android).
stopForegroundServiceFerma il foreground service (solo Android).
getPluginVersionOttieni la versione nativa del plugin Capacitor.
addListenerAdd a listener for device scanned events.
addListenerAdd a listener for device connected events.
addListenerAdd a listener for device disconnected events.
addListenerAggiungi un listener per gli eventi di modifica delle caratteristiche.
removeAllListenersRimuovi tutti i listener di questo plugin.

Questo riferimento è sincronizzato da src/definitions.ts in capacitor-bluetooth-low-energy.

Se stai usando @capgo/capacitor-bluetooth-low-energy per pianificare la migrazione e le operazioni enterprise, connettilo con Usando @capgo/capacitor-bluetooth-low-energy per la funzionalità nativa in Usando @capgo/capacitor-bluetooth-low-energy, Capgo Enterprise per il workflow del prodotto in Capgo Enterprise, Alternative ai plugin Ionic Enterprise per il workflow del prodotto nelle alternative ai plugin Ionic Enterprise, Alternative Capgo per il workflow del prodotto in Alternative Capgo, e Consulenza Capgo per il workflow di prodotto in Capgo Consulting.