Déclencheurs (triggers)
Guide d'intégration · BoothApp pour Windows
Les déclencheurs permettent de connecter BoothApp au monde extérieur : piloter des lumières, un bandeau LED, une machine à fumée, ou notifier vos propres applications à chaque moment clé d'une session photo. Deux canaux, utilisables ensemble ou séparément, se configurent dans Réglages → Général → Déclencheurs :
- Application : BoothApp lance votre script ou programme (
.bat,.exe,.cmd…) avec le type d'événement et ses paramètres en arguments de ligne de commande. - URL : BoothApp appelle votre URL en
GETavec les mêmes informations en paramètres de requête.
1. Les événements envoyés
| Événement | Moment | Paramètres |
|---|---|---|
session_start | Un invité démarre une session photo. | — |
countdown_start | Le compte à rebours d'une photo démarre. | param1 = secondes (ex. 3) |
capture_start | La photo est sur le point d'être prise. | — |
processing_start | Toutes les photos sont prises, le montage se prépare. | — |
sharing_screen | L'écran de partage (fin de session) s'affiche. | — |
printing | Une impression part vers l'imprimante. | param1 = fichier imprimé, param2 = nombre de copies |
session_end | L'invité quitte l'écran de partage (ou retour automatique). | — |
2. Canal « Application »
Votre programme est lancé à chaque événement, avec le type d'événement en premier argument :
C:\monscript.bat [type_evenement] [param1] [param2]
Exemple de .bat qui allume une lumière au début du compte à rebours :
@echo off if "%~1"=="countdown_start" curl "http://192.168.1.50/lumiere/on" if "%~1"=="session_end" curl "http://192.168.1.50/lumiere/off"
Dans un script batch, les arguments se lisent avec %~1, %~2, %~3.
3. Canal « URL »
BoothApp appelle votre URL en GET et ajoute event_type, puis
param1, param2… en paramètres de requête :
http://127.0.0.1:8000/booth?event_type=countdown_start¶m1=3
Idéal pour un petit serveur local (domotique, Node-RED, Home Assistant…) ou un webhook. L'appel a un délai maximum de 5 secondes et n'est jamais bloquant.
4. Bon à savoir
- Les déclencheurs sont « fire and forget » : un script en erreur ou une URL injoignable ne ralentit ni ne bloque jamais la session de l'invité.
- Ils se configurent par machine (le chemin du script est local à la borne) et ne sont pas synchronisés entre vos PC.
- Champ vide = canal désactivé. Les deux champs vides = aucun déclencheur.
- Les noms d'événements sont compatibles avec les scripts écrits pour d'autres logiciels photobooth du marché — vos intégrations existantes se branchent telles quelles.