스마트 홈 작업을 개발하는 방법을 알아볼 수 있는 새로운 공간인 Google Home 개발자 센터에 오신 것을 환영합니다. 참고: Actions 콘솔에서 작업을 계속 만들 수 있습니다.
컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

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

기기 오류

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