XML identifiers: home_buttoned and #var:HomeButtoned#. This particular pair is per default placed in HBL11/HBV11. Please see example (below).
Purpose: The #var:HomeButtoned# is parameter replaced during heartbeat with the true/false value of the app being put into background (“home-buttoned”) or in the process of termination, per default using the home_buttoned as label. This state will be transferred to the heartbeat logging server, and will either signify that someone has put the app into background (pushed the home button, making the app disappear), or that someone is terminating (“killing”) the app. Note! To be able to signal app termination, heartbeat frequency must be down to the seconds level.
Status: Currently in use.
Category: Heartbeat keys (labels and value).
Usage: Transfers the home buttoned status to the logging server. If another label is wanted, for instance BUTTONED, either change the string of the HBL11 key, or add a pair of BUTTONED and #var:HomeButtoned# as a pair of HBL/HBV in a vacant (or intentionally redefined pair of ) 01-25.
Default: Defaults to the pair of HBL11 = home_buttoned, and HBV11 = #var:HomeButtoned# with the replacement identifier #var:HomeButtoned# being replaced during actual operation with the false (normal operation) or true (going into the background, or being terminated) value, as a string.
Development: Stable, with no current plans for change.
Example:
Choosing to use the WAL HeartBeat Configuration Label 24 and Value 24 pair to transfer heartbeats to logging server, informing about charge level, using a custom defined name battery_level label of BUTTONED:
…
<key>HBL24</key>
<string>BUTTONED</string>
…
<key>HBV24</key>
<string>#var:HomeButtoned#</string>
..
Document Revision: December, 2019. February, 2020. March, 2020. Nov. 2024. Rev. 1.0