power.battery.low (Low battery alert (standard))
power.battery.low: Low battery alert (standard)
power.battery.low · device scope · message query permission Alarm
What it does
Reported when the battery is low (compose leaf: multiple legacy idents map to the same msgType). msgType is power.battery.low. Subscribe to capabilityEvent in callbackFlag. See Receive device messages, setMessageCallback, Event catalog, and Overview and common payload.
Reported fields
Fields inside outputData. Platform fields are described in Overview and common payload.
| Name | Description | Type | Required | Values |
|---|---|---|---|---|
type | Low-battery pack type. 0 camera battery, 1 door lock battery. | enum | no | 0 camera battery; 1 door lock battery |
elePercent | Remaining charge percentage. Range 0–100, step 1, unit %. | int | no | 0–100, step 1, unit % |
Example
{
"msgType": "power.battery.low",
"deviceId": "TESTIPC000012345",
"productId": "56WGTET2",
"outputData": {
"type": "0",
"elePercent": 0
},
"time": 1673406989,
"localTime": "20230111T111629",
"alarmId": "116257862023505xxxx"
}
Minimum permission
The administrator does not need an extra permission on a device they bound. A shared device needs the alarm message permission. A bound sub-user does not. A sub-account needs Alarm. list / search filters out events you are not allowed to see. Battery.