Aller au contenu

Tâche Get Charging Type

Résumé

  • Nom interne : GetChargingType
  • Catégorie : Battery
  • Objectif : Lire le type de chargeur actuellement connecté à l'appareil. Retourne USB, AC, Wireless ou None.
  • 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 Charging Type lit le type de chargeur depuis le broadcast Android (ACTION_BATTERY_CHANGED). Le résultat indique si l'appareil est connecté via USB, un adaptateur secteur AC, une charge sans fil, ou s'il n'est connecté à aucun chargeur. Le résultat 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.


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 : USB, AC, Wireless, None Android 13 (API 33) → Android 16 (API 36) 1.1.0 → 1.1.0 <ANDROMATE_NULL_VALUE>

Valeurs de sortie possibles

Valeur Description
USB L'appareil se charge via une connexion USB
AC L'appareil se charge via un adaptateur secteur
Wireless L'appareil se charge sans fil (Qi ou similaire)
None Aucun chargeur n'est connecté

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
${CHARGING_TYPE_USB} "USB"
${CHARGING_TYPE_AC} "AC"
${CHARGING_TYPE_WIRELESS} "Wireless"
${CHARGING_TYPE_NONE} "None"

Exemple — comparer $type_charge avec ${CHARGING_TYPE_AC} dans une tâche Compare Strings plutôt que de saisir "AC" manuellement.


Exceptions

Cette tâche ne lève pas d'exceptions. Si aucun chargeur n'est connecté, "None" est stocké dans value_output.


Diagramme d'exécution

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

    Register --> ReadPlugged[🔌 Lire EXTRA_PLUGGED\nconvertir en chaîne]

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

Fonctionnement :

  1. Enregistrer le récepteur batterie : enregistre un récepteur ponctuel pour ACTION_BATTERY_CHANGED
  2. Lire l'état branché : extrait EXTRA_PLUGGED et convertit la constante entière en chaîne de type de chargeur
  3. Stocker le résultat : définit value_output avec la chaîne du type de chargeur
  4. Résultat : retourne StrTaskResult

Exemples de code

Exemple 1 — Lire le type de chargeur

{
  "GetChargingType": [
    {
      "id": "1",
      "title": "Vérifier le type de chargeur",
      "value_output": "$type_charge"
    }
  ]
}

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 — Type de chargeur

Stocke le type de chargeur connecté sous forme de chaîne dans la variable workflow spécifiée.

  • L'une des valeurs USB, AC, Wireless, None
  • None signifie qu'aucun chargeur n'est connecté
  • Astuce : comparer avec les variables spéciales ${CHARGING_TYPE_*} plutôt que des chaînes en dur

Exemple JSON complet

{
  "GetChargingType": [
    {
      "id": "1",
      "title": "Get Charging Type",
      "value_output": "$CHARGING_TYPE"
    }
  ]
}