kdeconnect-kde/plugins/battery
Adam Pigg ebc316f703 Add a method for creating simple notifications
Summary:
Add a helper function to the daemon interface, which must be subclassed
by the implementations, which creates a simple notification.

For more complex needs, involving interacting with the notification, it
will still be nescessary to use KNotification directly, but this allows
for other future implementations to create a simple notification without
ifdef'ing the code.

Reviewers: kdeconnect, apol

Reviewed By: apol

Subscribers: kdeconnect

Differential Revision: https://phabricator.kde.org/D11104
2018-03-18 12:52:22 +01:00
..
batterydbusinterface.cpp Make member variable names, & placement and * placement more coherent 2017-09-03 21:45:08 +02:00
batterydbusinterface.h Make member variable names, & placement and * placement more coherent 2017-09-03 21:45:08 +02:00
batteryplugin.cpp Add a method for creating simple notifications 2018-03-18 12:52:22 +01:00
batteryplugin.h Rename NetworkPackage -> NetworkPacket 2018-03-05 20:03:23 +01:00
CMakeLists.txt Add a method for creating simple notifications 2018-03-18 12:52:22 +01:00
kdeconnect_battery.json Remove unused "Encoding": "UTF-8" from plugins' metadata JSON 2018-03-17 23:32:27 +01:00
README Move the plugins into a different top-ĺevel directory 2014-06-14 16:34:11 +02:00

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)

<TODO>
Symmetrically, it sends its own battery information in packages with the same
format.
</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.