스마트 홈 SensorState 특성 스키마

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

기기 상태: STATES

이 특성이 있는 항목은 QUERY 작업의 일부로 다음 상태를 보고할 수 있습니다. QUERY 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

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

이 특성이 지원하는 다양한 기능과 센서 유형에 관한 자세한 내용은 지원되는 센서를 참고하세요.

예시

구체적인 상태 값을 보고하는 센서 기기입니다.

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

숫자 상태 값을 보고하는 센서 기기입니다.

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

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

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

기기 COMMANDS

없음

기기 알림

이 특성이 있는 기기는 기기 상태가 변경될 때 다음 알림 페이로드를 반환할 수 있습니다. 알림 구현에 관한 자세한 내용은 스마트 홈 작업 알림을 참고하세요.

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

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

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

각 센서 유형에 지원되는 다양한 기능에 관한 자세한 내용은 지원되는 센서를 참고하세요.

예시

에서 연기를 감지합니다.

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

기기 ERRORS

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