Guida
Come usare Bluetooth Low Energy in Capacitor
Utilizzo di @capgo/capacitor-bluetooth-low-energy
Plugin Bluetooth Low Energy Capacitor per la comunicazione BLE.
Installa
bun add @capgo/capacitor-bluetooth-low-energy
bunx cap sync
bunx cap sync copia i code nativi del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.
Importa
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
API in breve
| 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. Chiamalo manualmente prima di usare il API Web Bluetooth 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 |
Attiva 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. |
addGattService |
Aggiunge un servizio GATT con caratteristiche al server GATT locale. Deve essere chiamato in modalità peripheral prima di avviare l'advertising. |
removeGattService |
Rimuove un servizio GATT dal server GATT locale. |
setGattCharacteristicValue |
Imposta il valore di una caratteristica GATT locale. |
notifyGattCharacteristicChanged |
Notifica le centrali connesse che il valore di una caratteristica GATT locale è cambiato. |
startForegroundService |
Avvia un foreground service per mantenere le connessioni BLE in background (solo Android). |
stopForegroundService |
Ferma il foreground service (solo Android). |
Esempi
initialize()
Inizializza il plugin BLE. Deve essere chiamato prima di qualsiasi altro metodo.
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
await BluetoothLowEnergy.initialize({ mode: 'central' });
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.
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
BluetoothLowEnergy.shimWebBluetooth();
isAvailable()
Verifica se il Bluetooth è disponibile sul dispositivo.
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
const { available } = await BluetoothLowEnergy.isAvailable();
isEnabled()
Verifica se il Bluetooth è abilitato sul dispositivo.
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
const { enabled } = await BluetoothLowEnergy.isEnabled();
isLocationEnabled()
Verifica se i servizi di localizzazione sono attivi (solo Android).
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
const { enabled } = await BluetoothLowEnergy.isLocationEnabled();
openAppSettings()
Apri la pagina delle impostazioni dell'app.
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
await BluetoothLowEnergy.openAppSettings();
La tabella sopra elenca i 36 metodi core. Listener, helper di versione e il contratto completo di ogni metodo sono documentati nella repository GitHub.
Ascolta gli eventi
addListener restituisce un handle. Chiama handle.remove() quando la schermata viene smontata, o BluetoothLowEnergy.removeAllListeners() per rimuovere tutti i listener.
Riferimento completo
Continua con l'uso di @capgo/capacitor-bluetooth-low-energy
Se stai usando Utilizzo di @capgo/capacitor-bluetooth-low-energy per pianificare il lavoro sui plugin nativi, collegalo a @capgo/capacitor-bluetooth-low-energy per i dettagli di implementazione in @capgo/capacitor-bluetooth-low-energy, Per iniziare per i dettagli di implementazione nella guida introduttiva, Directory dei plugin di Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Plugin Capacitor di Capgo, e Aggiunta o aggiornamento dei plugin per i dettagli di implementazione in Aggiunta o aggiornamento dei plugin.