Tâche Get Battery Level

Résumé

• Nom interne : GetBatteryLevel
• Catégorie : Battery
• Objectif : Lire le niveau de charge actuel de la batterie en pourcentage. Retourne une valeur entre 0 et 100.
• 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 Level lit le niveau de charge actuel de la batterie depuis le broadcast Android (ACTION_BATTERY_CHANGED). Le niveau est exprimé en pourcentage de 0 (vide) à 100 (plein) et est stocké sous forme de chaîne dans value_output.

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

---

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 — pourcentage de batterie sous forme de chaîne numérique (ex. "85")	Android 13 (API 33) → Android 16 (API 36)	1.1.0 → 1.1.0	<ANDROMATE_NULL_VALUE>

---

Exceptions

Cette tâche ne lève pas d'exceptions. Si le niveau de batterie ne peut pas être lu, Android retourne -1, qui est stocké en tant que "-1" dans value_output.

---

Diagramme d'exécution

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

    Register --> ReadLevel[🔋 Lire EXTRA_LEVEL / EXTRA_SCALE\ncalculer le pourcentage]

    ReadLevel --> 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 ReadLevel fill:#f3e5f5
    style StoreResult fill:#c8e6c9

Fonctionnement :

1. Enregistrer le récepteur batterie : enregistre un récepteur ponctuel pour ACTION_BATTERY_CHANGED — aucune permission requise
2. Lire le niveau : extrait EXTRA_LEVEL et EXTRA_SCALE depuis l'intent batterie et calcule (level * 100) / scale
3. Stocker le résultat : définit value_output avec la chaîne de pourcentage
4. Résultat : retourne StrTaskResult

---

Exemples de code

Exemple 1 — Lire le niveau de batterie dans une variable

{
  "GetBatteryLevel": [
    {
      "id": "1",
      "title": "Lire le pourcentage de batterie",
      "value_output": "$niveau_batterie"
    }
  ]
}

---

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

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

---

Détails des paramètres de sortie

value_output — Pourcentage du niveau de batterie

Stocke le niveau de batterie sous forme de chaîne numérique dans la variable workflow spécifiée.

• Plage : "0" (vide) à "100" (plein)
• Exemple : "85" signifie 85 % de batterie restante
• Si le niveau ne peut pas être déterminé, Android retourne -1

---

Exemple JSON complet

{
  "GetBatteryLevel": [
    {
      "id": "1",
      "title": "Get Battery Level",
      "value_output": "$BATTERY_LEVEL"
    }
  ]
}