Contents

HMCharacteristic

A specific characteristic of a service, like the brightness of a dimmable light or its color temperature.

Declaration

class HMCharacteristic

Overview

An HMCharacteristic instance represents an aspect of a service that provides data, or that your app can control.

You don’t create characteristic instances. Instead, an accessory manufacturer incorporates them into a device, which publishes them to you through the characteristics array of an HMService instance.

Characteristics have a properties array that indicates attributes like readability, writability, and user-visibility. They also have a characteristicType property that tells your app what the characteristic controls or describes. Device manufacturers can use one of the standard types, given in Characteristic types, or they can create custom types.

Each characteristic has a value that you can read or write. Some characteristics use plain numbers, Booleans, or strings. Others have application specific meanings declared in enumerations associated with the given characteristic type. The characteristic’s metadata can help your app interpret the value.

Topics

Identifying a characteristic

Reading characteristic properties

Determining what a characteristic controls

Controlling a characteristic

Managing characteristic presentation

Receiving change notifications

Getting the characterized service

Initializers

See Also

Accessories