FAQ
このページでは、GitHubの課題トラッカーで繰り返し出る質問を集めています。新しい課題を開く前にここを確認すると時間を節約できます。なぜなら、これらのほとんどはバグではなく、文書化された原因のある予期された動作だからです。
既存の課題を検索
どれも当てはまりませんか？新しいものを開く前にGitHub上のクローズされた課題を必ず検索してください。問題が解決しない場合は、問題報告ページでデバッグログの収集方法や適切なバグレポートまたは機能リクエストの開き方が説明されています。
通知を携帯電話にプッシュできますか？
回答を表示
直接はできません。デフォルトでは、統合は Home Assistant ダッシュボード内に 持続的な通知 を作成するだけであり、それらはモバイルデバイスの Home Assistant Companion App に 自動的には転送されません。これは、統合が持たない特定のデバイスごとの通知ターゲットが必要だからです。
電話でそれらを受信するには、統合のイベント（または生成された永続通知）をリッスンし、それらをモバイルデバイス用のnotifyターゲットに転送するカスタム自動化を作成する必要があります。
障害物 / AI検出写真が表示されない マップサポート
回答を表示
アプリでAI障害物画像アップロードが有効になっているにもかかわらず障害物画像が空のままの場合、Home Assistantに接続されたアカウントがデバイスを最初に追加し所有しているアカウントではなく、共有/ファミリーアカウントであると、メーカーのクラウドAPIがその共有アカウントの障害物画像アクセスを静かにブロックすることがあります。実際の所有アカウントを使用するか、アプリ内で共有アカウントにカメラアクセスが明示的に許可されていることを確認すると、ほとんどの場合これが解決します。
マップカメラをHomeKit / Apple Homeにストリームできますか？ マップサポート
回答を表示
ライブビューとしては確実ではありません。マップカメラは本物のMJPEGとしてストリーミングされており、Home Assistant自身のカメラプラットフォームが使用する方法と同じです。そのため、Apple Homeでの静止プレビュー画像は正しく表示されます。新しいフレームはマップが実際に変わったときのみ生成され、掃除機が停止している間はストリームは何も出力しません。HomeKitのライブビューは常に更新されるソースが必要で、Home AssistantはMJPEGストリームをHomeKitが表示可能にするために追加のレイヤーで変換する必要があります。HomeKitはMJPEGを直接受け入れないためです。マップストリームが静かになると、その変換レイヤーは接続が失われたと見なし、Home Assistantはカメラにストリームソースがないか、ライブ映像の代わりに空のフィードを表示します。
これは複数回報告されています。ffmpeg カメラプラットフォーム、go2rtc、および Generic Camera 統合を使用した試みでは、すべて同じ結果が出ます: 静止プレビューは動作しますが、HomeKit 内での連続的なライブフィードは動作しません。この統合や他の類似の掃除機マップストリームで完全に動作するセットアップは確認されていません。
Home Assistant がクラッシュ、再起動、または大量のメモリを使用する マップサポート
回答を表示
この統合は、公式アプリに似たズーム可能な高解像度マップ画像をレンダリングしますが、これにはかなりの量のメモリを使用する可能性があります。Raspberry Pi、小規模な VM、または 2～3GB 程度に制限されたコンテナなど、RAM が限られたシステムでは、使用可能なメモリを使い果たし、Home Assistant がフリーズ、再起動、または起動に失敗することがあります。これは通常、マップ対応デバイスの追加後、またはそのデバイスページやマップカメラを開いた直後に発生します。
修正
デバイスの設定オプションから 低解像度マップ画像 を有効にします。これにより、ほとんどのケースが解決します。
そのオプションを有効にした後でもまだクラッシュする場合、マップデータ自体が破損しているか、時間の経過とともに異常に大きくなっている可能性があり、それがレンダリング時のメモリ使用量を増加させることがあります。バックアップとリカバリー から古い正常なマップを復元すると解決することがあります。どちらも効果がない場合は、デバッグログを収集する してバグレポートを開いてください。これは異なる根本原因を示しています。
Home Assistant アップデート後に、py_mini_racer に関するメッセージとともに統合が読み込めない マップサポート
回答を表示
この統合は py-mini-racer に依存しており、これは公式アプリに合わせてマップを最適化およびレンダリングするために使用される JavaScript エンジンです。この依存関係は統合によってではなく、Home Assistant 自身によってインストールされ、時々インストールに失敗したり、Home Assistant Core のアップデート後にネイティブバイナリの読み込みに失敗したりすることがあります。特に musl ベースのシステム（いくつかのプラットフォーム上の HAOS など）やアップグレード直後に発生しやすい問題です。
環境の問題
これは統合のコードで検出したり回避したりできる問題ではなく、環境／依存関係のインストールの問題です。Home Assistant のバージョンやインストールタイプに関係なく、繰り返し発生します。
依存関係のインストールを再試行させるために Home Assistant を再起動すると、場合によっては解決することがあります。問題が続く場合は、実際の pip/依存関係のインストールエラーについて、Home Assistant の起動時のログを確認してください。そのエラーが解決する必要がある問題です（プラットフォームレベルのインストール失敗のように見える場合は、Home Assistant Core の問題としても含まれます）。
Valetudo を実行しているデバイスは、この統合で使用できますか？
回答を表示
はいとも言えますし、いいえとも言えます。技術的には、この統合が Valetudo と併用して動作するのを妨げる制限はありません。Valetudo はローカル miIO API を無効にしないため、トークンを取得できればデバイスは ローカル接続 を通じて制御可能です。しかし、マップデータはローカル API 経由では取得できず、Valetudo はサービスを通じて生のマップデータを公開していません。したがって、この統合はマップサポートなしでのみ機能します。
マップサポートがない場合、この統合によって提供される機能はほとんど冗長となります。なぜなら、残りのすべての機能は既にネイティブを通じて利用可能だからです。 Valetudo Home Assistant MQTT 統合.