스마트 홈 에너지 스토리지 트레잇 스키마

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

기기 속성

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

속성	유형	설명
queryOnlyEnergyStorage	Boolean	필수사항. 기기가 저장된 에너지 수준 및 활성 충전 상태 (isRechargeable 속성에 따름)에 관한 쿼리만 지원하고 충전 시작 및 중지는 지원하지 않는 경우 참입니다.
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	배열	기기가 현재 보유하고 있는 에너지 용량에 관한 정보를 담고 있는 단위/값 쌍의 배열입니다. 예: 내 <device> 몇 마일이지 현재 보유 중인 기기 또는 내 <기기> 충전율은 얼마야?
[item, ...]	객체	단위 및 값 쌍의 잔여 용량입니다.
rawValue	정수	필수사항. 용량 값입니다.
unit	String	필수사항. 용량 단위입니다. 지원되는 값: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
capacityUntilFull	배열	기기가 완전히 충전될 때까지 용량에 관한 정보를 보유하는 단위/값 쌍의 배열입니다. 예: <device>까지 남은 시간 완전히 충전됨을 선택합니다.
[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
  }
}

기기 ERRORS

전체 목록 보기 오류 및 예외를 방지합니다.

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