This section covers global events that clients can receive via the WebsSocket connection .

For more events check out the hubs section since many important events are generated by the hub itself. A lot of other events are very special to the devices and their respective product. Learn more about these specific events in the devices section .

StateChanged Event

The StateChanged event is the most common event in the system. It is always being generated when a state of a Product, Device (including the Hub) or Capability changes. This event is defined globally and always has the same structure, however it is always implemented by each product, device, capability.

StateChanged example event of a Product:

{
  "sequenceNumber": 674,
  "type": "StateChanged",
  "desc": "/desc/product/GarageDoor.Novoferm/1.0/event/StateChanged",
  "namespace": "GarageDoor.Novoferm",
  "timestamp": "2020-02-07T21:13:37.1816140Z",
  "source": "/product/GarageDoor.Novoferm/1.0",
  "properties": {
    "activeOnShc": true,
    "enabledByUser": true,
    "enabledByWebshop": true,
    "fullVersion": "1.0.5.36",
    "updateAvailable": false
  }
}

This event was generated because the product GarageDoor.Novoferm was just provisioned and activated on the Hub.

StateChanged example event of a Device:

{
  "sequenceNumber": 93,
  "type": "StateChanged",
  "desc": "/desc/device/BT-WDS.Medion/1.0/event/StateChanged",
  "namespace": "BLEDevices.Medion",
  "timestamp": "2020-02-07T20:41:45.4981220Z",
  "source": "/device/20a32ca23fed443cb472c92772456f73",
  "properties": {
    "batteryLevel": 80
  }
}

This event was generated because the property batteryLevel of the Medion Window and Door Sensor changed changed to 80%.

StateChanged example event of a Capability:

{
  "sequenceNumber": 322,
  "type": "StateChanged",
  "desc": "/desc/device/VRCC.RWE/2.0/capability/RoomHumidity/event/StateChanged",
  "namespace": "VRCC.RWE",
  "timestamp": "2020-02-07T20:52:13.2159930Z",
  "source": "/capability/fa9444ccb2694df7a69698a91f23d2eb",
  "properties": {
    "humidity": 49.0
  }
}

This event was generated because the humidity property of the RoomHumidity capability of the Virtual Room Climate Controller device changed changed to 49%.

ControllerConnectivityChanged Event

This event is generated when the LIVISI Home Hub looses or regains its connectivity to the back-end. This can have multiple reasons:

• The home internet connection is lost
• The Hub lost connection to the home network
• The Hub is being manually restarted by the user
• The Hub is installing a software update

{
  "sequenceNumber": 0,
  "type": "ControllerConnectivityChanged",
  "namespace": "core.RWE",
  "timestamp": "2020-02-07T20:38:09.3186114Z",
  "properties": {
    "isConnected": false,
    "serialNumber": "40156259078520001617"
  }
}

The property isConnected is false when connection is lost and true when connection is established.