Skip Navigation
Class

CBCentralManager

An object that scans for, discovers, connects to, and manages peripherals.
class CBCentralManager

Overview

CBCentralManager objects manage discovered or connected remote peripheral devices (represented by CBPeripheral objects), including scanning for, discovering, and connecting to advertising peripherals.

Before calling the CBCentralManager methods, set the state of the central manager object to powered on, as indicated by the CBCentralManagerState.poweredOn constant. This state indicates that the central device (your iPhone or iPad, for instance) supports Bluetooth low energy and that Bluetooth is on and available for use.

Topics

Initializing a Central Manager

convenienceinit()
Initializes the central manager without a delegate.
convenienceinit(delegate: (any CBCentralManagerDelegate)?, queue: dispatch_queue_t?)
Initializes the central manager with a specified delegate and dispatch queue.
init(delegate: (any CBCentralManagerDelegate)?, queue: dispatch_queue_t?, options: [String: Any]?)
Initializes the central manager with specified delegate, dispatch queue, and initialization options.
Central Manager Initialization Options
Keys used to pass options when initializing a central manager.
Central Manager State Restoration Options
Keys used to pass state restoration options to the central manager initializer.

Establishing or Canceling Connections with Peripherals

funcconnect(CBPeripheral, options: [String: Any]?)
Establishes a local connection to a peripheral.
Peripheral Connection Options
Keys used to pass options when connecting to a peripheral.
funccancelPeripheralConnection(CBPeripheral)
Cancels an active or pending local connection to a peripheral.

Retrieving Lists of Peripherals

funcretrieveConnectedPeripherals(withServices: [CBUUID]) -> [CBPeripheral]
Returns a list of the peripherals connected to the system whose services match a given set of criteria.
funcretrievePeripherals(withIdentifiers: [UUID]) -> [CBPeripheral]
Returns a list of known peripherals by their identifiers.

Scanning or Stopping Scans of Peripherals

funcscanForPeripherals(withServices: [CBUUID]?, options: [String: Any]?)
Scans for peripherals that are advertising services.
Peripheral Scanning Options
Keys used to pass options when scanning for peripherals.
funcstopScan()
Asks the central manager to stop scanning for peripherals.
varisScanning: Bool
A Boolean value that indicates whether the central is currently scanning.

Inspecting Feature Support

classfuncsupports(CBCentralManager.Feature) -> Bool
Returns a Boolean that indicates whether the device supports a specific set of features.
structFeature
An option set of device-specific features.

Monitoring Properties

vardelegate: (any CBCentralManagerDelegate)?
The delegate object that you want to receive central manager events.

Receiving Connection Events

funcregisterForConnectionEvents(options: [CBConnectionEventMatchingOption: Any]?)
Register for an event notification when the central manager makes a connection matching the given options.
Peripheral Connection Options
Keys used to pass options when connecting to a peripheral.
enumCBConnectionEvent
A change to the connection state of a peer.
structCBConnectionEventMatchingOption
A set of options to use when registering for connection events.

Deprecated

enumCBCentralManagerState
Values that represent the current state of a central manager object.
Deprecated

Relationships

Inherits From

Conforms To

See Also

Centrals

classCBCentral
A remote device connected to a local app, which is acting as a peripheral.
protocolCBCentralManagerDelegate
A protocol that provides updates for the discovery and management of peripheral devices.
Current page is CBCentralManager