스마트 홈 EnergyStorage 특성 스키마

action.devices.traits.EnergyStorage: 이 특성은 배터리에 에너지를 저장하고 충전할 수 있는 기기 또는 다른 기기를 충전할 수 있는 기기에 속합니다.

기기 속성

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

속성	유형	설명
queryOnlyEnergyStorage	Boolean	필수. 기기가 저장된 에너지 수준 및 선택적으로 활성 충전 상태 (isRechargeable 속성에 따라 다름)에 관한 쿼리만 지원하고 충전 시작 및 중지는 지원하지 않는 경우 true입니다.
energyStorageDistanceUnitForUX	String	(기본값: "KILOMETERS") 사용자의 응답에 사용됩니다. 지원 값: KILOMETERS MILES
isRechargeable	Boolean	(기본값: false) 기기를 충전할 수 있는 경우 true로 설정합니다. 이는 기기가 capacityUntilFull, isCharging 및 선택적으로 isPluggedIn 상태를 보고할 수 있으며 Charge 명령어를 수락할 수 있음을 나타냅니다.

예

충전 기기

{
  "isRechargeable": true,
  "queryOnlyEnergyStorage": false
}

현재 충전 수준을 마일 단위로 표시하는 충전식 기기

{
  "isRechargeable": true,
  "energyStorageDistanceUnitForUX": "MILES",
  "queryOnlyEnergyStorage": false
}

현재 충전 수준 보고만 지원하는 충전 불가능한 기기

{
  "isRechargeable": false,
  "queryOnlyEnergyStorage": true
}

기기 상태

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

상태	유형	설명
descriptiveCapacityRemaining	String	필수. 에너지 용량 수준에 관한 정성적 설명 숫자 용량 데이터가 없는 경우에 해당합니다. 숫자 용량 데이터도 사용할 수 있는 경우 가능하면 데이터를 설명하는 것보다 우선으로 사용합니다. 지원 값: CRITICALLY_LOW LOW MEDIUM HIGH FULL
capacityRemaining	배열	기기가 현재 보유하고 있는 에너지 용량에 대한 정보를 보유하는 단위/값 쌍의 배열입니다. 예: 내 <기기>의 거리는 얼마야 또는 내 <기기>의 배터리 잔량
[item, ...]	객체	단위 및 값 쌍의 잔여 용량
rawValue	정수	필수. 용량 값입니다.
unit	String	필수. 용량 단위입니다. 지원 값: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
capacityUntilFull	배열	기기가 완전히 충전될 때까지 용량 정보를 포함하는 단위/값 쌍의 배열입니다. 예: <기기>가 완전히 충전될 때까지 걸리는 시간
[item, ...]	객체	충전 완료까지 수용 인원
rawValue	정수	필수. 용량 값입니다.
unit	String	필수. 용량 단위입니다. 지원 값: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
isCharging	Boolean	기기가 현재 충전 중인지 여부
isPluggedIn	Boolean	기기가 현재 전원에 연결되어 있는지 여부를 나타냅니다. 기기를 전원에 연결할 수는 있지만 충전 중이 아닙니다.

예

충전 기기

{
  "descriptiveCapacityRemaining": "HIGH",
  "capacityRemaining": [
    {
      "rawValue": 36000,
      "unit": "SECONDS"
    },
    {
      "rawValue": 90,
      "unit": "PERCENTAGE"
    }
  ],
  "capacityUntilFull": [
    {
      "rawValue": 120,
      "unit": "SECONDS"
    }
  ],
  "isCharging": true,
  "isPluggedIn": true
}

현재 충전 수준을 마일 단위로 표시하는 충전식 기기

{
  "descriptiveCapacityRemaining": "CRITICALLY_LOW",
  "capacityRemaining": [
    {
      "rawValue": 12,
      "unit": "MILES"
    }
  ],
  "capacityUntilFull": [
    {
      "rawValue": 6000,
      "unit": "SECONDS"
    }
  ],
  "isCharging": true,
  "isPluggedIn": true
}

현재 충전 수준 보고만 지원하는 충전 불가능한 기기

{
  "descriptiveCapacityRemaining": "LOW"
}

기기 명령어

이 특성이 있는 기기는 EXECUTE 작업의 일부로 다음 명령어에 응답할 수 있습니다. EXECUTE 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

action.devices.commands.Charge

충전을 시작하거나 중지합니다.

이 명령어에는

{
  "isRechargeable": true
}

속성이 필요합니다.

매개변수

매개변수	유형	설명
charge	Boolean	필수. 충전을 시작하려면 True, 충전을 중지하려면 False로 설정합니다.

예

충전 시작하기

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": true
  }
}

충전 중지 명령어

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": false
  }
}

기기 오류

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

deviceUnplugged: 사용자가 전원에 연결되지 않은 기기를 충전하려고 했습니다.