本页翻译不是最新的。点击此处可查看最新英文版本。

subscribe

订阅特征通知或指示

全页折叠

语法

subscribe(c)
subscribe(c,type)

说明

subscribe(c) 订阅低功耗 Bluetooth® 外围设备的特征通知或指示。通知或指示取决于特征 c 的 Attributes 属性。该属性必须包含 "Notify"、"Indicate" 或同时包含两者。如果该属性同时包含 "Notify" 和 "Indicate"，则该函数会订阅通知。

示例

subscribe(c,type) 订阅低功耗 Bluetooth 外围设备的特征，并指定订阅是针对通知还是指示。特征 c 的 Attributes 属性必须包含指定的 type。

示例

示例

全部折叠

打开实时脚本

订阅支持通知或指示的特征。完成使用该特征后取消订阅。

创建与附近低功耗蓝牙外围设备的连接。

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" 特征的特征对象。

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)

输入参数

全部折叠

低功耗 Bluetooth 外围设备的特征，指定为 characteristic 对象。

示例: subscribe(c) 根据特征对象 c 的 Attributes 属性，订阅 c 的通知或指示。

订阅类型，指定为 "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 中推出

另请参阅

| | |

主题