词幕Lyricon是什么？Android状态栏歌词工具完全入门指南-开发者社区

【免费下载链接】lyricon

为 Android 系统扩展状态栏歌词显示功能的增强工具

项目地址：https://gitcode.com/gh_mirrors/ly/lyricon

词幕Lyricon是一款基于 Xposed / LSPosed 的Android 状态栏歌词工具，能把正在播放的歌曲歌词实时显示在系统状态栏区域，支持逐字高亮、翻译歌词、AI 翻译和自定义样式。无论你是想"边听歌边看状态栏歌词"，还是想给不同播放器配置独立样式，这份指南都能帮你在 10 分钟内完成安装并跑通显示效果。

词幕Lyricon 能做什么？核心功能一览

一句话概括：词幕负责"显示"，插件负责"供歌词"。主体应用本身不直接显示状态栏歌词，只有 LSPosed 模块启用、作用域包含System UI并重启后，歌词才会出现在状态栏。

功能	说明
🎵 状态栏歌词	在系统状态栏区域显示当前播放歌词
✨ 逐字歌词	支持字词级进度和高亮（取决于歌词来源）
🌏 翻译歌词	插件提供翻译，或接入 OpenAI 兼容接口生成
🧩 插件扩展	通过歌词提供服务（LyricProvider）适配不同播放器
🎨 视觉自定义	文字、图标、动画、封面取色均可独立配置
💾 备份恢复	一键导出、恢复全部配置

不同 ROM 的状态栏结构差异较大，位置参数没有通用最佳值，需要结合自己的设备微调。

词幕由哪三部分组成？

理解下面的结构，能帮你快速判断"歌词不显示"到底卡在哪一步：

组成	作用	对应源码/文档
词幕主体应用	管理配置、样式、歌词服务和备份恢复	docs/zh-cn/app/index.md
LSPosed 模块	将歌词视图注入 System UI	xposed/
歌词提供服务	从播放器提供歌词、状态和翻译数据	lyric/bridge/provider/

安装前准备：环境要求

先确认设备满足以下条件，再开始安装：

项目	要求
Android 版本	Android 10（API 29）及以上
Root	需要 Root 环境
LSPosed 框架	LSPosed 2.0 及更高版本（建议最新正式版）
模块作用域	必须包含系统界面（System UI）

三步完成安装激活

安装主体应用：从项目 Releases 下载最新 APK 并安装，打开确认可进入首页。
启用 LSPosed 模块：打开 LSPosed 管理器，启用词幕模块，进入作用域设置勾选系统界面（System UI）。
重启 System UI：保存后重启 System UI 或重启设备（词幕首页也提供"重启系统界面"入口，需要 Root 授权）。
安装歌词提供服务：根据你使用的播放器安装对应插件（如 LyricProvider），然后重新打开播放器播放一首有歌词的歌。

安装与激活的完整步骤可参考 docs/zh-cn/app/installation.md。

首次使用检查清单

歌词能正常显示后，再去做视觉微调。按顺序逐项确认：

词幕 APK 已安装
LSPosed 中已启用词幕模块
模块作用域已勾选系统界面（System UI）
System UI 已重启或设备已重启
首页模块状态显示为已激活
已安装当前播放器对应的歌词提供服务
播放器正在播放一首有歌词的歌

💡 首页顶部状态卡片是你的"诊断面板"：出现"待重启系统界面"说明需要重新注入；出现"系统界面异常，已禁用"说明触发了保护机制，需要回退最近修改的配置。

歌词来自哪里？认识歌词提供服务

词幕主体应用不保证所有播放器都能直接提供歌词，它依赖歌词提供服务（LyricProvider）把播放器和词幕连接起来。进入词幕首页的歌词提供服务页面，可以按类别查看已安装的服务、作者、版本和能力标签（如逐字歌词、翻译）。

想适配的播放器没有插件？优先检查插件是否支持当前播放器版本，而不是去调整样式。
插件安装后无歌词？确认插件 APK 已安装成功、词幕拥有读取应用列表权限，并重新打开播放器。

详细规则见 docs/zh-cn/app/providers.md。

状态栏歌词样式怎么调？常用设置速览

词幕把显示相关的设置分成两大类，新手建议按"先位置、后样式"的顺序调整：

页面	管什么	典型调整项
基本设置	歌词容器在状态栏中的位置与尺寸	锚点、插入顺序、宽度、边距、内边距
应用样式	歌词的文字、图标和动画	字号、颜色、字体、跑马灯、图标来源、切换动画

几个实用建议：

位置不对：先换锚点和插入顺序，再调宽度，最后用边距/内边距做像素级微调。
覆盖系统图标：优先减小宽度或更换锚点。
长歌词较多：开启跑马灯滚动比单纯加宽更稳定。
单播放器特殊需求：为它单独创建应用样式（单独样式 > 默认样式）。

完整说明见 docs/zh-cn/app/basic-settings.md 和 docs/zh-cn/app/app-style.md。

AI 翻译：让外语歌词自动变中文

除了插件直接提供的翻译，词幕还支持接入OpenAI 兼容接口生成翻译，并自动缓存结果，避免重复消耗额度。配置项包括目标语言、API 密钥、模型、基础地址和自定义提示词。

⚠️ 使用 AI 翻译时，歌词文本会发送到你配置的服务，请注意费用与隐私政策。修改提示词后想重新翻译，可使用"清空数据库"清除本地缓存。详见 docs/zh-cn/app/translation.md。

常见问题快速排查

现象	优先检查
歌词完全不显示	LSPosed 模块是否启用 → 作用域是否含 System UI → 是否重启 → 是否安装歌词服务
模块未激活	LSPosed 配置、作用域、System UI 是否重启
提示"待重启系统界面"	点击首页重启入口或手动重启设备（需 Root 授权）
歌词覆盖系统图标	减小宽度、更换锚点、调整插入顺序
没有逐字歌词	查看歌词服务是否有"逐字歌词"标签（依赖歌词来源）
更新后显示异常	重启 System UI、检查作用域、重新调整锚点宽度

更多排查思路见 docs/zh-cn/app/troubleshooting.md。

换机或刷机前，记得备份配置

词幕支持一键导出/恢复配置（默认文件名lyricon_backup.bin），包含基本设置、默认与单应用样式、文字/图标/动画、翻译配置等偏好（密钥等敏感信息不会被备份）。建议在新设备恢复后，重新检查锚点、宽度和视图规则是否仍适合当前 ROM。详见 docs/zh-cn/app/backup-restore.md。

写在最后

词幕Lyricon 的核心价值在于：用插件化解锁任意播放器的歌词，用 LSPosed 把歌词搬进系统状态栏，再用丰富的样式选项让它融入你的桌面。建议按"先跑通显示 → 再调位置 → 最后玩样式"的节奏上手，遇到问题优先看首页状态卡片。官方使用文档入口见 docs/zh-cn/app/index.md，祝你早日享受"抬眼即歌词"的体验 🎧