OptionaldisplayName: stringOptionalsubtype: stringOptionalsubtypeStatic ReadonlyUUIDAdds a new link to the specified service. The service MUST be already added to the SAME accessory.
The service this service should link to
Returns an id which uniquely identifies a service on the associated accessory. The serviceId is a concatenation of the UUID for the service (defined by HAP) and the subtype (could be empty) which is programmatically defined by the programmer.
the serviceId
Removes a link to the specified service which was previously added with addLinkedService
Previously linked service
This updates the value by calling the CharacteristicEventTypes.SET event handler associated with the characteristic.
This acts the same way as when a HomeKit controller sends a /characteristics request to update the characteristic.
An event notification will be sent to all connected HomeKit controllers which are registered
to receive event notifications for this characteristic.
This method behaves like a Characteristic.updateValue call with the addition that the own CharacteristicEventTypes.SET event handler is called.
The name or the constructor of the desired Characteristic.
The updated value.
Note: If you don't want the CharacteristicEventTypes.SET to be called, refer to updateCharacteristic.
Sets the state of the characteristic to an errored state.
If a Characteristic.onGet or CharacteristicEventTypes.GET handler is set up, the errored state will be ignored and the characteristic will always query the latest state by calling the provided handler.
If a generic error object is supplied, the characteristic tries to extract a HAPStatus code from the error message string. If not possible a generic HAPStatus.SERVICE_COMMUNICATION_FAILURE will be used. If the supplied error object is an instance of HapStatusError the corresponding status will be used.
This doesn't call any registered Characteristic.onSet or CharacteristicEventTypes.SET handlers.
Have a look at the Presenting Erroneous Accessory State to the User guide for more information on how to present erroneous state to the user.
The name or the constructor of the desired Characteristic.
The error object
Note: Erroneous state is never pushed to the client side. Only, if the HomeKit client requests the current state of the Characteristic, the corresponding HapStatusError is returned. As described above, any Characteristic.onGet or CharacteristicEventTypes.GET handlers have preference.
Marks the service as hidden
optional boolean (default true) if the service should be marked hidden
Sets this service as the new primary service. Any currently active primary service will be reset to be not primary. This will happen immediately, if the service was already added to an accessory, or later when the service gets added to an accessory.
optional boolean (default true) if the service should be the primary service
This updates the value of the characteristic. If the value changed, an event notification will be sent to all connected HomeKit controllers which are registered to receive event notifications for this characteristic.
The name or the constructor of the desired Characteristic.
The new value.
Sets the state of the characteristic to an errored state. If a Characteristic.onGet or CharacteristicEventTypes.GET handler is set up, the errored state will be ignored and the characteristic will always query the latest state by calling the provided handler.
If a generic error object is supplied, the characteristic tries to extract a HAPStatus code from the error message string. If not possible a generic HAPStatus.SERVICE_COMMUNICATION_FAILURE will be used. If the supplied error object is an instance of HapStatusError the corresponding status will be used.
The name or the constructor of the desired Characteristic.
The error object
Have a look at the Presenting Erroneous Accessory State to the User guide for more information on how to present erroneous state to the user.
Note: Erroneous state is never pushed to the client side. Only, if the HomeKit client requests the current state of the Characteristic, the corresponding HapStatusError is returned. As described above, any Characteristic.onGet or CharacteristicEventTypes.GET handlers have precedence.
StaticAccessStaticAccessStaticAccessoryStaticAccessoryStaticAccessoryStaticAirStaticAirStaticAssetStaticAssistantStaticAudioStaticBatteryStaticCameraStaticCameraStaticCameraStaticCarbonStaticCarbonStaticCloudStaticContactStaticDataStaticDiagnosticsStaticDoorStaticDoorbellStaticFanStaticFanv2StaticFaucetStaticFilterStaticFirmwareStaticGarageStaticHeaterStaticHumidifierStaticHumidityStaticInputStaticIrrigationStaticLeakStaticLightbulbStaticLightStaticLockStaticLockStaticMicrophoneStaticMotionStaticNFCStaticOccupancyStaticOutletStaticPairingStaticPowerStaticProtocolStaticSecurityStaticServiceStaticSiriStaticSiriStaticSlatsStaticSmartStaticSmokeStaticSpeakerStaticStatefulStaticStatelessStaticSwitchStaticTapStaticTargetStaticTargetStaticTelevisionStaticTelevisionStaticTemperatureStaticThermostatStaticThreadStaticTransferStaticTunnelStaticValveStaticWiStaticWiStaticWiStaticWindowStaticWindow
Service "Microphone"