Web Bluetooth接続とスキャンテスト
Web Bluetooth API を使用して、近くの Bluetooth デバイスをオンラインでスキャンします。ブラウザの Bluetooth 接続、ペアリング、データ送信機能をテストします (ハードウェア サポートが必要です)。
環境とサポート
GATTのサービス・特徴
ログ
このページを使用して問題を迅速に特定する方法
Bluetooth 診断テスト ガイド
Web Bluetooth スキャン、接続、GATT 診断に基づいて、ペアリングの失敗、切断、目に見えないサービス、互換性の問題のトラブルシューティングを支援します。すべての操作はローカル ブラウザーで完了します。
環境とブラウザのサポートを確認する
デバイスをスキャンして選択する
GATT サービス/特性を接続して列挙する
通知の読み取り/購読とレポートのエクスポート
よくある質問
ご質問がありますか?答えは見つかりました!以下は、Web Bluetooth スキャン、接続、および GATT 診断に関するよくある質問の概要です。
この Bluetooth 診断ページでは何ができるのでしょうか?
ブラウザの Web Bluetooth 機能に基づいて、「デバイスのスキャンと選択 → GATT への接続 → サービス/機能の列挙 → 通知の読み取り/購読」を完了し、主要なログとエラーを記録して、ペアリングの失敗、切断、サービスの非表示、および互換性の問題の特定を容易にします。
「Web Bluetooth はサポートされていません」というメッセージが表示されるのはなぜですか?
Web Bluetooth は、すべてのブラウザ/プラットフォームでサポートされているわけではありません。通常、デスクトップ バージョンの Chrome/Edge のサポートが優れています。 iOS Safari は通常、これをサポートしていません。ブラウザを変更するか、デスクトップに切り替えて再度テストしてください。
なぜ HTTPS でアクセスする必要があるのですか?
Web Bluetooth は高特権機能であり、ブラウザには安全なコンテキスト (HTTPS) が必要です。 http 環境または安全でない環境にある場合は、SecurityError がトリガーされるか、直接使用できなくなります。
「デバイスのスキャン」をクリックしても応答がないのはなぜですか? NotAllowedError が直接報告されますか?
スキャンはユーザーのジェスチャ (ボタンのクリックなど) によってトリガーされる必要があり、ブラウザ/システムは Bluetooth の許可を許可する必要があります。クリックして手動でトリガーしていること、システムの Bluetooth がオンになっていること、ブラウザが許可ポップアップをブロックしていないことを確認してください。
デバイスをスキャンできないのはなぜですか?
一般的な理由としては、デバイスが検出できない/接続できない、距離が遠すぎるかブロックされている、フィルタリング条件が厳しすぎる (namePrefix/service)、またはシステム Bluetooth が他のアプリケーションによって占有されているなどがあります。最初に acceptAllDevices を確認し、デバイスに近づいて再試行することをお勧めします。
接続はできているのに「サービス/機能を列挙できない」のはなぜですか?
ブラウザは、宣言されていない GATT サービスへのアクセスを制限します。対象のサービス UUID をOptionalServices に追加して (battery_service などのキーワードをサポートし、完全な UUID を書き込むこともできます)、再スキャン/接続して再度列挙してください。
頻繁に切断 (NetworkError/InvalidStateError) が発生するのはなぜですか?
一般的な理由としては、距離/干渉、バッテリー残量低下またはデバイスの省電力休止状態、Bluetooth 接続が他のデバイスによってプリエンプトされている、システムの Bluetooth スタックが不安定であるなどが挙げられます。デバイスの近くに移動し、2.4GHz の干渉を減らし、Bluetooth/デバイスを再起動して、単一デバイスの接続を維持することをお勧めします。
「通知」をオンにしてもデータがありません。これは正常ですか?
おそらく正常です。すべての機能が積極的に通知をプッシュするわけではありません。一部の場合は、最初に構成を書き込むか、デバイス上でイベントをトリガーする必要があります。さらに、ブラウザ/デバイスによっては通知イベントに制限がある場合もあります。まず「読み取り」を試して機能が読み取り可能かどうかを確認するか、プッシュされることがわかっている機能検証リンクを変更します。
プライバシーは安全ですか? Bluetooth データはアップロードされますか?
このページは主にローカル ブラウザ内で対話および解析し、Bluetooth データを積極的にアップロードしません。 「レポートをコピー」をクリックすると、内容がクリップボードに保存されます。それを共有するかどうかはあなた次第です。
レプリケーションレポートにはどのような情報が含まれますか?
レポートには、テスト時間、ブラウザー UA、HTTPS/可用性ステータス、スキャン パラメーター (フィルター/オプション サービス)、デバイス情報の概要、列挙されたサービス/機能構造、最近のエラーとログが含まれます。問題を迅速に再現し、特定するために使用されます。