HomeAssistant に塗鴉（Tuya）デバイスを追加する方法は主に 2 つあります：公式 Tuya インテグレーション（クラウド、最も簡単）と Tuya Local（ローカル化、応答が速いが設定はやや手間）です。
「初心者」ユーザーには公式 Tuya インテグレーションを強くおすすめします。現在のバージョン（2025.12.x）では手順が大幅に簡素化され、以前のように開発者アカウントを登録したり、Access ID を申請したり、開発者トライアル期間の期限切れを心配したりする必要はありません。今は「ユーザーコード」とスマホアプリでのコードスキャンだけで済みます。
以下は HomeAssistant 2025.12.2 バージョンに基づく詳しい初心者向けチュートリアルです。
🟢 方法1：公式 Tuya インテグレーション（初心者に推奨）
この方法が最も簡単です。設定すると、スマホの「塗鴉智能」または「智能生活」アプリで見えるデバイスが自動的に HomeAssistant に同期されます。
1. 準備
- スマホアプリ：スマホに「塗鴉智能」(Tuya Smart) または「智能生活」(Smart Life) アプリがインストールされていることを確認します。
- アカウント：登録・ログイン済みで、アプリにスマートデバイス（コンセント、電球など）がすでに追加されていること。
- ネットワーク：スマホと HomeAssistant は同じローカルネットワークにあるのが望ましいですが、クラウドインテグレーションでは必須ではありません。
2. 「ユーザーコード」(User Code) を取得する
これが新版インテグレーションで最も重要な手順で、以前の複雑な開発者アカウントに代わるものです。
- スマホの 塗鴉智能 または 智能生活 アプリを開きます。
- 右下の「我」(Me) をタップします。
- 右上の六角形の設定アイコン (⚙️) をタップします。
- 最初の項目「アカウントとセキュリティ」(Account and Security) をタップします。
- ページ中央に「ユーザーコード」(User Code) が表示されます。
- コードの横にある「コピー」ボタンをタップします（または手動で控えます）。
注意
：「ユーザーコード」が見つからない場合は、アプリが最新バージョンに更新されているか確認してください。
3. HomeAssistant にインテグレーションを追加する
- パソコンのブラウザで HomeAssistant の管理画面を開きます（通常は http://homeassistant.local:8123）。
- 左側のサイドバーの「設定」(Settings) をクリックします。
- 「デバイスとサービス」(Devices & Services) を選択します。
- 右下の青いボタン「+ インテグレーションを追加」(+ ADD INTEGRATION) をクリックします。
- 検索ボックスに Tuya と入力し、表示された Tuya アイコンをクリックします。
4. ペアリングする
- HomeAssistant が表示するウィンドウで、ユーザーコードの入力が求められます。
- 先ほどスマホアプリで取得したユーザーコードを貼り付け、「送信」をクリックします。
- 画面に QR コードが表示されます。
- すぐにスマホを手に取り、塗鴉／智能生活アプリを開きます：
- アプリのホーム画面（「家庭」ページ）に戻ります。
- 右上の「+」をタップし、「スキャン」を選択します。
- パソコン画面の QR コードをスキャンします。
スマホにログイン確認のプロンプトが表示されるので、「ログインを確認」をタップします。
5. 完了
- HomeAssistant のページが自動的に更新され、「成功！」と表示されます。
- デバイスを特定の部屋に割り当て（管理しやすいようエリアを選ぶことをおすすめします）、「完了」をクリックします。
- 「概要」(Overview) パネルを開くと、塗鴉デバイスが表示され、オン／オフを操作できるはずです！
🔵 方法2：Tuya Local（上級、ローカル制御）
公式インテグレーションの応答が遅い、またはネットワークが切れると使えないと感じた場合は、この方法を試してください。HACS 経由でインストールし、実現できます
簡単な流れ（参考）：
- まず HACS（Home Assistant Community Store）をインストールする必要があります。
- HACS で Tuya Local を検索してダウンロードします（LocalTuya ではない点に注意。Tuya Local のほうが設定が分かりやすいです）。
- HomeAssistant を再起動します。
- 「デバイスとサービス」でインテグレーションを追加し、Tuya Local を検索します。
- 新版の利点：現在の Tuya Local も上記の「スキャン」モードで Key を自動取得でき、開発者プラットフォームで通信をキャプチャする必要がなくなりました。とても便利です。
よくある質問 (Q&A)
Q: 以前のチュートリアルでは iot.tuya.com の開発者アカウント登録、Access ID と Secret、さらに 6 か月ごとの更新が必要と言われていましたが、もう不要ですか？ A: 不要です！ それは旧版（2024 年初頭以前）の手順です。現在の公式インテグレーションは「スマートホーム PaaS」モデルを使用しており、一般ユーザーはアプリでコードをスキャンするだけで、面倒な開発者トライアル期間の問題を完全に回避できます。
Q: HomeAssistant でデバイスが「使用不可」と表示されたらどうすればよいですか？ A:
- 物理デバイスに通電があり、ネットワークに接続されているか確認します。
- HA のインテグレーションページで Tuya を見つけ、3 つの点をクリックして「再読み込み」(Reload) を選択します。
- それでも解決しない場合は、HomeAssistant を再起動してみてください。
Q: アプリでデバイス名を変更したら、HA は同期しますか？ A: リアルタイムでは同期しません。HA の Tuya インテグレーションページで「再読み込み」をクリックすると、最新のデバイス名に更新されます。
