智能家居 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
- 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