【阿木制作】天聚数行-实时动态 Home Assistant 集成

lambilly

2025-10-18 v1.1.0版本更新说明 (请在HACS中点击更新信息）

主要更新内容

🔄 数据更新机制优化

• 从固定间隔更新改为定时更新：不再使用24小时固定间隔更新API数据
• 新增双时段自动更新：每天上午7:00和下午16:00各自动请求一次API数据
• 智能更新时间记录：记录最后一次成功更新的时间，便于前端展示

📊 滚动内容属性增强

1. 新增标题属性：

• title: "📚实时动态" - 带图标的标题
• title1: "实时动态" - 简洁标题
• title2: "今日动态" - 日期相关标题

2. 新增更新时间属性：

• update_time: 记录7:00或16:00的成功更新时间

⚙️ 配置简化

• 移除更新间隔配置：不再需要手动设置数据更新间隔（60-43200分钟）
• 保留滚动间隔配置：仍可自定义头条滚动间隔（5-300秒）
• 配置界面优化：更新配置描述，明确说明自动更新时间

天聚数行-实时动态 Home Assistant 集成

这是一个用于 Home Assistant 的自定义集成，通过天聚数行 API 获取实时数据，包括头条新闻、油价、汇率和空气质量信息。

功能特性

• 💵 美元汇率：美元兑人民币汇率（每天7时/16时更新一次）
• ⛽ 今日油价：全国各省市最新油价（每天7时/16时更新一次）
• 🌤️ 空气质量：全国地级市空气质量指数（每天7时/16时更新一次）
• 📰 头条新闻：全国当前今日头条热点50条（每天7时/16时更新一次）
• 📰 滚动内容：自动滚动显示今日头条热点（可配置滚动间隔）
• ⚙️ 高度可配置：可设置更新间隔和滚动间隔
• 🌏 多地区支持：支持全国31个省市油价查询和300+地级市空气质量查询

安装方式

方法一：通过 HACS 安装（推荐）

1. 确保已安装 HACS
2. 在 HACS 中点击「集成」
3. 点击右上角三个点，选择「自定义仓库」
4. 添加仓库地址：https://github.com/lambilly/hass_tian_realtime
5. 选择分类为「集成」
6. 搜索「天聚数行-实时动态」并安装
7. 重启 Home Assistant

方法二：手动安装

1. 下载本集成文件
2. 将 custom_components/tian_realtime 文件夹复制到您的 Home Assistant 配置目录中的 custom_components 文件夹
3. 重启 Home Assistant

配置

通过界面配置

1. 进入 Home Assistant「配置」->「设备与服务」
2. 点击「添加集成」
3. 搜索「天聚数行-实时动态」

4. 按照提示填写以下信息：

   • API 密钥：从天聚数行官网申请
   • 油价省份：选择您所在的省份
   • 空气质量城市：输入您所在的城市
   • 数据更新间隔：每天7时/16时更新一次
   • 头条滚动间隔：5-300秒（默认15秒）

天行数据 API 申请

1. 访问 天行数据官网
2. 注册账号并登录
3. 在控制台申请 API 密钥
4. 确保已开通以下接口：
   • 头条热搜榜
   • 实时油价
   • 汇率查询
   • 空气质量指数

生成的实体

集成将创建以下传感器实体：

实体名称	实体ID	描述	图标
头条新闻	sensor.toutiao_xin_wen	热点新闻信息	mdi:newspaper-variant-multiple
今日油价	sensor.jin_ri_you_jia	指定省份油价	mdi:gas-station
美元汇率	sensor.mei_yuan_hui_lv	美元兑人民币汇率	mdi:currency-usd
空气质量	sensor.kong_qi_zhi_liang	指定城市空气质量	mdi:air-filter
滚动内容	sensor.gun_dong_nei_rong	所有信息的滚动展示	mdi:chart-box-outline

设备信息

所有实体都归属于名为「实时动态」的设备，方便统一管理。

属性说明

滚动内容实体属性

• title - 带图标的实时动态标题
• title1 - 不带图标的实时动态标题
• title2 - 今日动态标题
• hot_detail - 当前显示的头条新闻
• oil_detail - 油价信息
• rate_detail - 汇率信息  
• air_detail - 空气质量信息
• hot_index - 当前头条新闻的序号
• update_time - 当前头条新闻更新的时间

头条新闻实体属性

• detail - 当前显示的头条内容
• hot_data - 所有头条新闻的字典（1-50条）
• hot_index - 当前显示的新闻序号

自动化示例

当空气质量变差时发送通知

automation:
  - alias: "空气质量警告"
    trigger:
      platform: state
      entity_id: sensor.kong_qi_zhi_liang
    condition:
      condition: template
      value_template: >
        {{ state_attr('sensor.kong_qi_zhi_liang', 'detail') | regex_search('AQI\\d+)', '\\1') | int > 100 }}
    action:
      service: notify.mobile_app
      data:
        message: "空气质量变差：{{ states('sensor.kong_qi_zhi_liang') }}"

在仪表板上显示滚动信息，需要在HACS中安装：Lovelace HTML Jinja2 Template card

卡片效果：


下载地址：

游客，如果您要查看本帖隐藏内容请回复

type: custom:html-template-card
content: >-
  <div
  style="color: white;"><p align=left><h3 style="color: white; margin-bottom:
  0px;">【{{ state_attr('sensor.gun_dong_nei_rong','title') }}】</h3> </p> </div>    <p align= left style="color:
  white; font-size: 1.0em; margin-top: 10px;">{{ state_attr('sensor.gun_dong_nei_rong','hot_detail') }}
  <br>{{ state_attr('sensor.gun_dong_nei_rong','rate_detail') }}
  <br>{{ state_attr('sensor.gun_dong_nei_rong','oil_detail') }}
  <br>{{ state_attr('sensor.gun_dong_nei_rong','air_detail') }}
  </p>

复制代码

nuaawmy

谢谢大佬

creazycar

感谢分享！

tanbobo

怎么老是提示：API密钥无效，请检查是否正确

lambilly

tanbobo 发表于 2025-10-13 08:28
怎么老是提示：API密钥无效，请检查是否正确

日志导出来看看

深兰之刃

dahai2626

感谢分享！

tanbobo

2025-10-13 13:26:39.835 WARNING (sentry-sdk.BackgroundWorker) [urllib3.connectionpool] Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'NewConnectionError('<urllib3.connection.HTTPSConnection object at 0x7ff0aa5e6e90>: Failed to establish a new connection: [Errno 111] Connection refused')': /api/5370612/envelope/
2025-10-13 13:26:39.837 WARNING (sentry-sdk.BackgroundWorker) [urllib3.connectionpool] Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by 'NewConnectionError('<urllib3.connection.HTTPSConnection object at 0x7ff0aa5e7d90>: Failed to establish a new connection: [Errno 111] Connection refused')': /api/5370612/envelope/
2025-10-13 13:26:39.840 WARNING (sentry-sdk.BackgroundWorker) [urllib3.connectionpool] Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'NewConnectionError('<urllib3.connection.HTTPSConnection object at 0x7ff0aa5e7890>: Failed to establish a new connection: [Errno 111] Connection refused')': /api/5370612/envelope/

接口密钥信息
编号        APIKEY        状态        安全操作        权限管理
默认        23accef3a08bb21e7f2cd757*******

是这个apikey 没有搞错

威风八面小怪兽

感谢分享！

georgewu57

感谢分享！