스마트 홈 SensorState Trait 스키마

action.devices.traits.SensorState - 이 특성은 정량적 측정과 정성적 상태를 모두 다룹니다.

기기 속성

이 특성이 있는 기기는 다음을 보고할 수 있습니다. 속성을 SYNC 작업의 일부로 사용할 수 있습니다. 배우기 위해 SYNC 인텐트 처리에 관한 자세한 내용은 인텐트 처리.

속성	유형	설명
sensorStatesSupported	배열	필수사항. 각 객체는 이 특정 기기에서 지원하는 센서 상태 기능을 나타냅니다. 각 센서에는 최소한 설명적 또는 숫자 기능이 있어야 합니다. 센서는 둘 다 보고할 수도 있으며, 이 경우 숫자 값이 선호됩니다.
[item, ...]	객체	지원되는 센서 기능입니다. 항목이 1개 이상 필요합니다.
name	String	필수사항. 지원되는 센서 유형입니다. 지원되는 센서 표를 참고하세요.
descriptiveCapabilities	객체	센서 기능에 관한 설명입니다.
availableStates	배열	필수사항. 기기에 사용 가능한 상태 목록입니다. '알 수 없음' 상태는 센서가 값을 반환하지 않는 경우 암시적으로 지원됩니다.
[item, ...]	String	지원되는 설명 상태 값입니다. 항목이 1개 이상 필요합니다.
numericCapabilities	객체	센서가 보고할 수 있는 가능한 숫자 값을 설명합니다.
rawValueUnit	String	필수사항. 지원되는 숫자 단위입니다.

다양한 센서에 대한 자세한 내용은 지원되는 센서를 참조하세요. 이 트레잇이 지원하는 센서 유형을 알아야 합니다.

예

설명된 상태 값을 보고하는 센서 기기

{
  "sensorStatesSupported": [
    {
      "name": "AirQuality",
      "descriptiveCapabilities": {
        "availableStates": [
          "healthy",
          "moderate",
          "unhealthy",
          "very unhealthy"
        ]
      }
    }
  ]
}

숫자 상태 값을 보고하는 센서 기기

{
  "sensorStatesSupported": [
    {
      "name": "CarbonMonoxideLevel",
      "numericCapabilities": {
        "rawValueUnit": "PARTS_PER_MILLION"
      }
    }
  ]
}

설명 및 숫자 상태 값을 보고하는 센서 기기

{
  "sensorStatesSupported": [
    {
      "name": "SmokeLevel",
      "numericCapabilities": {
        "rawValueUnit": "PARTS_PER_MILLION"
      },
      "descriptiveCapabilities": {
        "availableStates": [
          "smoke detected",
          "high",
          "no smoke detected"
        ]
      }
    }
  ]
}

지원되는 센서

다음 표에는 지원되는 센서 유형과 관련 기능이 나열되어 있습니다.

공기질

이름	설명 기능	숫자 기능
지원되는 값: AirQuality	지원되는 값: healthy moderate unhealthy unhealthy for sensitive groups very unhealthy hazardous good fair poor very poor severe unknown	지원되는 값: AQI

일산화탄소

이름	설명 기능	숫자 기능
지원되는 값: CarbonMonoxideLevel	지원되는 값: carbon monoxide detected high no carbon monoxide detected unknown	지원되는 값: PARTS_PER_MILLION

연기 수치

이름	설명 기능	숫자 기능
지원되는 값: SmokeLevel	지원되는 값: smoke detected high no smoke detected unknown	지원되는 값: PARTS_PER_MILLION

필터 청결도

이름	설명 기능	숫자 기능
지원되는 값: FilterCleanliness	지원되는 값: clean dirty needs replacement unknown	지원되지 않음.

누수

이름	설명 기능	숫자 기능
지원되는 값: WaterLeak	지원되는 값: leak no leak unknown	지원되지 않음.

강수 감지

이름	설명 기능	숫자 기능
지원되는 값: RainDetection	지원되는 값: rain detected no rain detected unknown	지원되지 않음.

필터 수명

이름	설명 기능	숫자 기능
지원되는 값: FilterLifeTime	지원되는 값: new good replace soon replace now unknown	지원되는 값: PERCENTAGE

계산된 필터 수명

이름	설명 기능	숫자 기능
지원되는 값: PreFilterLifeTime HEPAFilterLifeTime Max2FilterLifeTime	지원되지 않음.	지원되는 값: PERCENTAGE

이산화탄소 수치

이름	설명 기능	숫자 기능
지원되는 값: CarbonDioxideLevel	지원되지 않음.	지원되는 값: PARTS_PER_MILLION

미세먼지

이름	설명 기능	숫자 기능
지원되는 값: PM2.5 PM10	지원되지 않음.	지원되는 값: MICROGRAMS_PER_CUBIC_METER

휘발성 유기화합물

이름	설명 기능	숫자 기능
지원되는 값: VolatileOrganicCompounds	지원되지 않음.	지원되는 값: PARTS_PER_MILLION

기기 상태

이 특성을 가진 항목은 다음을 보고할 수 있습니다. QUERY 작업의 일부로 제공됩니다. 배우기 위해 QUERY 인텐트 처리에 관한 자세한 내용은 인텐트 처리.

주	유형	설명
currentSensorStateData	배열	필수사항. 현재 센서 상태의 목록입니다.
[item, ...]	객체	현재 센서 상태입니다.
name	String	필수사항. 센서 상태 이름입니다. sensorStatesSupported의 값과 일치합니다.
currentSensorState	String	현재 설명 상태 값입니다. sensorStatesSupported의 값과 일치합니다.
rawValue	숫자	현재 숫자 센서 값입니다.

다양한 센서에 대한 자세한 내용은 지원되는 센서를 참조하세요. 이 트레잇이 지원하는 센서 유형을 알아야 합니다.

예

설명된 상태 값을 보고하는 센서 기기

{
  "currentSensorStateData": [
    {
      "name": "AirQuality",
      "currentSensorState": "healthy"
    }
  ]
}

숫자 상태 값을 보고하는 센서 기기

{
  "currentSensorStateData": [
    {
      "name": "CarbonMonoxideLevel",
      "rawValue": 200
    }
  ]
}

설명 및 숫자 상태 값을 보고하는 센서 기기

{
  "currentSensorStateData": [
    {
      "name": "SmokeLevel",
      "currentSensorState": "smoke detected",
      "rawValue": 200
    }
  ]
}

기기 명령어

없음

기기 알림

이 트레잇이 있는 기기는 다음을 반환할 수 있습니다. 알림 페이로드를 전송해야 합니다. 배우기 위해 알림 구현에 대한 자세한 내용은 스마트 홈 작업 알림

필드	유형	설명
SensorState	객체	필수사항. 알림 페이로드.
priority	정수	필수사항. 알림 수준을 나타냅니다. 현재 지원되는 값은 0이며, 이 값은 알림을 소리 내어 읽어야 함을 나타냅니다.
name	String	필수사항. 센서 상태 이름입니다. 알림에 지원되는 센서 유형 목록을 참고하세요.
currentSensorState	String	필수사항. 현재 설명 상태 값입니다. 알림에 지원되는 센서 유형 목록을 참고하세요.

알림 페이로드에는 다음 센서 유형이 포함될 수 있습니다.

• AirQuality
• CarbonMonoxideLevel
• SmokeLevel
• FilterCleanliness
• WaterLeak
• RainDetection
• FilterLifeTime

다양한 센서에 대한 자세한 내용은 지원되는 센서를 참조하세요. 각 센서 유형에서 지원하는 기능을 보여줍니다

예

에서 연기가 감지되었습니다.

{
  "SensorState": {
    "priority": 0,
    "name": "SmokeLevel",
    "currentSensorState": "high"
  }
}

기기 ERRORS

전체 목록 보기 오류 및 예외를 방지합니다.