Variables

Généralités

Quand Tasker rencontre un nom de variable dans un texte, il remplace le nom avec la valeur actuelle de la variable appropriée avec d'effectuer l'action.

Les utilisations principales des variables sont :

• liaison dynamique : faire quelque chose dans une action avec des données inconnues quand la tâche est créée. Par exemple pour répondre à un SMS, l'expéditeur n'est pas connu tant que le SMS n'a pas été reçu.
• permettre le contrôle de flux à l'intérieur et entre les tâches
• enregistrer des données pour utilisation future, comme par exemple passer des données entre les tâches

Durée de vie des variables

Variables internes

• État du mode avion
  (dynamique)
  %AIR
  Indique si le mode avion est actif ou inactif
• Niveau de batterie
  %BATT
  Niveau actuel de la batterie de l'appareil, de 0 à 100.
• État Bluetooth (dynamique)
  %BLUE
  Indique si Bluetooth est actif ou inactif
  
• Nom / Numéro / Date / Heure d'un appel entrant (dynamique, surveillé)
  %CNAME / %CNUM / %CDATE / %CTIME
  Le nom, numéro, date et heure du dernier appel entrant reçu.
  Le numéro d'appelant est 0 s'il est inconnu.
  Le nom d'appelant est ? s'il est inconnu (probablement parce que le numéro d'appelant était caché) et mis au numéro de l'appelant si le contact n'a pas pu être trouvé. Non disponible sur les versions Android inférieures à 2.0.
• Nom / Numéro / Date / Heure d'un appel sortant (dynamique, surveillé)
  %CONAME / %CONUM / %CODATE / %COTIME / %CODUR
  Le nom, numéro, date et heure du dernier appel sortant effectué.
  Le nom de l'appelé est mis au numéro de l'appelé si le contact n'a pas pu être trouvé. Non disponible sur les versions Android inférieures à 2.0.
• ID de cellule (dynamique, surveillé)
  %CELLID
  L'identifiant actuel de la tour de cellule si connu.
  Si vous utilisez un état Cellule proche, notez que l'état Cellule proche restera parfois actif même si %CELLID indique que l'identifiant de tour est inconnu ou invalide; c'est parce que Cellule proche ne répond qu'aux identifiants valides pour éviter que l'état ne devienne inactif à cause d'interruptions de service par exemple.
• Puissance du signal de cellule (dynamique, surveillé)
  %CELLSIG
  Le niveau de signal du téléphone actuel entre et 0 et 8 inclus sur une échelle grossièrement linéaire. Sur certains téléphones CDMA le niveau s'élèvera par pas de 2 (0,2,4,6,8). La valeur est -1 si la valeur est inconnue comme par exemple lors de l'absence de service.
  Un bug existe dans certaines versions d'Android qui fait que le niveau de signal n'est mis à jour que quand l'appareil se réveille ou s'endort.
• État de service de cellule (dynamique, surveillé)
  %CELLSRV
  L'état actuel du service de téléphonie. Une valeur parmi unknown, service, noservice, emergency, nopower.
• Contenu du presse-papiers
  %CLIP
  Le contenu actuel du presse-papiers système.
• Fréquence de CPU
  %CPUFREQ
  La fréquence à laquelle le CPU tourne actuellement. Voir aussi Contrôle de CPU.
• Gouverneur CPU
  %CPUGOV
  Le gouverneur actuel contrôlant la fréquence du CPU. Voir aussi Contrôle de CPU.
• Date
  %DATE
  La date actuelle sous forme lisible par un humain.
• Jour du mois
  %DAYM
  Numéro de jour dans le mois pour le jour actuel, en commençant à 1.
• Jour de la semaine
  %DAYW
  Jour actuel de la semaine, en commençant avec Dimanche.
• Luminosité de l'écran %BRIGHT
  Luminosité de l'écran actuelle, 0-255. Sur certains appareils, si le paramètre luminosité automatique d'Android est activé, la valeur sera toujours 255.
• Délai d'affichage %DTOUT
  Le délai d'affichage système courant (secondes).
• Émetteur/Cc/Sujet/Date/Heure d'email
  (dynamique) %EFROM / %ECC / %ESUBJ / %EDATE / %ETIME
  Les champs Émetteur, Cc, Sujet, Date de réception et Heure de réception du dernier email reçu par l'agent email K9.
• Mémoire libre
  %MEMF
  Mémoire système libre en Mo.
• État GPS
  %GPS
  Indique si le récepteur système GPS est actif ou inactif.
• Code réponse / Données / Longueur de contenu HTTP
  (dynamique) %HTTPR / %HTTPD / %HTTPL
  Valeurs issues de la dernière action HTTP POST/GET.
• État du verrouillage clavier
  %KEYG
  Indique si le verrouillage clavier est actif ou inactif
• Dernière application
  %LAPP
  Le nom de la dernière application qui était en premier plan avant l'application actuelle, par exemple Google Maps.
• Dernière photo
  %FOTO
  Le chemin dans le système de fichiers de la dernière photo prise par Tasker ou l'application appareil photo standard du système.
• Niveau de luminosité (dynamique, surveillé)
  %LIGHT
  La dernière luminosité enregistrée, en lux.
• Lieu (dynamique)
  %LOC
  La latitude et la longitude du dernier accrochage GPS.
  Voir la note.
• Précision de l'accrochage (dynamique)
  %LOCACC
  La précision en mètres du dernier accrochage GPS.
  Voir la note.
• Altitude du lieu (dynamique)
  %LOCALT
  L'altitude en mètres du dernier accrochage GPS, ou 0 si indisponible.
  Voir la note.
• Vitesse instantanée (dynamique)
  %LOCSPD
  La vitesse en mètres/secondes du dernier accrochage GPS ou 0 si indisponible.
  Voir la note.
• Heure d'accrochage du lieu en secondes (dynamique)
  %LOCTMS
  L'heure en secondes du dernier accrochage GPS. Pour obtenir l'âge de l'accrochage, retirez ceci de %TIMES.
  Cette valeur n'est pas affectée tant qu'un décalage entre l'heure GPS et l'heure système n'a pas été calculé (ce qui devrait arriver après le premier accrochage GPS) car la valeur n'a pas de sens jusque là.
  Voir la note.
• Lieu (Réseau) (dynamique)
  %LOCN
  La latitude et la longitude du dernier accrochage de lieu réseau.
  Voir la note.
• Précision de l'accrochage (Réseau) (dynamique)
  %LOCNACC
  La précision en mètres du dernier accrochage de lieu réseau.
  Voir la note.
• Heure d'accrochage du lieu (Réseau) (dynamique)
  %LOCNTMS
  L'heure en secondes du dernier accrochage de lieu réseau. Pour obtenir l'âge de l'accrochage, retirez ceci de %TIMES.
  Voir la note.
• Piste musicale (dynamique)
  %MTRACK
  La piste musicale en cours de lecture (pour les actions Tasker Jouer de la musique et Jouer un répertoire de musique uniquement)
• Muet
  %MUTED
  Indique si le microphone est actuellement muet (on) ou pas (off).
• Titre de notification (surveillé, dynamique)
  %NTITLE
  Le titre de la dernière notification affichée dans la barre d'état. Nécessite que le serveur d'accessibilité de Tasker soit en cours d'exécution (voir les paramètres d'accessibilité d'Android). Les notifications générées par Tasker ne sont pas affichées.
  Pas disponible sous Cupcake.
• Numéro de téléphone
  %PNUM
  Le numéro de téléphone actuel de l'appareil, s'il est en service.
• Profils actif (dynamique)
  %PACTIVE
  Une liste séparée par des virgules des profils nommés actuellement actifs par ordre d'activation. Les noms dupliqués n'apparaissent qu'une fois dans la liste.
• Profils activés (dynamique)
  %PENABLED
  Une liste séparée par des virgules des profils nommés actuellement activés par ordre de création. Les nom dupliqués n'apparaissent qu'une fois dans la liste.
• Itinérance
  %ROAM
  on si l'appareil est en itinérance sur le réseau téléphonique actuel, sinon off.
• Écran (dynamique)
  %SCREEN
  Indique si l'écran est allumé (valeur on) ou éteint (valeur off).
• Mode silence (dynamique)
  %SILENT
  L'état actuel du mode silence : off, vibrate ou on.
• Haut parleur
  %SPHONE
  Indique si le haut parleur est on ou off
• Parole (dynamique)
  %SPEECH
  L'énoncé actuel résultant d'une action Dire ou Dire dans un fichier, si disponible.
• Temps en file en secondes (dynamique)
  %QTIME
  Le nombre de secondes depuis que la tâche actuelle a commencé à s'exécuter. Notez que les tâches peuvent être interrompues par des tâches de plus haute priorité, donc cette valeur n'est pas forcément la durée totale d'exécution de la tâche.
• Réseau téléphonique
  %TNET
  L'opérateur de réseau téléphonique actuel que l'appareil utilise.
  Peut être peu fiable sur les réseaux CDMA
• Expéditeur/Date/Sujet/Heure Texte (surveillé)
  %SMSRF / %SMSRN / %SMSRB / %SMSRD / %MMSRS / %SMSRT
  L'adresse de l'émetteur, son nom, le corps et la date et l'heure du dernier message de texte (SMS ou MMS) reçu.
  Ces variables seront vide jusqu'à la première réception d'un message texte après leur référencement car Tasker ne surveille les SMSs que si c'est nécessaire.
  Le nom de l'appelant est mis à l'adresse de l'appelant si aucun contact n'a pu être trouvé. Non disponible sur les versions d'Android avant la 2.0.
  Sujet sera uniquement renseigné si le dernier message texte était un MMS.
• Heure
  %TIME
  L'heure actuelle sous forme lisible par un humain.
• Heure en secondes
  %TIMES
  L'heure actuelle en secondes.
  (secondes depuis début janvier 1970, pour information).
• Temps depuis le démarrage en secondes
  %UPS
  Le nombre de secondes depuis le dernier démarrage de l'appareil.
• Volume - Alerte/Appel/DTMF/Média/Notification/Sonnerie/Système (dynamique)
  %VOLA / %VOLC / %VOLD / %VOLM / %VOLN / %VOLR / %VOLS
  Niveau actuel du canal audio.
  Sur certains appareils, les changements de volumes ne sont pas vus dynamiquement et sur d'autres pas quand l'application de téléphonie est utilisée.
• Info Wifi
  %WIFII
  Quand une connexion est établie à un point d'accès (AP), affiche des données sous forme lisible par un humain à propos de l'AP. Quand la connexion n'est pas établie affiche des détails sur les plus récents résultats de scan Wifi pour les APs proches.
• État Wifi (dynamique)
  %WIFI
  Indique si le Wifi est on ou off. Remarque : si Wifi est en cours d'activation ou désactivé, en fait tout autre état qu'activé, c'est classé comme étant off.
• État Wimax
  %WIMAX
  Indique si le Wimax est on ou off. Remarque : si Wimax est en cours d'activation ou désactivé, en fait tout autre état qu'activé, c'est classé comme étant off.
• Libellé de fenêtre (surveillé)
  %WIN
  Le libellé de la fenêtre actuelle qui peut être une activité plein écran ou une boite de dialogue.
  Non renseigné si le libellé est inconnu.
  Pour certaines fenêtres, le libellé peut être celui du premier élément dans la fenêtre, comme par exemple une entrée de menu ou même un bouton.

Remarques générales

Les variables signalées dynamique dans l liste ci-dessus déclenchent un changement dans l'état Valeur de variable et l'évènement Variable affectée à chaque fois que leur valeur change.

Les variables signalées surveillé causeront le démarrage du processus de surveillance approprié est effectué pour suivre l'état quand elles sont utilisées dans des contextes ou des tâches qui sont utilisés par des widgets ou des profils activés. Par exemple, %CELLS utilisé dans une action Affichage provoquera le suivi de la localisation de cellule.

Limite : les variables surveillées ne peuvent pas être détectées dans les raccourcis anonymes.

Remarque sur les variables de lieu

Quand le fournisseur approprié (Réseau ou GPS) est actif, ces variables indiquent les valeurs du fournisseur qui peuvent être plus récentes que celles vues par Tasker si d'autres applications ont demandé une localisation.

Quand le fournisseur approprié n'est pas actif, ces variables indiquent les dernières valeurs vues par Tasker, qui pourraient être le résultat d'une action Obtenir un lieu ou de la surveillance pour un Contexte de lieu.

Ceci signifie que les heures d'accrochages peuvent aller dans le passé, si vous coupez le fournisseur de lieu entre deux utilisation des variables.

Variables utilisateur

• ils doivent commencer par le caractère %
• ils sont sensibles à la casse
• ils doivent être longs d'au moins 3 caractères alphanumériques, le premier ne pouvant pas être un numéro
• ils peuvent aussi contenir le caractère de soulignement (_) mais ne peuvent ni démarrer ni finir par celui ci

Variables non initialisées

Les variables utilisateur qui n'ont pas encore eu de valeur affectée ne provoquent pas de remplacement. Par exemple, dans l'expression J'aime %FRUIT, si %FRUIT n'est pas initialisé, l'expression reste telle qu'elle est, sinon %FRUIT est remplacé par sa valeur.

Exception : les variables non initialisées utilisées dans des expressions mathématiques sont remplacées par 0.

Actions sur les variables

D'autre part, vous pouvez lire des lignes ou des paragraphes depuis un fichier texte dans une variable avec les actions Lire une ligne et Lire un paragraphe dans la catégorie Fichier.

Variables dans les Plugins

http://tasker.dinglisch.net/plugins.html

elle contient les détails appropriés.