خدمات جاروبرقی

ادغام خدمات سفارشی مختلفی را برای اقدامات و ویژگی‌های پیشرفته که به طور مستقیم از طریق موجودیت‌های استاندارد قابل کنترل نیستند، فراهم می‌کند. این خدمات سفارشی از دامنه 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

شروع نظافت نقطه‌ای انتخاب شده با پارامترهای اختیاری و سفارشی‌سازی شده.

توجه

ویژگی نظافت نقطه‌ای فقط برای ربات‌های برند شیائومی/میجیا در دسترس است، اما با دستگاه‌های 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

فرستادن ربات به یک مختصات خاص روی نقشه و توقف آن در آن نقطه.

توجه

• در دستگاه‌هایی با قابلیت کروزینگ (جاروبرقی‌هایی با ناوبری لیدار و پخش زنده دوربین) این کار یک وظیفه حرکت به نقطه را شروع می‌کند و ربات هنگام رسیدن به نقطه هدف، عکس‌هایی از اطراف آن نقطه می‌گیرد. این کار در تاریخچه کروزینگ ذخیره می‌شود. (اطلاعات بیشتر در مورد نقشه‌های تاریخچه گشت و گذار)
• در سایر دستگاه‌ها همین رفتار با یک کار تمیز کردن ناحیه کوچک حول نقطه داده شده شبیه‌سازی می‌شود. سطح مکش روی حالت بی‌صدا تنظیم شده و تی‌کشی برای آن کار غیرفعال است، و ربات به محض رسیدن به نقطه متوقف شده و تنظیمات قبلی تمیز کردن توسط ادغام بازیابی می‌شوند.
• سطح باتری باید حداقل ۱۵٪ باشد و مختصات باید داخل نقشه فعلی باشد.
• دستگاه به این عمل پاسخ نمی‌دهد وقتی ربات پیش از این روی مختصات انتخاب شده ایستاده باشد، ایستگاه در حال تخلیه است یا ایستگاه در حال تعمیر/آزمایش خودکار است.

نکته

شما می‌توانید مختصات نقطه را با کارت نقشه جاروبرقی شیائومی به دست آورید.

مثال

• برو به [819, -2235] و متوقف شو

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

دنبال کردن مسیر آزمایشی

dreame_vacuum.vacuum_follow_path

یک کار مسیر کروز شروع کن که مختصات داده شده را یکی یکی بازدید کند و به داک بازگردد.

هشدار

این دستگاه محدود به انجام وظایف دنبال کردن مسیر فقط در زمان فعال بودن پخش زنده دوربین است. بر خلاف رفتن به نقطه، این سرویس به دوربین مرتبط است و شما باید قبل از فراخوانی آن، دوربین را از طریق برنامه رسمی باز کنید. در غیر این صورت ربات کاملاً درخواست را نادیده می‌گیرد و اصلاً کاری انجام نمی‌دهد.

توجه

• این سرویس فقط بر روی دستگاه‌هایی که دارای قابلیت گشت زنی هستند (جاروبرقی‌های دارای ناوبری لایدار و پخش زنده دوربین) در دسترس است.
• فقط 20 نقطه اول به دستگاه ارسال می‌شود و هر مختصات باید در داخل نقشه فعلی باشد.
• وقتی points حذف شود، نقاط گشت ذخیره‌شده نقشه فعلی استفاده می‌شوند. حداقل یک مختصات معتبر یا ذخیره‌شده برای شروع کار لازم است.
• سطح باتری باید حداقل ۱۵٪ باشد و دستگاه در حالی که ایستگاه در حال تخلیه یا خود تعمیر/آزمایش است به این اقدام پاسخ نمی‌دهد.
• شما می‌توانید مختصات نقطه را با کارت نقشه جاروبرقی شیائومی به دست آورید.

نمونه‌ها

• دنبال کردن یک مسیر با سه نقطه

  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 موجودیت جاروبرقی به‌دست آورید.
• شناسه‌های معتبر میانبر بین ۲۵ تا ۱۲۸ هستند.
• ادغام همچنین یک موجودیت دکمه برای هر میانبر دستگاه به‌صورت button.{vacuum_name}_shortcut_{shortcut_id} ایجاد می‌کند، بنابراین استفاده از این سرویس معمولاً ضروری نیست.
• دستگاه در حالی که ایستگاه در حال تخلیه یا خودتعمیر/آزمایش است، به این عمل پاسخ نمی‌دهد.

مثال

• شروع میانبر با شناسه ۳۲

  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 می‌شود)
• نام موجودیت دکمه میانبر ایجاد شده مطابق نام میانبر است.
• میانبرها نمی‌توانند در حالی که ربات در حال اجرا است تغییر نام دهند.

مثال

• تغییر نام میانبر با شناسه ۳۲ به "تمیز کردن بعد از جارو کردن"

  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 موجودیت جاروبرقی به‌دست آورید.
• موجودیت دکمه‌ی میانبر حذف‌شده به‌طور خودکار حذف می‌شود.
• نمی‌توان یک میانبر را در حالی که کار مربوط به خود آن در حال اجراست، حذف کرد.
• میانبرهای حذف‌شده قابل بازیابی نیستند و تنها می‌توان آن‌ها را از اپلیکیشن رسمی دوباره ایجاد کرد.

مثال

• حذف میانبری با شناسه ۳۴

  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

تعیین ترتیب تمیز کردن اتاق‌ها در نقشه فعلی.

توجه

تعداد دقیق شناسه‌های اتاق باید به‌عنوان لیست ترتیب داده شده ارائه شود.

مثال

• تعیین ترتیب تمیز کردن اتاق‌ها در نقشه فعلی به ترتیب ۳، ۵، ۴، ۲، ۱

  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

تنظیم پارامترهای تمیز کردن سفارشی برای اتاق‌ها در نقشه فعلی.

توجه

تنظیمات برای همه اتاق‌ها باید به‌صورت لیست ارائه شود.

نمونه‌ها

• تنظیم سرعت فن اتاق ۱ به حالت بی‌صدا، سطح آب به کم، تعداد دفعات تمیز کردن به ۲ و سرعت فن اتاق ۵ به حالت توربو، سطح آب به متوسط، تعداد دفعات تکرار به ۱

  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

• تنظیم سطح رطوبت اتاق ۳ به ۱۶

  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