View Source HAP.Display behaviour (HAP v0.6.0)

A behaviour which encapsulates all user-facing display concerns for an accessory. Applications which use HAP may provide their own implementation of this behaviour as a field in a HAP.AccessoryServer. If no such implementation is provided HAP uses a default console based implementation

Summary

Callbacks

clear_pairing_code()

Stop displaying any currently displayed pairing information to the user. This is most commonly because a pairing has been established with a controller

display_pairing_code(name, pairing_code, pairing_url)

Display a notification to the user containing information on how to pair with this accessory server. The value of pairing_url can be encoded in a QR code to enable pairing directly from an iOS device.

identify(name)

Display a notification to the user that identifies the named device or accessory. This comes from a user request within the Home app to identify the given device or accessory.

Callbacks

Link to this callback

clear_pairing_code()

View Source 
@callback clear_pairing_code() :: any()

Stop displaying any currently displayed pairing information to the user. This is most commonly because a pairing has been established with a controller

Link to this callback

display_pairing_code(name, pairing_code, pairing_url)

View Source 
@callback display_pairing_code(
  name :: HAP.AccessoryServer.name(),
  pairing_code :: HAP.AccessoryServer.pairing_code(),
  pairing_url :: HAP.AccessoryServer.pairing_url()
) :: any()

Display a notification to the user containing information on how to pair with this accessory server. The value of pairing_url can be encoded in a QR code to enable pairing directly from an iOS device.

Link to this callback

identify(name)

View Source 
@callback identify(name :: String.t()) :: any()

Display a notification to the user that identifies the named device or accessory. This comes from a user request within the Home app to identify the given device or accessory.