これは Home Assistant 2025.12.2+ をベースに、初心者ユーザー向けに書かれた Samsung TV（サムスンテレビ）接続チュートリアルです。
核心となる仕組み（わかりやすい版）
Home Assistant (HA) でサムスンテレビを操作する方法は、主に次の 2 つを組み合わせます：
- ローカルネットワーク制御：HA が家庭内の WiFi／LAN ケーブルを通してテレビに直接コマンドを送ります（音量調整・チャンネル変更）。テレビの電源が入っていて、制御が許可されている必要があります。
- SmartThings クラウド制御（強く推奨）：最近のサムスンテレビは省エネのため電源を切るとローカルネットワーク接続を遮断し、HA から直接「起こす」（電源を入れる）ことができません。Samsung SmartThings アカウントを連携すると、HA はクラウド経由で「電源オン」コマンドを送信でき、「消せるけど点けられない」という悩みを解決できます。
ステップ1：テレビ側の設定（重要！この手順をしないと接続できません）
テレビを HA に接続する前に、まずテレビの「リモートコントロール」の扉を開ける必要があります。メニューは機種によって多少異なりますが、ほぼ同じです：
- 固定 IP アドレス（推奨）：
- ルーターの管理画面でテレビの IP を固定 IP（例：192.168.1.100）に設定することをおすすめします。テレビの再起動で IP が変わると、HA がテレビを見つけられなくなります。
IP 制御の許可を有効にする：
- テレビのリモコンを手に取り、設定 (Settings) -> 一般 (General) -> ネットワーク (Network) -> 詳細設定 (Expert Settings) に進みます。
- IP リモート (IP Remote) または モバイルから電源オン (Power On with Mobile) を見つけ、すべてオン (Enable/On) にします。
通知設定を調整する（煩わしさを防ぐ）：
- 設定 -> 一般 -> 外部デバイスマネージャー (External Device Manager) -> デバイス接続マネージャー (Device Connection Manager) に進みます。
- アクセス通知 (Access Notification) を 初回のみ (First Time Only) に変更します。変更しないと、以降 HA がコマンドを送るたびにテレビ画面に「許可しますか」というポップアップが表示されます。
ステップ2：SmartThings トークンを取得する（「電源が入らない」問題を解決）
シンプルな電源オフと音量制御だけで十分で、HA からの電源オンにこだわらない場合は、この手順を省略できます。ただし最高の体験のためには追加をおすすめします。
- パソコンのブラウザで開きます：。
- サムスンアカウントでログインします（テレビにログインしているアカウントと同じである必要があります）。
- “Generate new token” をクリックします。
- Token Name：任意で構いません。例：HomeAssistant。
- Authorized Scopes（認可範囲）：すべて選択（すべてのチェックボックスをオンにします。一部の権限だけで足りますが、初心者は全選択が最も簡単で、選び忘れも防げます）。
- 下部の “Generate token” をクリックします。
- 重要：ページに長い文字列（xxxxxxxx-xxxx… で始まるもの）が表示されます。すぐにコピーして保存してください！この文字列は一度しか表示されず、ページを閉じると二度と確認できません。
ステップ3：Home Assistant にテレビを追加する
テレビの電源が入っており、HA と同じローカルネットワーク内にあることを確認します。
- Home Assistant の Web 版を開きます。
- 左メニューの 設定 (Settings) -> デバイスとサービス (Devices & Services) をクリックします。
- 通常 HA はテレビを自動検出し、上部の「検出済み」に表示します。
- ケース A：自動検出された場合
- 設定 (Configure) をクリックします。
- HA が接続するか確認してくるので、送信 (Submit) をクリックします。
ケース B：自動検出されない場合
- 右下の + インテグレーションを追加 (Add Integration) をクリックします。
- Samsung を検索し、Samsung Smart TV を選択します。
- Host：テレビの IP アドレスを入力します（例：192.168.1.100）。
- Name：任意の名前で構いません。例：リビングのテレビ。
テレビ画面に注目
：
- このときテレビの右上に「Allow Home Assistant to connect?」（Home Assistant の接続を許可しますか？）というウィンドウが表示されることがあります。
- すぐにリモコンを手に取り、許可 (Allow) を選択します。見逃すと最初からやり直しになる場合があります。
SmartThings トークンを入力する（求められた場合）：
- HA が SmartThings API Key（または Token）の入力を求めるポップアップを表示することがあります。
- ステップ2でコピーした文字列を貼り付けます。
- 注：Token の入力を求められなくても心配いりません。追加成功後にインテグレーションの「オプション」を確認できますし、自動認識されている可能性もあります。
ステップ4：検証とトラブルシューティング
追加に成功したら、HA の「概要」ページでメディアプレーヤーのカードが表示されるはずです。
- 電源のオン／オフをテスト：
- 「電源オフ」アイコンをクリックすると、テレビが消えるはずです。
- 1 分待ってから「電源オン」アイコンをクリックします。SmartThings を設定していれば、テレビが点灯するはずです。
状態が更新されない場合（ずっとオフ表示なのに、実際はテレビがついている）：
- これはネットワーク遅延です。通常は数秒から数十秒で同期されます。
電源が入らない場合：
- テレビが WiFi の 5G 帯に接続されていないか確認してください。古いサムスンテレビの中には 5G WiFi 環境でスリープ後に深くネットワークから切断され、接続できなくなるものがあります。2.4G WiFi に接続するか、LAN ケーブルを挿してみてください。
- ステップ2の SmartThings Token が正しく設定されているか確認してください。
よく使う機能の補足
HA のオートメーション (Automation) では、次のようなことができます：
- トリガー条件：media_player.living_room_tv が off から on に変わったとき。
- 実行アクション：リビングの照明を自動で暗くし、カーテンを閉める。
これで、サムスンテレビを Home Assistant 2025.12.2+ に正常に接続できました！
