Plugin BLE complet pour scanner, se connecter, lire, écrire et recevoir des notifications d'appareils Bluetooth
Commencez par initialize() et les autres méthodes principales listées ci-dessous.
Plateformes compatibles
Section intitulée « Plateformes compatibles »| Plateforme | Support | Notes |
|---|---|---|
| iOS | Oui | Natif |
| Android | Oui | Natif |
| Web | Non | Sécurisez avec Capacitor.getPlatform() |
Fonctionnalités clés
Section intitulée « Fonctionnalités clés »initialize- Initialisez le plugin BLE. Doit être appelé avant toute autre méthode.shimWebBluetooth- Installez le shim Web Bluetooth Capacitor surnavigator.bluetooth. Appelez cela manuellement avant d'utiliser l’API Web Bluetooth depuis une application native Capacitor.isAvailable- Vérifiez si le Bluetooth est disponible sur l'appareil.isEnabled- Vérifier si le Bluetooth est activé sur l'appareil.
API public
Section intitulée « Public API »| Méthode | Description |
|---|---|
initialize | Initialiser le plugin BLE. Doit être appelé avant toute autre méthode. |
shimWebBluetooth | Installer le shim Web Bluetooth Capacitor sur navigator.bluetooth. Appelez ceci manuellement avant d'utiliser l’API Web Bluetooth depuis une application native Capacitor. |
isAvailable | Vérifier si le Bluetooth est disponible sur l'appareil. |
isEnabled | Vérifier si le Bluetooth est activé sur l'appareil. |
isLocationEnabled | Vérifier si les services de localisation sont activés (Android uniquement). |
openAppSettings | Ouvrir la page des paramètres de l'application. |
openBluetoothSettings | Ouvrir la page des paramètres Bluetooth (Android uniquement). |
openLocationSettings | Ouvrir la page des paramètres de localisation (Android uniquement). |
checkPermissions | Vérifier le statut actuel des permissions. |
requestPermissions | Demander les permissions Bluetooth. |
startScan | Lancer le scan des appareils BLE. |
stopScan | Arrêter le scan des appareils BLE. |
connect | Se connecter à un appareil BLE. |
disconnect | Se déconnecter d'un appareil BLE. |
createBond | Créer un appairage avec un appareil BLE (Android uniquement). |
isBonded | Vérifier si un appareil est appairé (Android uniquement). |
discoverServices | Découvrir les services sur un appareil connecté. |
getServices | Récupérer les services découverts pour un appareil. |
getConnectedDevices | Obtenir la liste des appareils connectés. |
readCharacteristic | Lire la valeur d'une caractéristique. |
writeCharacteristic | Écrire une valeur dans une caractéristique. |
startCharacteristicNotifications | Activer les notifications pour une caractéristique. |
stopCharacteristicNotifications | Désactiver les notifications pour une caractéristique. |
readDescriptor | Lire la valeur d'un descripteur. |
writeDescriptor | Écrire une valeur dans un descripteur. |
readRssi | Lire le RSSI (force du signal) d'un appareil connecté. |
requestMtu | Demander un changement de taille MTU (Android uniquement). |
requestConnectionPriority | Demander une priorité de connexion (Android uniquement). |
startAdvertising | Lancer l'advertising en tant que périphérique (serveur BLE). |
stopAdvertising | Arrêter l'advertising. |
startForegroundService | Lancez un service de premier plan pour maintenir les connexions BLE en arrière-plan (Android uniquement). |
stopForegroundService | Arrêtez le service de premier plan (Android uniquement). |
getPluginVersion | Récupérer la version du plugin natif Capacitor. |
addListener | Ajoutez un écouteur pour les événements de scan d'appareil. |
addListener | Ajoutez un écouteur pour les événements de connexion d'appareil. |
addListener | Ajoutez un écouteur pour les événements de déconnexion d'appareil. |
addListener | Ajoutez un écouteur pour les événements de changement de caractéristique. |
removeAllListeners | Supprimer tous les écouteurs de ce plugin. |
Source de vérité
Section intitulée « Source de vérité »Cette référence est synchronisée depuis src/definitions.ts dans capacitor-bluetooth-low-energy.
Continuer avec @capgo/capacitor-bluetooth-low-energy
Section intitulée « Continuer avec @capgo/capacitor-bluetooth-low-energy »Si vous utilisez @capgo/capacitor-bluetooth-low-energy pour planifier la migration et les opérations d'entreprise, connectez-l’à Utiliser @capgo/capacitor-bluetooth-low-energy pour la capacité native dans Utiliser @capgo/capacitor-bluetooth-low-energy, Capgo Enterprise pour le workflow produit dans Capgo Enterprise, Alternatives aux plugins Ionic Enterprise pour le workflow produit dans les alternatives aux plugins Ionic Enterprise, Alternatives à Capgo pour le workflow produit dans Capgo Alternatives, et Consulting Capgo pour le workflow produit dans Capgo Consulting.