Teste de Bluetooth Web

Use a API Web Bluetooth para escanear, conectar e diagnosticar dispositivos BLE próximos diretamente do navegador.

Ambiente

Web Bluetooth
Não Suporta
HTTPS Seguro
Não
Disponibilidade Bluetooth
Desconhecido/Não suportado
User-Agent
-
Seu navegador não suporta Web Bluetooth
Use Chrome ou Edge no Desktop/Android. Safari no iOS não suporta.
ProntoDispositivo:-
Dispositivo Atual
Nome: -
ID:-
Conexão:Desconectado
Última queda:-
Broadcast/Anúncios
Monitorar sinais passivos (RSSI).

Serviços GATT

0 Srv / 0 Chars
Conecte e clique em 'Listar Serviços'.

Logs

Sem logs.

Dicas de Uso

Primeiro, observe "Ambiente e Suporte": deve estar no contexto HTTPS/segurança; versão desktop Chrome/Edge é recomendada. O iOS Safari geralmente não oferece suporte para Web Bluetooth.
A verificação deve ser acionada por gestos do usuário, como “clicar em um botão”; caso contrário, é fácil reportar NotAllowedError ou ser interceptado pelo navegador.
Não é possível conectar/desconectar frequentemente: Aproxime-se do dispositivo para reduzir a obstrução e a interferência de 2,4 GHz; desligue o Bluetooth do sistema e ligue ou reinicie o dispositivo; evite ser ocupado por outros dispositivos/aplicativos.
Não é possível enumerar serviços/recursos: adicione o serviço de destino a opcionalServices (o navegador restringirá o acesso a serviços não declarados).
Precisa de ajuda na solução de problemas: clique em "Copiar relatório" para fornecer o UA, status, erros e logs ao desenvolvimento/atendimento ao cliente.

Guia de Teste Bluetooth

Escaneie, conecte e explore serviços GATT.

Passo 1

Verificar Suporte

10s
No cartão "Ambiente e Suporte" confirme: Web Bluetooth é "Suportado" e "Contexto de Segurança (HTTPS) = Sim".
Se aparecer "Web Bluetooth não compatível": use a versão desktop do Chrome/Edge; iOS Safari geralmente não oferece suporte.
Passo 2

Escanear Dispositivos

10-20s
Certifique-se de que o Bluetooth do sistema esteja ativado e que o dispositivo de destino possa ser descoberto/conectado.
Clique em "Verificar dispositivo" (deve ser acionado por clique, não pode verificar automaticamente).
Se o dispositivo não puder ser encontrado: Você pode verificar primeiro AcceptAllDevices; ou use namePrefix/service para filtrar o posicionamento preciso.
Passo 3

Conectar e Explorar

10-30s
Clique em “Conectar” e o status muda para “Conectado”.
Clique em “Enumerar Serviços” para visualizar a lista no cartão “Serviços/Características do GATT”.
Se o serviço de destino não puder ser enumerado: adicione o UUID do serviço a opcionalServices, verifique/conecte novamente e tente novamente.
Passo 4

Ler Dados/Notificações

20s
Clique em "Ler" na lista de recursos e observe se o conteúdo hexadecimal/texto retornado é razoável.
Se o recurso suportar notificação/indicação, você pode clicar em "Ativar notificação" para observar se o log continua recebendo dados.
Se você encontrar um erro ou precisar de assistência: Clique em “Copiar Relatório” para enviar o conteúdo ao desenvolvimento/atendimento ao cliente para posicionamento.

Perguntas Frequentes

Por que não encontro meu dispositivo? Quais navegadores funcionam?

1.

O que esta página de diagnóstico de Bluetooth pode fazer?

Com base na capacidade Web Bluetooth do navegador, ele ajuda você a concluir "verificar e selecionar dispositivos → conectar-se ao GATT → enumerar serviços/recursos → ler/assinar notificações" e registrar registros e erros importantes para facilitar a localização de falhas de emparelhamento, desconexões, invisibilidade de serviço e problemas de compatibilidade.

2.

Por que aparece "Web Bluetooth não suportado"?

O Web Bluetooth não é compatível com todos os navegadores/plataformas. Normalmente a versão desktop Chrome/Edge tem melhor suporte; iOS Safari geralmente não oferece suporte. Você pode mudar o navegador ou mudar para a área de trabalho e testar novamente.

3.

Por que deve ser acessado em HTTPS?

Web Bluetooth é um recurso de alto privilégio e o navegador requer um contexto seguro (HTTPS). Se estiver em um ambiente http ou inseguro, um SecurityError será acionado ou ficará diretamente indisponível.

4.

Por que não há resposta ao clicar em "Verificar dispositivo"/um NotAllowedError é relatado diretamente?

A verificação deve ser acionada por um gesto do usuário (por exemplo, clique de botão) e o navegador/sistema precisa permitir permissões de Bluetooth. Certifique-se de clicar para acioná-lo manualmente, o Bluetooth do sistema está ativado e o navegador não bloqueia pop-ups de permissão.

5.

Por que não consigo escanear o dispositivo?

Os motivos comuns incluem: o dispositivo não pode ser descoberto/conectado, a distância é muito grande ou bloqueada, as condições de filtragem são muito rigorosas (namePrefix/serviço) ou o sistema Bluetooth está ocupado por outros aplicativos. Recomenda-se verificar primeiro acceptAllDevices, aproximar-se do dispositivo e tentar novamente.

6.

Por que estou conectado, mas "não consigo enumerar serviços/recursos"?

Os navegadores restringem o acesso a serviços não declarados do GATT. Adicione o UUID do serviço de destino a opcionalServices (suporta palavras-chave como battery_service e você também pode escrever o UUID completo), verifique/conecte novamente e enumere novamente.

7.

Por que há desconexões frequentes (NetworkError/InvalidStateError)?

Os motivos comuns são distância/interferência, bateria fraca ou hibernação para economia de energia do dispositivo, conexão Bluetooth interrompida por outros dispositivos ou instabilidade da pilha Bluetooth do sistema. Recomenda-se aproximar-se do dispositivo, reduzir a interferência de 2,4 GHz, reiniciar o Bluetooth/dispositivo e tentar manter uma conexão de dispositivo único.

8.

Não há dados após ativar "Notificações". Isso é normal?

Provavelmente normal. Nem todos os recursos enviarão notificações por push proativamente; alguns exigem que a configuração seja gravada primeiro ou que os eventos sejam acionados no dispositivo. Além disso, navegadores/dispositivos também podem ter restrições no evento de notificação. Você pode primeiro tentar "ler" para confirmar se o recurso é legível ou alterar um link de verificação de recurso que foi enviado por push.

9.

A privacidade é segura? Meus dados Bluetooth serão carregados?

Esta página interage e analisa principalmente no navegador local e não carrega ativamente seus dados de Bluetooth. Se você clicar em “Copiar relatório”, o conteúdo irá para a sua área de transferência; cabe a você decidir se deseja compartilhá-lo.

10.

Que informações contém o Relatório de replicação?

O relatório inclui tempo de teste, UA do navegador, status de HTTPS/disponibilidade, parâmetros de verificação (filtros/serviços opcionais), resumo de informações do dispositivo, serviços enumerados/estruturas de recursos, erros recentes e registro. Usado para reproduzir e localizar problemas rapidamente.