智能家居 StartStop Trait 架构

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

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

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

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

设备属性

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

属性 类型 说明
pausable 布尔值

（默认：false）

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

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

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

示例

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

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

设备状态

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

州 类型 说明
isRunning 布尔值

必填。

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

指明设备是否已明确暂停。如果此值为 true，则表示 isRunning 为 false，但可以恢复。如果 pausable 属性为 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 布尔值

必填。

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

设备错误

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