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

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software