스마트 홈 EnergyStorage 특성 스키마

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

기기 속성

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

속성 유형 설명
queryOnlyEnergyStorage Boolean

필수.

기기가 저장된 에너지 수준 및 활성 충전 상태 (isRechargeable 속성에 따름)에 관한 쿼리만 지원하지만 충전 시작 및 중지는 지원하지 않는 경우 참입니다.

energyStorageDistanceUnitForUX String

(기본값: "KILOMETERS")

사용자의 응답에 사용됩니다.

지원되는 값:

KILOMETERS
MILES
isRechargeable Boolean

(기본값: false)

이 기기가 충전 가능한 경우 true로 설정합니다. 이는 기기가 capacityUntilFull, isChargingisPluggedIn 상태를 선택적으로 보고할 수 있음을 나타내며 Charge 명령어를 수락할 수 있습니다.

예시

충전 기기

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

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

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

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

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

기기 상태: STATES

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

상태 유형 설명
descriptiveCapacityRemaining String

필수.

에너지 용량 수준을 정성적으로 설명합니다. 이는 숫자 용량 데이터가 없는 경우에 해당합니다. 숫자 용량 데이터도 사용할 수 있는 경우 가능하면 설명하는 것보다 우선합니다.

지원되는 값:

CRITICALLY_LOW
LOW
MEDIUM
HIGH
FULL
capacityRemaining 배열

기기에서 현재 보유하고 있는 에너지 용량에 대한 정보를 보유하는 단위-값 쌍의 배열입니다. 예: 현재 <기기>의 주행 거리 또는 <기기>의 충전비

[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"
}

기기 COMMANDS

이 특성이 있는 기기는 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: 사용자가 연결되지 않은 기기를 충전하려고 했습니다.