美文网首页
【BLE】ANCS

【BLE】ANCS

作者: Blue_Well | 来源:发表于2020-03-26 23:35 被阅读0次

苹果ANCS官网ANCS spec

端和字符编码

IOS设备ANCS与ble设备进行通信的过程中都是采用的小端模式进行传输的。
NC接收到的attribute length数据为0x02 0x00,应该解析为0x00 0x02,即长度为2byte.
字符串的编码采用了UTF-8编码格式。

术语

ANCS:苹果通知中心服务。
NP(Notification Provider):消息提供者,指的是ANCS服务的产生者,即IOS设备。
NC(Notification Consumer):消息接受者,指的是ANCS服务的客户端,即周边BLE设备。

服务特性

ANCS Service UUID:7905F431-B5CE-4E99-A40F-4B1E122D00D0

Characteristic:

  • Notification Source:9FBF120D-6301-42D9-8C58-25E699A21DBD, 权限是可通知
  • Control Point:69D1D8F3-45E1-49A8-9821-9BBDFDAAD9D9,权限是可写入,可响应
  • Data Source:22EAC6E9-24D6-4BB5-BE44-B36ACE7C7BFB,权限是可通知

通知源

NC收到的通知源特性主要有三种事件:

  • NP上新通知的到达
  • NP上通知的修改
  • NP上通知的删除

  • EventID: 这个字段指明了iOS通知添加、修改或移除三种事件中的一种。

  • EventFlags: 一个位掩码,这个位掩码表明了这个通知的一种特征。例如,如果一个通知被认为是重要的,那么NC收到这个通知后,就想用明显的方式提醒用户。

  • CategoryID: 通知的种类,分为邮件,来电,未接来电,社交,娱乐等多种分类,短信、微信、QQ等消息全部在社交(social)。

  • CategoryCount: 给定类型中活跃的通知的数量。例如,邮箱中有两封未读的邮件,这个时候又来了一封新的邮件,那么通知的邮件的数量将是3。

  • NotificationUID: 该通知的id,一个32位的数字来作为通知的唯一标示(UID)。获取更多该通知的信息时,这个数值在将作为命令中的一个句柄写入Control Point特性(即告诉Control Point我想要获得那条通知的详细信息)。

Control Point和Data Source

NC设备可能想要与IOS通知进行交互。它可能需要获得通知的更多信息,其中包括它的内容以及在此基础上进行一些操作,这些都要通过Data Source和Control Point特性来实现。

NC可以通过往Control Point特性里写入命令来获取关于通知的更多消息。如果命令写入成功的话,NP会在Data Source特性中通过通知流对该请求进行回复。

获取通知具体属性

获取通知属性命令使得NC可以得到某个特定通知的详细属性,比如短信的发送人,短信内容,时间等。



该命令包含了一下的信息:

  • CommandID: 设为零 (CommandIDGetNotificationAttributes),0x00
  • NotificationUID: 想要获得的通知的uid,32位数字是通知的唯一标示。
  • AttributeIDs: NC想要获得的属性列表。有些属性可能需要后面接一个16位的的参数,0xff 0xff。

    该响应包含了一下的信息:
  • CommandID: 设为零 (CommandIDGetNotificationAttributes)
  • NotificationUID: 32位的UID。
  • AttributeList: 由属性ID、16位长度、属性所组成的一个列表。一个属性始终是字符串,并且它的长度由16位长度所决定,而不是以空(NULL)结束。如果所请求的属性是空的,或者是错过了iOS通知,那么长度设为0。
    如果响应的长度大于GATT所规定的最大传输单元(Maximum Transmission Unit, MTU),则NP会它分成多段传送。NC必须将响应的数据段重新组包。当收到所有请求属性的内容时,则表示响应完成。

获取应用属性

获取应用属性命令允许NC指定获取NP上某个已安装的应用程序的属性。



获取应用属性命令包含下面信息:

  • CommandID: 必须设置为1(CommandIDGetAppAttributes)。
  • AppIdentifier: 客户端想要获取信息的应用程序的字符串标志。字符串必须以空(NULL)结束。
  • AttributeIDs: 想要NC先要获取的属性列表。

响应一个获取应用属性命令的数据包含下面信息:

  • CommandID: 设置为1(CommandIDGetAppAttributes)。
  • AppIdentifier: 应用的字符串标识。字符串以空(NULL)结束。
  • AttributeList: 由属性ID、16位长度、属性所组成的一个列表。一个属性始终是字符串,并且它的长度由16位长度所决定,而不是以空(NULL)结束。如果所请求的属性是空的,或者错过了应用应用程序,那么长度设为0。
    如果响应数据的长度大于GATT所规定的最大传输单元(Maximum Transmission Unit, MTU),则NP会它分成多端传送。NC必须将响应的数据段重新组包。当收到所有请求属性的内容时,则表示响应完成。

执行通知动作

它允许NC向指定的iOS通知执行一条预定动作。


image.png

一条执行通知动作包含下面信息:

  • CommandID: 必须设置为2(CommandIDPerformNotificationAction)。
  • NotificationUID: 一个32位的数值,表示ios通知的UID,客户端希望在该UID上执行一个操作。
  • ActionID: NC希望在ios通知上执行的操作。
    当发送这个命令到控制点特征后,无论发送成功或失败,数据源特征上都不会产生数据。也就是说这是一个无需响应的命令。

通知动作

从iOS8开始,NP发送的iOS通知起始可以间接的告诉NC可执行哪些动作。接着,NC就可以针对指定的iOS通知,请求NP执行一个动作。
通知源特征上生成的GATT通知包含一个叫做Eventflags的数据域,NC根据这个数据域就可得知对一条iOS通知可以执行哪些操作:

  • EventFlagPositiveAction:积极动作(Positive Action),与iOS通知相关。
  • EventFlagNegativeAction:消极动作(Negative Action),与iOS通知相关。
    实际的动作都是由NP执行的,这就表示:NC可执行动作都是由NP所决定的,而且根据iOS通知的不同而不同。举个例子,当NC收到来电通知时,执行积极动作可以接听,执行消极动作就拒接,而对于消息(官方是social)类型的通知而言,则只有消极操作,也就是说,在手表等从设备上面只能查看消息,而无法回复。
    NC不能预先去假设或尝试猜测一条iOS通知确切的可执行的动作。因为这些动作都是基于特定通知的,只有NP知道,而对NC无用的;同时还有其它的因素,如ANCS版本的变化等。这样,NP才能保证积极动作和消极动作的结果都与用户没多大关系。
    iOS 8系统中,NC通过发送获取通知属性命令,可获取到某条iOS通知可执行动作的简洁描述:
  • NotificationAttributeIDPositiveActionLabel:这条标签用于描述某条iOS通知可执行的积极动作。
  • NotificationAttributeIDNegativeActionLavel:这条标签用于描述某条iOS通知可执行的消极动作。

声明周期

一个ANCS的服务周期开始于NC订阅NP上的Notification Source characteristic,结束于NC取消该订阅或者断开连接。因为ANCS不是一种完全同步的服务,它没有追踪不同周期中的状态,因此所有的标示以及NC、NP之间的数据交换只在某一个周期中是有效的。
当一个周期结束后,NC应该删除其在本周期内采集和存储的所有的标示以及数据。一个新的周期开始的时候,NP会可能的把所有存在的通知下发给NC。

错误码

当往 Control Point characteristic中写入控制命令时,NC有时会受到ANCS错误码:

  • Unknown command (0xA0): 命令无法识别.
  • Invalid command (0xA1): 命令格式错误.
  • Invalid parameter (0xA2): 参数错误,例如notification uid并不存在对应的notification对象.
  • Action failed (0xA3): 动作没有被执行。
    如果NP回复了一个错误码,那么Data Source characteristic中将不再产生任何回应的命令的数据。

示例图

以下两个图展示了NP和NC之间的两种交互的过程的例子。Figure 2-7显示了NC上想要开启ANCS的基本流程;Figure 2-8 展示了NC获得IOS通知更多信息的基本流程。



相关文章

网友评论

      本文标题:【BLE】ANCS

      本文链接:https://www.haomeiwen.com/subject/lvvhuhtx.html