HomeAssistant - SamsungTV Smart 组件使用教程

1. 项目介绍

HomeAssistant - SamsungTV Smart 是一个自定义组件，用于在 HomeAssistant 中控制 SamsungTV 设备。该项目是基于内置的 samsungtv 组件进行的修改，添加了一些额外功能。此插件仅适用于2016年及以后型号的电视（可能是所有Tizen系列）。本项目是对 SamsungTV Tizen 组件的分支，增加了使用 HomeAssistant 用户界面进行配置的功能，简化了配置过程，并在通信层使用异步 aiohttp 替代了 request，优化了代码。

2. 项目快速启动

安装

方式一：使用 HACS

1. 在 HomeAssistant 前端中，导航到 '配置'，然后选择 '集成'。
2. 点击右下角的 '+' 按钮，搜索 'SamsungTV Smart' 并点击 '配置'。
3. 在配置界面中，输入电视的 IP 地址、实体名称以及 SmartThings 个人访问令牌（如果已创建），然后点击 '提交'。

方式二：手动安装

1. 下载 custom_components 文件夹。
2. 将 samsungtv_smart 目录复制到你的 HomeAssistant 安装目录中的 custom_components 目录下。custom_components 目录位于你的 HomeAssistant 配置目录中。
3. 如果 custom_components 目录不存在，你需要创建它。

正确安装后，你的配置目录应该如下所示：

...
└── configuration.yaml
└── custom_components
    └── samsungtv_smart
        └── __init__.py
        └── media_player.py
        └── websockets.py
        └── shortcuts.py
        └── smartthings.py
        └── upnp.py
        └── exceptions.py
        ...

配置

一旦安装了组件，你需要进行配置以使其工作。

配置方式一：使用 Web UI [推荐]

1. 从 HomeAssistant 前端中，导航到 '配置'，然后选择 '集成'。
2. 点击右下角的 '+' 按钮，搜索 'SamsungTV Smart' 并点击 '配置'。
3. 在配置界面中，输入电视的 IP 地址、实体名称以及 SmartThings 个人访问令牌（如果已创建），然后点击 '提交'。
4. 注意：电视屏幕上出现弹出窗口时，立即使用 OK 确认。

配置方式二：编辑 configuration.yaml

从 v0.3.16 版本开始，不再支持从 yaml 进行初始配置。你仍然可以在 configuration.yaml 中设置以下参数：

• 使用 SmartThings 电视状态信息
• 使用 SmartThings 电视频道信息
• 使用 SmartThings 电视频道号码信息
• 标志选项
• 允许使用本地标志图像
• 应用程序列表加载模式启动
• 开机方法

3. 应用案例和最佳实践

（此处根据实际项目情况编写应用案例和最佳实践，例如如何通过 HomeAssistant 控制电视，如何利用 SmartThings API 获取电视状态等。）

4. 典型生态项目

（此处可以列出与 HomeAssistant - SamsungTV Smart 组件相互配合使用的其他开源项目或生态组件，例如其他智能家居设备控制组件、自动化脚本等。）