kdeconnect-kde

History

Alexander Lohnau 1631ada5b3 Simplify KDEConnectPlugin::recievePacket - We do not need the return type. If a plugin declares it can handle the packet it should do so. We don't have any fallback logic in place and the packet types are namespaced with the plugin IDs anyway. - Provide a default implementation with a warning, not all plugins need to overwrite this		2023-08-03 20:49:44 +02:00
..
batteryplugin.cpp	Simplify KDEConnectPlugin::recievePacket	2023-08-03 20:49:44 +02:00
batteryplugin.h	Simplify KDEConnectPlugin::recievePacket	2023-08-03 20:49:44 +02:00
CMakeLists.txt	Use versionless Qt targets where possible	2023-07-25 18:29:38 +02:00
kdeconnect_battery.json	SVN_SILENT made messages (.desktop file) - always resolve ours	2023-08-01 01:39:50 +00:00
README	Finally, we have support for sending out Battery information.	2020-04-13 05:54:11 +00:00

README

This plugins receives packages with type "kdeconnect.battery" and reads the
following fields:

isCharging (boolean): If the battery of the peer device is charging
currentCharge (int): The charge % of the peer device
thresholdEvent (int) [optional when = 0, see below]:
    means that a battery threshold event were fired on the remote device:
        0 := no event. generally not transmitted.
        1 := battery entered in low state
    This is an int so in the future we'll be able to subscribe to more events.
    (see BatteryPlugin.ThresholdBatteryEvent)

Symmetrically, it sends its own battery information in packages with the same
format. We only look for the 'primary' battery of the system, if one is present.

<TODO>
Support for devices with multiple batteries isn't there yet.
</TODO>

It also sends packages with type kdeconnect.battery and a field "request": true,
to ask the peer device to send a package like the mentioned above, and should
also answer this same kind of packages with its own information.

If the battery is low and discharging, it will notify the user.