Class Accessory

constructor

• new Accessory(displayName, UUID): Accessory

• Parameters

  • displayName: string
  • UUID: string

  Returns Accessory

_isBridge

aid

Optionalbridge

bridged

bridgedAccessories

category

displayName

OptionallastKnownUsername

reachable

services

shouldPurgeUnusedIDs

UUID

addBridgedAccessories

• addBridgedAccessories(accessories): void

• Parameters

  • accessories: Accessory[]

  Returns void

addBridgedAccessory

• addBridgedAccessory(accessory, deferUpdate?): Accessory

• Parameters

  • accessory: Accessory
  • deferUpdate: boolean = false

  Returns Accessory

addService

• addService(service): Service

• Add the given service instance to the Accessory.

  Parameters

  • service: Service

    A Service instance.

  Returns Service

  Returns the service instance passed to the method call.
• addService<S>(serviceConstructor, ...constructorArgs): Service

• Adds a given service by calling the provided Service constructor with the provided constructor arguments.

  Type Parameters

  • S extends typeof Service

  Parameters

  • serviceConstructor: S

    A Service service constructor (e.g. Service.Switch).
  • Rest...constructorArgs: ConstructorArgs<S>

    The arguments passed to the given constructor.

  Returns Service

  Returns the constructed service instance.

configureController

• configureController(controllerConstructor): void

• This method is used to set up a new Controller for this accessory. See Controller for a more detailed explanation what a Controller is and what it is capable of.

  The controller can be passed as an instance of the class or as a constructor (without any necessary parameters) for a new Controller. Only one Controller of a given ControllerIdentifier can be configured for a given Accessory.

  When called, it will be checked if there are any services and persistent data the Controller (for the given ControllerIdentifier) can be restored from. Otherwise, the Controller will be created with new services.

  Parameters

  • controllerConstructor: Controller<ControllerServiceMap> | ControllerConstructor

    The Controller instance or constructor to the Controller with no required arguments.

  Returns void

destroy

• destroy(): Promise<void>

• Removes this Accessory from the local network Accessory object will no longer valid after invoking this method Trying to invoke publish() on the object will result undefined behavior

  Returns Promise<void>

disableUnusedIDPurge

• disableUnusedIDPurge(): void

• Returns void

emit

• emit(event, paired, callback): boolean

• Parameters

  • event: "identify"
  • paired: boolean
  • callback: VoidCallback

  Returns boolean

• emit(event, port, address): boolean

• Parameters

  • event: "listening"
  • port: number
  • address: string

  Returns boolean

• emit(event): boolean

• Parameters

  • event: "advertised"

  Returns boolean

• emit(event, change): boolean

• Parameters

  • event: "service-configurationChange"
  • change: ServiceConfigurationChange

  Returns boolean

• emit(event, change): boolean

• Parameters

  • event: "service-characteristic-change"
  • change: AccessoryCharacteristicChange

  Returns boolean

• emit(event): boolean

• Parameters

  • event: "paired"

  Returns boolean

• emit(event): boolean

• Parameters

  • event: "unpaired"

  Returns boolean

• emit(event, warning): boolean

• Parameters

  • event: "characteristic-warning"
  • warning: CharacteristicWarning

  Returns boolean

enableUnusedIDPurge

• enableUnusedIDPurge(): void

• Returns void

getPrimaryAccessory

• getPrimaryAccessory(): Accessory

• Returns the bridging accessory if this accessory is bridged. Otherwise, returns itself.

  Returns Accessory

  the primary accessory

getService

• getService<T>(name): undefined | Service

• Type Parameters

  • T extends WithUUID<typeof Service>

  Parameters

  • name: string | T

  Returns undefined | Service

getServiceById

• getServiceById<T>(uuid, subType): undefined | Service

• Type Parameters

  • T extends WithUUID<typeof Service>

  Parameters

  • uuid: string | T
  • subType: string

  Returns undefined | Service

on

• on(event, listener): this

• Parameters

  • event: "identify"
  • listener: ((paired: boolean, callback: VoidCallback) => void)
    • • (paired, callback): void

      • Parameters

        • paired: boolean
        • callback: VoidCallback

        Returns void

  Returns this

• on(event, listener): this

• Parameters

  • event: "listening"
  • listener: ((port: number, address: string) => void)
    • • (port, address): void

      • Parameters

        • port: number
        • address: string

        Returns void

  Returns this

• on(event, listener): this

• Parameters

  • event: "advertised"
  • listener: (() => void)
    • • (): void

      • Returns void

  Returns this

• on(event, listener): this

• Parameters

  • event: "service-configurationChange"
  • listener: ((change: ServiceConfigurationChange) => void)
    • • (change): void

      • Parameters

        • change: ServiceConfigurationChange

        Returns void

  Returns this

• on(event, listener): this

• Parameters

  • event: "service-characteristic-change"
  • listener: ((change: AccessoryCharacteristicChange) => void)
    • • (change): void

      • Parameters

        • change: AccessoryCharacteristicChange

        Returns void

  Returns this

• on(event, listener): this

• Parameters

  • event: "paired"
  • listener: (() => void)
    • • (): void

      • Returns void

  Returns this

• on(event, listener): this

• Parameters

  • event: "unpaired"
  • listener: (() => void)
    • • (): void

      • Returns void

  Returns this

• on(event, listener): this

• Parameters

  • event: "characteristic-warning"
  • listener: ((warning: CharacteristicWarning) => void)
    • • (warning): void

      • Parameters

        • warning: CharacteristicWarning

        Returns void

  Returns this

publish

• publish(info, allowInsecureRequest?): Promise<void>

• Publishes this accessory on the local network for iOS clients to communicate with.

  • info.username - formatted as a MAC address, like CC:22:3D:E3:CE:F6, of this accessory. Must be globally unique from all Accessories on your local network.
  • info.pincode - the 8-digit pin code for clients to use when pairing this Accessory. Must be formatted as a string like 031-45-154.
  • info.category - one of the values of the Accessory.Category enum, like Accessory.Category.SWITCH. This is a hint to iOS clients about what "type" of Accessory this represents, so that for instance an appropriate icon can be drawn for the user while adding a new Accessory.

  Parameters

  • info: PublishInfo

    Required info for publishing.
  • OptionalallowInsecureRequest: boolean

    Will allow unencrypted and unauthenticated access to the http server

  Returns Promise<void>

purgeUnusedIDs

• purgeUnusedIDs(): void

• Manually purge the unused ids if you like, comes handy when you have disabled auto purge, so you can do it manually

  Returns void

removeAllBridgedAccessories

• removeAllBridgedAccessories(): void

• Returns void

removeBridgedAccessories

• removeBridgedAccessories(accessories): void

• Parameters

  • accessories: Accessory[]

  Returns void

removeBridgedAccessory

• removeBridgedAccessory(accessory, deferUpdate?): void

• Parameters

  • accessory: Accessory
  • deferUpdate: boolean = false

  Returns void

removeController

• removeController(controller): void

• This method will remove a given Controller from this accessory. The controller object will be restored to its initial state. This also means that any event handlers setup for the controller will be removed.

  Parameters

  • controller: Controller<ControllerServiceMap>

    The controller which should be removed from the accessory.

  Returns void

removeService

• removeService(service): void

• Parameters

  • service: Service

  Returns void

setupURI

• setupURI(): string

• Returns string

unpublish

• unpublish(): Promise<void>

• Returns Promise<void>

StaticcleanupAccessoryData

• cleanupAccessoryData(username): void

• Parameters

  • username: string

  Returns void

Staticdeserialize

• deserialize(json): Accessory

• Parameters

  • json: SerializedAccessory

  Returns Accessory

Staticserialize

• serialize(accessory): SerializedAccessory

• Parameters

  • accessory: Accessory

  Returns SerializedAccessory