本帖最后由 lambilly 于 2025-10-15 23:30 编辑
每周电影 Home Assistant 集成
这是一个用于 Home Assistant 的自定义集成，可以获取内地即将上映的电影信息，并以滚动方式展示。
功能特点
- 🎬 获取内地即将上映的电影信息
- ⏰ 24小时自动更新数据
- 🔄 可配置的滚动显示（默认每分钟切换一部电影）
- 📱 支持中文本地化界面
- 🖼️ 显示电影海报和详细信息
- 📊 两个实体：数据实体和滚动显示实体
安装
通过 HACS 安装（推荐）
- 确保已安装 HACS
- 在 HACS 中点击「集成」
- 点击右下角「+ 浏览并下载存储库」
- 搜索「每周电影」或添加自定义存储库：
- 下载「每周电影」集成
- 重启 Home Assistant
手动安装
- 将
weekly_film 文件夹复制到 custom_components 目录
- 重启 Home Assistant
- 在集成界面添加「每周电影」
配置
初始配置
- 在 Home Assistant 中进入「配置」->「设备与服务」
- 点击「+ 添加集成」
- 搜索「每周电影」
- 输入以下信息：
- API Key: 从冷言数据申请（见下文）
- 滚动间隔: 电影切换间隔（秒），默认60秒
API Key 申请
- 访问 冷言数据
- 注册账号并登录
- 在API市场中找到「内地即将上映的电影」免费API
- 申请获取 API Key
- 将获得的 API Key 填入集成配置中
选项配置
集成安装后，可以在集成选项中进行配置：
生成的实体
集成会创建一个设备，包含两个实体：
1. 每周电影数据
- 状态: 最后更新时间
- 属性:
film_count: 电影数量film_list: 完整的电影列表update_time: 更新时间
2. 每周电影滚动显示
- 状态: 当前显示的电影名称和日期
- 属性:
name: 电影名称type: 电影类型director: 导演actors: 主演picurl: 海报图片URLreleasedatestr: 上映日期poster: HTML格式的海报图片
使用示例
Lovelace 卡片配置
type: custom:html-template-card
content: >
<div style="color: white;"><p align="left"><h3>【🎬每周电影】</h3></p><div
style="display: flex; align-items: flex-start;"><div style="flex: 0 0 150px;
margin-right: 15px;"><img src="{{ state_attr('sensor.gun_dong_xian_shi',
'picurl') }}" width="150" height="250" style="border-radius: 5px;"></div> <div
style="flex: 1;">
影片名称：{{ state_attr('sensor.gun_dong_xian_shi', 'name') }}<br>
类 型：{{ state_attr('sensor.gun_dong_xian_shi', 'type') }}<br>
导 演：{{ state_attr('sensor.gun_dong_xian_shi', 'director') }}<br>
演 员：{{ state_attr('sensor.gun_dong_xian_shi', 'actors') }}<br>
上映日期：{{ state_attr('sensor.gun_dong_xian_shi', 'release_date') }}</div></div></div>
故障排除
常见问题
- API 错误: 检查 API Key 是否正确，确保申请的是「内地即将上映的电影」API
- 无数据显示: 确认网络连接正常，API服务可用
- 滚动不工作: 检查滚动间隔设置，重启集成
日志调试
如需查看详细日志，在 configuration.yaml 中添加：
logger:
default: info
logs:
custom_components.weekly_film: debug
支持
如遇问题，请：
- 查看 Home Assistant 日志
- 确认 API Key 有效
- 检查网络连接
许可证
MIT License
贡献
欢迎提交 Issue 和 Pull Request！
下载地址：
上面卡片代码打包下载：
每周电影卡片代码.zip
(654 Bytes, 下载次数: 0)
| 
发表于 
