Smart Home StartStop Trait Schema

action.devices.traits.StartStop - This trait belongs to devices that support starting and stopping operations.

Starting and stopping a device serves a similar function to turning it on and off. Devices that inherit this trait function differently when turned on and when started. Certain washing machines, for instance, are able to be turned on and have their settings modified before actually starting operation.

Unlike devices that simply have an on and off state, some devices that can start and stop are also able to pause while performing an operation. Devices that can pause will cease operation, but upon resume will continue in the same state as when they were paused. Unpausing differs from starting/restarting as regardless of the current state of the device, this will begin operation from the beginning.

Some devices may support running in certain zones. For example, a sprinkler may have various watering zones and support the ability to water particular zones separately, while a vacuum may support cleaning specific rooms.

Device ATTRIBUTES

Devices with this trait may report the following attributes as part of the SYNC operation. To learn more about handling SYNC intents, see Intent fulfillment.

Examples

Device that can be paused and supports operating in multiple zones.

{
  "pausable": true,
  "availableZones": [
    "Kitchen",
    "Living room",
    "Office",
    "Bedroom"
  ]
}

Device STATES

Entities with this trait may report the following states as part of the QUERY operation. To learn more about handling QUERY intents, see Intent fulfillment.

Examples

Is the device paused?

{
  "isRunning": false,
  "isPaused": true
}

Is the device paused?

{
  "isRunning": true,
  "isPaused": false
}

Is the device running?

{
  "isRunning": true,
  "isPaused": false,
  "activeZones": [
    "Kitchen",
    "Living room"
  ]
}

Device COMMANDS

Devices with this trait may respond to the following commands as part of the EXECUTE operation. To learn more about handling EXECUTE intents, see Intent fulfillment.

action.devices.commands.StartStop

Start or stop the device.

Parameters

Examples

Start the device.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true
  }
}

Stop the device.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": false
  }
}

Start the device in the office.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true,
    "zone": "office"
  }
}

Start device in the kitchen, dining room, and living room.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true,
    "multipleZones": [
      "Kitchen",
      "Dining room",
      "Living room"
    ]
  }
}

action.devices.commands.PauseUnpause

Pause or unpause device operation.

{
  "pausable": true
}

Parameters

Examples

Pause the device.

{
  "command": "action.devices.commands.PauseUnpause",
  "params": {
    "pause": true
  }
}

Related errors

The user tried to pause a device, but the device is in some state where it cannot be paused.

Supported values:

unpausableState

Sample utterances

Device ERRORS