جهاز العرض لديك، في Home Assistant وHubitat.

• تنشر الحالة. يظهر جهاز العرض كمستشعر في Home Assistant، أو كجهاز في Hubitat، أو كحمولة JSON في Webhook لديك، ويحمل القراءات نفسها التي يعرضها لك التطبيق.
• تنشر عناصر التحكم. كل مشهد تحفظه، إضافة إلى التشغيل وكل مدخل وكل وضع ألوان وكل ذاكرة عدسة، يصبح شيئًا تستطيع الأتمتة أو المساعد الصوتي تشغيله.
• تعمل دون خادم. بعد إعداد النصوص البرمجية، يرسل Home Assistant الأوامر مباشرة إلى عنوان IP لجهاز العرض. لا يحتاج هاتفك إلى أن يكون على الشبكة، ولا يمر شيء عبر حساب سحابي.

ثلاثة مداخل، ومركز واحد

الإعدادات › أتمتة المنزل هي المركز. اختر المنصة التي تستخدمها - Home Assistant أو Hubitat أو Webhooks - وأعدّها من هناك. يمكنك ربط أكثر من واحدة في الوقت نفسه؛ فهي مستقلة.

1. افتح الإعدادات › أتمتة المنزل › Home Assistant.
2. اكتب عنوان Home Assistant (مثل http://homeassistant.local:8123 أو عنوان IP الخاص به)، ثم المس تسجيل الدخول. إنه تسجيل دخول عبر المتصفح إلى نسختك الخاصة - ولا يوجد رمز للصقه. استخدم بيانات دخولك المعتادة إلى Home Assistant، بما فيها التحقق بخطوتين.
3. ينشر التطبيق جهاز العرض كـمستشعر، بكيان مثل sensor.projector_pilot_epson_qb1000b_qb1000w، يحمل التشغيل والمدخل ووضع الألوان وأرقام الصورة وساعات المصباح.
4. فعّل إرسال حالة جهاز العرض لتتحدث هذه القراءات في Home Assistant كلما تغيّرت بينما التطبيق مفتوح، وفعّل مزامنة عناصر التحكم المتقدمة لنشر نصوص برمجية لأوضاع الصورة والمداخل وذاكرات العدسة والتشغيل.
5. الصق كتلة shell_command الواحدة (أدناه) في configuration.yaml لديك، وأعد تشغيل Home Assistant، ثم المس المزامنة مع HA.

كتلة shell_command

هذه هي الحيلة كلها لتعمل دون خادم. يكتب التطبيق أمرًا واحدًا يشغّله Home Assistant للتحدث إلى Web Control في جهاز العرض، ويستدعي كل نص برمجي يزامنه هذا الأمر بفعل مختلف. المس نسخ الكتلة في التطبيق والصقها في configuration.yaml. المثال أدناه توضيحي - فالتطبيق يملأ عنوان جهاز العرض واسم الأمر الخاصين بك:

shell_command:
  projector_pilot_epson: >-
    curl -s --max-time 5 --digest -u 'EPSONWEB:'
    -H "X-Requested-With: XMLHttpRequest"
    -H "Referer: http://192.168.1.50/cgi-bin/webconf"
    "http://192.168.1.50/cgi-bin/directsend?{{ verb }}={{ value | urlencode }}"

مثال فقط. ينشئ التطبيق كتلتك بعنوان IP الحقيقي لجهاز العرض واسم مشتق من رقمه التسلسلي.

اختبار الاتصال والمزامنة والتنظيف

• يتحقق اختبار الاتصال من قدرة التطبيق على الوصول إلى Home Assistant ومن وجود shell_command الملصوق فعلًا، لتكتشف أي خطأ مطبعي قبل أن تبني شيئًا فوقه.
• تكتب المزامنة مع HA النصوص البرمجية لمشاهدك وعناصر التحكم أو تحدّثها، وتبني لوحة Projector Pilot جاهزة مباشرة داخل Home Assistant. شغّلها مجددًا في أي وقت تضيف فيه مشهدًا أو تغيّر عنصر تحكم - فهي تحدّث في مكانها ولا تكدّس نسخًا مكررة.
• إزالة النصوص البرمجية اليتيمة تعثر على النصوص التي كتبها التطبيق ولم يعد لها مشهد أو عنصر تحكم مطابق - مثلًا بعد حذف مشهد - وتعرض بالضبط ما ستزيله وتسأل أولًا. لا يُحذف شيء حتى تؤكد. وهي لا تلمس إلا النصوص التي أنشأها Projector Pilot؛ ولا يُمسّ أي شيء آخر في Home Assistant، وإن لم يعرض Home Assistant قائمة نصوصه البرمجية فلا يُزال شيء.

• متصل بـ Home Assistant - تم تسجيل الدخول وهو يستجيب. وإن لم يستجب Home Assistant، يطلب الصف التحقق من العنوان ومن أن هاتفك على الشبكة نفسها.
• أُضيف جهاز العرض إلى Home Assistant - هل يملك Home Assistant هذا الجهاز بالفعل. وإن لم يكن كذلك، يرشدك الصف إلى إضافة تكامل PJLink، وتعرض خطوة إضافة التكامل مضيف PJLink ومنفذه اللذين يطلبهما Home Assistant.
• تم تسجيل مستشعر القراءات - المستشعر الذي يحمل قراءات جهاز العرض. يُسجَّل أول مرة يقرأ فيها التطبيق جهاز العرض، ويعرض الصف سجّل الآن أو تشغيل حين يوجد ما يعيق ذلك.
• ما لدى Home Assistant لديك - HACS (المتجر المجتمعي)، وتكامل Epson Projector Link، وتكامل PJLink، وأوامر Projector Pilot في configuration.yaml. يعرض كل منها تم العثور أو غير مثبّت أو تعذر التحديد، مع زرّي طريقة التثبيت وفتح في HACS حيث يفيدان.

• البطاقات المدمجة أولًا. إن لم تكن لديك بطاقات مجتمع، تبني المزامنة لوحتك ببطاقات Home Assistant المدمجة وتخبرك بذلك عند الانتهاء. يعمل مباشرة دون إعداد.
• ترقية عند تثبيت بطاقات HACS. يتحقق التطبيق من بطاقات المجتمع المثبّتة (Mushroom وbutton-card وcard-mod وapexcharts-card) ويرقّي كل بطاقة إلى الأغنى منها حيث تملكها. ويذهب دليل اللوحة المبنية يدويًا أبعد إن أردت مظهر الزجاج الأخضر الكامل.
• المشاهد وعناصر التحكم تحتاج إلى اللصقة الواحدة. إن لم يكن لدى Home Assistant أمر للإرسال إلى جهاز العرض بعد، تُبنى اللوحة مع ذلك بقراءات مباشرة، وتصحبك بطاقة إنهاء الإعداد خلاله: المس نسخ الكتلة، والصقها في configuration.yaml، وأعد تشغيل Home Assistant، ثم المس المزامنة مرة أخرى.
• لم يُثبَّت شيء؟ الصق يدويًا. إن لم يكن شيء مثبّتًا في Home Assistant فما زال بإمكانك نسخ كل شيء من التطبيق ولصقه بنفسك.
• تُنبَّه إلى كلمة المرور. تذكر كتلة الأوامر التي تلصقها ما إذا كانت تحمل كلمة مرور جهاز العرض، لتعرف ذلك قبل أن تشاركها أو تخزّنها.

• إنه كتلة اختيارية أخرى: الصقها في نهاية configuration.yaml (أو أضف أسطرها فقط تحت قسم template: موجود) وأعد تشغيل Home Assistant. وفي التطبيق زر تحقق من وجودها يخبرك ما إذا كانت موجودة في Home Assistant.
• يصل الإيقاف الآن إلى Home Assistant على أنه off، فترى لوحة التحكم والأتمتة جهاز العرض متوقفًا حين يكون كذلك.

• تستطيع الأتمتة تشغيلها. «عند الغروب، إن اشتغل التلفاز، شغّل ليلة أفلام» أتمتة عادية في Home Assistant بمجرد أن يصبح المشهد نصًا برمجيًا.
• تستطيع المساعدات الصوتية تشغيلها. اعرض نصًا برمجيًا لمساعدك فيضبط «شغّل ليلة أفلام» المدخل ووضع الصورة وذاكرة العدسة معًا.
• تظهر عناصر التحكم الحقيقية لديك فقط. يكتب التطبيق نصًا برمجيًا لكل مدخل ووضع ألوان وذاكرة عدسة يبلّغ بها جهاز العرض - لا قائمة عامة خمّنها.
• إزالة المزامنة تزيل ما كتبه التطبيق فقط. أوقف المزامنة، أو استخدم إزالة النصوص البرمجية اليتيمة (التي تعرضها وتسأل أولًا)، فيحذف Projector Pilot النصوص التي أنشأها ولا شيء غيرها.

لوحة التحكم

المزامنة تبني اللوحة لك

لا تحتاج إلى بناء عرض Lovelace يدويًا، ولم تعد مضطرًا إلى لصق واحد أيضًا. عندما تلمس المزامنة مع HA، يبني التطبيق لوحة Projector Pilot كاملة مباشرة داخل Home Assistant عبر واجهته البرمجية: الحالة المباشرة لجهاز العرض وزرًا لكل مشهد وعنصر تحكم زامنه. وتظهر في الشريط الجانبي لـ Home Assistant باسم Projector Pilot - افتحها وانتهى الأمر.

1. سجّل الدخول إلى Home Assistant في التطبيق.
2. الصق كتلة النسخ من التطبيق في configuration.yaml مرة واحدة وأعد تشغيل Home Assistant (الخطوة اليدوية الوحيدة - فـ Home Assistant لا يسمح للتطبيقات بإضافة ذلك الأمر عن بُعد).
3. المس المزامنة مع HA. تُبنى اللوحة لك وتظهر في الشريط الجانبي باسم Projector Pilot.

سواء بُنيت لك أو لصقتها بنفسك، فاللوحة هي نفسها - بطاقة حالة وزر لكل عنصر تحكم (مقتطف توضيحي):

views:
  - title: Projector
    cards:
      - type: entity
        entity: sensor.projector_pilot_epson_qb1000b_qb1000w
        name: Projector
      - type: button
        name: Power On
        tap_action:
          action: perform-action
          perform_action: script.turn_on
          target:
            entity_id: script.projector_pilot_power_on
      - type: button
        name: Movie Night
        tap_action:
          action: perform-action
          perform_action: script.turn_on
          target:
            entity_id: script.projector_pilot_scene_movie_night

مثال فقط. تحمل لوحتك كيان جهاز العرض الحقيقي لديك ومشاهدك أنت.

1. في Hubitat، فعّل تطبيق Maker API ودوّن رابط الوصول والرمز، واختر الأجهزة التي يعرضها.
2. في Projector Pilot، افتح الإعدادات › أتمتة المنزل › Hubitat وأدخل تفاصيل Maker API الخاصة بمركزك.
3. اختر الجهاز الذي يمثل جهاز العرض. يقترح التطبيق الأرجح؛ اختره أو حدد جهازك أنت.
4. يعكس التطبيق التشغيل وكتم الصوت والمدخل على ذلك الجهاز، ولا يرسل إلا الأوامر التي يقبلها الجهاز.
5. ابنِ قواعد Rule Machine على ذلك الجهاز كما تفعل مع أي جهاز آخر - فحالة جهاز العرض هي التي تحركها.

1. افتح الإعدادات › أتمتة المنزل › Webhooks.
2. أدخل الرابط الذي سيُرسل إليه. يبدو Webhook في Home Assistant هكذا http://homeassistant.local:8123/api/webhook/your-id.
3. اختر الأحداث التي تطلق Webhook: التشغيل والإيقاف وتغيّر المدخل واستدعاء مشهد - ويمكنك اختياريًا حصره بمدخل أو مشهد معين.
4. اضبط اختياريًا حمولة مخصصة إن كانت الخدمة المستقبِلة تريد شكلًا معينًا؛ وإلا يرسل التطبيق JSON الافتراضي.
5. احفظ. يرسل التطبيق عند كل حدث مطابق من الآن فصاعدًا.

الحمولة الافتراضية JSON عادي - حدث وجهاز العرض والقيمة التي تغيّرت:

{
  "event": "scene_recalled",
  "projector": "Epson QB1000B/QB1000W",
  "scene": "Movie Night",
  "power": "on",
  "input": "HDMI1",
  "color_mode": "Cinema",
  "timestamp": "2026-09-23T20:14:07Z"
}

حمولة مثال. يحمل حدث تغيّر المدخل أو التشغيل الحقول المتعلقة به.