모든 도구블루투스 진단

Web 블루투스 연결 및 스캔 테스트

Web Bluetooth API를 활용해 주변의 블루투스 장치를 온라인으로 스캔합니다. 브라우저의 블루투스 연결, 페어링 및 데이터 전송 능력을 테스트하세요 (하드웨어 지원 필요).

환경 및 지원

Web Bluetooth
Web Bluetooth 미지원
보안 컨텍스트 (HTTPS)
아니요
블루투스 가용성 (getAvailability)
알 수 없음/미지원
User-Agent
-
현재 브라우저는 Web Bluetooth를 지원하지 않을 수 있습니다
데스크탑 Chrome / Edge (HTTPS) 사용을 권장합니다. iOS Safari는 대부분 미지원입니다.
준비됨장치:-
현재 장치
이름: -
ID:-
연결:미연결
최근 끊김:-
광고/브로드캐스트 (선택)
일부 Chrome/장치만 지원, RSSI/송출 지속 여부 관찰용.

GATT 서비스 / 특성

총 0 서비스 / 0 특성
데이터 없음. 연결서비스 열거를 클릭하세요.

로그

로그 없음. '장치 스캔'으로 시작하세요.

이 페이지로 문제를 빠르게 찾는 법

먼저 "환경 및 지원"을 살펴보세요. HTTPS/보안 컨텍스트에 있어야 합니다. 데스크톱 버전 Chrome/Edge를 권장합니다. iOS Safari는 일반적으로 웹 블루투스를 지원하지 않습니다.
검색은 "버튼 클릭"과 같은 사용자 동작에 의해 실행되어야 합니다. 그렇지 않으면 NotAllowedError를 보고하거나 브라우저에서 가로채기 쉽습니다.
연결할 수 없거나 자주 연결이 끊어지는 경우: 장애물과 2.4GHz 간섭을 줄이기 위해 장치에 더 가까이 이동하십시오. 시스템 Bluetooth를 끈 다음 장치를 켜거나 다시 시작하십시오. 다른 장치/애플리케이션이 점유하지 않도록 하세요.
서비스/기능을 열거할 수 없습니다. optionServices에 대상 서비스를 추가합니다(브라우저는 선언되지 않은 서비스에 대한 액세스를 제한합니다).
문제 해결에 도움이 필요한 경우: "보고서 복사"를 클릭하여 UA, 상태, 오류 및 로그를 개발/고객 서비스에 제공하세요.

블루투스 진단 가이드

Web Bluetooth 스캔, 연결, GATT 진단으로 페어링 실패, 끊김, 서비스 미표시 및 호환성 문제를 확인합니다. 모든 작업은 로컬 브라우저에서 완료됩니다.

단계 1

환경 및 브라우저 지원 확인

약 10초
"환경 및 지원" 카드에서 웹 블루투스가 "지원됨"이고 "보안 컨텍스트(HTTPS) = 예"인지 확인합니다.
'웹 블루투스가 지원되지 않음'이라고 표시되는 경우: 대신 Chrome/Edge의 데스크톱 버전을 사용하세요. iOS Safari는 일반적으로 이를 지원하지 않습니다.
단계 2

스캔 및 장치 선택

약 10–20초
시스템 Bluetooth가 켜져 있고 대상 장치가 검색/연결 가능한지 확인하세요.
"장치 검색"을 클릭합니다(클릭으로 실행되어야 하며 자동으로 검색할 수 없음).
장치를 찾을 수 없는 경우: 먼저 acceptAllDevices를 확인할 수 있습니다. 또는 namePrefix/service를 사용하여 정확한 위치 지정을 필터링하세요.
단계 3

연결 및 GATT 서비스/특성 열거

약 10–30초
"연결"을 클릭하면 상태가 "연결됨"으로 변경됩니다.
"GATT 서비스/특성" 카드의 목록을 보려면 "서비스 열거"를 클릭하십시오.
대상 서비스를 열거할 수 없는 경우: optionServices에 서비스 UUID를 추가하고 다시 검색/연결한 후 다시 시도하세요.
단계 4

알림 읽기/구독 및 리포트 내보내기

약 20초
기능 목록에서 "읽기"를 클릭하고 반환된 16진수/텍스트 콘텐츠가 합리적인지 확인하세요.
기능이 알림/표시를 지원하는 경우 "알림 켜기"를 클릭하여 로그가 계속 데이터를 수신하는지 관찰할 수 있습니다.
오류가 발생하거나 도움이 필요한 경우: "보고서 복사"를 클릭하여 포지셔닝을 위해 콘텐츠를 개발/고객 서비스로 보냅니다.

자주 묻는 질문 (FAQ)

궁금한 점이 있으신가요? Web Bluetooth 스캔, 연결, GATT 진단에 관한 FAQ 모음.

1.

이 Bluetooth 진단 페이지의 기능은 무엇입니까?

브라우저의 웹 블루투스 기능을 기반으로 "장치 검색 및 선택 → GATT에 연결 → 서비스/기능 열거 → 알림 읽기/구독"을 완료하고 키 로그 및 오류를 기록하여 페어링 실패, 연결 끊김, 서비스 비가시성 및 호환성 문제를 쉽게 찾을 수 있도록 도와줍니다.

2.

"웹 블루투스가 지원되지 않습니다"라는 메시지가 나타나는 이유는 무엇입니까?

웹 블루투스는 모든 브라우저/플랫폼에서 지원되지 않습니다. 일반적으로 데스크톱 버전인 Chrome/Edge가 더 나은 지원을 제공합니다. iOS Safari는 일반적으로 이를 지원하지 않습니다. 브라우저를 변경하거나 데스크탑으로 전환하여 다시 테스트할 수 있습니다.

3.

왜 HTTPS에서 액세스해야 합니까?

웹 블루투스는 높은 권한 기능이며 브라우저에는 보안 컨텍스트(HTTPS)가 필요합니다. http 또는 안전하지 않은 환경에 있는 경우 SecurityError가 발생하거나 직접 사용할 수 없게 됩니다.

4.

"장치 검색"을 클릭하면 응답이 없는 이유는 무엇입니까/NotAllowedError가 직접 보고됩니까?

검색은 사용자 동작(예: 버튼 클릭)에 의해 트리거되어야 하며 브라우저/시스템은 Bluetooth 권한을 허용해야 합니다. 클릭하여 수동으로 실행하는지, 시스템 블루투스가 켜져 있는지, 브라우저가 권한 팝업을 차단하지 않는지 확인하세요.

5.

왜 장치를 스캔할 수 없나요?

일반적인 이유는 다음과 같습니다: 장치를 검색/연결할 수 없음, 거리가 너무 멀거나 차단됨, 필터링 조건(namePrefix/service)이 너무 엄격함, 시스템 Bluetooth가 다른 애플리케이션에 의해 사용됨. 먼저 acceptAllDevices를 확인하고 장치에 가까이 다가가서 다시 시도하는 것이 좋습니다.

6.

연결은 되었지만 "서비스/기능을 열거할 수 없습니다"라는 이유는 무엇입니까?

브라우저는 선언되지 않은 GATT 서비스에 대한 액세스를 제한합니다. optionServices에 대상 서비스 UUID를 추가한 후(battery_service와 같은 키워드를 지원하고 전체 UUID를 작성할 수도 있음) 다시 검색/연결하고 다시 열거해 보세요.

7.

연결이 자주 끊어지는 이유(NetworkError/InvalidStateError)는 무엇입니까?

일반적인 이유는 거리/간섭, 배터리 부족 또는 장치 절전 모드, 다른 장치가 Bluetooth 연결을 선점하거나 시스템 Bluetooth 스택이 불안정하기 때문입니다. 장치에 더 가까이 이동하여 2.4GHz 간섭을 줄이고 Bluetooth/장치를 다시 시작하고 단일 장치 연결을 유지하는 것이 좋습니다.

8.

"알림"을 켠 후에는 데이터가 없습니다. 이게 정상인가요?

아마 정상일 겁니다. 모든 기능이 사전에 알림을 푸시하는 것은 아닙니다. 일부는 구성을 먼저 작성하거나 장치에서 이벤트를 트리거해야 합니다. 또한 브라우저/장치에 따라 알림 이벤트가 제한될 수도 있습니다. 먼저 "읽기"를 시도하여 기능을 읽을 수 있는지 확인하거나 푸시된 것으로 알려진 기능 확인 링크를 변경할 수 있습니다.

9.

개인 정보 보호는 안전한가요? 내 Bluetooth 데이터가 업로드되나요?

이 페이지는 주로 로컬 브라우저 내에서 상호 작용하고 구문 분석하며 Bluetooth 데이터를 적극적으로 업로드하지 않습니다. "보고서 복사"를 클릭하면 내용이 클립보드로 이동됩니다. 공유할지 여부는 귀하에게 달려 있습니다.

10.

복제 보고서에는 어떤 정보가 포함되어 있나요?

보고서에는 테스트 시간, 브라우저 UA, HTTPS/가용성 상태, 검색 매개변수(필터/선택적 서비스), 장치 정보 요약, 열거된 서비스/기능 구조, 최근 오류 및 로깅이 포함됩니다. 문제를 신속하게 재현하고 찾는 데 사용됩니다.