Aller au contenu

Tâche Is Charging

Résumé

  • Nom interne : IsCharging
  • Catégorie : Battery
  • Objectif : Vérifier si l'appareil est actuellement en charge. Oriente l'exécution du workflow selon l'état de charge — true si un chargeur est connecté, false sinon.
  • Type de tâche : Condition

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 Is Charging lit le statut de charge de la batterie depuis le broadcast Android (ACTION_BATTERY_CHANGED) et évalue si l'appareil est activement en charge. Elle agit comme un nœud de condition dans le workflow : le workflow prend la branche true si l'appareil est en charge, et la branche false sinon.

Un appareil est considéré en charge si EXTRA_STATUS est égal à BATTERY_STATUS_CHARGING ou BATTERY_STATUS_FULL.

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 configurables.


Paramètres de sortie

C'est une tâche de type Condition — elle ne stocke pas de valeur. Elle oriente plutôt l'exécution du workflow :

Condition Prochaine étape
L'appareil est en charge (statut = Charging ou Full) Branche true
L'appareil n'est pas en charge Branche false

Exceptions

Cette tâche ne lève pas d'exceptions.


Diagramme d'exécution

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

    Register --> ReadStatus[🔋 Lire EXTRA_STATUS]

    ReadStatus --> CheckCharging{Statut = Charging\nou Full ?}

    CheckCharging -->|Oui| TrueBranch([✅ Branche true])
    CheckCharging -->|Non| FalseBranch([❌ Branche false])

    style Start fill:#e3f2fd
    style TrueBranch fill:#c8e6c9
    style FalseBranch fill:#ffcdd2
    style Register fill:#fff9c4
    style ReadStatus fill:#f3e5f5
    style CheckCharging fill:#fff9c4

Fonctionnement :

  1. Enregistrer le récepteur batterie : enregistre un récepteur ponctuel pour ACTION_BATTERY_CHANGED
  2. Lire le statut : extrait EXTRA_STATUS depuis l'intent batterie
  3. Évaluer la condition : si le statut est BATTERY_STATUS_CHARGING ou BATTERY_STATUS_FULL, prend la branche true ; sinon prend la branche false

Exemples de code

Exemple 1 — Orienter le workflow selon l'état de charge

{
  "IsCharging": [
    {
      "id": "1",
      "title": "L'appareil est-il en charge ?"
    }
  ]
}

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

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


Détails des paramètres de sortie

C'est une tâche de type Condition — elle ne stocke aucune variable de sortie. Le résultat pilote le branchement du workflow :

Branche true

Prise lorsque EXTRA_STATUS est égal à BATTERY_STATUS_CHARGING ou BATTERY_STATUS_FULL.

Branche false

Prise lorsque l'appareil n'est pas en charge.


Exemple JSON complet

{
  "IsCharging": [
    {
      "id": "1",
      "title": "Is Charging"
    }
  ]
}