ANCS 介绍

Apple 通知中心服务（ANCS）是 IOS 设备中的 GATT 服务。该服务可以通知配件在 IOS 设备中的通知，称为 Nofication Provider(NP)。本地设备充当附件，称为通知消费者（NC）。

NP有3个特点：

通知来源 NC 启用 CCCD 后，通知源特性将发送带有 categoryID 和计数的通知。

通知数据格式
- 事件 ID 通知 NC 是否添加、修改或删除通知。
- EventFlags 通知通知的特殊性。 NC 可以决定是通知用户还是只是过滤。
- CategoryID 通知通知的类别，如来电、新闻或消息。
- CategoryCount 通知通知中心中存在的通知计数。
- NotificationUID 是用于标识类别的 32 位 ID。
控制点和数据源

NC 可以向控制点写入命令以与 NP 交互以获取详细信息或执行操作。有3个命令：
- 获取通知属性。此命令允许 NC 从 Notification 检索通知的模式详细信息。
  
  获取通知属性命令格式
  - CommandID 应设置为 0
  - NotificationUID 来自通知源的通知。
  - AttributeIDs是NC想要获取更多详细信息的通知属性。
    
    获取通知属性命令的响应格式
  - CommandID、Notification UID、Attribute_ID 都与 get Notification Attributes 命令相同。
  - 属性长度和属性是与属性ID 相关联的长度和数据。数据包括详细信息。
- 获取APP属性。该命令允许 NC 检索已安装 APP 的详细信息。
  
  获取APP属性命令格式
  - CommandID 应设置为 1
  - APP Identifier 是从通知 APP_ID 属性中获取的字符串 ID。表示在IOS中注册的APP ID。
  - APP AttributeIDs是NC想要获取更多详细信息的APP属性。
    
    获取APP属性命令的响应格式
  - CommandID、APP Identifier 与 get APP Attributes 命令相同。
  - 属性长度和属性是与属性ID 相关联的长度和数据。数据包括详细信息。
- 执行通知操作。此命令允许 NC 对特定 IOS 通知执行预定操作。有两个动作：
  1. 积极行动
  2. 消极行动 IOS 会根据动作执行行为，但UI 行为取决于IOS 和通知。例如，如果通知是来电，则积极动作可能会接听它，而消极动作可能会拒绝它。但行为可能会在其他通知中改变。

实施 ANCS NC

Sibles ANCS 提供 API 来搜索 IOS 设备中的 ANCS 并配置通知属性。用户只需要执行以下操作：

配置预期的通知和 APP 属性和关联长度。
收到APP_ID属性信息后，使用相关API获取APP属性。
使用 perform action API 为指定的 attributeID 执行动作。

有关 ANCS API 的详细信息，请参阅 ANCS .

这是示例代码：

int app_ancs_event_handler(uint16_t event_id, uint8_t *data, uint16_t len, uint32_t context)
{
 
    switch (event_id)
    {
    // ANCS only allows paired device to access its service.
    case BLE_GAP_ENCRYPT_IND:
    {
        ble_gap_encrypt_ind_t *ind = (ble_gap_encrypt_ind_t *)data;
        rt_kprintf("encryt ind %d", ind->conn_idx);
        // configure attributes and its length.
        ble_ancs_attr_enable(BLE_ANCS_NOTIFICATION_ATTR_ID_APP_ID, 1, 0);
        ble_ancs_attr_enable(BLE_ANCS_NOTIFICATION_ATTR_ID_TITLE, 1, 50);
        ble_ancs_attr_enable(BLE_ANCS_NOTIFICATION_ATTR_ID_MESSAGE, 1, 100);
        // enable ANCS
        ble_ancs_enable(ind->conn_idx);
        break;
    }
    case BLE_ANCS_NOTIFICATION_IND:
    {
        // Go through all attributes data.
        ble_ancs_noti_attr_t *notify = (ble_ancs_noti_attr_t *)data;
        rt_kprintf("received_notify %d, attr_count %d\r\n", notify->evt_id, notify->attr_count);
        if (notify->evt_id == BLE_ANCS_EVENT_ID_NOTIFICATION_ADDED &&
                !(notify->evt_flag & BLE_ANCS_EVENT_FLAG_PRE_EXISTING)) // No need to shown pre-existing notifcations
        {
            ble_ancs_attr_value_t *value = notify->value;
            ble_ancs_dev_app_id_name_t *app_id_name;
            uint32_t i;
            for (i = 0; i < notify->attr_count; i++)
            {
                if (value->len == 0)
                {
                    value = (ble_ancs_attr_value_t *)((uint8_t *)value + sizeof(ble_ancs_attr_value_t));
                    continue;
                }
                if (value->attr_id == BLE_ANCS_NOTIFICATION_ATTR_ID_TITLE)
                {
                    // Handle title content.
                }
                else if (value->attr_id  == BLE_ANCS_NOTIFICATION_ATTR_ID_APP_ID)
                {
                    // Get APP attribute
                    ble_ancs_get_app_attr(app_id, value->len + 1);
 
                }
                else if (value->attr_id  == BLE_ANCS_NOTIFICATION_ATTR_ID_MESSAGE)
                {
                    // Handle message content.
                }
                value = (ble_ancs_attr_value_t *)((uint8_t *)value + sizeof(ble_ancs_attr_value_t) + value->len);
            }
            break;
        }
        break;
    }
    case BLE_ANCS_GET_APP_ATTR_RSP:
    {
        // Handle APP display name
        break;
    }
    default:
        break;
 
    }
 
    return 0;
}
 
// Reigster event to listen ancs events.
BLE_EVENT_REGISTER(app_ancs_event_handler, NULL);