Protocol

CBPeripheralDelegate

The delegate of a CBPeripheral object must adopt the CBPeripheralDelegate protocol. The delegate uses this protocol’s methods to monitor the discovery, exploration, and interaction of a remote peripheral’s services and properties. There are no required methods in this protocol.

Declaration

@protocol CBPeripheralDelegate

Topics

Discovering Services

peripheral:didDiscoverServices:

Invoked when you discover the peripheral’s available services.

peripheral:didDiscoverIncludedServicesForService:error:

Invoked when you discover the included services of a specified service.

Discovering Characteristics and Characteristic Descriptors

peripheral:didDiscoverCharacteristicsForService:error:

Invoked when you discover the characteristics of a specified service.

peripheral:didDiscoverDescriptorsForCharacteristic:error:

Invoked when you discover the descriptors of a specified characteristic.

Retrieving Characteristic and Characteristic Descriptor Values

peripheral:didUpdateValueForCharacteristic:error:

Invoked when you retrieve a specified characteristic’s value, or when the peripheral device notifies your app that the characteristic’s value has changed.

peripheral:didUpdateValueForDescriptor:error:

Invoked when you retrieve a specified characteristic descriptor’s value.

Writing Characteristic and Characteristic Descriptor Values

peripheral:didWriteValueForCharacteristic:error:

Invoked when you write data to a characteristic’s value.

peripheral:didWriteValueForDescriptor:error:

Invoked when you write data to a characteristic descriptor’s value.

Managing Notifications for a Characteristic’s Value

peripheral:didUpdateNotificationStateForCharacteristic:error:

Invoked when the peripheral receives a request to start or stop providing notifications for a specified characteristic’s value.

Retrieving a Peripheral’s Received Signal Strength Indicator (RSSI) Data

peripheralDidUpdateRSSI:error:

Invoked when you retrieve the value of the peripheral’s current RSSI while it is connected to the central manager.

Deprecated
peripheral:didReadRSSI:error:

Invoked after you call readRSSI to retrieve the value of the peripheral’s current RSSI while it is connected to the central manager.

Monitoring Changes to a Peripheral’s Name or Services

peripheralDidUpdateName:

Invoked when a peripheral’s name changes.

peripheralDidInvalidateServices:

Invoked when a peripheral’s services have changed.

peripheral:didModifyServices:

Invoked when a peripheral’s services have changed.

Relationships

Inherits From