@capgo/capacitor-bluetooth-low-energy

Panoramica

Plugin BLE completo per la scansione, connessione, lettura, scrittura e ricezione di notifiche da dispositivi Bluetooth

Inizia con initialize() e gli altri metodi principali elencati qui sotto.

Supporto piattaforme

Piattaforma	Supporto	Note
iOS	Sì	Nativo
Android	Sì	Nativo
Web	No	Proteggi con Capacitor.getPlatform()

Funzionalità principali

• initialize - Inizializza il plugin BLE. Deve essere chiamato prima di qualsiasi altro metodo.
• shimWebBluetooth - Installa lo shim Capacitor Web Bluetooth su navigator.bluetooth. Chiama questo metodo manualmente prima di usare il Web Bluetooth API da un'app nativa Capacitor.
• isAvailable - Verifica se il Bluetooth è disponibile sul dispositivo.
• isEnabled - Verifica se il Bluetooth è attivato sul dispositivo.

Pubblico API

Metodo	Descrizione
initialize	Inizializza il plugin BLE. Deve essere chiamato prima di qualsiasi altro metodo.
shimWebBluetooth	Installa lo shim Web Bluetooth di Capacitor su navigator.bluetooth. Chiama questo metodo manualmente prima di usare il Web Bluetooth API da un'app nativa Capacitor.
isAvailable	Verifica se il Bluetooth è disponibile sul dispositivo.
isEnabled	Verifica se il Bluetooth è abilitato sul dispositivo.
isLocationEnabled	Verifica se i servizi di localizzazione sono attivi (solo Android).
openAppSettings	Apri la pagina delle impostazioni dell'app.
openBluetoothSettings	Apri la pagina delle impostazioni Bluetooth (solo Android).
openLocationSettings	Apri la pagina delle impostazioni di posizione (solo Android).
checkPermissions	Controlla lo stato attuale dei permessi.
requestPermissions	Richiedi i permessi Bluetooth.
startScan	Avvia la scansione dei dispositivi BLE.
stopScan	Interrompi la scansione dei dispositivi BLE.
connect	Connettiti a un dispositivo BLE.
disconnect	Disconnettiti da un dispositivo BLE.
createBond	Crea un accoppiamento con un dispositivo BLE (solo Android).
isBonded	Controlla se un dispositivo è accoppiato (solo Android).
discoverServices	Rileva i servizi su un dispositivo connesso.
getServices	Ottieni i servizi scoperti per un dispositivo.
getConnectedDevices	Ottieni l'elenco dei dispositivi connessi.
readCharacteristic	Leggi il valore di una caratteristica.
writeCharacteristic	Scrivi un valore in una caratteristica.
startCharacteristicNotifications	Avvia le notifiche per una caratteristica.
stopCharacteristicNotifications	Interrompe le notifiche per una caratteristica.
readDescriptor	Legge il valore di un descrittore.
writeDescriptor	Scrive un valore in un descrittore.
readRssi	Legge l'RSSI (intensità del segnale) di un dispositivo connesso.
requestMtu	Richiede la modifica della dimensione MTU (solo Android).
requestConnectionPriority	Richiede la priorità di connessione (solo Android).
startAdvertising	Avvia l'advertising come periferica (BLE server).
stopAdvertising	Interrompi l'advertising.
startForegroundService	Avvia un foreground service per mantenere le connessioni BLE in background (solo Android).
stopForegroundService	Arresta il foreground service (solo Android).
getPluginVersion	Ottieni la versione nativa del plugin Capacitor.
addListener	Add a listener for device scanned events.
addListener	Add a listener for device connected events.
addListener	Add a listener for device disconnected events.
addListener	Aggiungi un listener per gli eventi di modifica delle caratteristiche.
removeAllListeners	- Rimuove tutti i listener di questo plugin.

Fonte di verità

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

Continua con @capgo/capacitor-bluetooth-low-energy

Se stai usando @capgo/capacitor-bluetooth-low-energy per pianificare la migrazione e le operazioni enterprise, collegalo a Utilizzo di @capgo/capacitor-bluetooth-low-energy per la funzionalità nativa nella guida Usare @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 a Capgo per il workflow di prodotto in Capgo Alternatives, e Consulenza Capgo per il workflow di prodotto in Capgo Consulting.