Tâche Get Battery Status

Résumé

Nom interne : GetBatteryStatus
Catégorie : Battery
Objectif : Lire le statut de charge actuel de la batterie. Retourne une chaîne descriptive telle que Charging, Discharging, Full ou Not Charging.
Type de tâche : Normale

Compatibilité

Version AndroMate minimale : 1.1.0
Version AndroMate maximale : 1.1.0
Android minimum : Android 13 (API 33)
Android testé maximum : Android 16 (API 36)
Permissions requises : Aucune

Description détaillée

La tâche Get Battery Status lit le statut de charge actuel depuis le broadcast Android (ACTION_BATTERY_CHANGED). Le résultat est une chaîne descriptive stockée dans value_output.

Aucune permission spéciale n'est requise — ACTION_BATTERY_CHANGED est un broadcast système protégé accessible à toutes les applications.

Paramètres d'entrée

Cette tâche n'a pas de paramètres d'entrée.

Paramètres de sortie

Champ	Type	Condition de déclenchement	Compatibilité Android	Compatibilité AndroMate	Défaut
`value_output`	Chaîne	Toujours en cas de succès — l'une des valeurs : `Charging`, `Discharging`, `Full`, `Not Charging`, `Unknown`	Android 13 (API 33) → Android 16 (API 36)	1.1.0 → 1.1.0	`<ANDROMATE_NULL_VALUE>`

Valeurs de sortie possibles

Valeur	Description
`Charging`	L'appareil est actuellement en charge
`Discharging`	La batterie se décharge — aucun chargeur connecté
`Full`	La batterie est complètement chargée
`Not Charging`	Connecté à un chargeur mais pas en charge (ex. batterie endommagée)
`Unknown`	Le statut n'a pas pu être déterminé

Variables spéciales

Lors de la comparaison de la sortie de cette tâche dans une condition (ex. Compare Strings), vous pouvez utiliser les variables spéciales AndroMate intégrées plutôt que des chaînes codées en dur. Cela évite les fautes de frappe et rend votre workflow plus lisible.

Variable spéciale	Valeur résolue
`${BATTERY_STATUS_CHARGING}`	`"Charging"`
`${BATTERY_STATUS_DISCHARGING}`	`"Discharging"`
`${BATTERY_STATUS_FULL}`	`"Full"`
`${BATTERY_STATUS_NOT_CHARGING}`	`"Not Charging"`
`${BATTERY_STATUS_UNKNOWN}`	`"Unknown"`

Exemple — comparer $statut_batterie avec ${BATTERY_STATUS_CHARGING} dans une tâche Compare Strings plutôt que de saisir "Charging" manuellement.

Exceptions

Cette tâche ne lève pas d'exceptions. Si le statut ne peut pas être lu, "Unknown" est stocké dans value_output.

Diagramme d'exécution

flowchart TD
    Start([▶ GetBatteryStatus]) --> Register[📡 Enregistrer ACTION_BATTERY_CHANGED\nrecepteur ponctuel]

    Register --> ReadStatus[🔋 Lire EXTRA_STATUS\nconvertir en chaîne]

    ReadStatus --> StoreResult[💾 Définir value_output\nStrTaskResult]

    StoreResult --> LogReport[📋 Journaliser le rapport]

    LogReport --> Success([✅ StrTaskResult])

    style Start fill:#e3f2fd
    style Success fill:#c8e6c9
    style Register fill:#fff9c4
    style ReadStatus fill:#f3e5f5
    style StoreResult fill:#c8e6c9

Fonctionnement :

Enregistrer le récepteur batterie : enregistre un récepteur ponctuel pour ACTION_BATTERY_CHANGED
Lire le statut : extrait EXTRA_STATUS et le convertit en chaîne descriptive
Stocker le résultat : définit value_output avec la chaîne de statut
Résultat : retourne StrTaskResult

Exemples de code

Exemple 1 — Lire le statut de batterie

{
  "GetBatteryStatus": [
    {
      "id": "1",
      "title": "Vérifier le statut de la batterie",
      "value_output": "$statut_batterie"
    }
  ]
}

Détails des paramètres d'entrée