Roborock Vacuum ソースコード タピオカをおごる
日本語

Roborock を
「ホーム」App で。

Roborock のロボット掃除機を HomeKit または Matter で「ホーム」App に追加する Homebridge プラグインです。Siri やオートメーションで掃除を始められ、Roborock のクラウドが止まっても家のネットワーク内で操作できます。

無料のオープンソース。Homebridge 1.6 以降に対応し、Matter には Homebridge 2 が必要です。

リビング キッチン 寝室 書斎
ロボット掃除機
掃除する部屋

試してみてください。部屋を選ぶか、選ばなければ家全体を掃除します。部屋ごとの掃除には Matter と iOS 18.4 以降が必要です。

クラウドが止まっても使える

Roborock のクラウドが必要なのは、サインインとデバイス一覧の取得のときだけです。操作は家のネットワーク経由で掃除機に直接届きます。Homebridge の起動時にクラウドにつながらなくても、保存済みのデバイス一覧で起動し、シーンなどのクラウド機能はクラウドの復旧後に自動で戻ります。

  1. 「ホーム」AppiPhone、iPad、Mac、HomePod
  2. Homebridgeプラグインを実行
  3. Roborock 掃除機家の Wi-Fi に接続

デバイス一覧を保存するため、最初に一度はオンラインで起動する必要があります。別の Roborock アカウントから共有された掃除機は、クラウド経由でのみ操作できます。

「ホーム」App でできること

それぞれの掃除機が、実際に備えている操作と情報を持って表示されます。

  • 開始・停止・ドックへ戻す

    HomeKit では扇風機タイプのタイルとして表示されます。オンで掃除を開始し、オフで停止してドックに戻ります。Siri、シーン、オートメーションにも対応します。

  • バッテリー・充電・エラー

    バッテリー残量、充電状態、バッテリー低下の警告。エラーを報告したりオフラインになった掃除機は、そのことが表示されます。原因を取り除いても消えないエラーは、プラグインの設定画面から解除できます。

  • Roborock のシーン

    Roborock App で作ったシーンがスイッチになり、タップ 1 回やオートメーションで一連の掃除を実行できます。

  • ドックでのモップ洗浄

    モップを洗えるドックでは、洗浄を開始・停止するスイッチが追加されます。どこから始めた洗浄でも、洗浄中はオンになります。

  • フィルターとブラシ

    HomeKit では、フィルター、メインブラシ、サイドブラシの残り寿命を表示し、交換時期が近づくとお知らせします。

  • 掃除中の部屋を MQTT へ

    掃除中の部屋を MQTT ブローカーに送ることもでき、照明などのオートメーションを掃除機に合わせて動かせます。

Matter で本来の掃除機操作を ベータ

掃除機に Matter を選ぶと、Apple「ホーム」では扇風機ではなくロボット掃除機として表示されます。掃除する部屋を選び、吸引・モップ・両方を切り替え、ドックに戻すこともできます。Google Home、Alexa、SmartThings でも使えます。

Apple「ホーム」の Matter 掃除機対応はまだ新しく、ペアリング時に「認証されていないアクセサリ」の警告が出たり、iOS のアップデート後にときどき不調が出たりします。いちばん安定して使いたい場合は HomeKit のままにしてください。

掃除機ごとに選べます

プラグインの設定でデバイスを読み込み、掃除機ごとに次の 3 つから選びます。

  • HomeKit (HAP)

    既定の設定。安定した、おなじみの扇風機タイプのタイルです。

  • Matter(ベータ)

    掃除機本来の操作と部屋ごとの掃除。Matter を有効にした Homebridge 2 が必要で、部屋ごとの掃除には iOS 18.4 以降が必要です。

  • スキップ

    別の家から共有された掃除機などを、Apple「ホーム」に追加しません。

掃除機のプロトコルを切り替えるとアクセサリが作り直されるため、部屋とオートメーションを設定し直してください。

Roborock App の掃除機に対応

Roborock App で使っているアカウントでサインインすると、プラグインが掃除機を自動で見つけます。次の機種は動作が確認されており、Roborock App のほかの掃除機もほとんど使えます。

  • S4
  • S4 Max
  • S5 Max
  • S6
  • S6 Pure
  • S6 MaxV
  • S7
  • S7 MaxV (Ultra)
  • S7 Pro Ultra
  • S7 Max Ultra
  • S8
  • S8 Pro Ultra
  • Q5+
  • Q5 Pro
  • Q7
  • Q7 Max
  • Q8 Max
  • Qrevo
  • Qrevo Pro
  • Qrevo S
  • Qrevo Curv
  • Saros 10

Xiaomi Home だけで使っている場合

プラグインが見つけられるのは、Roborock アカウントに登録された掃除機です。Xiaomi Home App だけで設定した掃除機はこのアカウントにないため、表示されません。

数分でセットアップ

  1. プラグインをインストール

    Homebridge UI で「プラグイン」を開き、Roborock Vacuum を検索して homebridge-roborock-vacuum をインストールします。

  2. サインイン

    プラグインの設定で Roborock App のメールアドレスを入力し、パスワードかメールで届くコードでサインインします。リージョンは自動で判別されます。

  3. 選んで再起動

    Load devices を押し、掃除機ごとに HomeKit、Matter、スキップのいずれかを選んで、Homebridge を再起動します。

Homebridge 1.6 以降と、Node.js 18.20、20.15、22、24 のいずれかが必要です。Matter には Matter を有効にした Homebridge 2 が必要です。 詳しいドキュメント(英語)

無料のままで続けるために

このプラグインには広告も有料版もありません。家事が少しでも楽になっていたら、タピオカ 1 杯や少しのご支援が、Roborock の新機種や新しいファームウェアへの対応を続ける力になります。

タピオカはクレジットカードで支払えます。PayPal アカウントは不要です。