Web Bluetooth接続とスキャンテスト

Web Bluetooth API を使用して、近くの Bluetooth デバイスをオンラインでスキャンします。ブラウザの Bluetooth 接続、ペアリング、データ送信機能をテストします (ハードウェア サポートが必要です)。

環境とサポート

ウェブ Bluetooth
Web Bluetooth はサポートしていません
セキュリティコンテキスト (HTTPS)
いいえ
Bluetooth の可用性 (getAvailability)
不明/サポートされていません
User-Agent
-
現在のブラウザは Web Bluetooth をサポートしていない可能性があります
デスクトップ版Chrome/Edge(HTTPS環境)のご利用を推奨します。 iOS Safari は通常、これをサポートしていません。
準備ができて装置:-
現在のデバイス
名前: -
ID:-
接続する:接続されていません
最近切断されました:-
広告/放送 (オプション)
RSSI/ブロードキャストの持続性を観察するために、一部の Chrome バージョン/デバイスでサポートされています。

GATTのサービス・特徴

合計 0 サービス / 0 特性
まだデータがありません。まず接続してから、サービスの列挙をクリックしてください。

ログ

まだログがありません。 「デバイスのスキャン」をクリックして開始することをお勧めします。

このページを使用して問題を迅速に特定する方法

まず「環境とサポート」を見てください。これは HTTPS/セキュリティ コンテキスト内にある必要があります。デスクトップ版Chrome/Edgeを推奨します。 iOS Safari は通常、Web Bluetooth をサポートしていません。
スキャンは、「ボタンをクリックする」などのユーザーのジェスチャによってトリガーされる必要があります。そうしないと、NotAllowedError が報告されたり、ブラウザによって傍受されたりする可能性があります。
接続できない/頻繁に切断される: 障害物や 2.4 GHz の干渉を減らすためにデバイスに近づけてください。システムの Bluetooth をオフにしてから、デバイスをオンにするか再起動します。他のデバイス/アプリケーションによって占有されることを避けてください。
サービス/機能を列挙できません: ターゲット サービスをOptionalServices に追加します (ブラウザーは、宣言されていないサービスへのアクセスを制限します)。
トラブルシューティングで支援が必要な場合: [レポートのコピー] をクリックして、UA、ステータス、エラー、ログを開発/カスタマー サービスに提供します。

Bluetooth 診断テスト ガイド

Web Bluetooth スキャン、接続、GATT 診断に基づいて、ペアリングの失敗、切断、目に見えないサービス、互換性の問題のトラブルシューティングを支援します。すべての操作はローカル ブラウザーで完了します。

ステップ 1

環境とブラウザのサポートを確認する

約10秒
[環境とサポート] カードで、Web Bluetooth が [サポートされている] および [セキュリティ コンテキスト (HTTPS) = はい] であることを確認します。
「Web Bluetooth はサポートされていません」と表示される場合: 代わりに、デスクトップ バージョンの Chrome/Edge を使用してください。 iOS Safari は通常、これをサポートしていません。
ステップ 2

デバイスをスキャンして選択する

約10~20秒
システムの Bluetooth がオンになっていて、ターゲット デバイスが検出可能/接続可能であることを確認してください。
[デバイスのスキャン] をクリックします (クリックによってトリガーされる必要があります。自動的にはスキャンできません)。
デバイスが見つからない場合: 最初に acceptAllDevices をチェックします。または、namePrefix/service を使用して正確な位置をフィルタリングします。
ステップ 3

GATT サービス/特性を接続して列挙する

約10~30秒
「接続」をクリックするとステータスが「接続済み」に変わります。
[サービスの列挙] をクリックして、[GATT サービス/特性] カードのリストを表示します。
ターゲット サービスを列挙できない場合: サービス UUID をOptionalServices に追加し、再スキャン/接続して、再試行します。
ステップ 4

通知の読み取り/購読とレポートのエクスポート

約20秒
機能リストの「読み取り」をクリックし、返された 16 進数/テキストの内容が適切かどうかを確認します。
機能が通知/表示をサポートしている場合は、[通知をオンにする] をクリックして、ログがデータを受信し続けるかどうかを確認できます。
エラーが発生した場合、またはサポートが必要な場合: [レポートをコピー] をクリックして、コンテンツを開発/カスタマー サービスに送信して位置を確認します。

よくある質問

ご質問がありますか?答えは見つかりました!以下は、Web Bluetooth スキャン、接続、および GATT 診断に関するよくある質問の概要です。

1.

この Bluetooth 診断ページでは何ができるのでしょうか?

ブラウザの Web Bluetooth 機能に基づいて、「デバイスのスキャンと選択 → GATT への接続 → サービス/機能の列挙 → 通知の読み取り/購読」を完了し、主要なログとエラーを記録して、ペアリングの失敗、切断、サービスの非表示、および互換性の問題の特定を容易にします。

2.

「Web Bluetooth はサポートされていません」というメッセージが表示されるのはなぜですか?

Web Bluetooth は、すべてのブラウザ/プラットフォームでサポートされているわけではありません。通常、デスクトップ バージョンの Chrome/Edge のサポートが優れています。 iOS Safari は通常、これをサポートしていません。ブラウザを変更するか、デスクトップに切り替えて再度テストしてください。

3.

なぜ HTTPS でアクセスする必要があるのですか?

Web Bluetooth は高特権機能であり、ブラウザには安全なコンテキスト (HTTPS) が必要です。 http 環境または安全でない環境にある場合は、SecurityError がトリガーされるか、直接使用できなくなります。

4.

「デバイスのスキャン」をクリックしても応答がないのはなぜですか? NotAllowedError が直接報告されますか?

スキャンはユーザーのジェスチャ (ボタンのクリックなど) によってトリガーされる必要があり、ブラウザ/システムは Bluetooth の許可を許可する必要があります。クリックして手動でトリガーしていること、システムの Bluetooth がオンになっていること、ブラウザが許可ポップアップをブロックしていないことを確認してください。

5.

デバイスをスキャンできないのはなぜですか?

一般的な理由としては、デバイスが検出できない/接続できない、距離が遠すぎるかブロックされている、フィルタリング条件が厳しすぎる (namePrefix/service)、またはシステム Bluetooth が他のアプリケーションによって占有されているなどがあります。最初に acceptAllDevices を確認し、デバイスに近づいて再試行することをお勧めします。

6.

接続はできているのに「サービス/機能を列挙できない」のはなぜですか?

ブラウザは、宣言されていない GATT サービスへのアクセスを制限します。対象のサービス UUID をOptionalServices に追加して (battery_service などのキーワードをサポートし、完全な UUID を書き込むこともできます)、再スキャン/接続して再度列挙してください。

7.

頻繁に切断 (NetworkError/InvalidStateError) が発生するのはなぜですか?

一般的な理由としては、距離/干渉、バッテリー残量低下またはデバイスの省電力休止状態、Bluetooth 接続が他のデバイスによってプリエンプトされている、システムの Bluetooth スタックが不安定であるなどが挙げられます。デバイスの近くに移動し、2.4GHz の干渉を減らし、Bluetooth/デバイスを再起動して、単一デバイスの接続を維持することをお勧めします。

8.

「通知」をオンにしてもデータがありません。これは正常ですか?

おそらく正常です。すべての機能が積極的に通知をプッシュするわけではありません。一部の場合は、最初に構成を書き込むか、デバイス上でイベントをトリガーする必要があります。さらに、ブラウザ/デバイスによっては通知イベントに制限がある場合もあります。まず「読み取り」を試して機能が読み取り可能かどうかを確認するか、プッシュされることがわかっている機能検証リンクを変更します。

9.

プライバシーは安全ですか? Bluetooth データはアップロードされますか?

このページは主にローカル ブラウザ内で対話および解析し、Bluetooth データを積極的にアップロードしません。 「レポートをコピー」をクリックすると、内容がクリップボードに保存されます。それを共有するかどうかはあなた次第です。

10.

レプリケーションレポートにはどのような情報が含まれますか?

レポートには、テスト時間、ブラウザー UA、HTTPS/可用性ステータス、スキャン パラメーター (フィルター/オプション サービス)、デバイス情報の概要、列挙されたサービス/機能構造、最近のエラーとログが含まれます。問題を迅速に再現し、特定するために使用されます。