ホーム アシスタントはほぼ無限にカスタマイズ可能であるにもかかわらず、表面レベルでは比較的簡単に感じることができます。ただし、場合によっては、統合をセットアップしたり、手動で変更を加えたりする必要があることがわかり、その場合、 configuration.yaml ファイル。
このファイルの役割、編集方法、そしておそらくあまり心配する必要がない理由を以下に示します。
configuration.yaml ファイルにはいくつかの目的がありますの configuration.yaml ファイルは、一般的に次の場所にある一連の命令です。 config ホーム アシスタント サーバー上のディレクトリ。 YAML 拡張子は、ファイル内で使用される書式設定のタイプを指します (当初は Yet Another Markup Language の略語と言われていましたが、最終的には YAML Ain't Markup Language に適応されました)。
YAML 形式は、インデントなどの単純なルールを使用して、人間が判読できるコードになるように設計されています。これは、オートメーションやスクリプトなど、Home Assistant プラットフォーム全体で広く使用されています。エンティティや値などの基本的なホーム アシスタントの概念を理解する必要はありますが、書式設定が参入障壁にならないようにアクセシブルであることを目標に設計されています。
おそらく、変更を加える主な理由は、 configuration.yaml ファイルは、特定のオートメーションを呼び出したり、メイン ユーザー インターフェイスの外でホーム アシスタントが動作する方法に変更を加えたりするためのものです。
プラットフォームの使用中に遭遇する統合の大部分は、便利な構成パネルとセットアップ プロセスを備えたメイン UI を介して追加されます。人里離れた道を少し踏み込んで、ホーム アシスタントのメイン リリースの外部から (たとえば、ホーム アシスタント コミュニティ ストアから) 統合をインストールする場合は、 configuration.yaml ファイルを使用して、サーバーの起動時にこれらの統合を実行します。
これは、コピーして貼り付けることができる数行のコードを追加するだけの簡単な場合もあれば、統合で目的の動作をさせるためにパラメーターを定義する、より複雑なセットアップ プロセスが必要になる場合もあります。以前、ホーム アシスタント ダッシュボードに交通機関に重点を置いた統合を追加したことがありますが、そのためには、必要な API にリンクし、YAML で適切な停車地と移動データを参照する必要がありました。
もう一つの用途は、 configuration.yaml ファイルは、ホーム アシスタントの機能方法に変更を加えるときに作成されます。この良い例は、プラットフォームのさまざまな部分へのショートカットを作成するためにサイドバーをカスタマイズすることです。
このファイルは、スクリプト、オートメーション、シーン、フロントエンド テーマを含む他の YAML ファイルを呼び出すためにも使用されます。ほとんどの場合、これらを変更する理由はありませんが、必要に応じて独自のものを追加することもできます。
configuration.yaml ファイル編集できます configuration.yaml アクセスできる限り、通常のテキスト エディタを使用してファイルを作成します。ほとんどの場合、次の場所にあります。 /config/ ディレクトリはサーバー上にありますが、Docker ユーザーはコアの下にあります。 /homeassistant/ ディレクトリ。
Raspberry Pi などのサーバーでホーム アシスタントを実行している場合、または仮想マシンを使用して別のオペレーティング システムでホーム アシスタントを実行している場合。このファイルにアクセスするのは面倒な場合があります。ありがたいことに、ファイル エディターと呼ばれるアドオンを使用すると、これを簡単に回避する方法があります。
ファイル エディター アドオンは、[設定]>[アドオン]で[アドオン ストア]ボタンをクリックして検索することでインストールできます。セットアップが完了したら、[設定]>[アドオン]>[ファイル エディター]>[Web UI を開く]でファイル エディターを起動します。さらに簡単にするために、このショートカットを作成しました。
デフォルトでは、 configuration.yaml ファイルが最初に開きます。ここで、必要な行を追加し、各行の上にコメント (#) を使用して説明を追加すると、さまざまなセクションの動作がわかります。完了したら、画面の下部にある赤い「保存」ペンボタンをクリックします。
変更を実行するには、 configuration.yaml ファイルを削除するには、ホーム アシスタントを再起動する必要があります。これを行うには、[設定]メニューからページの右上隅にある[3 つの点]をクリックし、[ホーム アシスタントを再起動]を選択します。
別のオプションは、 /homeassistant/ Samba 共有アドオンをインストールし、ネットワーク上の別のコンピューター経由でサーバーに接続することにより、ネットワーク共有経由でディレクトリを作成します。ここから、 configuration.yaml テキスト エディター内でファイルを開き、必要に応じて変更を加えます。
指摘したように、 configuration.yaml ファイルは、突然操作する必要があることが判明するまで、操作する必要があるものではありません。日常的に使用する統合は、シンプルなユーザー インターフェイスを中心に構築されているため、このファイルを使用して手動で呼び出す必要はありません。
場合によっては、ニッチなデバイスやサービスをサーバーに統合するために使用する必要がある、あいまいな統合が見つかることがあります。をいじる必要がある configuration.yaml このファイルは、統合に時間をかける価値がないという意味ではなく、使用することを恐れる必要はありません。
いつものように、不要な変更を元に戻したり、必要に応じてサーバーを復元したりできるように、ホーム アシスタントのバックアップが設定されていることを確認してください。