Guida
Come utilizzare il Bluetooth Low Energy in Capacitor
Utilizzare @capgo/capacitor-bluetooth-low-energy
Capacitor Plugin Bluetooth Low Energy per comunicazione BLE.
Installare
bun add @capgo/capacitor-bluetooth-low-energy
bunx cap sync
bunx cap sync copia il plugin nativo code nei tuoi progetti nativi. Esegui nuovamente dopo ogni aggiornamento del plugin.
Importare
import { BluetoothLowEnergy } from '@capgo/capacitor-bluetooth-low-energy';
Vista d'insieme di API
| Metodo | Descrizione |
|---|---|
initialize |
Inizializza il plugin BLE. Deve essere chiamato prima di qualsiasi altro metodo. |
shimWebBluetooth |
Installare il shim Web Bluetooth Capacitor su navigator.bluetoothChiamalo manualmente prima di utilizzare 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 abilitati (solo Android). |
openAppSettings |
Apre la pagina di impostazioni dell'applicazione. |
openBluetoothSettings |
Apre la pagina di impostazioni Bluetooth (solo Android). |
openLocationSettings |
Apre la pagina di impostazioni localizzazione (solo Android). |
checkPermissions |
Verifica lo stato attuale dei permessi. |
requestPermissions |
Richiedi i permessi Bluetooth. |
startScan |
Inizia a cercare dispositivi BLE. |
stopScan |
Fermare la ricerca dei dispositivi BLE. |
connect |
Connetti a un dispositivo BLE. |
disconnect |
Disconnetti dal dispositivo BLE. |
createBond |
Creare un legame con un dispositivo BLE (solo per Android). |
isBonded |
Verificare se un dispositivo è legato (solo per Android). |
discoverServices |
Scoprire i servizi su un dispositivo connesso. |
getServices |
Ottenere i servizi scoperti per un dispositivo. |
getConnectedDevices |
Ottenere l'elenco dei dispositivi connessi. |
readCharacteristic |
Lettura di un valore di caratteristica. |
writeCharacteristic |
Scrittura di un valore in una caratteristica. |
startCharacteristicNotifications |
Avviare le notifiche per una caratteristica. |
stopCharacteristicNotifications |
Sospendere le notifiche per una caratteristica. |
readDescriptor |
Lettura di un valore di descriptor. |
writeDescriptor |
Scrittura di un valore in un descriptor. |
readRssi |
Lettura della RSSI (intensità del segnale) di un dispositivo connesso. |
requestMtu |
Richiedi cambio di dimensione MTU (solo per Android). |
requestConnectionPriority |
Richiedi priorità di connessione (solo per Android). |
startAdvertising |
Inizia a pubblicizzare come periferica (server BLE). |
stopAdvertising |
Smetti di pubblicizzare. |
addGattService |
Aggiungi un servizio GATT con caratteristiche al server GATT locale. Deve essere chiamato in modalità periferica prima di iniziare a pubblicizzare. |
removeGattService |
Rimuovi un servizio GATT dal server GATT locale. |
setGattCharacteristicValue |
Imposta il valore di una caratteristica GATT locale. |
notifyGattCharacteristicChanged |
Notifica i centrali connessi che è cambiato il valore di un caratteristica GATT locale. |
startForegroundService |
Avvia un servizio in primo piano per mantenere le connessioni BLE in background (solo per Android). |
stopForegroundService |
Smetti il servizio in primo piano (solo per Android). |
Esempi
initialize()
Avvia 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 Bluetooth Web Capacitor su navigator.bluetoothChiamalo manualmente prima di utilizzare il Bluetooth Web 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 abilitati (solo per 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();
I metodi elencati nella tabella sopra sono 36. I listener e gli aiuti per la versione, nonché il contratto completo di ogni metodo, sono documentati nel repository del GitHub.
resta un riferimento. Chiamalo
addListener quando la schermata viene smontata, o handle.remove() per cancellare ogni ascoltatore. BluetoothLowEnergy.removeAllListeners() Install the __CAPGO_KEEP_0__ Web Bluetooth shim on
Riferimento completo
Continua da Utilizzo di @capgo/capacitor-low-energy-bluetooth
Se stai utilizzando Utilizzo di @capgo/capacitor-low-energy-bluetooth per pianificare il lavoro del plugin nativo, connettilo con @capgo/capacitor-low-energy-bluetooth per i dettagli di implementazione in @capgo/capacitor-low-energy-bluetooth Getting Started per i dettagli di implementazione in Avvio Capgo Directory dei Plugin per il workflow del prodotto nella Capgo Directory dei Plugin Capacitor Plugin da Capgo per il dettaglio di implementazione in Capacitor Plugin da Capgo, e Aggiungere o Aggiornare i Plugin per il dettaglio di implementazione in Aggiungere o Aggiornare i Plugin.