Plugin BLE complet pour scanner, se connecter, lire, écrire et recevoir les notifications d'appareils Bluetooth
Commencez par initialize() et les autres méthodes principales listées ci-dessous.
Support des plateformes
Section intitulée « Support des plateformes »| Plateforme | Support | Notes |
|---|---|---|
| iOS | Oui | Natif |
| Android | Oui | Natif |
| Le Web | Non | Protéger avec Capacitor.getPlatform() |
Fonctionnalités clés
Section intitulée « Fonctionnalités clés »initialize- Initialise le plugin BLE. Doit être appelé avant toute autre méthode.shimWebBluetooth- Installe le shim Web Bluetooth Capacitor surnavigator.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.
API public
Section intitulée « Public API »| Méthode | Description |
|---|---|
initialize | Initialiser le plugin BLE. À appeler 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 la recherche d'appareils BLE. |
stopScan | Arrêter la recherche d'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 | Récupérer 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 | Arrêter 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 la priorité de connexion (Android uniquement). |
startAdvertising | Commencer à diffuser en tant que périphérique (serveur BLE). |
stopAdvertising | Arrêter la diffusion. |
startForegroundService | Démarrer un service de premier plan pour maintenir les connexions BLE en arrière-plan (Android uniquement). |
stopForegroundService | Arrêter le service de premier plan (Android uniquement). |
getPluginVersion | Récupère la version du plugin natif Capacitor. |
addListener | Ajouter un listener pour les événements de scan d’appareils. |
addListener | Ajouter un listener pour les événements de connexion d’appareil. |
addListener | Ajouter un listener pour les événements de déconnexion d’appareils. |
addListener | Ajouter un listener pour les événements de changement de caractéristique. |
removeAllListeners | Supprimez 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 Entreprise 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 les alternatives Capgo, et Conseil Capgo pour le workflow produit chez Capgo Consulting.