HomeStrumentiDiagnostica Bluetooth

Test Web Bluetooth - Scansione e Connessione

Usa API Web Bluetooth per scansionare e connettere dispositivi BLE direttamente dal browser.

Ambiente

Web Bluetooth
Web Bluetooth NON Supportato
HTTPS Sicuro
No
Disponibilità BT
Sconosciuto/Non supportato
User-Agent
-
Browser non supportato
Usa Chrome desktop o Android.
Prontoattrezzatura:-
Dispositivo Attuale
Nome: -
ID:-
Stato:Non connesso
Disconnesso di recente:-
Pubblicità/Trasmissione (facoltativo)
Supportato da alcune versioni/dispositivi di Chrome per osservare la persistenza RSSI/trasmissione.

Servizi GATT / Caratteristiche

Totale 0 servizi/0 caratteristiche
Nessun dato. Connetti ed elenca servizi.

tronco d'albero

Nessun registro ancora. Si consiglia di fare clic su "Scansione dispositivo" per iniziare.

Uso rapido

Primo sguardo a "Ambiente e supporto": deve essere nel contesto HTTPS/sicurezza; Si consiglia la versione desktop Chrome/Edge. iOS Safari generalmente non supporta Web Bluetooth.
La scansione deve essere attivata da gesti dell'utente come "facendo clic su un pulsante"; in caso contrario, è facile segnalare NotAllowedError o essere intercettati dal browser.
Impossibile connettersi/disconnettersi frequentemente: avvicinarsi al dispositivo per ridurre l'ostruzione e l'interferenza a 2,4 GHz; spegnere il sistema Bluetooth e quindi accendere o riavviare il dispositivo; evitare di essere occupati da altri dispositivi/applicazioni.
Impossibile enumerare servizi/funzionalità: aggiungere il servizio di destinazione a optionalServices (il browser limiterà l'accesso ai servizi non dichiarati).
Hai bisogno di assistenza nella risoluzione dei problemi: fai clic su "Copia rapporto" per fornire l'UA, lo stato, gli errori e i registri al servizio di sviluppo/clienti.

Guida Bluetooth

Scansiona, connetti e leggi servizi GATT.

Passo 1

Verifica supporto

circa 10 secondi

Usa Chrome/Edge su PC o Android (iOS limitato).

Nella scheda "Ambiente e supporto" confermare: Web Bluetooth è "Supportato" e "Contesto di sicurezza (HTTPS) = Sì".
Se viene visualizzato il messaggio "Bluetooth Web non supportato": utilizza invece la versione desktop di Chrome/Edge; iOS Safari di solito non lo supporta.
Suggerimento: il Bluetooth Web sarà limitato dai criteri del browser/sistema, che variano notevolmente a seconda delle diverse piattaforme.
Passo 2

Scansiona dispositivo

Circa 10-20 secondi

Clicca 'Scansiona' e seleziona il device dal popup.

Assicurati che il Bluetooth del sistema sia attivo e che il dispositivo di destinazione sia rilevabile/connettibile.
Fare clic su "Scansione dispositivo" (deve essere attivato con un clic, non è possibile eseguire la scansione automaticamente).
Se il dispositivo non può essere trovato: puoi prima controllare accettaAllDevices; oppure utilizzare namePrefix/service per filtrare il posizionamento preciso.
Passo 3

Connetti GATT

Circa 10-30 secondi

Stabilisci connessione per leggere servizi.

Fai clic su "Connetti" e lo stato cambierà in "Connesso".
Fare clic su "Enumera servizi" per visualizzare l'elenco nella scheda "Servizi/Caratteristiche GATT".
Se non è possibile enumerare il servizio di destinazione: aggiungere l'UUID del servizio a optionalServices, eseguire nuovamente la scansione/connettersi e riprovare.
Suggerimento: molti browser limiteranno i servizi non dichiarati in optionalServices e non saranno "visibili" anche se il dispositivo esiste effettivamente.
Passo 4

Leggi/sottoscrivi notifiche ed esporta report

circa 20 secondi

Leggi i valori caratteristici, abilita le notifiche e infine copia il rapporto per un'ulteriore risoluzione dei problemi.

Fare clic su "Leggi" nell'elenco delle funzionalità e osservare se il contenuto esadecimale/testo restituito è ragionevole.
Se la funzione supporta la notifica/indicazione, è possibile fare clic su "Attiva notifica" per osservare se il registro continua a ricevere dati.
Se riscontri un errore o hai bisogno di assistenza: fai clic su "Copia rapporto" per inviare il contenuto al servizio di sviluppo/clienti per il posizionamento.

FAQ Bluetooth

Domande su Web Bluetooth API.

1.

Cosa può fare questa pagina di diagnostica Bluetooth?

Basato sulla funzionalità Web Bluetooth del browser, consente di completare "scansione e selezione dispositivi → connessione a GATT → enumerazione servizi/funzionalità → lettura/sottoscrizione notifiche" e registrazione di registri ed errori chiave per facilitare l'individuazione di errori di accoppiamento, disconnessioni, invisibilità del servizio e problemi di compatibilità.

2.

Perché viene visualizzato il messaggio "Il Bluetooth Web non è supportato"?

Web Bluetooth non è supportato da tutti i browser/piattaforme. Di solito la versione desktop Chrome/Edge ha un supporto migliore; iOS Safari di solito non lo supporta. Puoi cambiare browser o passare al desktop ed eseguire nuovamente il test.

3.

Perché è necessario accedervi tramite HTTPS?

Web Bluetooth è una funzionalità con privilegi elevati e il browser richiede un contesto sicuro (HTTPS). Se si trova in un ambiente http o non sicuro, verrà attivato un SecurityError o sarà direttamente non disponibile.

4.

Perché non viene ricevuta alcuna risposta quando si fa clic su "Scansiona dispositivo"/viene segnalato direttamente un NotAllowedError?

La scansione deve essere attivata da un gesto dell'utente (ad esempio il clic su un pulsante) e il browser/sistema deve consentire le autorizzazioni Bluetooth. Assicurati di fare clic per attivarlo manualmente, che il Bluetooth del sistema sia attivato e che il browser non blocchi i popup di autorizzazione.

5.

Perché non riesco a scansionare il dispositivo?

I motivi comuni includono: il dispositivo non è rilevabile/connettibile, la distanza è eccessiva o bloccata, le condizioni di filtraggio sono troppo rigide (nomePrefisso/servizio) oppure il sistema Bluetooth è occupato da altre applicazioni. Si consiglia di controllare prima AcceptAllDevices, avvicinarsi al dispositivo e riprovare.

6.

Perché sono connesso ma "non riesco a enumerare servizi/funzionalità"?

I browser limitano l'accesso ai servizi GATT non dichiarati. Aggiungi l'UUID del servizio di destinazione a optionalServices (supporta parole chiave come batteria_servizio e puoi anche scrivere l'UUID completo), quindi esegui nuovamente la scansione/connetti ed enumera di nuovo.

7.

Perché si verificano frequenti disconnessioni (NetworkError/InvalidStateError)?

I motivi più comuni sono la distanza/interferenza, la batteria scarica o l'ibernazione per risparmio energetico del dispositivo, la connessione Bluetooth bloccata da altri dispositivi o l'instabilità dello stack Bluetooth del sistema. Si consiglia di avvicinarsi al dispositivo, ridurre l'interferenza a 2,4 GHz, riavviare il Bluetooth/dispositivo e provare a mantenere una connessione con un singolo dispositivo.

8.

Non ci sono dati dopo aver attivato "Notifiche". È normale?

Probabilmente normale. Non tutte le funzionalità invieranno notifiche in modo proattivo; alcuni richiedono che venga prima scritta la configurazione o che gli eventi vengano attivati ​​sul dispositivo. Inoltre, anche i browser/dispositivi potrebbero avere restrizioni sull'evento di notifica. Puoi prima provare a "leggere" per confermare se la funzione è leggibile o modificare un collegamento di verifica della funzione noto per essere inviato.

9.

La privacy è sicura? I miei dati Bluetooth verranno caricati?

Questa pagina interagisce e analizza principalmente all'interno del browser locale e non caricherà attivamente i tuoi dati Bluetooth. Se fai clic su "Copia rapporto", il contenuto verrà inserito negli appunti; sta a te decidere se vuoi condividerlo.

10.

Quali informazioni contiene il rapporto di replica?

Il rapporto include tempo di test, UA del browser, stato HTTPS/disponibilità, parametri di scansione (filtri/servizi opzionali), riepilogo delle informazioni sul dispositivo, servizi enumerati/strutture di funzionalità, errori recenti e registrazione. Utilizzato per riprodurre e individuare rapidamente i problemi.