智能家居 StartStop 特征架构

action.devices.traits.StartStop - 此特征属于支持启动和停止操作的设备。

启动和停止设备的作用与开启和关闭设备的功能类似。开启和启动时沿用此特征功能的设备会有所不同。例如，某些洗衣机可以开启并修改其设置，然后再实际开始操作。

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

某些设备可能支持在特定可用区运行。例如，洒水器可能设有多个喷水区，并且支持为个别区域单独浇水，而吸尘器可能支持清洁特定房间。

设备属性

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

属性	类型	说明
pausable	Boolean	（默认：false） 指示设备是否可以在操作期间暂停。
availableZones	数组	表示支持的区域名称。字符串应根据用户设置进行本地化。此列表并不具有唯一性；用户可以报告自己想要的任何名称。
[item, ...]	String	支持启动设备的可用区的名称。

示例

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

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

设备状态

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

州	类型	说明
isRunning	Boolean	必填。 指示设备当前是否正在运行。
isPaused	Boolean	指示设备是否明确暂停。如果此值为 true，则表示 isRunning 为 false，但可以恢复。
activeZones	数组	从 availableZones 列表指示设备当前运行的可用区。
[item, ...]	String	区域名称。

示例

设备被暂停了吗？

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

设备被暂停了吗？

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

设备是否正在运行？

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

设备命令

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

action.devices.commands.StartStop

启动或停止设备。

参数

参数	类型	说明
start	Boolean	必填。 设为 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	Boolean	必填。 设为 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

设备错误

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