خدمات المكنسة

التكامل يكشف عن خدمات مخصصة متنوعة للقيام بإجراءات وميزات متقدمة لا يمكن التحكم بها مباشرة عبر الكيانات القياسية. تستخدم هذه الخدمات المخصصة نطاق vacuum وتوفر تحكمًا دقيقًا في وظائف الجهاز الخاصة.

تنظيف الغرفة

dreame_vacuum.vacuum_clean_segment

بدء تنظيف الغرفة المختارة مع معلمات تنظيف مخصصة اختيارياً.

ملاحظة

• إذا كنت تستخدم التكامل مع ميزة الخريطة، يمكنك الحصول على معرفات القطاعات من سمات كيان المكنسة الكهربائية.
• يتم تجاهل معلمات التنظيف وترتيب التنظيف من قبل الجهاز عندما يكون customized_cleaning أو cleaning_sequence مُمكَّنًا.

ضبط وضع التنظيف

لا يقبل هذا الخدمة معلمة cleaning_mode. لتعيين الوضع ديناميكيًا قبل بدء التنظيف، انظر إلى الأسئلة الشائعة.

أمثلة

• تنظيف الغرفة 3

  service: dreame_vacuum.vacuum_clean_segment
  data:
    segments: 3
  target:
    entity_id: vacuum.vacuum

• تنظيف الغرف 3 و 5

  service: dreame_vacuum.vacuum_clean_segment
  data:
    segments:
      - 3
      - 5
  target:
    entity_id: vacuum.vacuum

• تنظيف الغرف 3 و 5 مرتين

  service: dreame_vacuum.vacuum_clean_segment
  data:
    segments:
      - 3
      - 5
    repeats: 2
  target:
    entity_id: vacuum.vacuum

• تنظيف الغرفة 2 مرتين و 5 مرة واحدة

  service: dreame_vacuum.vacuum_clean_segment
  data:
    segments:
      - 3
      - 5
    repeats: 
      - 2
      - 1
  target:
    entity_id: vacuum.vacuum

• تنظيف الغرف 3 و 5 بسرعة مروحة عالية

  service: dreame_vacuum.vacuum_clean_segment
  data:
    segments:
      - 3
      - 5
    suction_level: "high"
  target:
    entity_id: vacuum.vacuum

• تنظيف الغرفة 3 بسرعة مروحة عالية و 5 بسرعة مروحة هادئة

  service: dreame_vacuum.vacuum_clean_segment
  data:
    segments:
      - 3
      - 5
    suction_level: 
      - "high"
      - "quiet"
  target:
    entity_id: vacuum.vacuum

تنظيف منطقة

dreame_vacuum.vacuum_clean_zone

ابدأ تنظيف المنطقة المحددة باستخدام معلمات تنظيف مخصصة اختيارية.

نصيحة

يمكنك الحصول على إحداثيات المنطقة باستخدام بطاقة خريطة مكنسة شاومي.

تعيين وضع التنظيف: هذه الخدمة لا تقبل معلمة cleaning_mode. لتعيين الوضع ديناميكيًا قبل بدء التنظيف، انظر الأسئلة الشائعة.

أمثلة

• تنظيف المنطقة المحددة

  service: dreame_vacuum.vacuum_clean_zone
  data:
    zone: 
      - 819
      - -263
      - 4424
      - 2105
  target:
    entity_id: vacuum.vacuum

• تنظيف مناطق متعددة

  service: dreame_vacuum.vacuum_clean_zone
  data:
    zone: 
      - - 819
        - -263
        - 4424
        - 2105
      - - 2001
        - -3050
        - 542
        - 515
  target:
    entity_id: vacuum.vacuum

• تنظيف المنطقة المحددة مرتين

  service: dreame_vacuum.vacuum_clean_zone
  data:
    zone: 
      - 819
      - -263
      - 4424
      - 2105
    repeats: 2
  target:
    entity_id: vacuum.vacuum

• تنظيف المنطقة الأولى مرتين والثانية ثلاث مرات

  service: dreame_vacuum.vacuum_clean_zone
  data:
    zone: 
      - - 819
        - -263
        - 4424
        - 2105
      - - 2001
        - -3050
        - 542
        - 515
    repeats: 
      - 2
      - 3
  target:
    entity_id: vacuum.vacuum

تنظيف موضعي

dreame_vacuum.vacuum_clean_spot

ابدأ تنظيف النقطة المحددة باستخدام معلمات تنظيف مخصصة اختيارية.

ملاحظة

ميزة تنظيف النقاط متوفرة فقط للروبوتات ذات العلامة التجارية Xiaomi/Mijia ولكنها تعمل أيضًا مع أجهزة Dreame.

نصيحة

يمكنك الحصول على إحداثيات النقطة باستخدام بطاقة خريطة مكنسة شاومي.

تعيين وضع التنظيف: هذه الخدمة لا تقبل معلمة cleaning_mode. لتعيين الوضع ديناميكيًا قبل بدء التنظيف، انظر الأسئلة الشائعة.

أمثلة

• تنظيف النقطة المحددة

  service: dreame_vacuum.vacuum_clean_spot
  data:
    points: 
      - 819
      - -263
  target:
    entity_id: vacuum.vacuum

• تنظيف نقاط متعددة

  service: dreame_vacuum.vacuum_clean_spot
  data:
    points: 
      - - 819
        - -263
      - - 2001
        - -3050
  target:
    entity_id: vacuum.vacuum

• تنظيف النقطة المحددة مرتين

  service: dreame_vacuum.vacuum_clean_spot
  data:
    points: 
      - 819
      - -263
    repeats: 2
  target:
    entity_id: vacuum.vacuum

• تنظيف النقطة الأولى مرتين والثانية ثلاث مرات

  service: dreame_vacuum.vacuum_clean_spot
  data:
    points: 
      - - 819
        - -263
      - - 2001
        - -3050
    repeats: 
      - 2
      - 3
  target:
    entity_id: vacuum.vacuum

الانتقال إلى نقطة

dreame_vacuum.vacuum_goto

أرسل الروبوت إلى إحداثية واحدة على الخريطة وتوقف هناك.

ملاحظة

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

نصيحة

يمكنك الحصول على إحداثيات النقطة باستخدام بطاقة خريطة مكنسة شاومي.

مثال

• اذهب إلى [819, -2235] وتوقف

  service: dreame_vacuum.vacuum_goto
  data:
    x: 819
    y: -2235
  target:
    entity_id: vacuum.vacuum

اتباع مسار تجريبي

dreame_vacuum.vacuum_follow_path

ابدأ مهمة مسار الإبحار التي تزور الإحداثيات المحددة واحدة تلو الأخرى وتعود إلى المحطة.

تحذير

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

ملاحظة

• هذه الخدمة متاحة فقط للأجهزة التي تحتوي على ميزة الإبحار (المكانس الكهربائية المزودة بملاحة ليدار وبث الكاميرا).
• يتم إرسال أول 20 نقطة فقط إلى الجهاز ويجب أن يكون كل إحداثي داخل الخريطة الحالية.
• عندما يتم تجاهل points، يتم استخدام نقاط الإبحار المحفوظة في الخريطة الحالية بدلاً من ذلك. مطلوب وجود إحداثي صالح واحد على الأقل أو محفوظ لبدء المهمة.
• يجب أن يكون مستوى البطارية لا يقل عن 15٪ والجهاز لا يستجيب لهذا الإجراء أثناء شحن المحطة أو أثناء الإصلاح/الاختبار الذاتي.
• يمكنك الحصول على إحداثيات النقطة باستخدام بطاقة خريطة مكنسة شاومي.

أمثلة

• تتبع مسار مكون من ثلاث نقاط

  service: dreame_vacuum.vacuum_follow_path
  data:
    points:
      - - 819
        - -263
      - - 2001
        - -3050
      - - 542
        - 515
  target:
    entity_id: vacuum.vacuum

• تتبع نقاط الإبحار المحفوظة في الخريطة الحالية

  service: dreame_vacuum.vacuum_follow_path
  target:
    entity_id: vacuum.vacuum

بدء اختصار

dreame_vacuum.vacuum_start_shortcut

بدء مهمة اختصار تم إنشاؤها على التطبيق الرسمي.

ملاحظة

• الاختصارات متوفرة فقط على الأجهزة المدعومة ويمكنك الحصول على معرفات الاختصار من الخاصية shortcuts للكيان المكنسة.
• معرفات الاختصار الصالحة تتراوح بين 25 و128.
• يقوم التكامل أيضًا بإنشاء كيان زر لكل اختصار للجهاز باسم button.{vacuum_name}_shortcut_{shortcut_id}، لذلك عادةً لا يكون استخدام هذه الخدمة ضروريًا.
• الجهاز لا يستجيب لهذا الإجراء أثناء تفريغ المحطة أو أثناء الإصلاح الذاتي/الاختبار.

مثال

• بدء الاختصار بالمعرف 32

  service: dreame_vacuum.vacuum_start_shortcut
  data:
    shortcut_id: 32
  target:
    entity_id: vacuum.vacuum

إعادة تسمية الاختصار

dreame_vacuum.vacuum_rename_shortcut

تعيين اسم مخصص لاختصار.

ملاحظة

• يمكنك الحصول على معرفات الاختصار من الخاصية shortcuts للكيان المكنسة.
• يجب أن تكون أسماء الاختصارات فريدة. عندما يكون الاسم الجديد مستخدمًا بالفعل بواسطة اختصار آخر، يتم إضافة رقم إليه كما تفعل التطبيق الرسمي. (على سبيل المثال: Mopping after sweeping يصبح Mopping after sweeping2)
• اسم كيان زر الاختصار الذي تم إنشاؤه يتبع اسم الاختصار.
• لا يمكن إعادة تسمية الاختصارات أثناء تشغيل الروبوت.

مثال

• إعادة تسمية الاختصار بالمعرف 32 إلى "التنظيف بعد الكنس"

  service: dreame_vacuum.vacuum_rename_shortcut
  data:
    shortcut_id: 32
    shortcut_name: "Mopping after sweeping"
  target:
    entity_id: vacuum.vacuum

حذف اختصار

dreame_vacuum.vacuum_delete_shortcut

حذف اختصار.

ملاحظة

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

مثال

• احذف الاختصار الذي له معرف 34

  service: dreame_vacuum.vacuum_delete_shortcut
  data:
    shortcut_id: 34
  target:
    entity_id: vacuum.vacuum

تثبيت حزمة صوتية

dreame_vacuum.vacuum_install_voice_pack

قم بتثبيت حزمة صوتية رسمية.

ضبط تسلسل التنظيف دعم الخريطة

dreame_vacuum.vacuum_set_cleaning_sequence

اضبط تسلسل تنظيف الغرف على الخريطة الحالية.

ملاحظة

يجب تمرير عدد الغرف بالضبط كقائمة تسلسل

مثال

• اضبط تسلسل تنظيف الغرف على الخريطة الحالية إلى 3، 5، 4، 2، 1

  service: dreame_vacuum.vacuum_set_cleaning_sequence
  data:
      cleaning_sequence: 
        - 3
        - 5
        - 4
        - 2
        - 1
  target:
      entity_id: vacuum.vacuum

• تعطيل تسلسل التنظيف المخصص على الخريطة الحالية

  service: dreame_vacuum.vacuum_set_cleaning_sequence
  data:
      cleaning_sequence: []
  target:
      entity_id: vacuum.vacuum

ضبط التنظيف المخصص دعم الخريطة

dreame_vacuum.vacuum_set_custom_cleaning

اضبط معلمات تنظيف الغرف المخصصة على الخريطة الحالية.

ملاحظة

يجب تمرير إعدادات جميع الغرف كقائمة

أمثلة

• اضبط سرعة مروحة الغرفة 1 على هادئ، ومستوى الماء منخفض، وأوقات التنظيف على 2 والغرفة 5 سرعة المروحة توربو، مستوى الماء متوسط، وعدد التكرارات 1

  service: dreame_vacuum.vacuum_set_custom_cleaning
  data:
      segment_id: 
        - 1
        - 5
      suction_level: 
        - 0
        - 3
      water_volume: 
        - 1
        - 2
      repeats: 
        - 2
        - 1
  target:
      entity_id: vacuum.vacuum

• اضبط مستوى الرطوبة للغرفة 3 على 16

  service: dreame_vacuum.vacuum_set_custom_cleaning
  data:
      segment_id: 
        - 3
      wetness_level: 
        - 16
  target:
      entity_id: vacuum.vacuum

إعادة ضبط المستهلكات

dreame_vacuum.vacuum_reset_consumable

أعد ضبط عمر عنصر الاستهلاك حسب النوع.

القيم الممكنة لعنصر الاستهلاك

• main_brush
• side_brush
• filter
• tank_filter
• sensor
• mop_pad
• silver_ion
• detergent
• squeege
• dirty_water_channel
• onboard_dirty_water_tank
• deodorizer
• wheel
• scale_inhibitor
• fluffing_roller
• rollermop_filter
• water_outlet_filter

أمثلة

• أعد ضبط عمر الفرشاة الرئيسية

  service: dreame_vacuum.vacuum_reset_consumable
  data:
      consumable: "main_brush"
  target:
      entity_id: vacuum.vacuum

• أعد ضبط عمر وسادة المسح

  service: dreame_vacuum.vacuum_reset_consumable
  data:
      consumable: "mop_pad"
  target:
      entity_id: vacuum.vacuum

التحكم عن بُعد غير موصى به

dreame_vacuum.vacuum_remote_control_move_step

أرسل أمر التحكم عن بُعد للمكنسة.

أرسل الأمر غير موصى به

vacuum.send_command

يمكن استخدام خدمة إرسال الأوامر لإرسال طلبات API الخام التي لا تتوفر من خلال هذا التكامل.

للاستخدام التجريبي فقط

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

نصيحة

مزيد من المعلومات حول الأوامر والمعلمات.

أمثلة

• بدء التفريغ التلقائي

  service: vacuum.send_command
  data:
      entity_id: vacuum.vacuum
      command: action
      params: 
          did: "15.1"
          siid: 15
          aiid: 1
          in: []

• تمكين نمط المسح المكثف وتعطيل تعزيز السجاد

  service: vacuum.send_command
  data:
      entity_id: vacuum.vacuum
      command: set_properties
      params: 
        - did: "4.29"
          siid: 4
          piid: 29
          value: 1
        - did: "4.12"
          siid: 4
          piid: 12
          value: 0