Aller au contenu

Tâche Vibrate

Résumé

  • Nom interne : Vibrate
  • Catégorie : Notifications
  • Objectif : Faire vibrer l'appareil pendant une durée donnée. La tâche attend la fin de la vibration avant de continuer.
  • 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 : VIBRATE

Description détaillée

La tâche Vibrate déclenche une vibration ponctuelle via le VibratorManager de l'appareil. Elle fonctionne en arrière-plan (foreground service) sans restriction supplémentaire.

Deux garde-fous sont intégrés :

  • Durée plafonnée : la durée est limitée à un maximum de 10 000 ms (10 s) — une demande d'une heure ne fera vibrer que 10 secondes.
  • Attente de la fin : la tâche bloque pendant la durée (plafonnée) afin que le timing du workflow reste déterministe et que la vibration soit garantie terminée avant la tâche suivante.

Paramètres d'entrée

Paramètre Type Requis Valeurs possibles / Règles Compatibilité Android Compatibilité AndroMate Défaut
duration_ms Integer Non Durée de vibration en ms — plafonnée à 10000 Android 13 (API 33) → Android 16 (API 36) 1.1.0 → 1.1.0 500

Paramètres de sortie

Cette tâche ne produit aucune variable de sortie. Elle retourne un VoidResult.

Exceptions

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

Diagramme d'exécution

flowchart TD
    Start([▶ Vibrate]) --> Cap[⛔ Plafonnement à 10000 ms max]

    Cap --> Vibrate[📳 VibratorManager.vibrate]

    Vibrate --> Wait[⏳ Attente de la durée]

    Wait --> Success([✅ VoidResult])

    style Start fill:#e3f2fd
    style Success fill:#c8e6c9
    style Cap fill:#fff9c4
    style Vibrate fill:#f3e5f5
    style Wait fill:#fff9c4

Fonctionnement :

  1. Plafonnement : duration_ms est limité à 10000 ms
  2. Vibration : une vibration ponctuelle est déclenchée avec l'amplitude par défaut
  3. Attente : la tâche bloque pendant la durée effective (plafonnée)
  4. Résultat : retourne VoidResult

Exemples de code

Exemple 1 — Vibration courte

{
  "Vibrate": [
    {
      "id": "1",
      "title": "Buzz",
      "duration_ms": 500
    }
  ]
}

Exemple 2 — Vibration plus longue (toujours plafonnée à 10s)

{
  "Vibrate": [
    {
      "id": "2",
      "title": "Buzz long",
      "duration_ms": 3000
    }
  ]
}

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

duration_ms — Durée de vibration

Durée de la vibration en millisecondes.

  • Défaut : 500
  • Maximum : 10000 ms (10 s) — toute valeur supérieure est silencieusement plafonnée
  • La tâche attend cette durée (plafonnée) avant de continuer

Détails des paramètres de sortie

Cette tâche ne produit aucune variable de sortie.

Exemple JSON complet

{
  "Vibrate": [
    {
      "id": "1",
      "title": "Vibrate",
      "duration_ms": 800
    }
  ]
}