스마트 홈 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

기기 상태

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

주 유형 설명
currentSensorStateData 배열

필수사항.

현재 센서 상태 목록입니다.
[item, ...] 객체

현재 센서 상태입니다.
name String

필수사항.

센서 상태 이름입니다. sensorStatesSupported의 값과 일치합니다.
currentSensorState String

현재 설명 상태 값입니다. sensorStatesSupported의 값과 일치합니다.
rawValue 숫자

현재 숫자 센서 값입니다.
alarmState String

현재 센서 판독값에 해당하는 경보 상태입니다. 센서 판독값이 위험 수준에 근접하거나 도달하면 사전 알람 또는 경보가 트리거될 수 있습니다.

지원되는 값:

IDLE
알람이 유휴 상태입니다. 감지된 수준은 위험하지 않습니다.
PRE_ALARM_1
감지된 수준이 높지만 아직 비상 수준에 도달하지는 않았습니다. 곧 위험해질 수 있습니다.
PRE_ALARM_2
기기가 응급 수준에 도달하기 전에 여러 알림을 지원하는 경우 PRE_ALARM_1보다 높은 감지 수준을 나타냅니다. 즉, 수준이 계속 증가하여 곧 응급 수준에 도달할 수 있습니다.
ALARM
감지된 수준이 비상 수준에 도달하여 알람이 트리거되었습니다.
alarmSilenceState String

현재 활성 경보의 음소거가 허용되는지 여부를 비롯하여 센서 경보의 음소거 상태를 나타냅니다. 이 상태는 전 알람 또는 알람 상태가 활성화되어 있을 때 제공될 수 있습니다.

지원되는 값:

ALLOWED
알람이 음소거되지 않았으며 현재 알람 음소거가 허용됩니다.
DISALLOWED
알람이 울리지 않으며 현재 알람을 끌 수 없습니다.
SILENCED
알람이 음소거되었습니다.

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

예

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

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

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

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

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

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

설명적이고 숫자 상태 값을 보고하고 알람이 활성화되었음을 나타내는 센서 기기

{
  "currentSensorStateData": [
    {
      "name": "SmokeLevel",
      "currentSensorState": "smoke detected",
      "rawValue": 200,
      "alarmState": "ALARM",
      "alarmSilenceState": "DISALLOWED"
    }
  ]
}

기기 명령어

없음

기기 알림

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

필드 유형 설명
SensorState 객체

필수사항.

알림 페이로드.
priority 정수

필수사항.

알림 수준을 나타냅니다. 현재 지원되는 값은 0으로, 알림을 소리내어 읽어야 함을 나타냅니다.
name String

필수사항.

센서 상태 이름입니다. 알림에 지원되는 센서 유형 목록을 참고하세요.
currentSensorState String

필수사항.

현재 설명 상태 값입니다. 알림에 지원되는 센서 유형 목록을 참고하세요.

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

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

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

예

연기가 감지되었습니다.

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

기기 오류

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