تكوين الخريطة المخصصة

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

يمكن تكوين هذه الإعدادات في المحرر المرئي عن طريق اختيار خريطة من قائمة الخرائط، أو باستخدام الخاصية map_config في تكوين YAML.

خيارات تكوين الخريطة

يتم تطبيق الإعدادات داخل map_config لكل فهرس خريطة باستخدام مفاتيح مثل map_1، map_2، إلخ. يمكن تعريف أي من الخيارات التالية تحت خريطة محددة:

تحذير

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

• rotation: يتجاوز التدوير المكوَّن ضمن بيانات الخريطة لرسم الخريطة بتدوير مخصص محدد لهذه البطاقة، ويقبل القيم 0، 90، 180، أو 270.
• scale: يتجاوز الحساب التلقائي للمقياس بناءً على الفرق بين الحجم الأصلي للخريطة وحجم البطاقة، ويقبل القيم بين 0.1 و 20.
• object_scale: يتجاوز الحجم المحسوب تلقائيًا لأشياء الخريطة، مثل أيقونات الغرف والعقبات، مما يسمح لها بالظهور أكبر أو أصغر.
• opacity: الشفافية العامة للخريطة المرسومة. القيمة الأولية هي 1 وتقبل القيم حتى 0.
• object_opacity: شفافية الأشياء المرسومة على الخريطة، مثل أيقونات الغرف أو العقبات. القيمة الأولية هي 1 وتقبل القيم حتى 0.
• font_size: حجم الخط لفقاعات النص المعروضة فوق الأشياء النشطة. ويقبل القيم بين 0 و 12.
• hidden_objects: يتجاوز الأشياء المخفية في الخريطة المعرفة في التهيئة المتقدمة الشاملة لهذه الخريطة المحددة.

التمركز والتكبير/التصغير

المعلمات أدناه تُستخدم لتجاوز حجم وإحداثيات المركز التي يقوم الكرت بحسابها تلقائيًا لرسم الخريطة.

تحذير

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

• left: يتجاوز المركز الأفقي للخريطة الذي تم حسابه تلقائيًا. على سبيل المثال، تعيين هذه القيمة إلى 0 يضع إحداثية 0 للخريطة على محور X تمامًا في مركز الكرت الأفقي. هذا النقطة عادة ما تكون موجودة مباشرة أمام الرصيف.
• top: يتجاوز المركز العمودي للخريطة الذي تم حسابه تلقائيًا. على سبيل المثال، تعيين هذه القيمة إلى 0 يضع إحداثية 0 للخريطة على محور Y تمامًا في مركز الكرت العمودي. هذا النقطة عادة ما تكون موجودة مباشرة أمام الرصيف.
• width: يتجاوز العرض الفعلي للخريطة المستخدم لحساب الملاءمة. نظرًا لأن البطاقة تقوم بتغيير حجم الخريطة بناءً على البُعد الأكبر الذي يناسب، فإن إدخال قيمة أكبر من العرض الفعلي للخريطة سيقلل حجم الخريطة داخل البطاقة، في حين أن القيمة الأصغر ستكبرها.
• height: يتجاوز الارتفاع الفعلي للخريطة المستخدم لحساب الملاءمة. مشابه للخاصية width، إدخال قيمة أكبر من ارتفاع الخريطة الفعلي سيقلل حجم الخريطة داخل البطاقة، بينما القيمة الأصغر ستكبرها.

مثال YAML

type: custom:dreame-vacuum-card
entity: vacuum.l10s_gen2
map_config:
  map_1:
    rotation: 90
    scale: 1.2
    object_scale: 1.5
    left: 10
    top: -20
    hidden_objects:
      - name
      - virtual_wall
  map_2:
    rotation: 180
    opacity: 0.8

صور الخلفية والتراكب

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

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

تصميم مخطط طابق ثلاثي الأبعاد

عند إنشاء رسومات مخصصة لمخطط طابق ثلاثي الأبعاد، يجب تصدير التصميم كصورتين منفصلتين بخلفيات شفافة: طبقة أساسية تحتوي على الأرضيات والأثاث المنخفض وطبقة علوية تحتوي فقط على الجدران العلوية.

تم إنشاء الصور التجريبية أدناه، المعروضة على خلفية منقوشة بالشطرنج لتسليط الضوء على مناطقها الشفافة، باستخدام تطبيق التصميم الداخلي المجاني Sweet Home 3D وتمت معالجتها لاحقًا في برنامج تحرير الصور القياسي لإزالة مناطق الأرضية وإنشاء الأجزاء الشفافة المطلوبة.

صورة الخلفية

صورة التراكب

يدعم كل من background_image وoverlay_image الخصائص التالية لمطابقة مخطط الأرضية:

• url: مسار الصورة، مثل /local/first_floor_bg.
• opacity: شفافية الصورة. القيمة الأولية هي 1 وتقبل القيم حتى 0.

محاذاة وتغيير حجم الصور

تعمل خصائص الصور left وtop وwidth وheight باستخدام نفس منطق الإحداثيات النسبية تمامًا مثل تكوين التمركز والتكبير/التصغير الخاص بالخريطة. هذه الخصائص اختيارية بالكامل.

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

القيم الافتراضية

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

• left: يحدد المركز الأفقي للصورة بالنسبة لمركز الخريطة. على سبيل المثال، تعيين هذه القيمة إلى 0 يضع إحداثية 0 للخريطة على محور X تمامًا في المركز الأفقي للصورة. يقع هذا النقطة عادةً مباشرة أمام الرصيف.
• top: يحدد المركز الرأسي للصورة بالنسبة لمركز الخريطة. على سبيل المثال، تعيين هذه القيمة إلى 0 يضع إحداثية 0 للخريطة على محور Y تمامًا في المركز الرأسي للصورة. يقع هذا النقطة عادةً مباشرة أمام الرصيف.
• width: يحدد عرض الصورة بالنسبة لنظام إحداثيات الخريطة الأصلي غير المقياس، بدلاً من بكسلات الشاشة المطلقة. على سبيل المثال، ضبط هذه القيمة لتتطابق مع العرض الخام للخريطة يضمن أن الصورة تُقاس بشكل متناسب لتغطي نفس المنطقة الأفقية تمامًا كما بيانات الخريطة.
• height: يحدد ارتفاع الصورة بالنسبة لنظام إحداثيات الخريطة الأصلي غير المقياس. على سبيل المثال، ضبط هذه القيمة لتتطابق مع الارتفاع الخام للخريطة يضمن أن الصورة تُقاس بشكل متناسب لتغطي نفس المنطقة الرأسية تمامًا كما بيانات الخريطة.

الدوران الأصلي

الصور المخصصة ليس لها خاصية دوران مستقلة؛ دورانها مرتبط بطبيعة الحال بدوران الخريطة. لضمان المواءمة عبر جميع المشاهد، يجب أن يتطابق الاتجاه الأساسي للصورة المصممة تمامًا مع الاتجاه الأولي للخريطة عند ضبطه على 0 درجة.

نسبة بكسل الجهاز (DPR)

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

تحديد حجم الصورة

تتضمن بيانات الخريطة الخاصية grid_size التي تشير إلى عدد المليمترات التي يمثلها كل بكسل في العالم الحقيقي. يمكن العثور على هذه القيمة في القسم معلومات الخريطة الحية. على سبيل المثال، فإن grid_size بقيمة 50 تعني أن كل بكسل يقابل 50 مم، أو 5 سم. من خلال قسمة أبعاد المنزل في العالم الحقيقي على هذا grid_size، يمكن حساب القيم الدقيقة لـ width و height لإدخالها في الإعدادات بدقة، مما يضمن أن صورة مخطط الطابق بمقياس 1:1 تتطابق تمامًا مع حجم المنزل في العالم الحقيقي.

مثال YAML

type: custom:dreame-vacuum-card
entity: vacuum.l10s_gen2

map_config:
  map_1:
    object_scale: 7
    width: 250
    height: 183
    opacity: 0.45
    hidden_objects:
      - customized_cleaning
      - floor
      - name
      - name_background
      - no_go
      - no_mop
      - order
      - walls
    background_image:
      url: /local/home.png
      left: 77
      top: 10.3
      width: 250
      height: 183
      opacity: 0.75
    overlay_image:
      url: /local/home_overlay.png
      opacity: 0.9
  map_2:
    left: 41
    top: -12
    width: 269
    height: 171
    background_image:
      url: /local/second_floor_bg.png