大家好,
非常好的消息,TI在6月新出品了ANCS的参考代码。
下载链接如下所示:https://github.com/ti-simplelink/ble_examples/tree/ble_examples-2.1/Projects/ble/ancs
该ANCS代码完全按照apple的说明,可以读到QQ, Wechat内容,但是不支持中文显示。
大家可以按照自己的项目需求更好的发挥自己想象力,专注应用层开发,另外,大家在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
Susan Yang:
谢谢分享,刚好最近在看!