BoothDock Studio poate anunța alte programe despre fiecare pas al unei sesiuni (webhook-uri) și se poate lăsa controlat de alte programe (API locală). Pe amândouă le găsești în zona de administrare, la Sistem → Automatizare.
În BoothDock Studio 1.4.0 și în versiunile mai vechi, webhook-urile se numesc acolo încă „Declanșatoare”.
Webhook-urile există pe Windows și, de la versiunea 1.5.10, și pe iPad, iPhone și Mac. API-ul local este disponibil începând cu versiunea 1.4.0 și pe iPad, iPhone și Mac, exportul în timp real începând cu versiunea 1.5.2.
Utilizări tipice: lumini sau DMX sincronizate cu numărătoarea inversă, un overlay pentru stream, un contor la intrare – sau un Stream Deck ca telecomandă pentru cabină.

Configurarea webhook-urilor
Completează câmpul Adresă (URL), pe Windows și câmpul Program – sau pe amândouă. La fiecare eveniment, cabina apelează tot ce este completat:
- Program (doar Windows) – un
.exe,.batsau.cmd. Apel:program <eveniment> <param1> <param2> …. Fiecare valoare ajunge ca argument separat, chiar dacă conține spații. Programul pornește fără fereastră, în propriul folder. Un script PowerShell (.ps1) îl pornești printr-un mic.batpus în fața lui. - Adresă (URL) –
httpsauhttps, apelată prin GET:https://serverul-tau/hook?event_type=<eveniment>¶m1=…¶m2=…. Valorile sunt codificate URL; parametrii care există deja în adresa ta se păstrează.
Pe iPad, iPhone și Mac există doar adresa. Acolo http:// funcționează doar în rețeaua locală (adresă IP sau .local) – deci Shelly, WLED și Tasmota din Wi-Fi funcționează. Adresele de pe internet au nevoie de https://.
Sesiunea nu așteaptă niciodată după webhook-ul tău: programul și apelul rulează în paralel, iar un apel poate dura cel mult 5 secunde. Trimite test trimite imediat un session_start – așa verifici conexiunea fără să pornești o sesiune.
Programul și adresa se pot seta doar direct la cabină, nu prin Hub: o cale de program înseamnă dreptul de a executa ceva pe calculator.
Adresă proprie pentru fiecare eveniment
De la versiunea 1.5.10, la Adresă proprie pentru fiecare eveniment (opțional) poți da în plus fiecărui eveniment propria adresă – de exemplu pentru o priză Shelly, WLED sau Tasmota din Wi-Fi care comută la numărătoarea inversă sau la captură. Exemplu pentru countdown_start: http://192.168.1.50/relay/0?turn=on.
Cabina apelează această adresă în plus față de programul și adresa de mai sus, ca GET simplu, fără valori adăugate. Adresa de până acum și scripturile existente funcționează mai departe neschimbate. countdown vine în fiecare secundă; la file_upload cabina apelează adresa proprie o dată pe sesiune (adresa generală în continuare pentru fiecare fișier).
Evenimente
| Eveniment | Când | Parametri |
|---|---|---|
session_start | Un invitat pornește o sesiune, modul este stabilit | 1: mod (PrintOnly, PrintAndGIF, OnlyGIF, SlowMoOr360, Video), 2: mod BoothDock (photo, gif, boomerang, video, slowmo, ai) |
countdown_start | Începe numărătoarea inversă | 1: secunde |
countdown | Fiecare secundă a numărătorii inverse | 1: progres în procente (de la 0) |
capture_start | Numărătoarea s-a încheiat, începe captura | – |
file_download | Camera a salvat o fotografie | 1: nume de fișier, 2: cale completă |
processing_start | Începe procesarea | câte un nume de fișier pentru fiecare original al camerei, ca ultimă valoare fișierul de imprimare (momentan gol) |
sharing_screen | Apare ecranul cu rezultatul (o dată pe sesiune) | – |
printing | O foaie pleacă la o imprimantă | 1: fișier (momentan gol), 2: copii, 3: imprimantă |
file_upload | Un fișier a ajuns în Hub (pentru fiecare fișier) | 1: cale pe cabină, 2: link de galerie, 3: tip (print, photo, original, animation, boomerang, video), 4: album (numele evenimentului) |
lead_submitted | Un invitat a trimis formularul Datele invitaților (formular) (începând cu 1.5.0) | – (răspunsurile propriu-zise sunt doar în exportul CSV) |
session_end | Sesiunea se încheie – finalizată, anulată, expirată sau ștearsă | – |
Exemplu de .bat care notează fiecare eveniment: echo %DATE% %TIME% %* >> "%~dp0evenimente.log"
API locală
Alte programe controlează cabina prin HTTP – de exemplu un Stream Deck, un script propriu sau o comandă 360° de pe telefon.
- Activare: Sistem → Automatizare → Activează API. Din fabrică, API-ul este oprit. Port 1500, modificabil.
- Adresă:
http://localhost:1500/api/<comanda>(sau127.0.0.1). Din fabrică, cabina acceptă cereri doar de pe acest calculator. - Parolă: 16 caractere, afișată în aceeași secțiune – o copiezi sau generezi una nouă. O trimiți ca
?password=…, ca antetX-Api-Passwordsau caAuthorization: Bearer …. Doarpingmerge fără ea. - Răspuns: întotdeauna HTTP 200 cu JSON, de exemplu
{"ApiVersion":1,"Command":"cancel","IsSuccessful":true,"ErrorMessage":""}. Dacă a reușit afli dinIsSuccessful, iar motivul unei erori dinErrorMessage. Unele comenzi livrează în plusData.
Un apel complet: http://localhost:1500/api/start?mode=print&password=PAROLA-TA
Control din rețea (telefon, tabletă, 360°)
Activează în plus Accesibil și din rețea. Atunci cabina acceptă cereri de la dispozitive din aceeași rețea Wi-Fi/LAN – niciodată din internet.
- Adresa pentru telefon: apare în linia de stare, de exemplu
http://192.168.1.20:1500. Exemplul de dedesubt arată atunci direct adresa potrivită. - Fără introducerea IP-ului: cabina se anunță singură în rețea (mDNS/Bonjour, tip de serviciu
_boothdock._tcp, nume „BoothDock” plus numele calculatorului). Aplicațiile care o caută o găsesc automat. - Blocare: dacă un dispozitiv trimite de zece ori în zece minute o parolă greșită, este blocat 15 minute. Calculatorul cabinei nu este blocat niciodată.
- Doar în rețeaua proprie: parola circulă necriptată prin rețea. Folosește modul de rețea doar în propria rețea Wi-Fi protejată – nu în rețeaua Wi-Fi deschisă pentru invitați a locației.
- Paravanul de protecție (firewall): instalarea creează regula, doar pentru rețele private. Dacă linia de stare arată un avertisment despre paravanul de protecție, reinstalează BoothDock Studio sau permite-l în Windows la „Permiteți o aplicație prin paravanul de protecție”. Dacă Windows tratează rețeaua Wi-Fi ca publică, dispozitivele nu pot intra – setează profilul la Privată în proprietățile rețelei.
Comenzi
| Comandă | Efect |
|---|---|
start?mode=print | Pornește o sesiune. Moduri: print (foto), gif, boomerang, slowmo (360°; fără 360°, boomerang), video, ai. Funcționează doar din ecranul de start, doar cu modul activat și nu când cabina este blocată. Cu șablon, stil și fundal: vezi mai jos. |
auswahl?mode=print | Livrează în Data ce se poate alege în acest mod: vorlagen (Id și nume; gol dacă este permis un singur șablon – acesta se află atunci în vorgabeVorlage), hintergruende pentru fiecare șablon și, în modul ai, stile (de la 1.5.13). |
cancel | Anulează sesiunea în curs și revine la ecranul de start. |
status | Livrează în Data: modul invitat pornit/oprit, ecranul curent, modul, blocată da/nu – de la 1.5.13 și sperrgrund (manuell sau zeitfenster) și oeffnetUm. |
print?count=1 | Tipărește încă o dată ultimul rezultat (1 până la 10 foi). Videoclipurile nu pot fi tipărite. |
lockscreen/show | Blochează cabina cu „Un moment – continuăm imediat.” sau cu propriul tău text și propria imagine (vezi „Ecran de blocare” mai jos). Colțul de administrare rămâne accesibil. De la 1.5.13 blocarea rămâne activă și după o repornire a aplicației. |
lockscreen/exit | Ridică blocarea – de la 1.5.13 și blocarea prin intervalul orar, până la următoarea schimbare. |
share/email?email=… | Trimite ultimul rezultat prin e-mail – necesită cuplarea cu Hub-ul și acțiunea pentru rezultat „Primește prin e-mail” (Sistem → Funcționare → Acțiuni pentru rezultat (invitat); până la 1.4.0, comutatorul „Fotografie prin e-mail (invitat)” de la Design → Ecrane). |
share/sms | Nu există; răspunsul o spune cinstit (IsSuccessful: false). |
createtestevent?name=… | Creează un eveniment de test și îl face activ. Data conține eventId și eventName. Fără nume primește unul cu data. Doar în afara modului invitat (începând cu 1.5.4). |
deletetestevent?eventId=… | Șterge un eveniment de test creat prin API – niciodată alte evenimente. Doar în afara modului invitat (începând cu 1.5.4). |
ping | Verifică fără parolă dacă API-ul rulează. |
Dacă cabina nu răspunde în 15 secunde, primești înapoi IsSuccessful: false cu o indicație.
Pornirea unei sesiuni cu șablon, stil și fundal
De la versiunea 1.5.13, start preia direct alegerea – cabina sare atunci exact peste aceste ecrane de selecție:
vorlage=<Id>(sautemplate=) – șablonul, doar în modulprint(foto). Id-urile le livreazăauswahl?mode=print.stil=<Id>(saustyle=) – stilul AI, doar în modulai.hintergrund=<Id>(saubackground=) – fundalul decupării, potrivit șablonului.
Exemplu: http://localhost:1500/api/start?mode=print&vorlage=hochzeit-gold&hintergrund=strand&password=PAROLA-TA
Un Id necunoscut sau nepotrivit nu pornește nicio sesiune: IsSuccessful este false, iar ErrorMessage indică motivul. Consimțământul privind protecția datelor și formularul cu datele invitaților le afișează în continuare cabina însăși – ele se aplică invitatului din fața cabinei și nu pot fi anticipate prin API.
Ecran de blocare
La Evenimente → Ecran de blocare (de la 1.5.13) stabilești ce afișează o cabină blocată: text propriu, imagine proprie și – la intervalul orar – o numărătoare inversă mare până la deschidere.
- Interval orar per eveniment: Cu Se deschide la și Se închide la, cabina este blocată înainte de început și după sfârșit.
- Deblocare pe dispozitiv: Dacă este configurat un PIN de operator (Sistem → Protecție), ecranul de blocare afișează un mic lacăt. Cine știe PIN-ul deblochează cabina. Deblocată înainte de început, rămâne deschisă până la sfârșit.
- De la distanță: În Hub, sub Cabine, blochezi și deblochezi fiecare cabină care suportă asta (Studio de la 1.5.13). Același lucru funcționează prin BoothDock Station și cu
lockscreen/show/lockscreen/exit.
O sesiune în desfășurare nu este întreruptă nici de blocarea din Hub, nici de intervalul orar – cabina se blochează imediat ce invitatul a terminat.
Export în timp real
În aceeași filă: fiecare fișier finalizat se salvează imediat chiar pe cabină (Copie locală) – și fără Hub, sortat după eveniment și tip (printuri, originale, GIF-uri, videoclipuri – fiecare se poate dezactiva separat). Această copie nu se șterge niciodată automat. În Stick USB / al doilea folder adaugi o a doua destinație: Scrie automat pe stickul USB scrie pe fiecare stick introdus, Recuperează fișierele ratate scrie ulterior ce s-a creat fără stick. Alternativ, indici un Al doilea folder fix (are prioritate), de exemplu un folder cloud (OneDrive, Dropbox). Dacă un invitat își șterge sesiunea la cabină, dispar și copiile. Pe iPad și iPhone: În aplicația Fișiere la „Pe iPadul meu › BoothDock Studio › Export”. În BoothDock Studio 1.5.3 și mai vechi există în schimb doar Folder de export.
Pornire cu telecomanda
În aceeași filă, la Pornire cu telecomanda înveți o tastă. Telecomenzile de prezentare, butoanele USB și pedalele trimit de obicei bara de spațiu; aceasta este presetată. La Pornește alegi ce declanșează tasta pe ecranul de start: Ca la atingere (flux normal) sau direct un mod, de exemplu 360° pe platformă. În BoothDock Studio 1.4.0 și în versiunile mai vechi, tasta există doar pentru 360°, vezi 360° / încetinire.
Depanare
- Nu se întâmplă nimic: apare ceva în jurnal? Webhook-urile scriu în
webhooks.log(până la 1.4.0:ausloeser.log), API-ul înlokale-api.log– ambele în folderul%LocalAppData%\Boothdock Studio\logs(Windows). Cererile respinse (parolă greșită, dispozitiv străin) apar acolo cel mult o dată pe minut. - „Invalid password.” – copiază din nou parola; după Parolă nouă, cea veche nu mai este valabilă.
- „The booth is not on the start screen …” –
startmerge doar din ecranul de start. Întâicancel, apoistart. - „Too many failed attempts …” – dispozitivul a trimis prea des o parolă greșită. Așteaptă 15 minute și verifică parola.
- Telefonul nu ajunge la cabină, dar pe calculator merge totul: aproape întotdeauna e paravanul de protecție Windows sau o rețea Wi-Fi tratată ca publică – vezi mai sus. Linia de stare semnalează ambele cazuri.