진공청소기 서비스

통합 기능은 표준 엔터티를 통해 직접 제어할 수 없는 고급 동작 및 기능을 위한 다양한 맞춤형 서비스를 제공합니다. 이러한 맞춤형 서비스는 vacuum 도메인을 사용하며 장치별 기능에 대한 세밀한 제어를 제공합니다.

방 청소

dreame_vacuum.vacuum_clean_segment

선택한 방 청소를 시작하며, 선택적으로 맞춤 청소 매개변수를 지정할 수 있습니다.

참고

• 지도 기능과 통합하여 사용하는 경우, 진공 청소기 엔터티 속성에서 세그먼트 ID를 얻을 수 있습니다.
• customized_cleaning 또는 cleaning_sequence이 활성화된 경우, 청소 매개변수와 청소 순서는 장치에서 무시됩니다.

청소 모드 설정

이 서비스는 cleaning_mode 매개변수를 허용하지 않습니다. 청소 시작 전에 모드를 동적으로 설정하려면 FAQ을 참조하세요.

예시

• 방 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

선택한 구역 청소를 시작하고 선택적으로 맞춤 청소 매개변수를 지정합니다.

팁

Xiaomi 진공청소기 지도 카드를 사용하여 구역 좌표를 획득할 수 있습니다.

청소 모드 설정: 이 서비스는 cleaning_mode 매개변수를 허용하지 않습니다. 청소 시작 전에 동적으로 모드를 설정하려면 FAQ를 참조하세요.

예시

• 선택한 구역 청소

  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 장치에서도 작동합니다.

팁

Xiaomi 진공청소기 지도 카드를 사용하여 지점 좌표를 획득할 수 있습니다.

청소 모드 설정: 이 서비스는 cleaning_mode 매개변수를 허용하지 않습니다. 청소 시작 전에 동적으로 모드를 설정하려면 FAQ를 참조하세요.

예시

• 선택한 지점 청소

  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%여야 하고 좌표는 현재 지도 내부에 있어야 합니다.
• 로봇이 이미 선택된 좌표 위에 있거나, 스테이션에서 배수 중이거나, 스테이션이 자체 수리/테스트 중일 때 장치는 이 동작에 응답하지 않습니다.

팁

Xiaomi 진공청소기 지도 카드를 사용하여 지점 좌표를 획득할 수 있습니다.

예시

• 좌표 [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% 이상이어야 하며, 스테이션이 배터리를 충전하거나 자가 수리/테스트 중일 때는 장치가 이 동작에 반응하지 않습니다.
• Xiaomi 진공청소기 지도 카드를 사용하여 지점 좌표를 획득할 수 있습니다.

예시

• 세 개의 지점 경로를 따라가기

  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 속성에서 바로가기 ID를 얻을 수 있습니다.
• 유효한 바로가기 ID는 25에서 128 사이입니다.
• 통합 기능은 또한 장치의 모든 바로가기에 대해 button.{vacuum_name}_shortcut_{shortcut_id}로 버튼 엔터티를 생성하므로, 일반적으로 이 서비스를 사용하는 것은 필요하지 않습니다.
• 장치는 스테이션이 배수 중이거나 자체 복구/테스트 중일 때 이 동작에 반응하지 않습니다.

예시

• ID 32의 바로가기를 시작합니다.

  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의 바로기기를 "청소 후 물걸레질"로 이름 변경합니다.

  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인 바로가기 삭제

  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로 설정

  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

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