CoreBluetooth lets your app discover, connect to, and exchange data with Bluetooth Low Energy peripherals, acting either as a central or as a peripheral. As a central, you use CBCentralManager and its CBCentralManagerDelegate to scan for and connect to a CBPeripheral, then read and write its CBService, CBCharacteristic, and CBDescriptor attributes over GATT. As a peripheral, you publish your own CBMutableService and CBMutableCharacteristic through CBPeripheralManager, respond to a CBCentral via CBATTRequest, and identify attributes with CBUUID. The framework also supports streaming over an L2CAP channel with CBL2CAPChannel and reports state and errors through types such as CBManagerState, CBError, and CBATTError.
Central Role 4
Scan for, connect to, and exchange data with Bluetooth Low Energy peripherals as a central.
- ClCBCentralManageriOS 5.0+@class CBCentralManager
- PrCBCentralManagerDelegate@protocol CBCentralManagerDelegate
- ClCBPeripheraliOS 5.0+@class CBPeripheral
- PrCBPeripheralDelegate@protocol CBPeripheralDelegate
Peripheral Role 4
Publish local services and respond to connected centrals by acting as a Bluetooth Low Energy peripheral.
- ClCBPeripheralManageriOS 6.0+@class CBPeripheralManager
- PrCBPeripheralManagerDelegate@protocol CBPeripheralManagerDelegate
- ClCBCentraliOS 6.0+@class CBCentral
- ClCBATTRequestiOS 6.0+@class CBATTRequest
GATT Attributes 10
The services, characteristics, and descriptors that make up a peripheral's GATT database.
- ClCBAttributeiOS 8.0+An abstract base class for the GATT attributes of a peripheral, including services, characteristics, and descriptors.
- ClCBServiceiOS 5.0+@class CBService
- ClCBMutableServiceiOS 6.0+@class CBMutableService
- ClCBCharacteristiciOS 5.0+@class CBCharacteristic
- ClCBMutableCharacteristiciOS 6.0+@class CBMutableCharacteristic
- ClCBDescriptoriOS 5.0+@class CBDescriptor
- ClCBMutableDescriptoriOS 6.0+@class CBMutableDescriptor
- StCBCharacteristicProperties@enum CBCharacteristicProperties
- StCBAttributePermissionsiOS 6.0+@enum CBAttributePermissions
- EnCBCharacteristicWriteType@enum CBCharacteristicWriteType
Manager Foundations 3
Shared base types and identifiers used across the central and peripheral managers.
- ClCBManageriOS 10.0+An abstract base class that manages the central or peripheral role and reports the Bluetooth system state.
- ClCBPeeriOS 8.0+An abstract base class representing a remote Bluetooth device, identified by a unique identifier.
- ClCBUUIDiOS 5.0+@class CBUUID
Channel Streaming 3
Stream data over an L2CAP channel and run channel-sounding ranging procedures.
- ClCBL2CAPChanneliOS 11.0+@class CBL2CAPChannel
- ClCBChannelSoundingSessionConfigurationiOS 27.0+An object that configures a channel-sounding session for high-accuracy Bluetooth distance ranging.
- ClCBChannelSoundingProcedureResultsiOS 27.0+An object that reports the measurement results produced by a channel-sounding ranging procedure.
State and Authorization 9
Values that report manager state, authorization status, and connection conditions.
- EnCBManagerStateiOS 10.0+@enum CBManagerState
- EnCBManagerAuthorizationiOS 13.0+@enum CBManagerAuthorization
- EnCBCentralManagerState@enum CBCentralManagerState
- EnCBPeripheralStateiOS 7.0+@enum CBPeripheralState
- EnCBPeripheralManagerState@enum CBPeripheralManagerState
- EnCBPeripheralManagerAuthorizationStatus@enum CBPeripheralManagerAuthorizationStatus
- EnCBPeripheralManagerConnectionLatencyiOS 6.0+@enum CBPeripheralManagerConnectionLatency
- EnCBConnectionEvent@enum CBConnectionEvent
- StCBConnectionEventMatchingOptionConstants that specify the criteria used to match connection events for a peripheral.
Errors 2
Error domains that describe Core Bluetooth and ATT-layer failures.
- StCBErrorA structure describing errors in the Core Bluetooth error domain.
- StCBATTErrorA structure describing errors in the Bluetooth Attribute Protocol error domain.
Type Aliases 1
- TyCBL2CAPPSM