CBCentralManager у iOS-у — шта је то, управљање BLE и Core Bluetooth

Шта је CBCentralManager?

CBCentralManager — је главна класа Core Bluetooth за имплементацију улоге Central у BLE архитектури на iOS-у. Управља целокупним животним циклусом BLE везе: од скенирања уређаја који се рекламирају до преноса података и прекида везе. CBCentralManager ради асинхроно путем делегата CBCentralManagerDelegate, обавештавајући апликацију о догађајима у Bluetooth стеку.

Иницијализација CBCentralManager покреће процес state restoration: менаџер проверава стање Bluetooth-а на уређају и обнавља претходне везе ако је апликација била затворена. Процес иницијализације може да траје од 50 до 500 мс у зависности од стања Bluetooth-а. Апликација мора да сачека позив centralManagerDidUpdateState пре почетка било којих BLE операција.

Архитектура Core Bluetooth изграђена је на обрасцу Delegation: CBCentralManager делегира обраду догађаја (откривање уређаја, повезивање, грешке) протоколу CBCentralManagerDelegate. За рад са одређеним Peripheral-ом користи се протокол CBPeripheralDelegate који обавештава о откривању сервиса, карактеристика и пријему података. Оває асинхрони модел осигурава неблокирајући рад UI-ја.

Стања CBCentralManager

CBCentralManager пролази кроз неколико стања која одређују да ли је BLE стек доступан за рад. Стање се преноси путем делегата: centralManagerDidUpdateState(_:). Програмер је дужан да обради сва стања — не само poweredOn, већ и случајеве када је Bluetooth искључен или недоступан.

Unauthorized state постаје све чешће од iOS 13+. Почевши од ове верзије, апликација мора да има дозволу NSBluetoothAlwaysUsageDescription у Info.plist. Без ње, централни менаџер прелази у стање .unauthorized и скенирање је немогуће. Корисник може да промени дозволу у сваком тренутку у Settings > Privacy > Bluetooth.

Скенирање BLE уређаја

scanForPeripherals(withServices:options:) — главна метода за покретање скенирања. Параметар withServices прима низ UUID сервиса за филтрирање: ако се проследи nil, биће откривени сви уређаји, што значајно повећава потрошњу енергије. Препоручује се увијек филтрирати по UUID сервиса који су потребни апликацији. Опције скенирања укључују CBCentralManagerScanOptionAllowDuplicatesKey (поновна обавештавања о истом уређају).

import CoreBluetooth

class BLEController: NSObject,
    CBCentralManagerDelegate {

    private var centralManager: CBCentralManager!

    override init() {
        super.init()
        centralManager =
            CBCentralManager(
                delegate: self,
                queue: nil
            )
    }

    func startScanning() {
        let serviceUUID =
            CBUUID("180F") // Сервис батерије

        centralManager.scanForPeripherals(
            withServices: [serviceUUID],
            options: [
                CBCentralManagerScanOptionAllowDuplicatesKey: false
            ]
        )
    }
}

При откривању уређаја позива се centralManager(_:didDiscover:advertisementData:rssi:). Параметар advertisementData садржи пун речник података рекламног пакета, укључујући име уређаја (CBAdvertisementDataLocalNameKey), UUID сервиса (CBAdvertisementDataServiceUUIDsKey) и податке произвођача (CBAdvertisementDataManufacturerDataKey). RSSI — ниво сигнала у dBm, доступан у тренутку откривања.

Повезивање са Peripheral

connect(_:options:) — метода за успостављање BLE везе са откривеним Peripheral-ом. Након позива connect, iOS покушава да се повеже са уређајем. Успешно повезивање потврђује се позивом centralManager(_:didConnect:), грешка — centralManager(_:didFailToConnect:error:). Опције повезивања укључују CBConnectPeripheralOptionNotifyOnConnectionKey, CBConnectPeripheralOptionNotifyOnDisconnectionKey и CBConnectPeripheralOptionNotifyOnNotificationKey за позадинска обавештавања.

// Повежи се на BLE уређај
func connectToPeripheral(
    _ peripheral: CBPeripheral
) {
    centralManager.connect(peripheral, options: nil)

    // Постави делегата за Peripheral
    peripheral.delegate = self
}

// Делегат: успешно повезивање
func centralManager(
    _ central: CBCentralManager,
    didConnect peripheral: CBPeripheral
) {
    print("Повезан на " +
          "\(peripheral.name ?? "unknown")")

    // Почни откривање сервиса
    peripheral.discoverServices(nil)
}

// Делегат: грешка повезивања
func centralManager(
    _ central: CBCentralManager,
    didFailToConnect peripheral: CBPeripheral,
    error: Error?
) {
    print("Connection failed: 
          \(error?.localizedDescription ?? "")")
}

Прекид повезивања на iOS-у износи 30 секунди. Ако уређај не одговори на захтев за повезивање у овом року, позива се didFailToConnect. На прекид утичу: удаљеност до уређаја, сметње, да ли се уређај тренутно рекламира. Пре повезивања уверите се да је уређај у режиму connectable advertising (ADV_IND, а не ADV_NONCONN_IND).

Откривање сервиса и карактеристика

Након повезивања потребно је открити сервисе (discoverServices) и карактеристике (discoverCharacteristics) Peripheral-а. Ово је обавезан корак пре читања или уписивања података. Процес је асинхрон: discoverServices враћа резултат путем peripheral(_:didDiscoverServices:), а discoverCharacteristics — путем peripheral(_:didDiscoverCharacteristicsFor:error:).

Препоручује се да у discoverServices проследите низ занимљивих UUID, а не nil. Филтрирање убрзава откривање и штеди енергију. Ако сервис није пронађен, iOS ће пријавити празан низ. Након откривања карактеристика, можете читати њихове вредности (readValue), претплатити се на обавештавања (setNotifyValue) или уписивати податке (writeValue).

Важан детаљ: MTU се договара аутоматски након повезивања. За добијање тренутног MTU-а користите peripheral.maximumWriteValueLength(for: .withResponse) или .withoutResponse. У iOS-у максимални MTU је 512 бајтова за BLE 5.0 уређаје. Ако треба да пренесете податке веће од MTU-а, имплементирајте фрагментацију на нивоу апликације.

Скенирање у позадини и iOS ограничења

Скенирање у позадини BLE уређаја на iOS-у захтева посебну конфигурацију. Core Bluetooth подржава извршавање у позадини, али са значајним ограничењима. За рад у позадини потребно је: укључити bluetooth-central у Background Modes у Capabilities пројекта, иницијализовати CBCentralManager са опцијом CBCentralManagerOptionRestoreIdentifierKey за state restoration и обрађивати догађаје централног менаџера при преласку у позадину.

Ограничења BLE-а у позадини у iOS-у: scanForPeripherals без филтрирања по UUID-у не ради у позадини. Апликација мора да наведе конкретне UUID сервиса за скенирање. iOS може да одложи испоруку BLE догађаја на неодређено време. Core Bluetooth аутоматски наставља скенирање при откривању одговарајућег уређаја, чак и ако је апликација у позадини. Прекид скенирања у позадини: iOS може да заустави скенирање након 10–30 минута ради штеде енергије.

State Restoration — механизам Core Bluetooth који омогућава обнављање BLE веза након поновног покретања апликације или поновног покретања iOS-а. За његово коришћење: наведите CBCentralManagerOptionRestoreIdentifierKey при иницијализацији, имплементирајте centralManager(_:willRestoreState:) у делегату и обновите листу повезаних Peripheral-а из прослеђеног речника. State Restoration је критична функционалност за BLE апликације које раде у позадини, као што су фитнес трекери или медицински уређаји.

Обрада грешака и опоравак везе

CBCentralManager генерише грешке у неколико сценарија: повезивање није успело (didFailToConnect), веза је прекинута (didDisconnectPeripheral), карактеристика је недоступна за читање/уписивање (didWriteValue error). Све Core Bluetooth грешке се враћају путем објекта Error са доменом CBErrorDomain. Најчешћи кодови: CBErrorConnectionTimeout (0x04), CBErrorPeripheralDisconnected (0x07), CBErrorOperationNotSupported (0x0A).

Стратегија опоравка везе: при пријему didDisconnectPeripheral проверите код грешке. Ако је грешка CBErrorConnectionTimeout или CBErrorPeripheralDisconnected — закажите аутоматско поновно повезивање након 1–5 секунди. Ако је грешка CBErrorOperationNotSupported — забележите и не покушавајте да поновите операцију. За критичне везе (медицински уређаји) користите exponential backoff са максималним интервалом од 60 секунди.

// Руковање прекидом са аутоматским поновним повезивањем
func centralManager(
    _ central: CBCentralManager,
    didDisconnectPeripheral peripheral: CBPeripheral,
    error: Error?
) {
    guard let error = error else {
        return // Очекивани прекид
    }

    print("Disconnected: \(error.localizedDescription)")

    // Аутоматско поновно повезивање
    if shouldAutoReconnect {
        DispatchQueue.main.asyncAfter(
            deadline: .now() + reconnectDelay
        ) {
            central.connect(peripheral)
        }
    }
}

При развоју поуздане BLE апликације на iOS-у узмите у обзир: Core Bluetooth не гарантује испоруку свих пакета при слабом сигналу. За поуздан пренос користите writeType .withResponse (потврђѐен упис) и претплатите се на обавештавања (setNotifyValue) за пријем података од Peripheral-а. Водите евиденцију грешака за дијагностику проблема са везом у производњи.