Aller au contenu

@capgo/capacitor-bluetooth-low-energy

Plugin BLE complet pour scanner, se connecter, lire, écrire et recevoir des notifications d'appareils Bluetooth

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.

PlateformeSupportNotes
iOSOuiNatif
AndroidOuiNatif
WebNonSécurisez avec Capacitor.getPlatform()
  • initialize - Initialisez le plugin BLE. Doit être appelé avant toute autre méthode.
  • shimWebBluetooth - Installez le shim Web Bluetooth Capacitor sur navigator.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.
MéthodeDescription
initializeInitialiser le plugin BLE. Doit être appelé avant toute autre méthode.
shimWebBluetoothInstaller le shim Web Bluetooth Capacitor sur navigator.bluetooth. Appelez ceci manuellement avant d'utiliser l’API Web Bluetooth depuis une application native Capacitor.
isAvailableVérifier si le Bluetooth est disponible sur l'appareil.
isEnabledVérifier si le Bluetooth est activé sur l'appareil.
isLocationEnabledVérifier si les services de localisation sont activés (Android uniquement).
openAppSettingsOuvrir la page des paramètres de l'application.
openBluetoothSettingsOuvrir la page des paramètres Bluetooth (Android uniquement).
openLocationSettingsOuvrir la page des paramètres de localisation (Android uniquement).
checkPermissionsVérifier le statut actuel des permissions.
requestPermissionsDemander les permissions Bluetooth.
startScanLancer le scan des appareils BLE.
stopScanArrêter le scan des appareils BLE.
connectSe connecter à un appareil BLE.
disconnectSe déconnecter d'un appareil BLE.
createBondCréer un appairage avec un appareil BLE (Android uniquement).
isBondedVérifier si un appareil est appairé (Android uniquement).
discoverServicesDécouvrir les services sur un appareil connecté.
getServicesRécupérer les services découverts pour un appareil.
getConnectedDevicesObtenir la liste des appareils connectés.
readCharacteristicLire la valeur d'une caractéristique.
writeCharacteristicÉcrire une valeur dans une caractéristique.
startCharacteristicNotificationsActiver les notifications pour une caractéristique.
stopCharacteristicNotificationsDésactiver les notifications pour une caractéristique.
readDescriptorLire la valeur d'un descripteur.
writeDescriptorÉcrire une valeur dans un descripteur.
readRssiLire le RSSI (force du signal) d'un appareil connecté.
requestMtuDemander un changement de taille MTU (Android uniquement).
requestConnectionPriorityDemander une priorité de connexion (Android uniquement).
startAdvertisingLancer l'advertising en tant que périphérique (serveur BLE).
stopAdvertisingArrêter l'advertising.
startForegroundServiceLancez un service de premier plan pour maintenir les connexions BLE en arrière-plan (Android uniquement).
stopForegroundServiceArrêtez le service de premier plan (Android uniquement).
getPluginVersionRécupérer la version du plugin natif Capacitor.
addListenerAjoutez un écouteur pour les événements de scan d'appareil.
addListenerAjoutez un écouteur pour les événements de connexion d'appareil.
addListenerAjoutez un écouteur pour les événements de déconnexion d'appareil.
addListenerAjoutez un écouteur pour les événements de changement de caractéristique.
removeAllListenersSupprimer tous les écouteurs de ce plugin.

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.