Tâche Get Battery Voltage

Résumé

• Nom interne : GetBatteryVoltage
• Catégorie : Battery
• Objectif : Lire la tension actuelle de la batterie en millivolts (mV). Utile pour les diagnostics matériels et la surveillance de la santé de la batterie.
• 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 Voltage lit la tension actuelle de la batterie depuis le broadcast Android (ACTION_BATTERY_CHANGED). La tension est retournée en millivolts sous forme de chaîne numérique (ex. "4200" pour 4,2 V) et 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 — tension de la batterie en millivolts sous forme de chaîne numérique (ex. "4200")	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 la tension ne peut pas être lue, Android retourne 0, qui est stocké en tant que "0" dans value_output.

---

Diagramme d'exécution

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

    Register --> ReadVoltage[⚡ Lire EXTRA_VOLTAGE\nen millivolts]

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

Fonctionnement :

1. Enregistrer le récepteur batterie : enregistre un récepteur ponctuel pour ACTION_BATTERY_CHANGED
2. Lire la tension : extrait EXTRA_VOLTAGE en millivolts
3. Stocker le résultat : définit value_output avec la chaîne de tension en mV
4. Résultat : retourne StrTaskResult

---

Exemples de code

Exemple 1 — Lire la tension de la batterie

{
  "GetBatteryVoltage": [
    {
      "id": "1",
      "title": "Lire la tension de la batterie",
      "value_output": "$tension_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 — Tension de la batterie en mV

Stocke la tension de la batterie sous forme de chaîne numérique en millivolts.

• Exemple : "4200" signifie 4,2 V (4200 mV)
• Plage typique : 3200 mV (presque vide) à 4350 mV (complètement chargé), varie selon la chimie de la batterie
• Diviser par 1000 dans un workflow pour convertir en volts

---

Exemple JSON complet

{
  "GetBatteryVoltage": [
    {
      "id": "1",
      "title": "Get Battery Voltage",
      "value_output": "$BATTERY_VOLTAGE"
    }
  ]
}