Main Content

subscribe

订阅特征通知或指示

自 R2019b 起

说明

示例

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

示例

subscribe(c,type) 订阅低功耗 Bluetooth 外围设备的特征,并指定订阅是针对通知还是指示。特征 cAttributes 属性必须包含指定的 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) 根据特征对象 cAttributes 属性,订阅 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 中推出