Deprecated CBCentralManager Methods

A method identified as deprecated has been superseded and may become unsupported in the future.

Deprecated in iOS 7.0

retrieveConnectedPeripherals

Retrieves a list of the peripherals currently connected to the system. (Deprecated in iOS 7.0. Use the retrieveConnectedPeripheralsWithServices: method instead.)

- (void)retrieveConnectedPeripherals
Discussion

Upon retrieving the list of connected peripherals, the central manager object calls the centralManager:didRetrieveConnectedPeripherals: method of its delegate object. If there are no peripherals currently connected to the system, the central manager object passes an empty array of peripherals to the centralManager:didRetrieveConnectedPeripherals: method. Note that the list of connected peripherals can include those that are connected by other apps and that will need to be connected locally using the connectPeripheral:options: method before they can be used.

Availability
  • Available in iOS 5.0 and later.
  • Deprecated in iOS 7.0.
Declared In
CBCentralManager.h

retrievePeripherals:

Retrieves a list of known peripherals by their UUIDs. (Deprecated in iOS 7.0. Use the retrievePeripheralsWithIdentifiers: method instead.)

- (void)retrievePeripherals:(NSArray *)peripheralUUIDs
Parameters
peripheralUUIDs

An array of CFUUIDRef objects from which CBPeripheral objects can be retrieved. Because CBUUID objects represent Bluetooth-specific universally unique identifiers (UUIDs) (used for Bluetooth GATT attributes such as services and characteristics), CBPeripheral objects use standard CFUUIDRef UUIDs as their unique identifiers.

Discussion

This method retrieves a list of peripherals that the central manager is able to match to the provided UUIDs. Upon retrieving the list of known peripherals, the central manager object calls the centralManager:didRetrievePeripherals: method of its delegate object. If no matches are made, the central manager object passes an empty array of peripherals to the centralManager:didRetrievePeripherals: method.

Availability
  • Available in iOS 5.0 and later.
  • Deprecated in iOS 7.0.
Declared In
CBCentralManager.h