스마트 홈 EnergyStorage 특성 스키마
action.devices.traits.EnergyStorage
: 이 특성은 배터리에 에너지를 저장하여 충전할 수 있는 기기 또는 다른 기기를 충전할 수 있는 기기에 속합니다.
기기 ATTRIBUTES
이 특성이 있는 기기는 SYNC
작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
특성 | 유형 | 설명 |
---|---|---|
queryOnlyEnergyStorage |
Boolean |
필수사항. 기기에서 저장된 에너지 수준 및 활성 충전 상태 ( |
energyStorageDistanceUnitForUX |
문자열 |
(기본값: 사용자에 대한 응답에 사용됩니다. 지원되는 값:
|
isRechargeable |
Boolean |
(기본값: 기기를 충전할 수 있으면 true로 설정합니다. 기기가 |
예
충전식 기기
{ "isRechargeable": true, "queryOnlyEnergyStorage": false }
현재 충전 수준을 마일 단위로 표시하는 충전식 기기
{ "isRechargeable": true, "energyStorageDistanceUnitForUX": "MILES", "queryOnlyEnergyStorage": false }
현재 충전 수준 보고만 지원하는 재충전 불가능 기기
{ "isRechargeable": false, "queryOnlyEnergyStorage": true }
기기 상태
이 특성을 가진 항목은 QUERY
작업의 일부로 다음 상태를 보고할 수 있습니다. QUERY
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
상태 | 유형 | 설명 |
---|---|---|
descriptiveCapacityRemaining |
문자열 |
필수사항. 에너지 용량 수준의 정성적 설명입니다. 이는 숫자 용량 데이터가 없는 경우에 해당합니다. 숫자 용량 데이터도 제공되는 경우 가능하면 설명 데이터보다 이 데이터가 선호됩니다. 지원되는 값:
|
capacityRemaining |
배열 |
기기가 현재 보유하고 있는 에너지 용량에 관한 정보를 보유하는 단위/값 쌍의 배열입니다. 예: <device> 현재 주행 거리가 몇 마일지 또는 <device> 충전 퍼센트가 얼마야 |
[item, ...] |
객체 |
단위와 값 쌍의 잔여 용량입니다. |
rawValue |
정수 |
필수사항. 용량 값입니다. |
unit |
문자열 |
필수사항. 용량 단위입니다. 지원되는 값:
|
capacityUntilFull |
배열 |
기기가 완전히 충전될 때까지 용량에 대한 정보를 보유하는 단위/값 쌍의 배열입니다. 예: <device>이(가) 완전히 충전되기까지 걸리는 시간. |
[item, ...] |
객체 |
충전 시까지 사용할 수 있는 용량입니다. |
rawValue |
정수 |
필수사항. 용량 값입니다. |
unit |
문자열 |
필수사항. 용량 단위입니다. 지원되는 값:
|
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
: 사용자가 전원에 연결되지 않은 기기를 충전하려고 했습니다.