스마트 홈 EnergyStorage 특성 스키마

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

기기 ATTRIBUTES

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

특성	유형	설명
queryOnlyEnergyStorage	Boolean	필수사항. 기기에서 저장된 에너지 수준 및 활성 충전 상태 (isRechargeable 속성에 종속됨)에 관한 쿼리만 지원하지만 충전 시작 및 중지를 지원하지 않는 경우 true입니다.
energyStorageDistanceUnitForUX	문자열	(기본값: "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	문자열	필수사항. 에너지 용량 수준의 정성적 설명입니다. 이는 숫자 용량 데이터가 없는 경우에 해당합니다. 숫자 용량 데이터도 제공되는 경우 가능하면 설명 데이터보다 이 데이터가 선호됩니다. 지원되는 값: CRITICALLY_LOW LOW MEDIUM HIGH FULL
capacityRemaining	배열	기기가 현재 보유하고 있는 에너지 용량에 관한 정보를 보유하는 단위/값 쌍의 배열입니다. 예: <device> 현재 주행 거리가 몇 마일지 또는 <device> 충전 퍼센트가 얼마야
[item, ...]	객체	단위와 값 쌍의 잔여 용량입니다.
rawValue	정수	필수사항. 용량 값입니다.
unit	문자열	필수사항. 용량 단위입니다. 지원되는 값: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
capacityUntilFull	배열	기기가 완전히 충전될 때까지 용량에 대한 정보를 보유하는 단위/값 쌍의 배열입니다. 예: <device>이(가) 완전히 충전되기까지 걸리는 시간.
[item, ...]	객체	충전 시까지 사용할 수 있는 용량입니다.
rawValue	정수	필수사항. 용량 값입니다.
unit	문자열	필수사항. 용량 단위입니다. 지원되는 값: 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: 사용자가 전원에 연결되지 않은 기기를 충전하려고 했습니다.