스마트 홈 StartStop 특성 스키마

action.devices.traits.StartStop - 이 특성은 시작 및 중지 작업을 지원하는 기기에 적용됩니다.

기기를 시작하고 중지하는 것은 기기를 켜고 끄는 것과 유사한 기능을 합니다. 이 특성을 상속하는 기기는 켜져 있을 때와 시작될 때 다르게 작동합니다. 예를 들어 특정 세탁기는 실제로 작동을 시작하기 전에 켜고 설정을 수정할 수 있습니다.

단순히 켜짐 및 꺼짐 상태만 있는 기기와 달리 시작 및 중지할 수 있는 일부 기기는 작업을 실행하는 동안 일시중지할 수도 있습니다. 일시중지할 수 있는 기기는 작동이 중지되지만 다시 시작하면 일시중지되었을 때와 동일한 상태로 계속됩니다. 일시중지 해제는 시작/다시 시작과 다릅니다. 기기의 현재 상태와 관계없이 처음부터 작동이 시작되기 때문입니다.

일부 기기는 특정 영역에서 실행을 지원할 수 있습니다. 예를 들어 스프링클러에는 다양한 물 공급 구역이 있으며 특정 구역을 별도로 물을 공급하는 기능을 지원할 수 있습니다. 진공 청소기는 특정 방 청소를 지원할 수 있습니다.

기기 속성

이 특성이 있는 기기는 SYNC 작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC 인텐트 처리에 대해 자세히 알아보려면 인텐트 처리를 참고하세요.

속성 유형 설명
pausable Boolean

(기본값: false)

작동 중에 기기를 일시중지할 수 있는지 여부를 나타냅니다.
availableZones 배열

지원되는 영역 이름을 나타냅니다. 문자열은 사용자가 설정한 대로 현지화되어야 합니다. 이 목록은 배타적이지 않으며 사용자는 원하는 이름을 신고할 수 있습니다.
[item, ...] 문자열

시작 기기가 지원되는 영역의 이름입니다.

예

일시중지가 가능하고 여러 영역에서 작동을 지원하는 기기

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

기기 상태

이 특성이 있는 엔티티는 QUERY 작업의 일부로 다음 상태를 보고할 수 있습니다. QUERY 인텐트 처리에 대해 자세히 알아보려면 인텐트 처리를 참고하세요.

주 유형 설명
isRunning Boolean

필수사항.

기기가 현재 작동 중인지 여부를 나타냅니다.
isPaused Boolean

기기가 명시적으로 일시중지되었는지 여부를 나타냅니다. 이 값이 true이면 isRunning이 false이지만 재개될 수 있음을 의미합니다. isPaused이 false인 경우 필드는 QUERY 또는 Report State에서만 반환되어야 하며 둘 다에서는 반환되지 않아야 합니다. 두 경우 모두에서 is_paused를 반환하면 상태 차이로 인해 상태 보고 부정확성 오류가 발생할 수 있습니다(MAY).
activeZones 배열

availableZones 목록에서 기기가 현재 실행 중인 영역을 나타냅니다.
[item, ...] 문자열

영역 이름입니다.

예

기기가 일시중지되어 있나요?

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

기기가 일시중지되어 있나요?

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

기기가 실행 중인가요?

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

기기 명령어

이 특성이 있는 기기는 EXECUTE 작업의 일환으로 다음 명령어에 응답할 수 있습니다. EXECUTE 인텐트 처리에 대해 자세히 알아보려면 인텐트 처리를 참고하세요.

action.devices.commands.StartStop

기기를 시작하거나 중지합니다.

매개변수

매개변수 유형 설명
start Boolean

필수사항.

기기 작업을 시작하려면 true, 중지하려면 false입니다.
zone 문자열

실행을 시작할 영역을 나타냅니다.
multipleZones 배열

실행을 시작할 두 개 이상의 영역을 나타냅니다. zone parameter. 대신 설정됩니다.
[item, ...] 문자열

기기를 시작할 영역의 이름입니다.

예

기기를 시작합니다.

{
  "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

기기 오류

오류 및 예외의 전체 목록을 참고하세요.