智能家居 StartStop trait 架构

action.devices.traits.StartStop - 此 trait 适用于支持启动和停止操作的设备。

启动和停止设备的功能与开启和关闭设备类似。继承此 trait 的设备在开启和启动时会以不同的方式运行。例如，某些洗衣机可以在实际开始运行之前开机并修改其设置。

与仅具有开启和关闭状态的设备不同，某些可以启动和停止的设备还可以在执行操作时暂停。可以暂停的设备将停止操作，但在恢复后会继续处于暂停时的状态。取消暂停与启动/重启不同，因为无论设备的当前状态如何，此操作都会从头开始运行。

某些设备可能支持在特定区域运行。例如，喷水器可能具有不同的灌溉区域，并且支持单独灌溉特定区域，而吸尘器可能支持清洁特定房间。

设备属性

具有此 trait 的设备可能会在 SYNC 操作中报告以下属性。如需详细了解如何处理 SYNC intent，请参阅intent 执行方式。

属性 类型 说明
pausable 布尔值

（默认值：false）

指示设备在运行期间是否可以暂停。
availableZones 数组

表示支持的区域名称。字符串应根据用户的设置进行本地化。此列表并非详尽无遗；用户可以举报他们想举报的任何名称。
[item, ...] String

支持启动设备的可用区的名称。

示例

可暂停且支持在多个时区运行的设备。

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

设备状态

具有此 trait 的实体可能会在 QUERY 操作期间报告以下状态。如需详细了解如何处理 QUERY intent，请参阅intent 执行方式。

州 类型 说明
isRunning 布尔值

必填。

指示设备当前是否正在运行。
isPaused 布尔值

指明设备是否已明确暂停。如果此值为 true，则表示 isRunning 为 false，但可以恢复。
activeZones 数组

指示设备当前运行的区域（来自 availableZones 列表）。
[item, ...] String

区域名称。

示例

设备是否处于暂停状态？

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

设备是否处于暂停状态？

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

设备是否正在运行？

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

设备命令

具有此 trait 的设备可能会在 EXECUTE 操作期间响应以下命令。如需详细了解如何处理 EXECUTE intent，请参阅intent 执行方式。

action.devices.commands.StartStop

启动或停止设备。

参数

参数 类型 说明
start 布尔值

必填。

设为 true 表示启动设备操作，设为 false 表示停止。
zone String

表示开始运行时所在的时区。
multipleZones 数组

指示要开始在两个或更多可用区中运行。将被设置，而不是 zone parameter.
[item, ...] String

设备启动时所在区域的名称。

示例

启动设备。

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

停止设备。

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

在办公室内启动设备。

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

在厨房、餐厅和起居室启动设备。

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

action.devices.commands.PauseUnpause

暂停或取消暂停设备操作。

此命令需要以下属性： 
{
  "pausable": true
}

参数

参数 类型 说明
pause 布尔值

必填。

设为 true 表示暂停，设为 false 表示取消暂停。

示例

暂停设备。

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

用户尝试暂停设备，但设备处于无法暂停的状态。

支持的值：

unpausableState

示例话语

de-DE

  • Bitte starte den Staubsauger im Wohnzimmer .
  • Geschirrspüler wieder anstellen
  • Staubsauger abschalten
  • Staubsauger pausieren
  • bitte starte die Waschmaschine
  • ist die Waschmaschine fertig

en-US

  • I need my roomba to start running in the den
  • is the vacuum running
  • pause the dryer now
  • start the dryer now
  • stop the dishwasher
  • unpause the dishwasher

es-ES

  • dime si ha acabado el lavavajillas
  • parar la lavadora
  • pon el lavavajillas en pausa
  • quiero usar el friegaplatos
  • vuelve a encender la aspiradora

fr-FR

  • Allumer l'aspirateur dans le salon .
  • Continuer l'aspirateur .
  • arrête l'aspirateur
  • est-ce que l'aspirateur est en marche
  • lance la machine à laver
  • mets l'aspirateur en pause

hi-IN

  • कमरे में वैक्यूम चलाओगी
  • क्या वैक्यूम चल रहा है?
  • डिशवॉशर को कुछ देर रोको
  • वैक्यूम को अनपॉज़ करो
  • वैक्यूम को चालू कर दो
  • वैक्यूम को बंद कर दो

it-IT

  • Mi accendi l'aspirapolvere in cucina ?
  • fa' partire aspirapolvere
  • fai ripartire l'aspirapolvere
  • la lavatrice è in funzione
  • metti in pausa l'aspirapolvere
  • stoppa l'aspirapolvere

ja-JP

  • お掃除ロボット を リビング で動かして
  • 台所の食洗機 を一時停止してください
  • 掃除機 は作動してる
  • 掃除機 を停止して
  • 掃除機 を再開してください
  • 洗濯機 をスタートさせて

ko-KR

  • 거실 에서 청소기 돌려
  • 건조기 돌아가고 있나
  • 세탁기 좀 돌려 줘
  • 식기 세척기 다시 시작해
  • 청소기 일시 정지
  • 청소기 작동 멈춰 줘

nl-NL

  • De schoonmaakrobot inschakelen in de keuken .
  • Is de stofzuiger klaar
  • hervat de stofzuiger
  • pauzeer de stofzuiger
  • start mijn stofzuiger
  • stop de stofzuiger

pt-BR

  • Inicia o aspersor no jardim
  • Iniciar o aspirador de pó na sala .
  • iniciar a máquina de lavar
  • o aspirador está parado?
  • parar a pausa na máquina de lavar roupa
  • parar o aspirador de pó
  • pausar o aspirador de pó

sv-SE

  • Kör igång sprinklern på gräsmattan .
  • har dammsugaren i vardagsrummet startat?
  • kör igång dammsugaren igen
  • pausa dammsugaren
  • starta tvättmaskinen
  • stoppa dammsugaren

设备错误

查看错误和异常的完整列表。