ANCS协议翻译

时间:2020-12-21 01:54:13

综述

苹果通知中心(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通知移除;

ANCS协议翻译

l  EventID:消息类型,添加(0)、修改(1)、删除(2);

l  EventFlags:消息优先级,静默(1)、重要(2);

l  CategoryID:消息类型;

l  CategoryCount:消息计数;

l  NotificationUID:通知ID,可以通过此ID获取详情;

Notification的生命周期如下:

ANCS协议翻译

Get Notification Attributes

当NC希望从NP读取Notification的详细信息时,它需要向Control Point characteristic发送一些命令,格式如下:

ANCS协议翻译

l  CommandID:设为0;

l  NotificationUID:对应Notification Source中相同名字的字段;

l  AttributeIDs:NC希望读取的变量ID列表,有些变量可能需要跟一个16bit的数说明想要的最大长度;

NP接收到此命令后,会通过Data Source characteristic将结果返回(通过GATT Notification),所以你需要监听这个参数。此命令发出后对应的返回信息如下:

ANCS协议翻译

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发送一些命令,格式如下:

ANCS协议翻译

l  CommandID:设成1;

l  AppIdentifier:App ID,这个字符串必须使用NULL结尾(“\0”吧);

l  AttributeIDs:希望获得属性的列表;

此命令的响应消息格式如下:

ANCS协议翻译

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之间的常见交互时序:

ANCS协议翻译

下面的图展示了获取详细信息的时序:

ANCS协议翻译

CategoryID

ANCS协议翻译

EventID

ANCS协议翻译

EventFlags

ANCS协议翻译

CommandID

ANCS协议翻译

NotificationAttributeID

ANCS协议翻译

ANCS协议翻译

ANCS协议翻译

AppAttributeID

ANCS协议翻译

实际实验之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)

发信人:内容