掃除機サービス

この統合は、標準エンティティでは直接制御できない高度な操作や機能のためのさまざまなカスタムサービスを提供します。これらのカスタムサービスはvacuumドメインを利用し、デバイス固有の機能に対する詳細な制御を可能にします。

部屋の掃除

dreame_vacuum.vacuum_clean_segment

選択した部屋の掃除を、オプションのカスタマイズされた掃除パラメータで開始します。

注意

マップ機能付きの統合を使用している場合、掃除機エンティティの属性からセグメントIDを取得できます。
customized_cleaningまたはcleaning_sequenceが有効な場合、掃除パラメータと掃除の順序はデバイスによって無視されます。

掃除モードの設定

このサービスはcleaning_modeパラメータを受け付けません。掃除を開始する前にモードを動的に設定するには、FAQを参照してください。

例

部屋3を掃除

yaml

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

部屋3と5を掃除

yaml

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

部屋3と5を2回掃除

yaml

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

部屋2を2回、部屋5を1回掃除

yaml

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

部屋3と5を高速ファンスピードで掃除

yaml

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

部屋3を高速ファンスピードで、部屋5を静音ファンスピードで掃除

yaml

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

ゾーン清掃

dreame_vacuum.vacuum_clean_zone

選択したゾーンの清掃を、オプションでカスタマイズした清掃パラメータで開始します。

ヒント

ゾーンの座標はXiaomi掃除機マップカードで取得できます。

清掃モードの設定: このサービスはcleaning_modeパラメータを受け付けません。清掃開始前に動的にモードを設定するには、FAQを参照してください。

例

選択したゾーンを清掃

yaml

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

複数のゾーンを清掃

yaml

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

選択したゾーンを2回清掃

yaml

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

1つ目のゾーンを2回、2つ目のゾーンを3回清掃

yaml

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デバイスでも機能します。

ヒント

座標はXiaomi掃除機マップカードで取得できます。

例

選択したスポットを清掃

yaml

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

複数のスポットを清掃

yaml

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

選択したスポットを2回清掃

yaml

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

1つ目のスポットを2回、2つ目のスポットを3回清掃

yaml

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

ポイントへ移動

dreame_vacuum.vacuum_goto

ロボットをマップ上の単一座標に移動させ、そこで停止させます。

注意

巡航機能を搭載したデバイス（LiDARナビゲーションとカメラストリーミング付きの掃除機）では、これによりポイントまで巡航ジョブが開始され、ロボットは到着時に目標地点周辺の写真を撮影します。このジョブは巡航履歴に保存されます。（移動履歴マップの詳細）
他のデバイスでは、同じ動作が指定された地点の周囲での小さいゾーン清掃ジョブでエミュレートされます。このジョブでは吸引レベルが静音に設定され、モップは無効になり、ロボットが地点に到達すると統合機能によって停止され、以前の清掃設定が復元されます。
バッテリーレベルは少なくとも15％で、座標は現在のマップ内である必要があります。
ロボットが既に選択された座標に立っている場合、ステーションが排出中、またはステーションが自己修復/テスト中の場合、デバイスはこの操作に応答しません。

ヒント

座標はXiaomi掃除機マップカードで取得できます。

例

[819, -2235] に移動して停止

yaml

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

パスに従う実験的

dreame_vacuum.vacuum_follow_path

与えられた座標を順番に訪問し、ドックに戻る巡航パスジョブを開始します。

警告

このデバイスは、ライブカメラストリーミングが有効な間のみ、パスに沿ったタスクを実行するよう制限されています。ポイントへ移動とは異なり、このサービスはカメラに紐付けられており、呼び出す前に公式アプリからカメラを開く必要があります。そうしないと、ロボットはリクエストを完全に無視し、何も行いません。

注意

このサービスは、クルージング機能（ライダー搭載ナビゲーションとカメラストリーミングを備えた掃除機）があるデバイスでのみ利用可能です。
デバイスに送信されるのは最初の20ポイントのみで、すべての座標は現在のマップ内にある必要があります。
pointsが省略された場合、現在のマップの保存されたクルーズポイントが代わりに使用されます。ジョブを開始するには、少なくとも1つの有効な座標または保存された座標が必要です。
バッテリー残量は少なくとも15％である必要があり、ステーションが排出中または自己修復/テスト中の場合、デバイスはこの操作に応答しません。
座標はXiaomi掃除機マップカードで取得できます。

例

3つのポイントのパスに沿って進む

yaml

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

現在のマップの保存されたクルーズポイントに沿って進む

yaml

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

ショートカットの開始

dreame_vacuum.vacuum_start_shortcut

公式アプリで作成されたショートカットタスクを開始する

注意

ショートカットは対応デバイスでのみ利用可能で、掃除機エンティティの shortcuts 属性からショートカットIDを取得できます。
有効なショートカットIDは25から128の間です。
統合はまた、デバイスの各ショートカットに対して button.{vacuum_name}_shortcut_{shortcut_id} としてボタンエンティティを作成するため、このサービスを使用する必要は通常ありません。
ステーションが排出中または自己修復／テスト中の場合、デバイスはこの操作に応答しません。

例

ID 32 のショートカットを開始します。

yaml

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

ショートカットの名前変更

dreame_vacuum.vacuum_rename_shortcut

ショートカットにカスタム名を設定します。

注意

掃除機エンティティの shortcuts 属性からショートカットIDを取得できます。
ショートカット名は一意である必要があります。新しい名前が他のショートカットで既に使用されている場合、公式アプリと同様にカウンターが追加されます。(例: Mopping after sweeping は Mopping after sweeping2 になります)
生成されたショートカットボタンエンティティの名前はショートカット名に従います。
ロボットが稼働中はショートカットの名前を変更できません。

例

ID 32 のショートカットの名前を "掃き掃除後のモップ掛け" に変更します。

yaml

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 属性からショートカットIDを取得できます。
削除されたショートカットのボタンエンティティは自動的に削除されます。
ショートカット自身のタスクが実行中の場合、削除できません。
削除されたショートカットは復元できず、公式アプリからのみ再作成できます。

例

ID 34のショートカットを削除

yaml

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

現在のマップでの部屋の掃除順序を設定

注意

正確な部屋IDの数をシーケンスリストとして渡す必要があります

例

現在のマップでの部屋の掃除順序を3、5、4、2、1に設定

yaml

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

現在のマップでカスタム掃除順序を無効にする

yaml

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に設定

yaml

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に設定

yaml

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

例

メインブラシの寿命をリセット

yaml

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

モップパッドの寿命をリセット

yaml

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リクエストを送信するために使用できます。

実験的使用のみ

エンドユーザーがこのサービスを直接使用することは推奨されません。この統合にまだ実装されていないためにこのサービスを使用する必要があるアクションがある場合は、代わりに機能リクエストを開くしてください。

ヒント

コマンドとパラメータの詳細情報。

例

自動空にする開始

yaml

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

タイトモッピングパターンを有効にし、カーペットブーストを無効にする

yaml

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

掃除機サービス ​

部屋の掃除 ​

ゾーン清掃 ​

スポット清掃 ​

ポイントへ移動 ​

パスに従う 実験的 ​

ショートカットの開始 ​

ショートカットの名前変更 ​

ショートカットの削除 ​

音声パックのインストール ​

清掃順序の設定 マップサポート ​

カスタマイズ清掃の設定 マップサポート ​

消耗品のリセット ​

リモートコントロール 推奨されない ​

コマンドを送信 推奨されない ​

掃除機サービス

部屋の掃除

ゾーン清掃

スポット清掃

ポイントへ移動

パスに従う実験的

ショートカットの開始

ショートカットの名前変更

ショートカットの削除

音声パックのインストール

清掃順序の設定マップサポート

カスタマイズ清掃の設定マップサポート

消耗品のリセット

リモートコントロール推奨されない

コマンドを送信推奨されない