Aller au contenu

Tâche Get Battery Temperature

Résumé

  • Nom interne : GetBatteryTemperature
  • Catégorie : Battery
  • Objectif : Lire la température actuelle de la batterie en degrés Celsius. Utile pour détecter les conditions de surchauffe lors des tests automatisés.
  • 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 Temperature lit la température de la batterie depuis le broadcast Android (ACTION_BATTERY_CHANGED). Android reporte la température en dixièmes de degré Celsius (ex. 365 = 36,5 °C). Cette tâche effectue automatiquement la conversion en valeur décimale avant de la stocker 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 — température de la batterie sous forme de chaîne décimale en °C (ex. "36.5") 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 température ne peut pas être lue, Android retourne 0, qui est stocké en tant que "0.0" dans value_output.


Diagramme d'exécution

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

    Register --> ReadTemp[🌡️ Lire EXTRA_TEMPERATURE\ndiviser par 10.0]

    ReadTemp --> 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 ReadTemp 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 température : extrait EXTRA_TEMPERATURE (en dixièmes de °C) et divise par 10.0
  3. Stocker le résultat : définit value_output avec la chaîne de température en °C
  4. Résultat : retourne StrTaskResult

Exemples de code

Exemple 1 — Lire la température de la batterie

{
  "GetBatteryTemperature": [
    {
      "id": "1",
      "title": "Vérifier la température de la batterie",
      "value_output": "$temp_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 — Température de la batterie en °C

Stocke la température de la batterie sous forme de chaîne décimale en degrés Celsius.

  • Exemple : "36.5" signifie 36,5 °C
  • Plage typique : 20.0 à 45.0 dans des conditions normales
  • Android fournit la valeur en dixièmes de degré — cette tâche divise par 10.0 automatiquement

Exemple JSON complet

{
  "GetBatteryTemperature": [
    {
      "id": "1",
      "title": "Get Battery Temperature",
      "value_output": "$BATTERY_TEMP"
    }
  ]
}