LiveBridge完整指南：如何在Android 16上把每条通知变成灵动岛实时活动-平芜编程栈

【免费下载链接】livebridge

Level up your dynamic pill/island on Android

项目地址：https://gitcode.com/gh_mirrors/li/livebridge

LiveBridge是一款专为 Android 16 打造的开源工具，能把普通通知一键转换为系统级的Live Updates（实时活动），也就是 Android 版"灵动岛"体验。出租车到哪了、外卖还剩多久、网速多快——这些信息都能常驻在状态栏的胶囊胶囊（pill）里实时刷新。本文将带你从零开始，快速上手这款"通知转灵动岛"神器。

LiveBridge 是什么？

一句话概括：它是一个"通知 → 灵动岛"的转换器。

系统里任何 App 发出的进度类通知（打车、外卖、下载、通话等），都会被 LiveBridge 捕获；
经过智能解析后，重新生成一条Live Update 通知，以动态胶囊形式悬浮在状态栏；
支持点击展开、执行快捷操作（接听、拒绝等），甚至同步到手表端。

安装前的准备工作

LiveBridge 依赖 Android 16 的系统能力，安装前请确认：

检查项	要求
系统版本	Android 16 或更高
安装包	从官方下载页面获取 APK
安装时	临时关闭 Play Protect拦截
运行权限	通知读取（Notification Listener）+ 通知发送权限

⚠️ 部分国产 ROM（如小米、三星等）建议额外关闭对该 App 的后台清理/电池限制，保证实时活动不中断。

三步跑通灵动岛实时活动

安装并打开 App，首页打开LiveBridge is running主开关；
在Permissions卡片中授予通知读取权限（系统会跳转到通知使用权设置页）；
在Settings里按需开启网络速度监控、智能转换等能力，等待第一条通知被"点亮"成胶囊。

首页下方的Recent conversions会记录最近被转换的通知来源（如 Pixel Weather、Google、Hiddify），点击任意条目可进入该应用的独立行为配置页。

核心功能详解

1. 智能状态识别（Smart Detection）

LiveBridge 内置多语言解析词典，能自动识别"出租车到达""外卖已送达""通话中"等语义场景，甚至天气更新也会以胶囊形式呈现。词典支持自动更新，还能在 App 内手动编辑——源码中的词典文件位于android/app/src/main/assets/liveupdate_dictionary.json（另有中、英、韩、俄、葡语版本）。

2. 通知源过滤与每应用自定义

不是所有通知都该上岛。在Rules → Smart conversion页面可以选择三种模式：

All apps：转换所有 App 的通知
Only selected：仅转换勾选的应用
Exclude selected：排除勾选的应用

每个应用还能单独设置：是否转换、是否删除原通知、自定义标题/正文模板等，配置入口即首页列表中的App config页面。过滤规则由原生层 SourceChannelRules.kt 缓存执行，保证高频通知下依然流畅。

3. OTP 验证码一键提取

收到的 4~8 位验证码会自动从通知文本中识别，并支持自动复制到剪贴板（带 60 秒防重复抑制），在灵动岛里输入密码不再需要来回翻找。相关实现见 LiveUpdateNotifier.kt，UI 入口在lib/screens/redesign/rules_otp_codes_screen.dart。

4. 实时网速：从状态栏到手表

开启网络速度监控后，LiveBridge 会启动前台服务周期性采样流量，把 ↓/↑ 速度实时刷进胶囊。更酷的是，它还支持Wear OS 同步——抬手就能在手表上看到与手机一致的实时网速活动：

控制逻辑封装在 NetworkSpeedController.kt，可见性策略则在同目录的NetworkSpeedVisibilityPolicy.kt中。

5. 小米 Hyper Island 专属适配

小米用户有福了：LiveBridge 通过 HyperBridgeAdapter.kt 桥接小米原生 Hyper Island 能力，让实时活动直接"住进"澎湃系统的智慧岛，进度条、快捷按钮一应俱全。

已知限制（安装前必读）

来自 README.md 的官方说明：

AOSP 纯净系统上图标与标签行为可能与 OEM 定制系统不同；
息屏显示（AoD）与isOngoing行为因厂商而异；
中国 OriginOS 与 CMF 设备目前不可用；
Nothing 设备若无 Progress Glyph 指示器，效果会打折扣。

总结

LiveBridge 把"通知"从一次性信息升级为持续追踪的实时活动，是 Android 16 平台上最接近 iOS Live Activity 的开源方案。它的架构也很值得学习：Flutter 负责 UI（lib/），Kotlin 原生层负责通知监听、解析与 Live Update 投递（android/app/src/main/kotlin/com/appsfolder/livebridge/liveupdate/），模块职责清晰。

只需一次授权，你的状态栏从此"活"了起来。