# LiveNotify **Repository Path**: xyzOvO/LiveNotify ## Basic Information - **Project Name**: LiveNotify - **Description**: 关注的主播开播时一条通知直达直播间。开源 Android 多平台开播提醒应用,支持 B站 / 抖音 / 斗鱼 / 虎牙(Kotlin + Jetpack Compose) - **Primary Language**: Kotlin - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-29 - **Last Updated**: 2026-11-07 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README
English · 简体中文

开播提醒 · 应用图标

开播提醒 · LiveNotify

关注的主播开播时,一条通知直达直播间。
开源的 Android 多平台开播提醒应用 · 无账号 · 无服务端 · 无埋点

Release Stars License Android Kotlin Jetpack Compose minSdk 26

📲 下载 · ✨ 功能 · 🖼 界面 · 🎯 支持平台 · 🛠 构建 · ❓ 常见问题 · 🧩 实现原理 · 📈 B 站数据 · ⚖️ 合规 · 📄 许可证

首页搜索展开状态:吸顶搜索框、平台筛选 chips 与 B站 / 抖音 / 斗鱼 / 虎牙 四平台主播卡片

首页(搜索已展开) · 吸顶搜索框 / 筛选 chips / 四平台主播卡片 · 收起搜索后右上角是放大镜入口,详见 🖼 界面

支持 **B站 / 抖音 / 斗鱼 / 虎牙**。前台服务常驻轮询(默认 120 秒),开播推送本地通知,**点通知直达直播间**;记录「上次开播距今」与「已播时长」,多平台状态一眼看完。 还带一个 **B 站数据页**:粉丝走势、月度互动观众、生涯统计,以及任意 UID 的互动分析(发言 / 打赏 / 活跃时段 / 常去直播间)。每个数字都标了统计口径,不拿「生涯累计」冒充「最近一个月」。 > [!WARNING] > **LiveNotify 永远免费开源。** 如果你是在任何地方「花钱买到」的,说明你被骗了,请立即退款。任何收费版本均为二次打包的诈骗版本,与本项目无关。 > [!NOTE] > 本项目使用 **MIT 开源协议**,使用代码请保留版权声明;且为 **Android 端个人应用**,与各直播平台无任何隶属、合作或授权关系,代码中的平台名称与图标仅用于标识来源平台,商标归各自权利人所有。App 界面**仅中文**,英文 README 只是文档翻译,不会在应用里加英文界面。 --- ## 📲 下载 > **系统要求**:Android 8.0(API 26)及以上。APK 为正式签名包,首次安装需在系统里允许「安装未知来源应用」。 - **[Releases](https://github.com/xyzOvO/LiveNotify/releases/latest)** 下载 `app-release.apk`(正式签名,装上即用) - 也可以自行构建(见 [🛠 构建](#build)) 安装后必做的两步,否则可能收不到通知: 1. **允许通知**:Android 13+ 首次启动会弹窗询问;若误拒,去系统设置 → 应用 → 通知 里打开。 2. **放行后台**:设置页关闭「电池优化」,并在系统「自启动 / 后台运行」白名单里放行本应用(MIUI / ColorOS / HarmonyOS 尤其需要)。 添加主播:点右下角 **+**,粘贴直播间链接或房间号,例如 `https://live.bilibili.com/21452505`、`https://live.douyin.com/629458933`、`https://www.douyu.com/71415`、`https://www.huya.com/520520`。 > 手动指定平台时,**纯数字房间号直接可用**(B 站 / 抖音 / 斗鱼 / 虎牙都支持)——不用先去找链接。 --- ## ✨ 功能 ### 🔎 检测与调度 | 功能 | 说明 | |---|---| | **多平台提醒** | B 站 / 抖音 / 斗鱼 / 虎牙,平台层可插拔,新增平台只需实现一个接口 | | **固定周期** | 设 120 秒就是「本轮开始 → 下一轮开始」120 秒,检测耗时已算在里面;单轮超时跳过下一次,不连续补跑 | | **没有网络不硬查** | 网络没通过系统连通性验证时整轮跳过:不发请求、不累计错误、不改开播状态,常驻通知与主页都写「等待网络」;「仅 Wi-Fi」下走流量时写「等待 Wi-Fi」 | | **防误报三道闸** | 状态跳变 + 连续确认 + 场次去重,网络抖动不会误报开播 | | **省电省流** | B 站批量接口 20 个主播 1 次请求;移动网络自动降频;可设仅 WiFi 检测;断网时零请求 | | **状态如实显示** | 服务没在跑、通知权限没开、检测被跳过时,界面与常驻通知直接说明原因,不会假装「一切正常」 | ### 🔔 通知与补发 | 功能 | 说明 | |---|---| | **开播通知** | 本地通知点击直达直播间,同一场次不重复推送,带冷却时间 | | **提醒方式可调** | 开播提醒的响铃 / 震动可分别开关(Android 8+ 走通知渠道) | | **常驻通知可隐藏** | 后台检测必须保留一条通知,可降到最低可见度,或在系统渠道设置里彻底关闭 | | **漏提醒会补发** | 通知权限或「开播提醒」渠道被关掉时,这一场不会被记成「已通知」;权限恢复后下一轮自动补上,超过 30 分钟则放弃(免打扰时段主动抑制的提醒根本不入补发队列) | | **免打扰时段** | 夜间不推送(可选),时段内检测照常但间隔放宽 | ### 📋 关注列表 | 功能 | 说明 | |---|---| | **上次开播** | 卡片显示「已播 1 小时 23 分」或「上次开播 5 天前 · 10-23 15:26」 | | **搜索与筛选** | 按昵称或房间号搜索、按平台筛选、只看直播中;结果实时计数,空结果可一键清除筛选或直接去添加 | | **点击 / 长按管理** | 卡片本身不跳转,点击或长按都开操作面板:打开直播间 / 复制链接 / B站数据 / 暂停关注 / 移除关注 | | **系统分享导入** | 在 B站 / 抖音等 App 里分享直播间文案 → 选「开播提醒」,自动预填并识别平台,你点确认才添加 | | **暂停 / 恢复关注** | 暂停后卡片保留但不检测、不提醒;恢复时先对齐当前场次,不会把正在直播误报成新开播 | | **关注列表备份** | 导出 / 导入 JSON(本地文件),换机或重装可恢复;不备份 Cookie、直播状态与通知冷却。导入的写库是一次事务:中途失败整批回滚,已有主播的备注与暂停状态不会被覆盖 | | **纯本地** | 无账号、无服务端、无埋点;数据只在本机 Room 数据库 | ### 📊 数据、更新与可维护性 | 功能 | 说明 | |---|---| | **B站数据(粉丝走势)** | 长按 B 站主播 → 粉丝数历史曲线、月度互动观众/付费/上舰趋势、生涯统计(每块都标注统计口径) | | **B站数据(互动事件)** | 填任一 UID,统计其发言、送礼、上舰、活跃时段与常去直播间 | | **B站数据有缓存** | 上次成功的数据存在本机:再进页面先看缓存并标注「X 前更新」,过期也会留着;点刷新才重新请求,刷新失败仍显示旧数据 | | **应用内更新** | 启动时静默检查 GitHub Releases:并排显示当前 / 最新版本与更新日志,下载有进度、失败可原地重试,下载完先校验 SHA-256 再比签名,最后拉起系统安装页 | | **数据可靠** | 数据库迁移有自动化测试:真实 SQLite 从 v1/v2/v3 分别跑完整条链,逐列对照入库的 schema 快照,暂停状态与通知去重字段逐行核对;发版时 CI 还会校验签名指纹与 versionName/Code 与 tag 一致 | | **设置页讲清影响** | 按检测 / 通知 / 后台权限 / 数据 / 其他五组分组;顶部直接显示实际间隔、上一轮用时(超时标红)与当前网络,每项都写明改了会怎样 | --- ## 🖼 界面 ### 🧭 首页速览 封面那张首页截图从上到下是这个结构;**四个平台各一位主播,和截图完全一致,没有更换**: | 位置 | 区域 | 展示内容 | |---|---|---| | 1 | 标题栏 | 「开播提醒」+ 刷新 / 设置两个图标;下面状态行按实时状态显示「监控中 · N / 4 位正在直播」或「监控中 · 4 位都很安静」,圆点随之变绿或变灰 | | 2 | 检测开关卡 | 「后台检测已开启 / 基础间隔 120 秒 · 上次 刚刚」,一键开关。写「基础间隔」是因为移动网络和免打扰时段会把它拉长;「上次」随最近一轮检测变化 | | 3 | 列表标题行 | 未展开搜索时是「关注的主播」+「点击或长按管理」+ **右侧放大镜(搜索入口)**;展开后放大镜收起,有筛选时右侧改显示「N / 总位数」 | | 4 | **搜索栏(点放大镜后)** | 吸顶输入框「搜索昵称 / 房间号 / 短号」+ 清空 / 关闭 +「取消」;下一行横向滚动的筛选 chips:全部平台 / B站 / 抖音 / 斗鱼 / 虎牙 / 只看直播中 | | 5 | 主播卡片 × 4 | 见下表 | | 6 | 右下角 **+** | 添加关注;搜索展开时自动收起,免得键盘压住结果 | > 封面是 2026-11-07 重拍(v1.0.12 后再次更新)的**搜索展开状态**:四个平台仍各一位主播,昵称与房间号未变,搜索框文案已与当前版本一致。拍摄时**七海Nana7mi 正在直播**,卡片淡红高亮并显示「已播…」,其余三位未开播。抖音卡片显示接口返回的 `web_rid`(稳定房间标识),与示例链接里的抖音号 `629458933` 指向同一位主播。 | 平台 | 主播 | 房间号(示例链接) | 封面拍摄时 | |---|---|---|---| | **哔哩哔哩** | 七海Nana7mi | `21452505` | 🔴 直播中 | | **抖音** | 女流66 | `629458933` | ⚪ 未开播 | | **斗鱼** | 寅子 | `71415` | ⚪ 未开播 | | **虎牙** | 骚男 | `520520` | ⚪ 未开播 | 每张卡片都显示头像(右下角带平台徽标)、昵称、平台与房间号、直播标题(未开播时是上一场的标题)、开播信息以及状态徽标;直播中时整卡淡红高亮、显示「已播 N 小时 N 分」,未开播时显示「上次开播…」或「暂无开播记录」。 ### 👆 交互一览 | 区域 | 操作 | 行为 | |---|---|---| | 首页 | 点击 / 长按卡片 | 弹出同一个操作面板,卡片本身不跳直播间,避免误触 | | 首页 | 下拉列表 / 右上角刷新 | 立即跑一轮检测,刷新按钮同步转圈,检测中禁用重复点击 | | 首页 | 点「关注的主播」右侧放大镜 | 展开吸顶搜索栏与筛选 chips,输入框自动聚焦 | | 搜索栏 | 输入昵称 / 房间号 / B 站短号 | 实时过滤,标题行显示「N / 总位数」;滚动列表时自动收起键盘 | | 搜索栏 | 点输入框右侧 × | 有输入时清空,无输入时直接收起搜索;「取消」与返回键也能退出搜索(返回键只收搜索,不会退出 App) | | 筛选 chips | 选平台 / 只看直播中 | 可叠加;再点一次同一项取消;窄屏下 chips 单行横向滚动,不占半屏 | | 空结果 | 「清除筛选」/「添加关注」 | 一键回到完整列表,或直接打开添加弹窗 | | 操作面板 | 打开直播间 / 复制链接 / 粉丝走势与数据 / 暂停或恢复关注 / 移除关注 | B 站主播才有「粉丝走势与数据」;暂停后卡片保留但不检测 | | 添加关注 | 右下角 **+** | 粘贴链接 / 房间号 / 整段分享文案,平台可手动指定(自动 / B站 / 抖音 / 斗鱼 / 虎牙) | | 添加关注 | 「识别主播」→「确认添加」 | **先识别、再确认**:弹窗展示平台、昵称、房间号与识别结果;不满意可「返回修改」,不会自动落库 | | 系统分享 | 其他 App 分享直播间文案 → 选「开播提醒」 | 自动预填并识别平台,同样要你点确认才添加 | | 设置页 | 顶部状态卡 | 显示服务是否真的在跑、实际检测间隔、上一轮用时(超时标红)、当前网络、最近一轮检测时间、关注主播数与免打扰状态 | | 设置页 | 检测 / 通知 / 后台权限 / 数据 / 其他 | 检测:间隔、仅 Wi-Fi、连续确认次数;通知:响铃震动、测试通知、免打扰、隐藏常驻通知、渠道设置;后台权限:自启动、电池优化、通知权限的实际状态与跳转,以及「有 N 条开播提醒待补发」的提示;数据:备份导出导入、B 站数据、抖音 Cookie;其他:检查更新 | | 设置页 | 返回键 / 侧滑 | 回主页面,不会直接退出 App | | 其他 · 更新卡片 | 「下载并安装」/「以后再说」 | 设置页内嵌的更新卡片(不是弹窗):并排显示当前 / 最新版本与完整更新日志,下载带字节进度;「以后再说」记下版本不再打扰,手动检查仍可见 | 卡片头像右下角带平台官方徽标,开播时整卡淡红高亮并呼吸描边,相对时间每 20 秒自动刷新。

点击或长按卡片弹出的操作面板 添加关注确认页:识别结果显示平台、昵称与房间号,可返回修改或确认添加 设置页:顶部检测状态总览,检测 / 通知 / 后台权限 / 数据 / 其他五组

操作面板 点击或长按卡片唤出 · 添加关注 先识别、再确认 · 设置页 真实运行状态与每项设置的实际影响

B 站数据:粉丝数概览、粉丝走势曲线、月度互动观众 月度互动观众明细与生涯统计 互动事件:任意 UID 的发言、打赏、活跃走势

粉丝走势 概览 / 采样曲线 / 月度观众 · 生涯统计 首播起的累计值 · 互动事件 任意 UID 的行为分析
示例截图中的具体统计数值已脱敏,口径说明保留

> 每个统计数字旁边都标了口径:粉丝是「截至某日的快照」,场次与总收入是「生涯累计」,粉丝走势写明「社区采集区间、多少个采样点、跨多少天」——避免把第三方采集到的片段当成完整历史。接口与边界见 [📈 B 站数据](#bili-stats)。 --- ## 🎯 支持平台 | 平台 | 接口 | 批量 | 开播时间 | |---|---|---|---| | **B 站** | 官方公开接口 `get_status_info_by_uids` | ✅ 一次 20 个 | 未开播时接口不返回,需本地观测累积 | | **抖音** | webcast 移动端落地页解析(`status=2` 为直播中) | ❌ 逐个请求,节流 1.5s | ✅ 页面直接返回 `createTime` | | **斗鱼** | `open.douyucdn.cn/api/RoomApi/room/{rid}` | ❌ 节流 1.2s | ✅ 接口直接返回 `start_time`,刚添加就能看到上次开播 | | **虎牙** | `mp.huya.com/cache.php?m=Live&do=profileRoom` | ❌ 节流 1s | ❌ 接口不返回,只能本地观测 | > 抖音官方未开放个人可用的直播间状态接口,这里读的是 `webcast.amemv.com` 的移动端落地页(免登录、免签名,约 90KB/次)。 > 属未经官方授权的网页解析,页面改版可能失效;设置页可粘贴浏览器 Cookie 提升成功率(仅存本机)。 > 分享文案里的 `v.douyin.com` 短链会自动跟随跳转到该落地页,直接粘贴整段文案即可。 --- ## 🛠 构建 **环境要求**:JDK 17、Android SDK(`compileSdk 35` / `minSdk 26`)、Gradle 8.9(Wrapper 已随仓库提供)。 > ⚠️ 项目请放在**纯英文路径**下(如 `D:\LiveNotify`)。AGP 在 Windows 上会拒绝含中文的目录(`Your project path contains non-ASCII characters`)。仓库里的 `android.overridePathCheck=true` 只是兜底,底层工具仍可能出问题。 ### 💻 命令行 ```bash ./gradlew assembleDebug # macOS / Linux gradlew.bat assembleDebug # Windows # 产物:app/build/outputs/apk/debug/app-debug.apk ``` > 国内网络下载 Gradle 分发慢的话,把 `gradle/wrapper/gradle-wrapper.properties` 的 `distributionUrl` 换成 > `https://mirrors.cloud.tencent.com/gradle/gradle-8.9-bin.zip` 即可。 ### 🧰 Android Studio `File → Open` 选项目根目录 → 等 `Sync Now` → 连真机点 Run。 ### 🔑 签名(可选) **本地构建**:没有 `keystore.properties` 时用 debug 签名,任何人克隆后都能构建出可安装的 APK。要用自己的签名: ```bash keytool -genkeypair -v -keystore keystore/livenotify.jks -alias livenotify \ -keyalg RSA -keysize 2048 -validity 10950 ``` 然后在项目根目录建 `keystore.properties`(该文件与 `keystore/` 目录均已在 `.gitignore` 中,不会误传): ```properties storeFile=keystore/livenotify.jks storePassword=你的密码 keyAlias=livenotify keyPassword=你的密码 ``` 存在该文件即自动切换为正式签名。想给 CI 也配上同一把密钥,把 `.jks` 编码成 base64 存进仓库 Secrets: | Secret | 值 | |---|---| | `KEYSTORE_BASE64` | `keystore/livenotify.jks` 的 base64(`base64 -w0` 或 PowerShell `[Convert]::ToBase64String(...)`) | | `KEYSTORE_PASSWORD` | `storePassword` | | `KEY_ALIAS` | `livenotify` | | `KEY_PASSWORD` | `keyPassword` | > [!IMPORTANT] > **正式发布不允许签名降级。** 本地 Debug 构建不受影响;但由 tag 触发的发布工作流会**强制**要求四个 Secret 齐全,缺任何一项直接失败、不产出可发布 APK。打包后还会逐字比对签名 SHA-256 指纹,并校验 `versionName` / `versionCode` 与 tag 一致、且高于上一版——保证连续版本可以直接覆盖安装。换密钥等于全体旧用户不能覆盖升级,必须同步更新工作流里的指纹并在 Release 里公告。 --- ## ❓ 常见问题 **Q:重启手机后不检测了?** 国产 ROM 默认禁止第三方应用自启动,开机广播根本不会发给 App(应用侧无法绕过)。去设置页「后台权限」→「自启动」把本应用加进白名单,并把省电策略设为「无限制」。另一种情况是被系统的「强行停止」点过——那之后所有广播都不再送达,必须手动打开一次 App 才恢复。 **Q:通知栏一直有一条「正在检测」的通知,能关掉吗?** 这是 Android 对前台服务的合规要求,应用内无法彻底移除。两条路:设置页打开「隐藏常驻通知」把它降到最低可见度(静音、不弹窗、不显示角标);或点设置页的「常驻通知设置」进系统渠道页,把「后台检测」渠道整个关掉——检测照常运行。 **Q:后台过一会儿就被杀了?** 这是厂商 ROM 的限制,不是应用 bug。去系统设置放行「自启动 / 电池优化 / 后台运行」。 **Q:搜索框怎么退出?筛选会不会把主播弄丢?** 点「取消」、点输入框右侧的 ×(有内容时先清空,再点一次收起)、或按返回键都可以;返回键只收搜索,不会退出 App。筛选**只作用于当前界面**:后台检测、常驻通知用的始终是完整关注列表,暂停状态和直播状态都不会因为筛选而改变。 **Q:搜不到某个主播?** 搜索匹配昵称、房间号与 B 站短号(`short_id`,卡片上以「短号 N」附注显示),可以只输一段;再检查是不是叠加了平台 chips 或「只看直播中」。空结果页有「清除筛选」一键回全量,也有「添加关注」直接去添加。 **Q:应用内更新提示「签名不一致」?** 更新包必须与当前安装的版本同签名才能覆盖安装。如果你之前装的是 debug 签名包(早期 CI 产物),换正式签名包必须先卸载一次;之后同一签名的版本都能直接覆盖升级,关注列表不会丢。应用会在提示里直接给出原因和唯一的出路——先去设置页导出一份关注列表备份,再卸载重装、导入备份。 **Q:更新日志为什么有时是空的?** 更新说明优先取 GitHub API;`api.github.com` 在部分网络(共享出口 IP、被限流)会返回 403,此时改走 Releases 页兜底:更新日志从 `releases.atom` 补回,版本号与下载地址来自 `/releases/latest` 的 302 重定向。两条路都不通时只显示「暂无更新说明」,不影响下载与安装。 **Q:点过「以后再说」还会提醒吗?** 不会。该版本会被记下来,之后启动时自动检查到这个版本不再打扰;出了更新的版本才会重新提示。手动点「检查更新」仍然能看到,随时可以改主意。 **Q:应用内更新为什么要校验 SHA-256?** GitHub Releases 的附件自带 `digest`(`sha256:`),下载完成后先算一遍文件 hash,不一致就删掉重下并提示「安装包校验未通过」。签名比对回答「是不是同一作者发的」,文件 hash 回答「这一份有没有下全」,两者互补。走 Releases 页 302 兜底拿不到 digest 时会跳过文件校验,但安装前的签名比对仍照常生效。 **Q:为什么「上次开播」是空的?** 只有接口直接返回开播时刻的平台(斗鱼、抖音)能立刻显示;B 站 / 虎牙需要 App 先观测到一次开播才能累积出来。 **Q:抖音一直提示「页面结构可能已变更」?** 抖音改版了。先在浏览器用移动端 UA 打开 `https://webcast.amemv.com/douyin/webcast/reflow/<房间号>` 看还能不能拿到数据;也可以在设置页填 Cookie 提升成功率。 **Q:抖音分享文案粘贴进去读不出来?** 正常能读。`v.douyin.com` 短链会跟随跳转到真实房间地址,房间号就在跳转后的 `reflow/<数字>` 里。若仍失败,多是直播已结束或短链过期,重新在抖音里分享一次即可。 **Q:检测延迟有多大?** 默认 120 秒一轮,周期是「本轮开始到下一轮开始」,检测本身的耗时已经算在里面——不会出现「设 2 分钟、实际 2 分半」。如果某一轮因为网络慢超过了一个周期,错过的轮次直接跳过,不会连着重跑。 **Q:两轮之间隔得比设置的久?** 先看设置页状态卡的「上一轮用时」。超过设定周期时它会标红——那时确实会少跑一轮。常见原因是抖音逐个数主播加上弱网,把一轮拖到了周期以上。把间隔调大一点或减少关注数量即可。 **Q:没网的时候还在不停请求吗?** 不会。网络没有通过系统连通性验证(没连上、连上了但没有出口、强制门户 Wi-Fi)时整轮直接跳过:一次请求都不发,也不累计主播的错误次数;常驻通知、主页状态行与设置页写「等待网络」,恢复后自动继续,不用等下一轮才改口。 **Q:怎么减少耗电?** 设置页开启「仅 WiFi 检测」、把间隔调大、免打扰时段设为夜间。 **Q:开播时我把通知关了,后来再打开还能收到吗?** 能,只要这场还没播太久。发不出去的通知不会被记成「已通知」,而是留一条待补发记录:设置页会写「有 N 条开播提醒因为通知被关掉没能送达」,权限恢复后下一轮检测自动补上。补发时通知标题是「正在直播」并注明「已开播约 N 分钟」,不会假装刚开播。超过 **30 分钟**就放弃——那时再弹「开播了」更像打扰。免打扰时段主动抑制的提醒不在此列,安静时段结束后不会突然补发。 --- ## 🧩 实现原理与取舍 ### 🤔 为什么是 Android 原生 | 方案 | 优点 | 为什么不选 | |---|---|---| | **Android 原生(本项目)** | 前台服务、通知渠道、Doze/电池优化行为可控;功耗可精细调优 | 只覆盖 Android,iOS 需另写一套 | | Flutter / RN | 一套代码双端 | 1~3 分钟轮询依赖原生前台服务,跨平台层最终仍要写原生插件;后台保活、厂商 ROM 适配反而更难调试 | **若必须覆盖 iOS,再单独做 iOS 原生或用 Flutter 重写;仅 Android 场景,原生是坑最少的方案。** ### ⏱ 为什么用前台服务而不是 WorkManager `PeriodicWorkRequest` 最小周期 **15 分钟**,且受 Doze 影响实际执行更晚,**无法实现 1~3 分钟轮询**。因此检测循环跑在 `MonitorService`(`foregroundServiceType="specialUse"`)里:固定周期调度——记下本轮开始时刻,跑完后等到「开始时刻 + 周期」再跑下一轮,单轮超时就跳到下一个格点,不补跑。若你能接受 15 分钟以上间隔,把调度换成 `PeriodicWorkRequest` 即可省掉常驻通知——引擎 `MonitorEngine.runOnce()` 是纯挂起函数,两种调度可直接替换。 类型选 `specialUse` 而不是 `dataSync`:Android 15 给 `dataSync` 加了「24 小时累计最多运行 6 小时」的硬限制,到点系统静默停掉服务;开播提醒需要全天候运行,只能走 `specialUse`(并在清单里写明用途)。 ### 🗂 项目结构 ``` app/ ├── schemas/ Room 每个版本的表结构快照(迁移测试的比对基准) └── src/main/java/com/example/livenotify/ ├── LiveNotifyApp.kt Application:初始化依赖图、建通知渠道、按需拉起服务 ├── Graph.kt 极简手工依赖图(无 Hilt) ├── data/ │ ├── StreamerEntity.kt Room 实体(含去重/防抖/待补发所需字段) │ ├── StreamerDao.kt DAO(Flow 观察 + 批量更新) │ ├── AppDatabase.kt Room 数据库单例(v1→v4 增量迁移,MIGRATION_SQL 单一来源) │ └── SettingsRepository.kt DataStore 设置项 ├── platform/ │ ├── LivePlatform.kt ★ 平台抽象(新增平台只需实现此接口 + 注册) │ ├── BilibiliPlatform.kt B 站:批量官方接口 │ ├── DouyinPlatform.kt 抖音:webcast 移动端落地页降级方案 │ ├── DouyuPlatform.kt 斗鱼:room_status / start_time 解析 │ ├── HuyaPlatform.kt 虎牙:liveStatus + realLiveStatus 交叉校验 │ └── DouyinParser.kt 抖音落地页解析(锚定 room 对象)+ 风控识别 ├── net/Http.kt OkHttp 封装 + 按 host 节流器 ├── bili/ B 站数据:第三方统计接口 + 手写 MessagePack 解码 │ ├── BiliStatsApi.kt 五个统计端点集中于此 │ ├── StatsEndpoint.kt 线路选择(主/备用域、按上次成功域排序、文档地址) │ ├── StatsCache.kt 本地缓存:优先读缓存、手动刷新才请求 │ └── MsgPack.kt 手写 MessagePack 解码器(免引入依赖) ├── update/ 应用内更新 │ ├── UpdateApi.kt 查 GitHub Releases、解析版本与 APK 下载地址 │ ├── ReleaseNotes.kt Release 正文去 Markdown 噪声,小屏可读 │ ├── ReleasesAtom.kt API 被 403 时用 releases.atom 补回更新日志 │ ├── ApkHash.kt 文件 SHA-256 校验(解析 asset 的 digest) │ ├── ApkDownloader.kt 流式下载(带字节进度)+ 复用旧包 + 下载后校验 │ └── ApkInstaller.kt 包名/签名/版本自检 + FileProvider 拉起系统安装页 ├── monitor/ │ ├── MonitorEngine.kt ★ 检测引擎:批量拉取 → 状态对比 → 去重 → 推送 → 落库 │ ├── PollSchedule.kt 周期与间隔的唯一算法(固定周期、移动网络倍数、免打扰降频) │ ├── NetworkState.kt 网络可用性(VPN 只看底层网络,两个方向的误判都有单测) │ ├── MonitorService.kt 前台服务轮询循环(specialUse 类型,划掉任务后自恢复) │ ├── NotificationHelper.kt 通知渠道与开播通知(点击跳直播间) │ ├── PendingNotify.kt 通知没发出去时的待补发判据(同场次、有效期、放弃) │ └── BootReceiver.kt 开机自启(受 ROM 限制,失败静默) └── ui/ Compose 界面(主列表与搜索 / 添加 / 设置 / 数据 / 更新) ``` **新增一个平台(例如快手)**:实现 `LivePlatform`(`accept` 识别输入、`resolve` 解析出稳定标识、`fetch` 批量查询)→ 在 `PlatformRegistry.platforms` 加一行 → UI、数据库、检测引擎**零改动**。 ### 🛡 检测引擎与防误报三道闸 一轮流程:读取启用列表 → 按平台分组 → 调 `platform.fetch()` → 逐个处理 → 批量落库。整轮用 `Mutex` 串行化,避免后台轮询与手动刷新并发导致重复推送。 1. **状态跳变**:必须「上次未开播 → 本次开播」才可能推送; 2. **连续确认**:连续 N 次检测到开播才推(默认 1,可调 2~3);**未达次数前 `isLive` 仍记 false**,否则第二轮会被「上次已开播」挡住,导致 2~3 次确认时永远不推送; 3. **场次去重 + 冷却**:`lastNotifiedLiveStart` 记录已推送场次,同场次不再推,外加冷却(默认 10 分钟)。 ### 🚧 边界情况 | 情况 | 处理 | |---|---| | 网络异常 / 超时 | **不改动已知状态**(不把「没查到」当成「没开播」),只累计错误次数,连续 3 次以上列表标红 | | 整轮无有效网络 | 不发起任何请求、不累计错误、不改开播状态,界面与常驻通知写「等待网络 / 等待 Wi-Fi」 | | 平台接口变更 / 解析失败 | 标记为不可重试错误并提示;抖音会明确显示「抖音页面结构可能已变更」 | | 抖音房间号失效 / 已下播 | 落地页退化成空壳,保守按「未开播」处理——宁可漏报也不误报开播 | | B 站限流(code -412 / -509) | 判定为可重试,节流器保证最小请求间隔 | | 主播改名 / 换头像 | 每轮把昵称、头像、标题、房间链接回写数据库 | | 主播注销 / 房间删除 | 标记失效,列表显示「失效」,不再推送,保留条目等用户移除 | | 添加时已开播 | 入库记为已开播但**不立即推送**,等下一场开播才提醒 | | 重复添加 | 唯一索引 `(platformId, anchorId)` 拦截 | | 开播超过 20 小时(多见于斗鱼重播房) | 斗鱼的 `room_status` 仍为 1 但 `start_time` 是几周前;此时**所有平台**都只显示「直播中」,不再显示「已播 N 小时」 | | 界面正在搜索 / 筛选 | 只影响当前列表的可见项;检测引擎与常驻通知始终读完整列表 | ### 🕒 上次开播:数据从哪来 | 状态 | 展示 | 数据来源 | |---|---|---| | 正在直播 | `已播 1 小时 23 分 · 15:26 开播` | `liveStartAt`(本场开播时刻) | | 未开播、有记录 | `上次开播 5 天前 · 10-23 15:26` | `lastLiveStartAt`(上一场,永久保留) | | 未开播、无记录 | `暂无开播记录` | — | `lastLiveEndAt` 记录引擎检测到「开播 → 未开播」跳变时的下播时刻。数据库 v1→v4 全程用 `ALTER TABLE ADD COLUMN` 增量迁移,升级不丢关注列表;迁移链由 `MigrationSqlTest` 用真实 SQLite 从 v1/v2/v3 三个起点逐列校验。 ### 🔋 省电与省流量 - **B 站批量接口**:20 个主播 1 次请求,而不是 20 次; - 节流器:B 站 800ms/次、抖音 1500ms/次; - 移动网络下间隔自动 ×3(可调 1~6),免打扰时段再 ×5;可设「仅 WiFi 检测」(按 `TRANSPORT_WIFI` 判断,不用「是否计费」代替网络类型); - OkHttp 连接池复用(3 连接 / 5 分钟);异常时 30 秒退避重试。 --- ## 📊 实测验证记录(2026-11-07) | 项目 | 结果 | |---|---| | **数据库迁移 v1→v4 自动化** | ✅ 真实 SQLite 从三个起点跑通迁移链,逐列对照 schema 快照;全量单测 133 项通过、lint 0 error | | **多平台一轮检测** | ✅ 4 位主播跨 4 平台:`checked=4 notified=0 err=0` | | **搜索 / 筛选 / 设置页返回** | ✅ 真机验证:操作面板、立即检测、搜索与筛选、返回键收搜索、侧滑回主页面均正常 | | **通知补发 / 应用内更新** | ✅ 真机:关权限后恢复自动补发;v1.0.5 → v1.0.6 未卸载覆盖升级,数据保留 | | **发布签名校验** | ✅ CI 逐字比对 SHA-256 指纹;`versionCode=10011` / `versionName=1.0.11` 与 tag 一致 | --- ## 📈 B 站数据(可选功能) 长按一个 B 站主播 → 「粉丝走势与数据」,或从设置页进入。两块内容: **粉丝走势**:粉丝总数历史曲线、月度互动观众 / 新观众 / 回访 / 付费人数 / 上舰数 / 打赏金额、生涯统计(场次、活跃天数、总时长、弹幕总量、总收入)。 **互动事件**:输入任意 B 站 UID,统计该用户在各直播间的发言量、打赏、活跃天数、事件类型分布、常去直播间排行、周×小时活跃热力、常用词。另附**最近的互动**清单——逐条列出该用户最近的弹幕 / 礼物 / 上舰 / 醒目留言,按时间倒序(最近在前),每条标出发生时间与所在直播间。 数据鸣谢 [danmakus.com](https://danmakus.com/):本页数据来自社区客户端采集并开放的公开统计接口,**数据覆盖取决于社区采集范围**,不是 B 站官方数据,也不需要登录任何账号。App 内「互动事件」页也标注了来源,接口文档见 [/swagger/index.html](https://ukamnads.icu/swagger/index.html)。 | 用途 | 接口 | |---|---| | 主播信息 + 粉丝历史 | `GET /api/v2/channel?uId=` | | 月度观众趋势 | `GET /api/v2/channel/audience-trend?uId=` | | 生涯统计 | `GET /api/v2/wiki/channel/{uid}/career` | | 用户互动分析 | `POST /api/v3/user-analysis-jobs` → 轮询 → `/result`(MessagePack) | | 最近的互动(逐条记录) | `GET /api/v3/users/{userId}/history`(按场次返回该用户的弹幕/打赏记录) | 几个必须说清的点: - **每个数字都标了口径**:粉丝数为最新快照(标「截至 MM-dd」);场次、总收入、总时长、弹幕总量都是**生涯累计**,从 `career` 接口给出的首播日算起;粉丝走势标的是**当前采集区间**(通常两三个月、十几个采样点),数据覆盖取决于社区采集范围;月度观众固定取最近 12 个月;互动分析标注实际提交的时间区间。 - 请求只带 uid,不发本机关注列表,也不带任何登录态。 - 分析任务是服务端重查询,因此**只在手动点「开始分析」时才发起**;主播数据与已成功的结果会落本机缓存,再进页面优先显示缓存并标注更新时间,刷新失败也保留旧数据。 - **接口线路自动容灾**:主节点 `ukamnads.icu` 与镜像 `api.ukamnads.icu` 返回同一份数据;网络异常 / 5xx / 429 时自动换域重试一次,成功后记住该线路(存本机设置),页脚显示「当前线路」。4xx 与业务错误不换域——换多少个节点结果都一样。全部失败时明确提示「数据服务暂不可用,开播提醒不受影响」。 - 没有采集到数据时给解释性空态,不画一张空图;服务端结构可能随时变更,接口路径集中在 `bili/BiliStatsApi.kt`,域名集中在 `bili/StatsEndpoint.kt`。 - 这些接口对同一 IP 有频率限制,密集查询可能返回空数据或失败,界面会给中文提示。 - 不想要这个功能可以完全不用——它不参与开播检测,也不影响任何本地数据。 --- ## ⚖️ 合规与风险提示 1. 本项目仅用于**个人关注主播的开播提醒**,数据来自各平台公开页面 / 公开接口,不做存储转发、不分发、不用于商业分析。 2. 抖音链路属**未经官方授权的网页解析**:请自行控制请求频率(默认已节流)、不要用于批量采集;页面改版会导致失效,届时应停用该链路或改用官方渠道申请企业资质。 3. 抖音 Cookie 为**可选**功能,仅保存在本机 DataStore,不会上传;应用已设 `allowBackup=false`(不进系统/云备份),设置页默认遮蔽显示。 4. 通知小图标为单色 PNG;若你的 ROM 上显示异常,替换 `drawable-*/ic_notification.png` 即可,无需改代码。 5. **商标与图标**:`drawable-*/ic_platform_*.png` 为各平台官方图标,商标权归对应公司所有,本项目不主张任何权利。若你是相关权利人并认为使用不当,请提 issue,我会第一时间移除。商业化分发请自行替换为中性图标。 --- ## 📄 许可证 [MIT](LICENSE) © 2026 gjkt --- ## 🙏 参考 - 问题反馈与建议:[GitHub Issues](https://github.com/xyzOvO/LiveNotify/issues) - 更新日志与历史版本:[Releases](https://github.com/xyzOvO/LiveNotify/releases) - B 站数据页的统计来自 [danmakus.com](https://danmakus.com/) 社区采集;各平台公开接口由其自行维护,本项目仅作调用。 - 头像、图标等资源版权归原作者所有。