Web Bluetooth Scanner & Test
Online Bluetooth LE Scanner. Finden Sie Geräte, verbinden Sie sich und lesen Sie Dienste/Charakteristiken aus.
Umgebung
GATT Dienste / Charakteristiken
Protokoll
So nutzen Sie diese Seite, um Probleme schnell zu lokalisieren
Bluetooth Diagnose
Mit Web Bluetooth API Geräte scannen und verbinden.
Bestätigen Sie die Umgebungs- und Browserunterstützung
Stellen Sie sicher, dass Sie über HTTPS zugreifen und einen Browser verwenden, der Web Bluetooth unterstützt.
Geräte scannen und auswählen
Klicken Sie auf „Geräte scannen“ und wählen Sie Ihr Bluetooth-Gerät im System-Popup-Fenster aus.
GATT-Dienste/-Merkmale verbinden und auflisten
Klicken Sie nach erfolgreicher Verbindung auf „Dienste auflisten“, um die Liste der Dienste und Merkmale anzuzeigen.
Benachrichtigungen lesen/abonnieren und Berichte exportieren
Kennwerte auslesen, Benachrichtigungen aktivieren und schließlich den Bericht zur weiteren Fehlerbehebung kopieren.
FAQ
Haben Sie Fragen? Wir haben die Antwort! Im Folgenden finden Sie eine Zusammenfassung häufig gestellter Fragen zum Web-Bluetooth-Scannen, zu Verbindungen und zur GATT-Diagnose.
Was kann diese Bluetooth-Diagnoseseite?
Basierend auf der Web-Bluetooth-Funktion des Browsers hilft es Ihnen dabei, „Geräte scannen und auswählen → Verbindung zu GATT herstellen → Dienste/Funktionen auflisten → Benachrichtigungen lesen/abonnieren“ durchzuführen und wichtige Protokolle und Fehler aufzuzeichnen, um das Auffinden von Kopplungsfehlern, Verbindungsabbrüchen, Unsichtbarkeit von Diensten und Kompatibilitätsproblemen zu erleichtern.
Warum erscheint die Meldung „Web Bluetooth wird nicht unterstützt“?
Web-Bluetooth wird nicht von allen Browsern/Plattformen unterstützt. Normalerweise bietet die Desktop-Version Chrome/Edge eine bessere Unterstützung; iOS Safari unterstützt dies normalerweise nicht. Sie können den Browser wechseln oder zum Desktop wechseln und erneut testen.
Warum muss der Zugriff unter HTTPS erfolgen?
Web-Bluetooth ist eine Funktion mit hohen Berechtigungen und der Browser erfordert einen sicheren Kontext (HTTPS). Wenn es sich in einer http- oder unsicheren Umgebung befindet, wird ein SecurityError ausgelöst oder es ist direkt nicht verfügbar.
Warum erfolgt beim Klicken auf „Gerät scannen“ keine Reaktion/wird direkt ein NotAllowedError gemeldet?
Der Scan muss durch eine Benutzergeste (z. B. Klicken auf eine Schaltfläche) ausgelöst werden und der Browser/das System muss Bluetooth-Berechtigungen zulassen. Bitte stellen Sie sicher, dass Sie auf klicken, um es manuell auszulösen, das System-Bluetooth eingeschaltet ist und der Browser Berechtigungs-Popups nicht blockiert.
Warum kann ich das Gerät nicht scannen?
Häufige Gründe sind: Das Gerät ist nicht erkennbar/verbindbar, die Entfernung ist zu groß oder blockiert, die Filterbedingungen sind zu streng (Namenspräfix/Dienst) oder das System-Bluetooth ist durch andere Anwendungen belegt. Es wird empfohlen, zunächst „acceptAllDevices“ zu überprüfen, sich dem Gerät zu nähern und es erneut zu versuchen.
Warum bin ich verbunden, kann aber „Dienste/Funktionen nicht auflisten“?
Browser beschränken den Zugriff auf nicht deklarierte GATT-Dienste. Bitte fügen Sie die UUID des Zieldienstes zu optionalServices hinzu (unterstützt Schlüsselwörter wie „battery_service“, und Sie können auch die vollständige UUID schreiben), dann erneut scannen/verbinden und erneut auflisten.
Warum kommt es häufig zu Verbindungsabbrüchen (NetworkError/InvalidStateError)?
Häufige Gründe sind Entfernung/Störungen, schwacher Akku oder energiesparender Ruhezustand des Geräts, die Unterbrechung der Bluetooth-Verbindung durch andere Geräte oder ein instabiler Bluetooth-Stack des Systems. Es wird empfohlen, näher an das Gerät heranzugehen, 2,4-GHz-Störungen zu reduzieren, Bluetooth/Gerät neu zu starten und zu versuchen, eine Verbindung mit einem einzelnen Gerät aufrechtzuerhalten.
Nach dem Aktivieren von „Benachrichtigungen“ sind keine Daten vorhanden. Ist das normal?
Wahrscheinlich normal. Nicht alle Funktionen senden proaktiv Benachrichtigungen. Einige erfordern, dass zuerst die Konfiguration geschrieben oder Ereignisse auf dem Gerät ausgelöst werden. Darüber hinaus können Browser/Geräte Einschränkungen hinsichtlich des Benachrichtigungsereignisses haben. Sie können zunächst „Lesen“ ausprobieren, um zu bestätigen, ob die Funktion lesbar ist, oder einen Funktionsüberprüfungslink ändern, der bekanntermaßen gepusht wird.
Ist die Privatsphäre sicher? Werden meine Bluetooth-Daten hochgeladen?
Diese Seite interagiert und analysiert hauptsächlich innerhalb des lokalen Browsers und lädt Ihre Bluetooth-Daten nicht aktiv hoch. Wenn Sie auf „Bericht kopieren“ klicken, wird der Inhalt in Ihre Zwischenablage verschoben. Es liegt an Ihnen, ob Sie es teilen möchten.
Welche Informationen enthält der Replikationsbericht?
Der Bericht umfasst Testzeit, Browser-UA, HTTPS-/Verfügbarkeitsstatus, Scan-Parameter (Filter/optionale Dienste), eine Zusammenfassung der Geräteinformationen, aufgezählte Dienste/Funktionsstrukturen, aktuelle Fehler und Protokollierung. Wird verwendet, um Probleme schnell zu reproduzieren und zu lokalisieren.