适用于iOS应用程序的核心蓝牙后台处理

对于iOS应用,了解应用是在前台还是在后台运行至关重要。应用在后台的行为必须与在前台的行为不同,因为iOS设备上的系统资源受到更多限制。有关iOS上后台操作的总体讨论,请参阅iOS版应用编程指南中的后台执行。

默认情况下,当应用处于后台或挂起状态时,中央和外围的许多常见核心蓝牙任务都会被禁用。也就是说,你可以声明你的应用支持核心蓝牙后台执行模式,以允许你的应用从挂起状态唤醒,以处理某些与蓝牙相关的事件。即使你的应用不需要全方位的后台处理支持,它仍然可以在发生重要事件时请求系统发出警报。

即使你的应用支持一种或两种核心蓝牙后台执行模式,它也不能永远运行。在某些时候,系统可能需要终止我们的应用程序,以便为当前前台应用程序释放内存,例如,导致任何活动或挂起的连接丢失。从iOS7 开始,酷睿蓝牙支持保存中央和外围管理器对象的状态信息,并在应用启动时恢复该状态。我们可以使用此功能来支持涉及蓝牙设备的长期操作。

仅限前台的应用

与大多数iOS应用一样,除非你请求执行特定后台任务的权限,否则你的应用会在进入后台状态后不久转换为挂起状态。处于挂起状态时,你的应用无法执行与蓝牙相关的任务,也无法识别任何与蓝牙相关的事件,直到它恢复到前台。

在中央侧,仅前台应用(尚未声明支持任一核心蓝牙后台执行模式的应用)无法在后台或挂起时扫描和发现广播外围设备。在外围设备端,广播被禁用,任何尝试访问应用已发布服务之一的动态特征值的中心都会收到错误。

根据用例,此默认行为可能会以多种方式影响我们的应用。例如,假设我们正在与当前连接到的外围设备上的数据进行交互。现在假设你的应用移动到挂起状态(例如,因为用户切换到另一个应用)。如果在应用挂起时与外围设备的连接丢失,则在应用恢复到前台之前,你不会意识到发生了任何断开连接。

利用外设连接选项

仅前台应用处于挂起状态时发生的所有蓝牙相关事件都由系统排队,并且仅在应用恢复到前台时传递到应用。也就是说,核心蓝牙提供了一种在发生某些中心角色事件时提醒用户的方法。然后,用户可以使用这些警报来确定特定事件是否值得将应用恢复到前台。

通过在调用连接外围设备时包括以下外围设备连接选项之一,可以利用这些警报: CBCentralManager 类连接到远程外围设备的方法:

有关外围设备连接选项的详细信息,请参阅 CBCentralManager 类参考中详细介绍的外围设备连接选项常量。

核心蓝牙后台执行模式

如果你的应用需要在后台运行才能执行某些与蓝牙相关的任务,则必须在其信息属性列表 (Info.plist) 文件中声明它支持核心蓝牙后台执行模式。当你的应用声明这一点时,系统会将其从挂起状态唤醒,以允许它处理与蓝牙相关的事件。此支持对于与定期提供数据的低功耗蓝牙设备(如心率监视器)交互的应用非常重要。

应用可以声明两种核心蓝牙后台执行模式,一种用于实现中心角色的应用,另一种用于实现外围角色的应用。如果你的应用实现了这两个角色,它可能会声明它支持这两种后台执行模式。核心蓝牙后台执行模式是通过将 UIBackgroundModes 键添加到 Info.plist 文件并将键的值设置为包含以下字符串之一的数组来声明的:

注意:默认情况下,Xcode 中的属性列表编辑器显示许多键的人类可读字符串,而不是实际的键名称。若要显示 Info.plist 文件中的实际键名称,请按住 Control 键点按编辑器窗口中的任意键,然后在上下文窗口中启用“显示原始键/值”项。

蓝牙中央后台执行模式

当实现中心角色的应用在其 Info.plist 文件中包含具有蓝牙中心值的 UIBackgroundModes 键时,核心蓝牙框架允许应用在后台运行以执行某些与蓝牙相关的任务。当应用在后台运行时,你仍然可以发现并连接到外围设备,以及浏览外围设备并与之交互。此外,当调用任何 CBCentralManagerDelegate 或 CBPeripheralDelegate 方法时,系统会唤醒你的应用,从而允许你的应用处理重要的中心角色事件,例如当连接建立或断开时、外围设备发送更新的特征值时,以及当中心管理器的状态发生更改时。

尽管你可以在应用处于后台时执行许多与蓝牙相关的任务,但请记住,当应用在后台时扫描外围设备与应用在前台时扫描外围设备的操作不同。特别是,当应用在后台扫描设备时:

蓝牙外设后台执行模式

若要在后台执行某些外围角色任务,必须在应用的 Info.plist 文件中包含具有蓝牙外围设备值的 UIBackgroundModes(用户界面)键。当此键值对包含在应用的 Info.plist 文件中时,系统会唤醒我们的应用以处理读取、写入和订阅事件。

除了允许唤醒应用以处理来自连接的中心的读取、写入和订阅请求外,核心蓝牙框架还允许应用在后台状态下进行播发。也就是说,我们应该知道,应用在后台运行时的广播与应用在前台时的操作方式不同。特别是,当我们的应用在后台投放广播时:

智能地使用后台执行模式

尽管声明应用支持一种或两种核心蓝牙后台执行模式对于满足特定用例可能是必需的,但应始终负责任地执行后台处理。由于执行许多与蓝牙相关的任务需要主动使用iOS设备的板载无线电,反过来,无线电的使用会对iOS设备的电池寿命产生不利影响,因此请尽量减少在后台执行的工作量。唤醒任何蓝牙相关事件的应用应尽快处理它们并返回,以便应用可以再次挂起。

声明支持任一核心蓝牙后台执行模式的任何应用都必须遵循一些基本准则:

在后台执行长期操作

某些应用可能需要使用核心蓝牙框架在后台执行长期操作。例如,假设我们正在为与门锁(配备蓝牙低功耗技术)通信的iOS设备开发家庭安全应用程序。应用和锁交互,在用户离开家时自动锁门,在用户返回时解锁门 - 所有这些都是在应用处于后台时进行的。当用户离开家时,iOS 设备最终可能会超出锁的范围,从而导致与锁的连接丢失。此时,应用可以简单地调用 CBCentralManager 类的 connectPeripheral:options: 方法,并且由于连接请求不会超时,因此当用户返回主页时,iOS 设备将重新连接。

现在假设用户离家几天。如果用户不在时系统终止应用,则当用户返回家时,应用将无法重新连接到锁,并且用户可能无法解锁门。对于此类应用程序,能够继续使用Core Blue执行长期操作(例如监视活动和挂起的连接)至关重要。

状态保护和恢复

由于状态保留和还原内置于 Core Bluetooth,因此你的应用可以选择启用此功能,要求系统保留应用的中央和外围管理器的状态,并继续代表它们执行某些与蓝牙相关的任务,即使你的应用不再运行也是如此。当其中一个任务完成时,系统会在后台重新启动你的应用,并使你的应用有机会还原其状态并适当地处理事件。对于上述家庭安全应用程序,系统将监视连接请求,并重新启动应用程序以处理 centralManager:didConnectPeripheral:当用户返回主页并完成连接请求时委托回调。

核心蓝牙支持实现中心角色和/或外围角色的应用的状态保留和还原。当应用实现中心角色并添加对状态保留和还原的支持时,系统会在系统即将终止应用以释放内存时保存中央管理器对象的状态(如果应用有多个中央管理器,则可以选择希望系统跟踪哪些中央管理器)。特别是,对于给定的 CBCentralManager 对象,系统会跟踪:

实现外围角色的应用同样可以利用状态保留和还原。对于 CBPeripheralManager 对象,系统会跟踪:

当系统将应用重新启动到后台时(例如,因为发现了应用正在扫描的外设),我们可以重新实例化应用的中央管理器和外围管理器并还原其状态。以下部分详细介绍了如何在应用中利用状态保留和还原。

添加对状态保存和恢复的支持

核心蓝牙中的状态保留和还原是一项可选功能,需要应用的帮助才能正常工作。我们可以按照以下过程在应用中添加对此功能的支持:

  1. (Required) 在分配和初始化中央管理器或外围管理器对象时选择加入状态保留和恢复。选择加入状态保护和还原中介绍了此步骤。
  2. (Required) 在系统重新启动应用后,重新实例化任何中央或外围管理器对象。重新实例化中央管理器和外围管理器中介绍了此步骤。
  3. (Required)实现适当的还原委托方法。实现适当的还原委托方法中介绍了此步骤。
  4. (Optional) 更新中央和外围管理器的初始化过程。更新初始化过程中介绍了此步骤。

选择加入状态保护和恢复

要选择启用状态保留和恢复功能,只需在分配和初始化中央管理器或外围管理器时提供唯一的恢复标识符。还原标识符是一个字符串,用于标识核心蓝牙和应用的中央或外围管理器。字符串的值仅对代码有效,但此字符串的存在告诉 Core Bluetooth 它需要保留标记对象的状态。核心蓝牙仅保留具有还原标识符的对象的状态。

例如,若要在仅使用 CBCentralManager 对象的一个实例来实现中心角色的应用中选择状态保留和还原,请指定 CBCentralManagerOptionRestoreIdentifierKey 初始化选项,并在分配和初始化中心管理器时为其提供还原标识符。

myCentralManager =
        [[CBCentralManager alloc] initWithDelegate:self queue:nil
         options:@{ CBCentralManagerOptionRestoreIdentifierKey:
         @"myCentralManagerIdentifier" }];

尽管上面的示例没有演示这一点,但我们可以选择在以类似方式使用外围管理器对象的应用中加入状态保留和还原:指定 CBPeripheralManagerOptionRestoreIdentifierKey 初始化选项,并在分配和初始化每个外围管理器对象时提供还原标识符。

注意:由于应用程序可以具有CBCentralManager和CBPeripheralManager对象的多个实例,因此请确保每个还原标识符都是唯一的,以便系统可以正确区分一个中央(或外围设备)管理器对象与另一个。

重新实例化中央和外围管理器

当系统将应用重新启动到后台时,我们需要做的第一件事是使用与首次创建时相同的还原标识符重新实例化相应的中央管理器和外围管理器。如果你的应用仅使用一个中央管理器或外围管理器,并且该管理器在应用的生存期内存在,则无需执行此步骤的其他操作。

如果你的应用使用多个中央管理器或外围管理器,或者它使用的管理器在应用的生存期内不存在,则你的应用需要知道在系统重新启动时要重新实例化哪些管理器。在实现应用程序委托的应用程序:didFinishLaunchingWithOptions: 方法时,可以使用相应的启动选项键(UIApplicationLaunchOptionsBluetoothCentralsKey 或 UIApplicationLaunchOptionsBluetoothPeripheralsKey)访问系统在应用程序终止时为应用程序保留的管理器对象的所有还原标识符的列表。

例如,当系统重新启动应用时,可以检索系统为应用保留的中央管理器对象的所有还原标识符,如下所示:

- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
 
    NSArray *centralManagerIdentifiers =
        launchOptions[UIApplicationLaunchOptionsBluetoothCentralsKey];
    ...

获得还原标识符列表后,只需遍历它并重新实例化相应的中央管理器对象即可。

注意:重新启动应用时,系统仅为正在执行某些蓝牙相关任务(当应用不再运行时)的中央和外围管理器提供恢复标识符。UIApplicationDelegate Protocol 参考中更详细地描述了这些启动选项键。

实现适当的还原委托方法

在应用中重新实例化相应的中央和外围管理器后,通过将其状态与蓝牙系统的状态同步来还原它们。若要使应用跟上系统代表它执行的操作(在系统未运行时),必须实现相应的还原委托方法。对于中央管理器,实现 centralManager:willRestoreState: delegate 方法;对于外围管理器,实现外围管理器:将恢复状态:委托方法。

重要提示:对于选择加入核心蓝牙的状态保留和恢复功能的应用,以下是第一种方法(centralManager:willRestoreState: and peripheralManager:willRestoreState:)在后台重新启动应用以完成某些与蓝牙相关的任务时调用。对于未选择加入状态保留的应用(或者在启动时没有要还原的内容),将首先调用 centralManagerDidUpdateState: 和外围设备管理器DidUpdateState: 委托方法。

在上述两种委托方法中,最后一个参数是一个字典,其中包含有关终止应用时保留的管理器的信息。有关可用字典键的列表,请参阅 CBCentralManagerDelegate Protocol Reference 中的 Central Manager 状态还原选项常量和 CBPeripheralManagerDelegate Protocol Reference 中的 Peripheral_Manager_State_Restoration_Options 常量。

若要还原 CBCentralManager 对象的状态,请使用 centralManager:willRestoreState: delegate 方法中提供的字典的键。例如,如果中央管理器对象在应用终止时有任何活动或挂起的连接,则系统会继续代表应用监视这些连接。如下所示,我们可以使用 CBCentralManagerRerestoreStatePeripheralsKey 字典键来获取中央管理器连接到或尝试连接的所有外围设备(由 CBPeripheral 对象表示)的列表:

- (void)centralManager:(CBCentralManager *)central
      willRestoreState:(NSDictionary *)state {
 
    NSArray *peripherals =
        state[CBCentralManagerRestoredStatePeripheralsKey];
    ...

在上面示例中,如何处理已恢复的外围设备列表取决于用例。例如,如果我们的应用保留了中央管理器发现的外围设备的列表,则我们可能希望将还原的外围设备添加到该列表中以保留对它们的引用。如发现外围设备后连接到外围设备中所述,请务必设置外围设备的委托,以确保它收到适当的回调。

可以使用外围管理器:willRestoreState: delegate 方法中提供的字典键,以类似的方式还原 CBPeripheralManager 对象的状态。

更新初始化过程

实现前三个必需步骤后,我们可能需要查看更新中央管理器和外围管理器的初始化过程。尽管这是一个可选步骤,但它对于确保应用中的内容顺利运行非常重要。例如,你的应用可能在浏览连接的外围设备的数据时被终止。当你的应用使用此外围设备还原时,它不会知道它在终止时使发现过程走了多远。我们需要确保从发现过程中中断的地方开始。

例如,在 centralManagerDidUpdateState: delegate 方法中初始化应用时,可以了解是否成功发现了已还原外围设备的特定服务(在应用终止之前),如下所示:

NSUInteger serviceUUIDIndex =
        [peripheral.services indexOfObjectPassingTest:^BOOL(CBService *obj,
        NSUInteger index, BOOL *stop) {
            return [obj.UUID isEqual:myServiceUUIDString];
        }];
 
    if (serviceUUIDIndex == NSNotFound) {
        [peripheral discoverServices:@[myServiceUUIDString]];
        ...

如上例所示,如果系统在完成发现服务之前终止了应用,则通过调用 discoverServices: 开始浏览还原的外围设备的数据。如果我们的应用成功发现了该服务,则可以检查是否发现了适当的特征(以及我们是否已订阅这些特征)。通过以这种方式更新初始化过程,可以确保在正确的时间调用正确的方法。