这是一个基于 Home Assistant 2025.12.2 +版本，专为小白用户编写的 Samsung TV（三星电视）接入教程。
核心原理（通俗版）
Home Assistant (HA) 控制三星电视主要靠两种方式“混搭”：
- 局域网控制：HA 直接通过家里的 WiFi/网线给电视发指令（调节音量、换台）。这需要电视开机且允许被控制。
- SmartThings 云端控制（强烈推荐）：因为现在的新款三星电视为了省电，关机后会切断局域网连接，导致 HA 没法直接把它“喊醒”（开机）。通过接入 Samsung SmartThings 账号，HA 可以通过云端发送“开机”指令，解决“能关不能开”的痛点。
第一步：电视端设置（关键！不做这一步连不上）
在把电视接入 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 每次发指令，电视屏幕都会弹窗问你“是否允许”。
第二步：获取 SmartThings 令牌（解决“无法开机”问题）
如果你只想要简单的关机和音量控制，且不在乎能不能用 HA 开机，可以跳过此步。但为了完美体验，建议加上。
- 电脑浏览器打开：。
- 登录你的三星账号（必须是电视上登录的那个账号）。
- 点击 “Generate new token”（生成新令牌）。
- Token Name：随便填，比如 HomeAssistant。
- Authorized Scopes（授权范围）：全选（把所有框都勾上，虽然只要部分权限，但小白全选最省事，防止漏选）。
- 点击底部的 “Generate token”。
- 重要：页面会显示一串长长的字符（以 xxxxxxxx-xxxx… 开头），立刻复制保存下来！这串字符只会显示一次，关掉网页就找不回了。
第三步：在 Home Assistant 中添加电视
确保电视是开机状态，且和 HA 在同一个局域网内。
- 打开 Home Assistant 网页版。
- 点击左侧菜单的 设置 (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）。
- 把第二步里复制的那串字符粘贴进去。
- 注：如果没有弹窗让你输 Token，不用担心，添加成功后可以去集成的“选项”里看看，或者它可能自动识别了。
第四步：验证与排坑
添加成功后，去 HA 的“概览”页面，你应该能看到一个媒体播放器卡片。
- 测试开关机：
- 点击“关机”图标，电视应该关闭。
- 等待 1 分钟，点击“开机”图标。如果配置了 SmartThings，电视应该会亮起。
如果状态不更新（一直显示关机，但电视其实开着）：
- 这是网络延迟，通常几秒到几十秒会同步。
如果无法开机：
- 检查你的电视是否连接了 WiFi 5G 频段，有些老款三星电视在 5G WiFi 下休眠后会深度断网，连不上。尝试连 2.4G WiFi 或 插网线。
- 确认第二步的 SmartThings Token 是否正确配置。
常用功能补充
在 HA 的自动化 (Automation) 里，你可以这样玩：
- 触发条件：当 media_player.living_room_tv 从 off 变成 on。
- 执行动作：自动把客厅灯光调暗，窗帘拉上。
现在，你已经成功把三星电视接入 Home Assistant 2025.12.2 +了！
