أزرار فعلية: زر ألعاب ودواسة وجهاز تحكم عرض
صِل الزر عبر USB فيعمل، دون أي إعداد. في شاشة الترحيب يبدأ الضغط الجلسة؛ وفي المعاينة المباشرة يلتقط الصورة أو يوقف الفيديو. وفي غير ذلك لا يفعل شيئًا، لأن هذه الشاشات تطلب اختيارًا لا يستطيع زر واحد إجراءه.
- مشفّرات لوحة المفاتيح ودواسات USB وأجهزة تحكم العرض: Space وEnter وPage Up/Down والأسهم وF13 إلى F15 أو تشغيل/إيقاف مؤقت.
- مشفّرات الألعاب «zero delay»، التي يراها ويندوز كذراع ألعاب: أي زر.
- الضغطات التي تفصلها أقل من 400 ms تُحسب مرة واحدة، فلا يلتقط تلامس مرتدّ صورتين.
المحفّزات: Webhook أو برنامج عند كل حدث
لكل ما عدا ذلك، توجد المحفّزات. يُضبط كل منها في إدارة الفوتو بوث، ويستمع إلى الأحداث التي تختارها، ويستدعي عنوان URL أو يشغّل برنامجًا على كمبيوتر الفوتو بوث.
- Webhookطلب HTTP POST بجسم JSON، موقّع بـ HMAC-SHA256 بسرّك الخاص. الترويسات: X-Froozbooth-Event وX-Froozbooth-Timestamp وX-Froozbooth-Signature.
- برنامجملف تنفيذي على كمبيوتر الفوتو بوث، يُعطى بمسار مطلق ويُسمح به في قائمة السماح لخدمة الأجهزة. وسائط مسمّاة: --event و--session و--booth-event و--ts و--device، ثم بيانات الحدث.
الأحداث السبعة عشر التي يمكنك الاستماع إليها
- الجلسة: session.start وcountdown.start وshot.taken وshots.done وcompose.done وsession.end وsession.canceled.
- المخرجات: print.sent وprint.done وshare.email.sent وshare.qr.shown.
- الأخطاء: error.capture وerror.compose وerror.print وerror.camera وerror.disk وerror.license.
تحمل كل رسالة رقم إصدار الصيغة (v)، واسم الحدث، وطابعًا زمنيًا بصيغة ISO 8601، ومعرّف الجلسة، ومعرّف المناسبة، ومعرّف الجهاز، وكائن data خاصًا بالحدث.
مصمَّمة لليلة مباشرة
- لا يؤخّر المحفّز الجلسة أبدًا: بعد ثانيتين دون رد، يمضي الفوتو بوث قدمًا.
- ثلاث محاولات إعادة، بعد 0.5 و2 و5 ثوانٍ. وأكثر من ذلك، سيصل الفلاش بعد انتهاء الوضعية.
- يُسجَّل الحدث الأقدم من 60 ثانية ولا يُعاد تشغيله: بعد إعادة التشغيل، لا فلاش في منتصف العشاء.
- زر اختبار يرسل حدثًا تجريبيًا ويعرض الرد، قبل فتح الأبواب بساعة.
- تُسجَّل آخر 200 عملية إرسال مع الحالة والرمز وزمن الاستجابة، وتُصدَّر إلى CSV.
وصفات جاهزة
- فلاش استوديو عند بدء العدّ التنازلي، عبر بوابة DMX أو Art-Net.
- نبضة أو صوت عند كل لقطة.
- العودة إلى الإضاءة المحيطة في نهاية الجلسة، عبر جسر Philips Hue.
الكاميرات والطابعات وأجهزة الكمبيوتر: الأجهزة التي تتحكم بها Froozbooth مباشرة موجودة في صفحة الأجهزة. برنامج فوتو بوث DSLR لكاميرات Canon وNikon: الكاميرات والطابعات المتوافقة
الأسئلة الشائعة
هل يعمل زر الألعاب مع Froozbooth؟
نعم. يعمل مشفّر لوحة مفاتيح أو مشفّر «zero delay» موصول عبر USB دون إعداد: يبدأ الضغط الجلسة في شاشة الترحيب ويلتقط الصورة في المعاينة المباشرة.
هل تستطيع Froozbooth التحكم بأضواء DMX أو آلة دخان؟
عبر محفّز. ترسل Froozbooth الحدث إلى Webhook أو برنامج، وتشغّل بوابة DMX أو Art-Net أو جسر Hue أو نصّك البرمجي الجهاز.
كيف أتأكد أن Webhook صادر فعلًا من الفوتو بوث؟
احسب HMAC-SHA256 لجسم الطلب الخام بسرّك وقارنه بترويسة X-Froozbooth-Signature. ويتيح لك الحقل ts، داخل الجسم الموقّع، رفض الطلبات القديمة.
هل يستطيع محفّز بطيء أن يُبقي الضيوف في الانتظار؟
لا. يحصل المحفّز على ثانيتين؛ وبعد ذلك يواصل الفوتو بوث عمله ويعيد المحاولة في الخلفية.
هل أستطيع استخدام دواسة قدم أو جهاز تحكم عرض لالتقاط الصورة؟
نعم. تتعرف Froozbooth على دواسات USB وأجهزة تحكم العرض دون إعداد، ما دامت ترسل Space أو Enter أو Page Up/Down أو سهمًا أو F13 إلى F15 أو تشغيل/إيقاف مؤقت. يبدأ الضغط الجلسة في شاشة الترحيب ويلتقط الصورة أو يوقف الفيديو في المعاينة المباشرة. وفي الشاشات الأخرى لا يفعل شيئًا، لأنها تطلب اختيارًا لا يستطيع زر واحد إجراءه.
ماذا يحدث إذا ضغط ضيف زر الفوتو بوث مرتين؟
تحسب Froozbooth الضغطات التي تفصلها أقل من 400 ms ضغطة واحدة، فلا يلتقط تلامس مرتدّ أو ضغط مزدوج سريع صورتين. والضغط على شاشة تطلب اختيارًا، مثل اختيار وضع، لا يفعل شيئًا.
أي أحداث الفوتو بوث تستطيع تشغيل Webhook؟
تتيح Froozbooth 17 حدثًا: خطوات الجلسة (session.start وcountdown.start وshot.taken وshots.done وcompose.done وsession.end وsession.canceled)، والمخرجات (print.sent وprint.done وshare.email.sent وshare.qr.shown)، والأخطاء (error.capture وerror.compose وerror.print وerror.camera وerror.disk وerror.license). يستمع كل محفّز إلى الأحداث التي تختارها فقط. وتحمل كل رسالة رقم إصدار الصيغة واسم الحدث وطابعًا زمنيًا بصيغة ISO 8601 ومعرّفات الجلسة والمناسبة والجهاز وبيانات خاصة بالحدث.
هل أستطيع تشغيل نص برمجي على كمبيوتر الفوتو بوث عند التقاط صورة؟
نعم، بمحفّز برنامج. تشغّل Froozbooth ملفًا تنفيذيًا على كمبيوتر الفوتو بوث عند الأحداث التي تختارها، مثل shot.taken؛ ويجب أن يُعطى بمسار مطلق ويُسمح به في قائمة السماح لخدمة الأجهزة. يتلقى وسائط مسمّاة (--event و--session و--booth-event و--ts و--device)، تليها بيانات الحدث.
كيف أختبر محفّز الفوتو بوث قبل وصول الضيوف؟
استخدم زر الاختبار في إدارة الفوتو بوث: ترسل Froozbooth حدثًا تجريبيًا وتعرض الرد. تُسجَّل آخر 200 عملية إرسال مع الحالة والرمز وزمن الاستجابة، وتُصدَّر إلى CSV. ويُسجَّل الحدث الأقدم من 60 ثانية بدل إعادة تشغيله، فلا تُطلق إعادة التشغيل فلاشًا في منتصف العشاء.
هل يستطيع الفوتو بوث تنبيهي عند تعطل الطابعة أو الكاميرا؟
نعم، بمحفّز على أحداث الأخطاء: error.print وerror.camera وerror.capture وerror.compose وerror.disk وerror.license. وجّهه إلى Webhook على خدمتك لتتلقى التنبيه أينما شئت. وتعرض صفحة الأجهزة في لوحة التحكم أيضًا حالة كل فوتو بوث مباشرة، ويمكنك إضافتها إلى الشاشة الرئيسية لهاتفك.