Aller au contenu

@capgo/capacitor-bluetooth-low-energy

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

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.

PlateformeSupportNotes
iOSOuiNatif
AndroidOuiNatif
Le WebNonProtéger avec Capacitor.getPlatform()
  • initialize - Initialise le plugin BLE. Doit être appelé avant toute autre méthode.
  • shimWebBluetooth - Installe 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.
MéthodeDescription
initializeInitialiser le plugin BLE. À appeler 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 la recherche d'appareils BLE.
stopScanArrêter la recherche d'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.
getConnectedDevicesRécupérer 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.
stopCharacteristicNotificationsArrêter 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 la priorité de connexion (Android uniquement).
startAdvertisingCommencer à diffuser en tant que périphérique (serveur BLE).
stopAdvertisingArrêter la diffusion.
startForegroundServiceDémarrer un service de premier plan pour maintenir les connexions BLE en arrière-plan (Android uniquement).
stopForegroundServiceArrêter le service de premier plan (Android uniquement).
getPluginVersionRécupère la version du plugin natif Capacitor.
addListenerAjouter un listener pour les événements de scan d’appareils.
addListenerAjouter un listener pour les événements de connexion d’appareil.
addListenerAjouter un listener pour les événements de déconnexion d’appareils.
addListenerAjouter un listener pour les événements de changement de caractéristique.
removeAllListenersSupprimez 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 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.