subscribe

特性の通知または特性の表示のサブスクライブ

R2019b 以降

構文

subscribe(c)

subscribe(c,type)

説明

subscribe(c) は、Bluetooth^® Low Energy 周辺デバイスの特性の通知または表示をサブスクライブします。通知または表示は、特性 c の Attributes プロパティに依存します。プロパティには、"Notify" と "Indicate" のいずれか、または両方が含まれていなければなりません。プロパティに "Notify" と "Indicate" の両方が含まれている場合、関数は通知をサブスクライブします。

subscribe(c,type) は、Bluetooth Low Energy 周辺デバイスの特性をサブスクライブし、サブスクリプションが通知と表示のどちらかを指定します。特性 c の Attributes プロパティには、指定した type が含まれていなければなりません。

例

Bluetooth Low Energy 周辺デバイス上の特性のサブスクライブとサブスクライブ解除

通知または表示をサポートする特性をサブスクライブします。特性の操作が終了したら、サブスクライブ解除します。

近くにある Bluetooth Low Energy 周辺デバイスへの接続を作成します。

b = ble("DemoDev")

b = 
  ble with properties:

               Name: "DemoDev"
            Address: "FF548EA5658F"
          Connected: 1
           Services: [5×2 table]
    Characteristics: [10×5 table]

Show services and characteristics

"Heart Rate Measurement" 特性を表す characteristic オブジェクトを作成します。

c = characteristic(b,"Heart Rate","Heart Rate Measurement")

c = 
  Characteristic with properties:

             Name: "Heart Rate Measurement"
             UUID: "2A37"
       Attributes: "Notify"
      Descriptors: [1x3 table]
 DataAvailableFcn: []

Show descriptors

この特性は "Notify" をサポートします。

subscribe を使用して通知の受信を開始します。

subscribe(c)

特性からの読み取りで、データを受信していることを確認します。

read(c)

ans = 1×19

    23    14     1   187     1   186     1   185     1   184     1   183     1   182     1   181     1   180     1

特性の操作が終了したら、unsubscribe を使用して通知を無効にします。

unsubscribe(c)

入力引数

c — Bluetooth Low Energy 周辺デバイスの特性

characteristic オブジェクト

Bluetooth Low Energy 周辺デバイスの特性。characteristic オブジェクトとして指定します。

例: subscribe(c) は、c の Attributes プロパティに従って、characteristic オブジェクト c の通知または表示をサブスクライブします。

type — サブスクリプション タイプ

"notification" | "indication"

サブスクリプション タイプ。"notification" または "indication" として指定します。特性で両方がサポートされていて、タイプを指定しない場合、既定値は "notification" です。

subscribe で可能な動作は以下のとおりです。

c.Attributes の内容	通知のサポートの有無	表示のサポートの有無
"Notify"	あり。以下を使用 subscribe(c) または subscribe(c,"notification")	なし
"Indicate"	なし	あり。以下を使用 subscribe(c) または subscribe(c,"indication")
"Notify" と "Indicate"	あり。以下を使用 subscribe(c) または subscribe(c,"notification")	あり。以下を使用 subscribe(c,"indication")

例: subscribe(c,"indication") は表示をサブスクライブします。

バージョン履歴

R2019b で導入

参考

characteristic | read | unsubscribe | write

トピック

• デバイスの特性と記述子の操作