الأسئلة الشائعة

تجمع هذه الصفحة الأسئلة التي تتكرر بشكل متكرر على متتبع المشكلات في GitHub. الفحص هنا قبل فتح مشكلة جديدة يوفر الوقت، حيث أن معظمها ليست أخطاء بل سلوكيات متوقعة لها سبب موثق.

البحث في المشكلات الموجودة

لا يوجد أي منها؟ تأكد من البحث في المشكلات المغلقة على GitHub قبل فتح مشكلة جديدة. إذا استمرت المشكلة، تشرح صفحة الإبلاغ عن مشكلة كيفية جمع سجلات التصحيح وفتح تقرير خطأ صحيح أو طلب ميزة.

هل يمكن دفع الإشعارات إلى الهاتف؟

عرض الإجابة

ليس مباشرة. بشكل افتراضي، يقوم التكامل بإنشاء الإشعارات المستمرة فقط داخل لوحة تحكم Home Assistant؛ فهي لا يتم إعادة توجيهها تلقائيًا إلى تطبيق Home Assistant Companion على جهاز محمول، حيث يتطلب ذلك هدف إشعار محدد لكل جهاز لا يمتلكه التكامل.

لتلقيها على الهاتف، يجب إنشاء أتمتة مخصصة يستمع إلى أحداث للتكامل (أو الإشعارات المستمرة المولدة) ويحولها إلى الهدف notify للجهاز المحمول.

مزيد من المعلومات حول تكوين الإشعارات التي يتم إنشاؤها

صور الكشف عن العقبات / الذكاء الاصطناعي لا تظهر دعم الخريطة

عرض الإجابة

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

هل يمكن بث كاميرا الخريطة إلى HomeKit / Apple Home؟ دعم الخريطة

عرض الإجابة

ليس موثوقًا كعرض مباشر. كاميرا الخريطة تبث كـ MJPEG حقيقي، نفس الطريقة التي يستخدمها نظام كاميرا Home Assistant الخاص، لذا تعرض الصورة الثابتة للمعاينة في Apple Home بشكل صحيح. يتم إنشاء إطار جديد فقط عندما تتغير الخريطة فعليًا، والبث لا ينتج أي شيء بينما يكون المكنسة ساكنة. عرض HomeKit المباشر يحتاج إلى مصدر يتم تحديثه باستمرار للبقاء متصلاً، ويجب على Home Assistant تحويل بث MJPEG عبر طبقة إضافية قبل أن يتمكن HomeKit من عرضه على الإطلاق، لأن HomeKit لا يقبل MJPEG مباشرة. عندما يصبح بث الخريطة صامتًا، تعتبر طبقة التحويل تلك الاتصال مفقودًا، ويبلغ Home Assistant أن الكاميرا ليس لديها مصدر بث أو يعرض تغذية فارغة بدلًا من صورة مباشرة.

تم الإبلاغ عن هذا عدة مرات. المحاولات باستخدام منصة الكاميرا ffmpeg، go2rtc، ودمج الكاميرا العامة كلها تنتج نفس النتيجة: المعاينة الثابتة تعمل، لكن البث المباشر المتجدد باستمرار داخل HomeKit لا يعمل. لم يتم تأكيد أي إعداد يعمل بالكامل لهذا الدمج أو لتدفقات خريطة المكنسة المشابهة في مكان آخر.

تعطل Home Assistant، إعادة التشغيل، أو استخدام الكثير من الذاكرة دعم الخريطة

عرض الإجابة

يقوم الدمج بعرض صور خريطة قابلة للتكبير وبجودة كاملة مماثلة للتطبيق الرسمي، مما يمكن أن يستخدم قدرًا كبيرًا من الذاكرة. على الأنظمة ذات ذاكرة الوصول العشوائي المحدودة، مثل Raspberry Pi، أو جهاز افتراضي صغير، أو حاوية محدودة بحوالي 2-3 جيجابايت، يمكن أن يؤدي هذا إلى استهلاك الذاكرة المتاحة ويتسبب في تجميد Home Assistant، أو إعادة تشغيله، أو فشله في البدء تمامًا، عادةً مباشرة بعد إضافة جهاز يدعم الخريطة أو عند فتح صفحته أو كاميرا الخريطة الخاصة به.

الحل

قم بتمكين صورة خريطة منخفضة الدقة من خيارات تكوين الجهاز. هذا يحل الغالبية العظمى من هذه الحالات.

إذا استمر في التعطل بعد تمكين هذا الخيار، قد تكون بيانات الخريطة نفسها قد تعرضت للتلف أو أصبحت كبيرة بشكل غير طبيعي مع مرور الوقت، مما يمكن أن يزيد أيضًا من استخدام الذاكرة أثناء العرض. يمكن أن يساهم استعادة خريطة قديمة وصحية من النسخ الاحتياطي والاستعادة في حل هذه المشكلة. إذا لم يُجدِ أي منهما نفعًا، جمع سجلات التصحيح وفتح تقرير عن الخطأ، لأن ذلك يشير إلى سبب أساسي مختلف.

فشل تحميل التكامل بعد تحديث Home Assistant، وذكر py_mini_racer دعم الخريطة

عرض الإجابة

يعتمد التكامل على py-mini-racer، وهو محرك جافا سكريبت يُستخدم لتحسين وعرض الخرائط لتطابق التطبيق الرسمي. يتم تثبيت هذا الاعتماد بواسطة Home Assistant نفسه، وليس بواسطة التكامل، وأحيانًا يفشل في التثبيت أو يفشل في تحميل الملف الثنائي الخاص به بعد تحديث نواة Home Assistant، خصوصًا على الأنظمة المعتمدة على musl (مثل HAOS على بعض المنصات) أو مباشرة بعد الترقية.

مشكلة في البيئة

هذه مشكلة تتعلق بتثبيت البيئة/التبعيات، وليست شيئًا يمكن لكود التكامل اكتشافه أو تجاوزه. تظهر بشكل متكرر عبر إصدارات Home Assistant وأنواع التثبيت المختلفة غير المتعلقة.

إعادة تشغيل Home Assistant (لاسمح له بمحاولة تثبيت التبعيات مرة أخرى) يحل المشكلة في بعض الحالات. إذا استمرت المشكلة، تحقق من سجل Home Assistant حول وقت بدء التشغيل للحصول على خطأ تثبيت pip/التبعيات الفعلي؛ هذا الخطأ هو ما يحتاج إلى حل (بما في ذلك كمسألة في جوهر Home Assistant، إذا بدا وكأنه فشل في التثبيت على مستوى المنصة).

هل يمكن استخدام جهاز يعمل بنظام Valetudo مع هذا التكامل؟

عرض الإجابة

نعم ولا. من الناحية التقنية، لا يوجد قيد يمنع تشغيل التكامل جنبًا إلى جنب مع Valetudo. فاليتودو لا يعطل واجهة برمجة التطبيقات المحلية miIO، لذلك يمكن التحكم في الجهاز عبر الاتصال المحلي طالما يمكن الحصول على الرمز المميز. ومع ذلك، لا يمكن استرجاع بيانات الخرائط عبر واجهة برمجة التطبيقات المحلية، وفاليتودو لا يتيح بيانات الخرائط الخام عبر أي خدمة. لذلك، يمكن لهذا التكامل العمل فقط بدون دعم الخرائط.

بدون دعم الخرائط، تصبح الوظائف التي يقدمها هذا التكامل زائدة إلى حد كبير، حيث يمكن بالفعل استخدام جميع الميزات المتبقية من خلال النسخة الأصلية تكامل فاليتودو مع هوم أسيستانت عبر MQTT.