1. 前言

1.1 名词解释

NP(Notification Provider)：消息提供者，指的是ANCS服务的生产者，即IOS设备。
NC(Nofitication Consumer):消息接受者，指的是ANCS服务的客户端，即周边BLE设备。

1.2 ANCS概述

Apple Notification Center Service 是一项首要服务，其服务UUID为7905F431-B5CE-4E99-A40F-4B1E122D00D0。一个 NP 上可能只存在一个 ANCS 实例。由于 iOS 的性质，不能保证 ANCS 始终存在。因此，NC 应该寻找并订阅 GATT 服务的 Service Changed 特性，以便随时监控 ANCS 的潜在发布和取消发布。

2. ANCS的特征

ANCS具备三个特征：

通知源（强制）： UUID 9FBF120D-6301-42D9-8C58-25E699A21DBD（可通知）
控制点（可选）： UUID 69D1D8F3-45E1-49A8-9821-9BBDFDAAD9D9（可写响应）
数据源（可选）： UUID 22EAC6E9-24D6-4BB5-BE44-B36ACE7C7BFB（可通知）

2.1 通知源

NP上新的IOS通知的到来
修改NP上的IOS通知
删除NP上的IOS通知

数据传输格式：
数据源通知数据格式
数据格式：

EventID：通知附件是添加、修改或删除了给定的IOS通知。
EventFlags：一个位掩码，其设置位通过IOS通知通知NC。例如，如果 iOS 通知被认为“重要”，则 NC 可能希望显示更具侵略性的用户界面 (UI) 以确保正确提醒用户。该字段的枚举位在EventFlags中定义。
CategoryID：一个数值，提供可以将 iOS 通知归入的类别。NP 将尽最大努力为每个 iOS 通知提供准确的类别。该字段的枚举值在CategoryID Values中定义。
CategoryCount：给定类别中当前活跃的 iOS 通知数。例如，如果用户的电子邮件收件箱中有两封未读电子邮件，并且新电子邮件被推送到用户的 iOS 设备，则 CategoryCount 的值为 3。
NotificationUID：一个 32 位数值，是 iOS 通知的唯一标识符 (UID)。此值可用作发送到控制点特征以与 iOS 通知交互的命令的句柄。

NORDIC的相关代码描述：

/**@brief iOS notification structure. */
typedef struct
{
    uint32_t                        notif_uid;       //!< Notification UID.
    ble_ancs_c_evt_id_values_t      evt_id;          //!< Whether the notification was added, removed, or modified.
    ble_ancs_c_notif_flags_t        evt_flags;       //!< Bitmask to signal if a special condition applies to the notification, for example, "Silent" or "Important".
    ble_ancs_c_category_id_val_t    category_id;     //!< Classification of the notification type, for example, email or location.
    uint8_t                         category_count;  //!< Current number of active notifications for this category ID.
} ble_ancs_c_evt_notif_t;

/**@brief Event IDs for iOS notifications. */
typedef enum
{
    BLE_ANCS_EVENT_ID_NOTIFICATION_ADDED,     /**< The iOS notification was added. */
    BLE_ANCS_EVENT_ID_NOTIFICATION_MODIFIED,  /**< The iOS notification was modified. */
    BLE_ANCS_EVENT_ID_NOTIFICATION_REMOVED    /**< The iOS notification was removed. */
} ble_ancs_c_evt_id_values_t;

/**@brief Flags for iOS notifications. */
typedef struct
{
    uint8_t silent          : 1;  //!< If this flag is set, the notification has a low priority.
    uint8_t important       : 1;  //!< If this flag is set, the notification has a high priority.
    uint8_t pre_existing    : 1;  //!< If this flag is set, the notification is pre-existing.
    uint8_t positive_action : 1;  //!< If this flag is set, the notification has a positive action that can be taken.
    uint8_t negative_action : 1;  //!< If this flag is set, the notification has a negative action that can be taken.
} ble_ancs_c_notif_flags_t;

/**@brief Category IDs for iOS notifications. */
typedef enum
{
    BLE_ANCS_CATEGORY_ID_OTHER,                /**< The iOS notification belongs to the "other" category.  */
    BLE_ANCS_CATEGORY_ID_INCOMING_CALL,        /**< The iOS notification belongs to the "Incoming Call" category. */
    BLE_ANCS_CATEGORY_ID_MISSED_CALL,          /**< The iOS notification belongs to the "Missed Call" category. */
    BLE_ANCS_CATEGORY_ID_VOICE_MAIL,           /**< The iOS notification belongs to the "Voice Mail" category. */
    BLE_ANCS_CATEGORY_ID_SOCIAL,               /**< The iOS notification belongs to the "Social" category. */
    BLE_ANCS_CATEGORY_ID_SCHEDULE,             /**< The iOS notification belongs to the "Schedule" category. */
    BLE_ANCS_CATEGORY_ID_EMAIL,                /**< The iOS notification belongs to the "E-mail" category. */
    BLE_ANCS_CATEGORY_ID_NEWS,                 /**< The iOS notification belongs to the "News" category. */
    BLE_ANCS_CATEGORY_ID_HEALTH_AND_FITNESS,   /**< The iOS notification belongs to the "Health and Fitness" category. */
    BLE_ANCS_CATEGORY_ID_BUSINESS_AND_FINANCE, /**< The iOS notification belongs to the "Buisness and Finance" category. */
    BLE_ANCS_CATEGORY_ID_LOCATION,             /**< The iOS notification belongs to the "Location" category. */
    BLE_ANCS_CATEGORY_ID_ENTERTAINMENT         /**< The iOS notification belongs to the "Entertainment" category. */
} ble_ancs_c_category_id_val_t;

2.2 控制点和数据源

NC 可能想要与 iOS 通知进行交互。它可能想要检索关于它的更多信息，包括它的内容，或者它可能想要对其执行操作。这些属性的检索是通过控制点和数据源特性执行的。

NC 可以通过将特定命令写入控制点特性来发出请求以检索有关 iOS 通知的更多信息。如果写入控制点特征成功，NP 将通过数据源特征上的 GATT 通知流立即响应请求。

2.3 获取通知属性

获取通知属性命令允许 NC 检索特定 iOS 通知的属性。

命令格式如下：
在这里插入图片描述

CommandID：应设置为0(CommandIDGetNotificationAttributes)。
NotificationUID： 32 位数值，表示客户端需要其信息的 iOS 通知的 UID。
AttributeIDs： NC 想要检索的属性列表。某些属性可能需要后跟一个 16 位长度的参数，该参数指定 NC 想要检索的属性的最大字节数。

响应格式如下：
在这里插入图片描述

命令ID：设置为0( CommandIDGetNotificationAttributes)。
NotificationUID： 32位数值，是以下属性对应的iOS通知的UID。
AttributeList： AttributeIDs/16 位长度/Attribute 元组的列表。属性始终是一个字符串，其长度（以字节为单位）在元组中提供，但不以 NULL 结尾。如果 iOS 通知请求的属性为空或缺失，则其长度设置为0. 元组的顺序始终与获取通知属性命令的 AttributeID 的顺序相同。
如果响应大于协商的 GATT 最大传输单元 (MTU)，则它会被 NP 分成多个片段。NC 必须通过拼接每个片段来重组响应。当收到每个请求属性的完整元组时，响应完成。

2.4 获取应用属性

获取应用程序属性命令允许 NC 检索安装在 NP 上的特定应用程序的属性。

命令格式如下：
在这里插入图片描述

CommandID：应设置为1( CommandIDGetAppAttributes)。
AppIdentifier：客户端想要了解其信息的应用程序的字符串标识符。此字符串必须以 NULL 结尾。
AttributeIDs：NC 想要检索的属性列表。

响应格式如下：
在这里插入图片描述

命令ID：设置为1( CommandIDGetAppAttributes)。
AppIdentifier：以下属性对应的应用的字符串标识。此字符串以 NULL 结尾。
AttributeList： AttributeIDs/16 位长度/Attribute 元组的列表。属性始终是一个字符串，其长度（以字节为单位）在元组中提供，但不以 NULL 结尾。如果应用程序请求的属性为空或缺失，则其长度设置为0。元组始终与 Get App Attributes 命令的 AttributeIDs 的顺序相同。

和Get Notification Attributes 命令的响应一样，如果对 Get App Attributes 命令的响应大于协商的 GATT 最大传输单元 (MTU)，它会被 NP 分成多个片段。NC 必须通过拼接每个片段来重组响应。当收到每个请求属性的完整元组时，响应完成。