스마트 홈 SensorState 트레잇 스키마

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

기기 ATTRIBUTES

이 특성이 있는 기기는 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 Number

현재 숫자 센서 값입니다.

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

예시

설명 값을 보고하는 센서 기기입니다.

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

기기 오류

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