智能家居 StartStop 特征架构
action.devices.traits.StartStop
- 此特征属于支持启动和停止操作的设备。
启动和停止设备的作用与开启和关闭功能类似。开启和启动时继承此特征功能的设备会有所不同。例如,某些洗衣机在开启之前可以开启并修改设置。
与具有开启和关闭状态的设备不同,某些可以启动和停止的设备也可以在执行操作时暂停。可以暂停的设备会停止操作,但恢复后的设备将继续处于暂停状态。无论设备的当前状态如何,取消暂停都与启动/重启不同,这将从头开始执行。
某些设备可能支持在特定可用区运行。例如,洒水器可能具有各种浇水区域,并且支持单独为特定区域浇水,而真空吸尘器可能支持清理特定房间。
设备属性
具有此特征的设备可能会在 SYNC
操作中报告以下属性。如需详细了解如何处理 SYNC
intent,请参阅 intent 执行方式。
属性 | 类型 | 说明 |
---|---|---|
pausable |
Boolean |
(默认值: 指示设备是否可以在操作期间暂停。 |
availableZones |
数组 |
指明支持的区域名称。字符串应根据用户设置进行本地化。此列表并非详尽无遗;用户可以举报他们需要的任何姓名。 |
[item, ...] |
String |
支持启动设备的可用区的名称。 |
示例
可以暂停且支持在多个可用区运行的设备。
{ "pausable": true, "availableZones": [ "kitchen", "living room", "office", "bedroom" ] }
设备状态
具有此特征的设备可能会在 QUERY
操作中报告以下状态。如需详细了解如何处理 QUERY
intent,请参阅 intent 执行方式。
州 | 类型 | 说明 |
---|---|---|
isRunning |
Boolean |
必填。 指示设备当前是否正在运行。 |
isPaused |
Boolean |
指明设备是否明确暂停。如果此值为 true,则表示 |
activeZones |
数组 |
从 |
[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 |
数组 |
指明开始运行的两个或多个可用区。将设置而不是 |
[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
en-US
-
I need
my roomba to start running inthe den -
pause
the dryer now -
start
the dryer now -
stop
the dishwasher -
unpause
the dishwasher
es-ES
-
parar
la lavadora -
pon
el aspirador enel dormitorio principal -
pon
el lavavajillas en pausa -
quiero usar
el friegaplatos -
vuelve a encender
la aspiradora
fr-FR
-
Allumer
l'aspirateur dansle salon . -
Continuer
l'aspirateur . -
arrête
l'aspirateur -
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 -
metti in pausa
l'aspirapolvere -
stoppa
l'aspirapolvere
ja-JP
-
お掃除ロボット をリビング で動かして -
台所の食洗機 を一時停止してください -
掃除機 を停止して -
掃除機 を再開してください -
洗濯機 をスタートさせて
ko-KR
-
거실 에서청소기 돌려 -
세탁기 좀 돌려 줘 -
식기 세척기 다시 시작해 -
청소기 일시 정지 -
청소기 작동 멈춰 줘
nl-NL
-
De schoonmaakrobot inschakelen inde keuken . -
hervat
de stofzuiger -
pauzeer
de stofzuiger -
start
mijn stofzuiger -
stop
de stofzuiger
pt-BR
-
Inicia
o aspersor nojardim -
Iniciar
o aspirador de pó nasala . -
iniciar
a máquina de lavar -
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 . -
kör igång
dammsugaren igen -
pausa
dammsugaren -
starta
tvättmaskinen -
stoppa
dammsugaren