Test Web Bluetooth - Scansione e Connessione
Usa API Web Bluetooth per scansionare e connettere dispositivi BLE direttamente dal browser.
Ambiente
Servizi GATT / Caratteristiche
tronco d'albero
Uso rapido
Guida Bluetooth
Scansiona, connetti e leggi servizi GATT.
Verifica supporto
Usa Chrome/Edge su PC o Android (iOS limitato).
Scansiona dispositivo
Clicca 'Scansiona' e seleziona il device dal popup.
Connetti GATT
Stabilisci connessione per leggere servizi.
Leggi/sottoscrivi notifiche ed esporta report
Leggi i valori caratteristici, abilita le notifiche e infine copia il rapporto per un'ulteriore risoluzione dei problemi.
FAQ Bluetooth
Domande su Web Bluetooth API.
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à.
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.
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.
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.
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.
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.
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.
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.
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.
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.