ANCS协议
苹果ANCS协议分析
标签：
苹果ANCS协议学习
综述
苹果通知中心（Apple Notification Center Service, ANCS）的目的是提供给蓝牙外设一种简单、方便的获取ios设备通知信息的方式。
依赖
ANCS的使用没有依赖，它是GATT的一个子集，任何一个实现了GATT client的设备可以方便的从ios设备获取通知信息。
传输注意事项
如果没有特殊说明，通过ANCS传输的数值均使用小端模式。
如果没有特殊说明，通过ANCS传输的字符串均使用UTF-8编码。
概念定义
l ANCS：苹果通知中心服务
l NP（Notification Provider）：通知的产生者，一般是ios设备
l NC（Notification Consumer）：通知的消费者，一般是蓝牙设备
l iOS notification：ios设备里出现的通知
l GATT notification：GATT characteristic发送的通知
Service定义
ANCS使用了一个私有UUID作为其Service的UUID：
7905F431-B5CE-4E99-A40F-4B1E122D00D0
NP上只有一个ANCS实例，基于ios的机制，ANCS没有办法保证一直运行。
所以NC需要搜索并且监听（subscribe）Service Changed characteristic，以保证能够坚挺到所有通知。
（怎么做。。。。Service Changed characteristic是啥）
Characteristic类型
所涉及的characteristic
1、Notification Source:
UUID 9FBF120D-6301-42D9-8C58-25E699A21DBD(notifiable)
基本通知源，通知一些计数的信息；
2、Control Point:
UUID 69D1D8F3-45E1-49A8-9821-9BBDFDAAD9D9(writeablewithresponse)
控制器，用于向ios设备写入控制信息，例如读取详情；
3、Data Source:
UUID 22EAC6E9-24D6-4BB5-BE44-B36ACE7C7BFB(notifiable)
数据源，用于提供详细数据，在控制信息写入后通过此characteristic返回；
还有许多其他characteristic，不过只有Notification Source是强制的，其他的都是可选的。
Notification Source
通知信息更新时，从NP发给NC的消息。
有以下一些情况：
l 新的ios通知到来；
l ios通知有改动；
l ios通知移除；
l EventID：消息类型，添加(0)、修改(1)、删除(2)；
l EventFlags：消息优先级，静默(1)、重要(2)；
l CategoryID：消息类型；
l CategoryCount：消息计数；
l NotificationUID：通知ID，可以通过此ID获取详情；
Notification的生命周期如下：
Get Notification Attributes
当NC希望从NP读取Notification的详细信息时，它需要向Control Point characteristic发送一些命令，格式如下：
l CommandID：设为0；
l NotificationUID：对应Notification Source中相同名字的字段；
l AttributeIDs：NC希望读取的变量ID列表，有些变量可能需要跟一个16bit的数说明想要的最大长度；
NP接收到此命令后，会通过Data Source characteristic将结果返回（通过GATT Notification），所以你需要监听这个参数。此命令发出后对应的返回信息如下：
l CommandID：为0；
l NotificationUID：对应之前请求的UID；
l AttributeList：查询结果列表，每一项的格式都是：ID/16bit Length/Value，每个attribute都是一个字符串，其长度由Length指定，但是此字符串不是以NULL结尾。若找不到对应的Attribute，则Length为0；
* 如果返回的消息长度大于GATT最大传输长度（MTU），则其会被分割成多个分段。蓝牙设备必须将这些分段组装起来。当所有请求属性的内容都接收完成后，此过程才算完成；
Get App Attributes
此命令允许NC读取NP上安装app的特定属性，它需要向Control Point characteristic发送一些命令，格式如下：
l CommandID：设成1；
l AppIdentifier：App ID，这个字符串必须使用NULL结尾（“\0”吧）；
l AttributeIDs：希望获得属性的列表；
此命令的响应消息格式如下：
l CommandID：为1；
l AppIdentifier：App ID，与之前的请求ID对应；
l AttributeList：属性值列表，每一个格式都是：ID/16-bit Length/Value，每个attribute都是一个字符串，其长度由Length指定，但是此字符串不是以NULL结尾。若找不到对应的Attribute，则Length为0；
* 关于分段以及传输结束的判断标准，与Get Notification Attributes一致；
Session（会话）
ANCS session 在NC订阅Notification Source之后开始，在取消订阅或者连接断开之后结束。由于ANCS不是一个完全同步的服务，它不会在会话中记录状态。所以，所有的NotificationUID以及AppIdentifier仅在某个特定的会话周期内有效。（换句话说，那些ID只是在会话后开始的计数，下次再连接重新计数）
当某个会话结束时，NC需要清空所有ID以及数据内容。当新的会话开始时，NP会尽量把现有的通知都发给NC。NC可以使用这些信息知道当前尚未处理的通知有哪些。
Attribute Fetching and Caching
我们建议，只在用户做出操作时才获取attribute。例如，一开始只是展示一个通知列表，然后在用户点击某一个后才查询详细的信息。
另外，我们建议在一次会话中建立一张App attribute的缓存表，这样可以避免重复获取一些常量attribute。
Error Codes
写入Control Point characteristic时，可能会有错误发生，错误码定义如下（在哪里返回错误码。。。同一次请求中么）：
0xA0 ： 未知命令，commandID非法；
0xA1 ： 无效命令，命令的格式错误；
0xA2 ： 无效参数，某一个参数（例如NotificationID无效）
如果有错误发生，就不会有Data Source返回。
时序图
下面展示了NP与NC之间的常见交互时序：
下面的图展示了获取详细信息的时序：
CategoryID
EventID
EventFlags
CommandID
NotificationAttributeID
AppAttributeID
实际实验之DataSource读取
主要是介绍一下读取的各个AttrID返回的都是啥：
电话：
|
AttrID |
返回值 |
|
0(App ID) |
com.apple.mobilephone |
|
1(Title) |
1 (326) 021-3971（电话号码，不过划分方式好怪。。。） 如果此号码存了名字，则是电话本中的名字 |
|
2(SubTitle) |
空 如果此号码存了名字，则是mobile |
|
3(Message) |
Incoming Call |
短信：
|
AttrID |
返回值 |
|
0(App ID) |
com.apple.MoileSMS |
|
1(Title) |
10698109555991 01051726663 +86 132-6021-3971 如果此号码存了名字，则是电话本中的名字 |
|
2(SubTitle) |
空 |
|
3(Message) |
短信的内容 |
微信：
|
AttrID |
返回值 |
|
0(App ID) |
com.tencent.xin |
|
1(Title) |
微信 |
|
2(SubTitle) |
空 |
|
3(Message) |
发信人:内容 |
其他应用的ID：
QQ：c o m . t e n c e n t . m q q
365：c o m . 3 6 5 r i l i . C o c o
Any.Do：c o m . a n y d o . A n y D O
系统提示：c o m . a p p l e . r e m i n d e r s
