Class

CBDescriptor

An object that provides further information about a remote peripheral’s characteristic.

Declaration

@interface CBDescriptor : CBAttribute

Overview

CBDescriptor and its subclass CBMutableDescriptor represent a descriptor of a peripheral’s characteristic. In partcular, CBDescriptor objects represent the descriptors of a remote peripheral’s characteristic. Descriptors provide further information about a characteristic’s value. For example, they may describe the value in human-readable form and describe how to format the value for presentation purposes. Characteristic descriptors also indicate whether a characteristic’s value indicates or notifies a client (a central) when the value of the characteristic changes.

CBUUID details six predefined descriptors and their corresponding value types. CBDescriptor lists the predefined descriptors and the CBUUID constants that represent them.

Table 1

Predefined descriptors

Descriptor type

Descriptor constant

Characteristic extended properties

CBUUIDCharacteristicExtendedPropertiesString

Characteristic user description

CBUUIDCharacteristicUserDescriptionString

Client characteristic configuration

CBUUIDClientCharacteristicConfigurationString

Server characteristic configuration

CBUUIDServerCharacteristicConfigurationString

Characteristic format

CBUUIDCharacteristicFormatString

Characteristic aggregate format

CBUUIDCharacteristicAggregateFormatString

Topics

Identifying a Descriptor

characteristic

The characteristic to which this descriptor belongs.

Accessing Descriptor Data

value

The value of the descriptor.

Relationships

Inherits From

See Also

Services

CBService

A collection of data and associated behaviors for accomplishing a function or feature of a device.

CBMutableService

A service with writeable property values.

CBCharacteristic

A characteristic of a remote peripheral’s service.

CBMutableCharacteristic

A characteristic of a local peripheral’s service.

CBMutableDescriptor

An object that provides additional information about a local peripheral’s characteristic.