Main Content

bluetoothlist

近くの Bluetooth Classic デバイスのスキャン

R2020b 以降

ページ内をすべて折りたたむ

構文

devlist = bluetoothlist
devlist = bluetoothlist("Timeout",time)

説明

例

devlist = bluetoothlist は近くの Bluetooth® Classic デバイスをスキャンします。bluetooth を使用してデバイスに接続します。

例

devlist = bluetoothlist("Timeout",time) は最大 time 秒間スキャンします。既定のタイムアウト期間は、Windows® の場合は 35 秒、macOS の場合は 20 秒です。time の値は 5 以上でなければなりません。

例

すべて折りたたむ

近くの Bluetooth Classic デバイスをスキャンし、その接続ステータスをチェックします。

bluetoothlist を使用して近くにあるすべてのデバイスをリストします。デバイスが別のデバイスまたはアプリケーションに既に接続されていると、このリストには表示されない場合があります。MATLAB® で検出するには、まずデバイスを他のデバイスまたはアプリケーションから切断してください。

devlist = bluetoothlist
devlist=5×4 table
        Name            Address        Channel          Status      
    _____________    ______________    _______    __________________

    "Pixel 3"        "3C286DD533CA"    8          "Ready to connect"         
    "HC-06"          "98D331FB3B77"    1          "Requires pairing"
    "mjin-maci"      "A886DDA44062"    3          "Requires pairing"
    "DMTDevice"      "B0B448F47A4C"    Unknown    "Unknown"

Name 列および Address 列は、デバイスを識別します。Channel 列は、デバイスの SPP チャンネルを示します。Status 列は、現在のデバイス接続ステータスを示します。

既定の 35 秒 (Windows) および 20 秒 (macOS) よりも短いタイムアウト値を指定することもできます。

devlist = bluetoothlist("Timeout",10)
devlist=3×4 table
        Name            Address        Channel          Status      
    _____________    ______________    _______    __________________

    "Pixel 3"        "3C286DD533CA"    8          "Ready to connect"         
    "mjin-maci"      "A886DDA44062"    3          "Requires pairing"

出力引数

すべて折りたたむ

近くの Bluetooth デバイスのリスト。table として返されます。table には次の列があります。

デバイス名。string スカラーとして返されます。複数のデバイスで同じ名前を共有できます。

データ型: string

デバイスの識別子。string スカラーとして返されます。

データ型: string

デバイス SPP チャネル。categorical スカラーとして返されます。チャネルが不明の場合、この列の値は Unknown になります。

データ型: categorical

デバイス接続のステータス。string として返されます。bluetooth を使用して Bluetooth デバイスに接続できるのは、そのステータスが "Ready to connect" の場合だけです。取り得る値は以下のとおりです。

値説明
"Ready to connect"デバイスは SPP をサポートし、ペアリングされていますが、どこにも接続されていません。
"Requires pairing"デバイスは SPP をサポートし、ペアリングされていません。
"Connected"デバイスは SPP をサポートし、接続されています。
"Unsupported"デバイスは SPP をサポートしていません。
"Unknown"デバイスが SPP をサポートしているかどうか不明です。デバイスがオフであるか、スキャン要求に応答しません。

データ型: string

バージョン履歴

R2020b で導入

参考