view mod_csi_battery_saver/README.markdown @ 2752:d0e75bf21d30

mod_delegation: added disco#items support disco#items are forwarded to managing entity when suitable. This feature is not yet in XEP-0355, but it should be added soon. "http://jabber.org/protocol/disco#items:*" is used as a pseudo-namespace to activate this delegation. Also changed spaces to tabs to follow Prosody coding style.
author Goffi <goffi@goffi.org>
date Sun, 27 Aug 2017 20:46:04 +0200
parents 538c54d2dab3
children 69248dcd7cff
line wrap: on
line source

---
description: CSI module to save battery on mobile devices
labels:
- 'Stage-Alpha'
---

Stanzas are queued in a buffer until either an "important" stanza is
encountered or the buffer becomes full. Then all queued stanzas are sent
at the same time. This way, nothing is lost or reordered while still
allowing for power usage savings by not requiring mobile clients to
bring up their radio for unimportant stanzas.

`IQ` stanzas, smacks "stanzas" and `message` stanzas containing a body are
considered important. Groupchat messages must set a subject or have
the user's username or nickname in their messages to count as "important".
`Presence` stanzas are not "important".

All buffered stanzas that allow timestamping are properly stamped to
reflect their original send time, see [XEP-0203].

Use with other CSI plugins such as [mod_throttle_presence],
[mod_filter_chatstates] or [mod_csi_pump] is *not* supported.
Please use this module instead of [mod_csi_pump] if you want timestamping
and properly handled carbon copies.

The internal stanza buffer of this module is hardcoded to 100 stanzas.