この連携について
SimplyPrintはHome Assistantの承認を受けておらず、同社との提携もありません。商標と画像は、プラットフォームとの互換性を示す目的でのみ使用しています。SimplyPrintでのHome Assistant製ハードウェアの使用は、Home Assistantが意図した用途と異なる場合があります。すべての権利はそれぞれの所有者に帰属します。
Home AssistantでSimplyPrintを使用：常時稼働している端末でクライアントを実行
SimplyPrint ClientアドオンはHome Assistantのマシン上でプリンタークライアントを直接実行します。常時稼働しているマシンでプリンターの接続も維持できるため、プリンターごとの予備のRaspberry Piや別の管理対象は不要です。
このアドオンはHome AssistantのマシンをプリンターとSimplyPrintの間のブリッジとして使います。役割はそれだけです。
プリンターをHome Assistantにエンティティとして追加する機能はありません。プリンターのセンサーや、ダッシュボードに表示する温度や進捗の値、自動化に使える情報は提供されません。それらは別の機能で、まだ開発されていません。提案#324を参照してください。
アドオンはHome AssistantのIngressを使用し、インターフェースはHome Assistant経由で提供されます。サイドバーに表示を有効にすると、Home AssistantのメニューにSimplyPrintが表示されます。ポートを開く必要はなく、クライアントのインターフェースはHome Assistant経由のリクエストのみを受け付けます。
必要なもの
- Home Assistant OSまたはSupervisedインストール。アドオンにはSupervisorが必要なため、Home Assistant ContainerとHome Assistant Coreにはインストールできません。
- 64ビットのマシン：
aarch64またはamd64。32ビットのRaspberry Pi OSはサポートされません。 - SimplyPrintがローカル接続をサポートしているプリンター。
ここで実行する利点
- 常時稼働の1台を活用。Home Assistantのマシンは家庭内で安定して電源が入っている機器です。
- 他のデータと一緒にバックアップ。アドオンはHome Assistantのバックアップに含まれます。
- サイドバーから設定。IngressによりクライアントUIはHome Assistantのパネルとして表示され、別のアドレスを覚える必要はありません。
- すでに稼働中のHome Assistant機器でSimplyPrintクライアントを実行
- My Home Assistantからワンクリックでリポジトリをインストール
- Home AssistantのサイドバーにSimplyPrintのパネルとして表示されます（Ingress）
- Home Assistantのバックアップに含まれる
- Home Assistant OSとSupervisedのインストール、aarch64およびamd64
- SimplyPrintが管理する公式アドオンリポジトリ
- プリンターをHome Assistantのエンティティとして公開しません。これはブリッジであり、ダッシュボード連携ではありません
Home AssistantにSimplyPrintアドオンをインストールする方法
インストールの種類を確認
アドオンにはSupervisorが必要です。64-bitマシンにHome Assistant OSまたはSupervisedをインストールしてください。ContainerまたはCoreのインストールには追加できません。
リポジトリを追加
Home Assistantで設定 → アプリに移動します（Home Assistantではアドオンの名称がアプリに変更されたため、古いガイドではアドオンと表記されています）。アプリストアを開き、3点メニューからリポジトリを選択して、https://github.com/SimplyPrint/home-assistant-appsを貼り付けてください。
SimplyPrint Clientをインストール
ストアにSimplyPrint Clientアドオンが表示されます。開いてInstallをクリックしてください。実験的なリリース候補版のため、まずアドオンページの警告を確認してください。
起動してパネルを開く
起動時に開始、ウォッチドッグ、サイドバーに表示をオンにし、アドオンを起動します。次にHome AssistantのメニューからSimplyPrintを開き、設定手順に従ってプリンターをSimplyPrintアカウントに接続します。
よくある質問
SimplyPrintのHome Assistantアドオンはすぐに使えますか？
はい。公式アドオンリポジトリで公開されており、すぐにインストールできます。まだ新しい実験的な機能（1.0.0-rc.17）のため、他のインストール方法ほど多くのユーザーに試されていません。バグを見つけた場合はお知らせください。修正します。
Home Assistant ContainerまたはCoreで動作しますか？
いいえ。アドオンはHome Assistant Supervisorによって管理されます。SupervisorはHome Assistant OSとSupervisedのインストール環境にのみ存在します。ContainerまたはCoreでは、代わりにネットワーク上のマシンでSimplyPrintクライアントを直接実行してください。
どのハードウェアに対応していますか？
64ビットのみ対応：aarch64とamd64。64ビットのHome Assistant OSを実行するRaspberry Pi 4または5、Intel NUC、汎用x86マシンに対応しています。32ビット環境ではアドオンが表示されません。
ポートを公開するか、トンネルを設定する必要がありますか？
いいえ。このアドオンはHome AssistantのIngressを使用するため、画面はHome Assistant自体を通じて提供され、クライアントはその経路からのリクエストのみを受け付けます。サイドバーに表示を有効にすると、Home Assistantのメニューにパネルとして表示されます。
Home Assistantと一緒にバックアップされますか？
はい。アドオンはHome Assistantのバックアップに含まれるため、他の設定と一緒に保存されます。
ワンクリックでインストールできますか？
はい。Home Assistantに接続できるデバイスで、このページのMy Home Assistantのアプリストアを開くボタンを押すと、リポジトリが追加されます。その後、ストアからSimplyPrint Clientをインストールしてください。手動で追加する場合は、設定 → アプリ（旧アドオン） → アプリストア → 三点メニュー → リポジトリの順に進みます。
プリンターはHome Assistantにセンサーやエンティティとして追加されますか？
いいえ。これはよくある誤解です。このアドオンはHome Assistantを実行している機器上でSimplyPrintのクライアントを動かし、プリンターがSimplyPrintに接続できるようにします。ダッシュボードとの連携ではなく、橋渡しの役割を果たします。エンティティは作成されないため、Home Assistantのダッシュボードに表示したり、オートメーションに使ったりできる温度、進捗、AMSのデータはありません。それには別途対応が必要です。提案 #324で状況を確認し、投票できます。
SimplyPrintの連携について
SimplyPrintの連携機能により、アプリケーションと3Dプリンターが相互にやり取りできます。これにより無限の可能性が広がります。3DプリンターはIOTデバイスとして、あらゆるアプリケーションと連携できるべきだと考えています。
そのため、SimplyPrintのチームは、よく使われるプラットフォーム、スライサー、アプリケーション向けの公式連携の提供に取り組んでいます。また、APIを使ったカスタム連携の作成や、承認済みのサードパーティーによる「SimplyPrintでログイン」方式（「OAuth2」方式を使用）の連携の作成も可能です。この連携はすべてのSimplyPrintユーザーが利用できます。
SimplyPrintとの連携機能を開発する場合は、関連するドキュメントを参照してください。
開発者ではない場合でも、特定のアプリケーションとの連携を希望する場合は、ロードマップまたは提案リストにすでにあるか確認してください。なければ、ご提案ください。