インテグレーションは、HAにおける重要な概念であり、システム全体を串聯するものです。では、インテグレーションとは何でしょうか？
インテグレーションとは、デバイスやサービスを統合することを意味します。つまり、デバイスやサービスは、インテグレーションの一種抽象的な表現と言えます。一方、エンティティ（Entity）は、インテグレーション（例：light、switchなど）を通じて標準化されます（例：Xiaomiライトはlightインテグレーションを通じてエンティティとして統合されます）。標準化されたエンティティには、制御に使用されるサービスが付加されます。
エンティティは、HAの内部動作を抽象化します。インテグレーターとして、サービスやステートマシンの動作を心配する必要はありません。代わりに、エンティティクラスを拡張し、統合するデバイスタイプに必要な属性とメソッドを実装することができます。
1.デバイスインテグレーション (例：hue) は、この設定を使用してデバイス/サービスとの接続を確立します。これは Config Entry (従来は検出アシスタントを使用) を転送して、それぞれのインテグレーション (light、switch) でエンティティを設定します。デバイスインテグレーションは、標準化されていないエンティティのために独自のサービスを登録することもできます。これらのサービスは、インテグレーションのドメイン下で公開されます (例: hue.activate_scene)。
2.エンティティインテグレーション (例: light) は、抽象的なエンティティクラスとサービスを定義してエンティティを制御する役割を担います。
3.エンティティコンポーネントヘルパー は、設定をプラットフォームに配信し、検出を転送し、サービス呼び出しに使用されるエンティティを収集する役割を担います。
4.エンティティプラットフォームヘルパー は、そのプラットフォームのすべてのエンティティを管理し、必要に応じて更新を取得するためにポーリングする役割を担います。エンティティを追加する際、エンティティプラットフォームはエンティティをデバイスおよびエンティティレジストリに登録する役割を担います。
5.インテグレーションプラットフォーム (例: hue.light) は、設定を使用して外部デバイス/サービスをクエリし、追加するエンティティを作成します。インテグレーションプラットフォームは、エンティティサービスを登録することもできます。これらのサービスは、デバイスインテグレーションのすべてのエンティティ上でエンティティインテグレーションによって実行されます (つまり、すべての Hue ライトエンティティ)。これらのサービスは、デバイスインテグレーションのドメイン下で公開されます。
エンティティと HA Core の相互作用
– エンティティ基底クラスから継承された統合エンティティクラスは、データの取得とサービス呼び出しの処理を担当します。ポーリングが無効になっている場合は、データが利用可能になったことを HA に通知する役割も担います。
– エンティティ基底クラス（エンティティインテグレーションによって定義）は、データをフォーマットしてステートマシンに書き込む役割を担います。
– エンティティレジストリは、現在エンティティオブジェクトによってサポートされていない any 登録エンティティに対して `unavailable` 状態を書き込みます。
エンティティデータ階層
エンティティデータは、以下の階層構造になっています。
– ドメイン: エンティティの種類を表します (例: light、switch、sensor)
– プラットフォーム: エンティティがどのように統合されているかを示します (例: hue、mqtt、zwave)
– エンティティID: 個々のエンティティを一意に識別します
エンティティを削除、無効化、または再有効化すると、下位のすべてのエンティティもそれに応じて調整されます。
エンティティと HA Core の相互作用
1. エンティティと HA Core の通信
- エンティティ基底クラスから継承された統合エンティティクラスは、データの取得とサービス呼び出しの処理を担当します。ポーリングが無効になっている場合は、データが利用可能になったことを HA に通知する役割も担います。
- エンティティ基底クラス（エンティティインテグレーションによって定義）は、データをフォーマットしてステートマシンに書き込む役割を担います。
- エンティティレジストリは、現在エンティティオブジェクトによってサポートされていない any 登録エンティティに対して
unavailable状態を書き込みます。
エンティティデータ階層
2. エンティティデータ階層
エンティティデータは、以下の階層構造になっています。
- ドメイン: エンティティの種類を表します (例: light、switch、sensor)
- プラットフォーム: エンティティがどのように統合されているかを示します (例: hue、mqtt、zwave)
- エンティティID: 個々のエンティティを一意に識別します
エンティティを削除、無効化、または再有効化すると、下位のすべてのエンティティもそれに応じて調整されます。
