스마트 홈 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"
]
}
}
]
}
지원되는 센서
다음 표에는 지원되는 센서 유형과 관련 기능이 나와 있습니다.
공기질
| 이름 | 설명 기능 | 숫자 특성 |
|---|---|---|
지원 값:
|
지원 값:
|
지원 값:
|
일산화탄소
| 이름 | 설명 기능 | 숫자 특성 |
|---|---|---|
지원 값:
|
지원 값:
|
지원 값:
|
연기 수치
| 이름 | 설명 기능 | 숫자 특성 |
|---|---|---|
지원 값:
|
지원 값:
|
지원 값:
|
필터 청결도
| 이름 | 설명 기능 | 숫자 특성 |
|---|---|---|
지원 값:
|
지원 값:
|
지원되지 않음. |
누수
| 이름 | 설명 기능 | 숫자 특성 |
|---|---|---|
지원 값:
|
지원 값:
|
지원되지 않음. |
강수 감지
| 이름 | 설명 기능 | 숫자 특성 |
|---|---|---|
지원 값:
|
지원 값:
|
지원되지 않음. |
전체 기간 필터링
| 이름 | 설명 기능 | 숫자 특성 |
|---|---|---|
지원 값:
|
지원 값:
|
지원 값:
|
계산된 필터의 전체 기간
| 이름 | 설명 기능 | 숫자 특성 |
|---|---|---|
지원 값:
|
지원되지 않음. | 지원 값:
|
이산화탄소 수치
| 이름 | 설명 기능 | 숫자 특성 |
|---|---|---|
지원 값:
|
지원되지 않음. | 지원 값:
|
미립자 물질
| 이름 | 설명 기능 | 숫자 특성 |
|---|---|---|
지원 값:
|
지원되지 않음. | 지원 값:
|
휘발성 유기화합물
| 이름 | 설명 기능 | 숫자 특성 |
|---|---|---|
지원 값:
|
지원되지 않음. | 지원 값:
|
기기 상태
이 특성이 있는 항목은 QUERY 작업의 일부로 다음 상태를 보고할 수 있습니다. QUERY 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
| 상태 | 유형 | 설명 |
|---|---|---|
currentSensorStateData |
배열 |
필수. 현재 센서 상태의 목록입니다. |
[item, ...] |
객체 |
현재 센서 상태입니다. |
name |
String |
필수. 센서 상태 이름입니다. |
currentSensorState |
String |
현재 설명 상태 값입니다. |
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 |
필수. 현재 설명 상태 값입니다. 알림에 지원되는 센서 유형 목록을 참고하세요. |
알림 페이로드에는 다음과 같은 센서 유형이 포함될 수 있습니다.
AirQualityCarbonMonoxideLevelSmokeLevelFilterCleanlinessWaterLeakRainDetectionFilterLifeTime
각 센서 유형에서 지원되는 다양한 기능에 관한 자세한 내용은 지원되는 센서를 참고하세요.
예
{
"SensorState": {
"priority": 0,
"name": "SmokeLevel",
"currentSensorState": "high"
}
}