Web 블루투스 연결 및 스캔 테스트
Web Bluetooth API를 활용해 주변의 블루투스 장치를 온라인으로 스캔합니다. 브라우저의 블루투스 연결, 페어링 및 데이터 전송 능력을 테스트하세요 (하드웨어 지원 필요).
환경 및 지원
GATT 서비스 / 특성
로그
이 페이지로 문제를 빠르게 찾는 법
블루투스 진단 가이드
Web Bluetooth 스캔, 연결, GATT 진단으로 페어링 실패, 끊김, 서비스 미표시 및 호환성 문제를 확인합니다. 모든 작업은 로컬 브라우저에서 완료됩니다.
환경 및 브라우저 지원 확인
스캔 및 장치 선택
연결 및 GATT 서비스/특성 열거
알림 읽기/구독 및 리포트 내보내기
자주 묻는 질문 (FAQ)
궁금한 점이 있으신가요? Web Bluetooth 스캔, 연결, GATT 진단에 관한 FAQ 모음.
이 Bluetooth 진단 페이지의 기능은 무엇입니까?
브라우저의 웹 블루투스 기능을 기반으로 "장치 검색 및 선택 → GATT에 연결 → 서비스/기능 열거 → 알림 읽기/구독"을 완료하고 키 로그 및 오류를 기록하여 페어링 실패, 연결 끊김, 서비스 비가시성 및 호환성 문제를 쉽게 찾을 수 있도록 도와줍니다.
"웹 블루투스가 지원되지 않습니다"라는 메시지가 나타나는 이유는 무엇입니까?
웹 블루투스는 모든 브라우저/플랫폼에서 지원되지 않습니다. 일반적으로 데스크톱 버전인 Chrome/Edge가 더 나은 지원을 제공합니다. iOS Safari는 일반적으로 이를 지원하지 않습니다. 브라우저를 변경하거나 데스크탑으로 전환하여 다시 테스트할 수 있습니다.
왜 HTTPS에서 액세스해야 합니까?
웹 블루투스는 높은 권한 기능이며 브라우저에는 보안 컨텍스트(HTTPS)가 필요합니다. http 또는 안전하지 않은 환경에 있는 경우 SecurityError가 발생하거나 직접 사용할 수 없게 됩니다.
"장치 검색"을 클릭하면 응답이 없는 이유는 무엇입니까/NotAllowedError가 직접 보고됩니까?
검색은 사용자 동작(예: 버튼 클릭)에 의해 트리거되어야 하며 브라우저/시스템은 Bluetooth 권한을 허용해야 합니다. 클릭하여 수동으로 실행하는지, 시스템 블루투스가 켜져 있는지, 브라우저가 권한 팝업을 차단하지 않는지 확인하세요.
왜 장치를 스캔할 수 없나요?
일반적인 이유는 다음과 같습니다: 장치를 검색/연결할 수 없음, 거리가 너무 멀거나 차단됨, 필터링 조건(namePrefix/service)이 너무 엄격함, 시스템 Bluetooth가 다른 애플리케이션에 의해 사용됨. 먼저 acceptAllDevices를 확인하고 장치에 가까이 다가가서 다시 시도하는 것이 좋습니다.
연결은 되었지만 "서비스/기능을 열거할 수 없습니다"라는 이유는 무엇입니까?
브라우저는 선언되지 않은 GATT 서비스에 대한 액세스를 제한합니다. optionServices에 대상 서비스 UUID를 추가한 후(battery_service와 같은 키워드를 지원하고 전체 UUID를 작성할 수도 있음) 다시 검색/연결하고 다시 열거해 보세요.
연결이 자주 끊어지는 이유(NetworkError/InvalidStateError)는 무엇입니까?
일반적인 이유는 거리/간섭, 배터리 부족 또는 장치 절전 모드, 다른 장치가 Bluetooth 연결을 선점하거나 시스템 Bluetooth 스택이 불안정하기 때문입니다. 장치에 더 가까이 이동하여 2.4GHz 간섭을 줄이고 Bluetooth/장치를 다시 시작하고 단일 장치 연결을 유지하는 것이 좋습니다.
"알림"을 켠 후에는 데이터가 없습니다. 이게 정상인가요?
아마 정상일 겁니다. 모든 기능이 사전에 알림을 푸시하는 것은 아닙니다. 일부는 구성을 먼저 작성하거나 장치에서 이벤트를 트리거해야 합니다. 또한 브라우저/장치에 따라 알림 이벤트가 제한될 수도 있습니다. 먼저 "읽기"를 시도하여 기능을 읽을 수 있는지 확인하거나 푸시된 것으로 알려진 기능 확인 링크를 변경할 수 있습니다.
개인 정보 보호는 안전한가요? 내 Bluetooth 데이터가 업로드되나요?
이 페이지는 주로 로컬 브라우저 내에서 상호 작용하고 구문 분석하며 Bluetooth 데이터를 적극적으로 업로드하지 않습니다. "보고서 복사"를 클릭하면 내용이 클립보드로 이동됩니다. 공유할지 여부는 귀하에게 달려 있습니다.
복제 보고서에는 어떤 정보가 포함되어 있나요?
보고서에는 테스트 시간, 브라우저 UA, HTTPS/가용성 상태, 검색 매개변수(필터/선택적 서비스), 장치 정보 요약, 열거된 서비스/기능 구조, 최근 오류 및 로깅이 포함됩니다. 문제를 신속하게 재현하고 찾는 데 사용됩니다.