本帖最后由 cyborg 于 2026-6-18 10:58 编辑
📱 项目介绍
中国联通话费查询集成早前是有人开发过的，参考：https://bbs.hassbian.com/thread-29136-1-1.html（https://github.com/hlhk2017/homeassistant-unicom_bill_info）。但近期出现多个传感器失效，抓包发现API已改变，基于此重新开发了一个 Home Assistant 自定义集成，可以查询中国联通的话费、流量、语音等信息。基于联通微信小程序 最新API，提供全面的话费账单查询功能。
目前支持 27 个传感器，涵盖语音通话、短信、移动数据（通用/专属/其他分类）、账户余额等全方位信息。同时内置了自定义 Lovelace 卡片，开箱即用。
✨ 核心特色
- 📊 27个传感器：全面覆盖语音、短信、流量（通用/专属/其他分类）、余额信息
- 🔄 自动更新：可配置刷新间隔（1-60分钟）
- 🔐 自动认证：自动获取 ticket 和 Cookie，无需手动配置
- 🎨 自定义卡片：内置 Lovelace 自定义卡片，可视化编辑器配置，开箱即用
- 🌍 国际化支持：代码完全英文化，支持多语言翻译
- 📱 微信小程序：基于联通微信小程序 API，稳定可靠
- 🏗️ 模块化设计：清晰的代码架构，易于维护和扩展
📸 效果展示
集成列表
配置界面
设备信息与传感器
选项配置
🚀 安装方式
方法一：HACS 安装（推荐）
- 确保已安装 HACS
- 进入 HACS → 集成 → 右上角三个点 → 自定义仓库
- 添加仓库地址：
[url=https://github.com/Cyborg2017/ha_unicom_bill]https://github.com/Cyborg2017/ha_unicom_bill`[/url]
- 搜索 "China Unicom Bill" 并安装
- 重启 Home Assistant
方法二：手动安装
- 下载最新版本的源代码
- 解压后将
custom_components/ha_unicom_bill 文件夹复制到 HA 的 custom_components 目录
- 重启 Home Assistant
⚙️ 配置步骤
1. 获取 OpenID
使用抓包工具（如 Charles、Fiddler、HttpCanary 等）抓取联通微信小程序的请求：
- 打开抓包工具
- 进入联通微信小程序
- 找到包含
openid 参数的请求
- 复制
openid 的值
提示：OpenID 是用户的唯一标识，有效期较长，一般不需要频繁更换。
2. 添加集成
- 进入 Home Assistant → 设置 → 设备与服务
- 点击右下角 "添加集成"
- 搜索 "China Unicom Bill" 并添加
- 输入抓包获取的 OpenID
- 手机号码将由系统自动从 API 获取，无需手动配置
3. 可选配置
- 刷新间隔：1-60 分钟（默认 30 分钟）
- 详细传感器：开启后可查看更多详细信息（语音详情、短信详情、流量详情）
🔧 高级配置
- 进入 设置 → 设备与服务
- 找到 "China Unicom Bill" 集成
- 点击 "选项" 修改刷新间隔或详细传感器开关
🃏 自定义 Lovelace 卡片
本集成内置了自定义卡片 (ha-unicom-card)，安装后自动注册前端资源到 Lovelace storage，无需手动添加 JS URL。
参考：https://bbs.hassbian.com/thread-29129-1-1.html
在 Dashboard 中添加卡片，搜索 HA联通卡片 即可使用：
type: custom:ha-unicom-card
title: 中国联通
device_id: xxxxxxxx # 集成设备 ID（必填）
balance_warning_below: 20 # 余额预警阈值（元），低于此值显示警告
usage_warning_percent: 80 # 流量使用率警告阈值（%）
usage_danger_percent: 95 # 使用率危险阈值（%）
show_details: true # 是否拓展显示详情面板
支持可视化编辑器，可直接在 UI 中调整参数预览效果。
## 致谢
参考项目：homeassistant-unicom_bill_info 原始版本：homeassistant-unicom_bill_info v1.0.8
| 
发表于 2026-6-7 11:46:21
