Web Bluetooth Scanner & Test

Online Bluetooth LE Scanner. Finden Sie Geräte, verbinden Sie sich und lesen Sie Dienste/Charakteristiken aus.

Umgebung

Web Bluetooth API
Unterstützt kein Web-Bluetooth
HTTPS
NEIN
Bluetooth-Verfügbarkeit (getAvailability)
Unbekannt/nicht unterstützt
User-Agent
-
Ihr aktueller Browser unterstützt möglicherweise kein Web-Bluetooth
Meist nur in Chrome/Edge auf Desktop & Android unterstützt.
BereitAusrüstung:-
aktuelles Gerät
Name: -
ID:-
verbinden:Nicht verbunden
Kürzlich getrennt:-
Werbung/Rundfunk (optional)
Wird von einigen Chrome-Versionen/-Geräten zur Beobachtung der RSSI-/Broadcast-Persistenz unterstützt.

GATT Dienste / Charakteristiken

Gesamtzahl der 0-Dienste / 0-Merkmale
Erst verbinden, dann 'Dienste laden' klicken.

Protokoll

Noch keine Protokolle. Es wird empfohlen, zum Starten auf „Gerät scannen“ zu klicken.

So nutzen Sie diese Seite, um Probleme schnell zu lokalisieren

Schauen Sie sich zunächst „Umgebung und Support“ an: Es muss sich im HTTPS-/Sicherheitskontext befinden. Desktop-Version Chrome/Edge wird empfohlen. iOS Safari unterstützt Web-Bluetooth im Allgemeinen nicht.
Das Scannen muss durch Benutzergesten wie „Klicken auf eine Schaltfläche“ ausgelöst werden; Andernfalls kann es leicht passieren, dass NotAllowedError gemeldet wird oder vom Browser abgefangen wird.
Keine Verbindung möglich/häufig getrennt: Gehen Sie näher an das Gerät heran, um Hindernisse und 2,4-GHz-Störungen zu reduzieren; Schalten Sie das Bluetooth des Systems aus und schalten Sie das Gerät dann ein oder starten Sie es neu. Vermeiden Sie die Belegung durch andere Geräte/Anwendungen.
Dienste/Funktionen können nicht aufgelistet werden: Fügen Sie den Zieldienst zu optionalServices hinzu (der Browser schränkt den Zugriff auf nicht deklarierte Dienste ein).
Benötigen Sie Hilfe bei der Fehlerbehebung: Klicken Sie auf „Bericht kopieren“, um UA, Status, Fehler und Protokolle an die Entwicklung/den Kundendienst zu übermitteln.

Bluetooth Diagnose

Mit Web Bluetooth API Geräte scannen und verbinden.

Schritt 1

Bestätigen Sie die Umgebungs- und Browserunterstützung

etwa 10 Sekunden

Stellen Sie sicher, dass Sie über HTTPS zugreifen und einen Browser verwenden, der Web Bluetooth unterstützt.

Bestätigen Sie auf der Karte „Umgebung und Support“, dass Web Bluetooth „Unterstützt“ und „Sicherheitskontext (HTTPS) = Ja“ ist.
Wenn „Web Bluetooth nicht unterstützt“ angezeigt wird: Verwenden Sie stattdessen die Desktop-Version von Chrome/Edge. iOS Safari unterstützt es normalerweise nicht.
Tipp: Web-Bluetooth wird durch Browser-/Systemrichtlinien eingeschränkt, die je nach Plattform stark variieren.
Schritt 2

Geräte scannen und auswählen

Ungefähr 10–20 Sekunden

Klicken Sie auf „Geräte scannen“ und wählen Sie Ihr Bluetooth-Gerät im System-Popup-Fenster aus.

Stellen Sie sicher, dass die Bluetooth-Funktion des Systems aktiviert ist und das Zielgerät erkennbar/verbindbar ist.
Klicken Sie auf „Gerät scannen“ (muss per Klick ausgelöst werden, kann nicht automatisch scannen).
Wenn das Gerät nicht gefunden werden kann: Sie können zunächst „acceptAllDevices“ überprüfen. oder verwenden Sie namePrefix/service, um die genaue Positionierung zu filtern.
Schritt 3

GATT-Dienste/-Merkmale verbinden und auflisten

Etwa 10–30 Sekunden

Klicken Sie nach erfolgreicher Verbindung auf „Dienste auflisten“, um die Liste der Dienste und Merkmale anzuzeigen.

Klicken Sie auf „Verbinden“ und der Status ändert sich in „Verbunden“.
Klicken Sie auf „Dienste auflisten“, um die Liste auf der Karte „GATT-Dienste/Merkmale“ anzuzeigen.
Wenn der Zieldienst nicht aufgelistet werden kann: Fügen Sie die Dienst-UUID zu optionalServices hinzu, scannen Sie erneut, stellen Sie eine Verbindung her und versuchen Sie es erneut.
Tipp: Viele Browser schränken Dienste ein, die nicht in optionalServices deklariert sind, und sind nicht „sichtbar“, selbst wenn das Gerät tatsächlich existiert.
Schritt 4

Benachrichtigungen lesen/abonnieren und Berichte exportieren

etwa 20 Sekunden

Kennwerte auslesen, Benachrichtigungen aktivieren und schließlich den Bericht zur weiteren Fehlerbehebung kopieren.

Klicken Sie in der Funktionsliste auf „Lesen“ und beobachten Sie, ob der zurückgegebene Hex-/Textinhalt angemessen ist.
Wenn die Funktion „Benachrichtigung/Anzeige“ unterstützt, können Sie auf „Benachrichtigung aktivieren“ klicken, um zu beobachten, ob das Protokoll weiterhin Daten empfängt.
Wenn Sie auf einen Fehler stoßen oder Hilfe benötigen: Klicken Sie auf „Bericht kopieren“, um den Inhalt zur Positionierung an die Entwicklung/den Kundendienst zu senden.

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.

1.

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.

2.

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.

3.

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.

4.

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.

5.

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.

6.

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.

7.

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.

8.

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.

9.

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.

10.

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.