# 文档 (/docs) # 卡片管理 (/docs/features/card-manager) 功能概述 [#功能概述] 卡片管理器允许你管理背屏中常驻显示的卡片。每张卡片对应一个目标应用的组件，你可以自定义卡片的标题、目标包名、组件名称、优先级以及启用状态。 卡片配置修改后，建议重启 com.xiaomi.subscreencenter 以使更改生效。 *** 功能说明 [#功能说明] 卡片属性 [#卡片属性] 每张卡片包含以下可配置属性： | 属性 | 说明 | | -------- | --------------------------------- | | **标题** | 卡片在背屏中显示的名称 | | **目标包名** | 卡片所指向的应用包名（如 `com.android.music`） | | **组件名称** | 应用中具体组件的类名 | | **优先级** | 卡片的排列顺序，数值越小排在越前面 | | **启用状态** | 控制卡片是否在背屏中显示 | *** 使用方法 [#使用方法] 查看现有卡片 [#查看现有卡片] 1. 打开 **REAREye** 应用 2. 进入 **背屏中心** → **卡片管理器** 3. 查看当前已配置的所有卡片列表 添加新卡片 [#添加新卡片] 1. 在卡片管理器中点击添加按钮 2. 填写卡片信息： * 输入 **标题**（用于标记该卡片的用途） * 输入 **目标包名**（应用的 package name 默认即可） * 输入 **组件名称**（卡片所对应的组件名称 - 需要在组件管理器中存在） * 设置 **优先级**（决定显示顺序） 3. 确认保存 4. 确保卡片的启用状态为开启 编辑卡片 [#编辑卡片] 1. 在卡片管理器中点击要编辑的卡片 2. 修改需要变更的属性 3. 保存更改 删除卡片 [#删除卡片] 1. 在卡片管理器中找到要删除的卡片 2. 选择删除并确认 调整优先级 [#调整优先级] 通过修改卡片的优先级数值来调整其在背屏中的排列顺序： * 数值越**小**，卡片排在越**前面** * 数值越**大**，卡片排在越**后面** 启用 / 禁用卡片 [#启用--禁用卡片] * **启用**：卡片将在背屏中正常显示 * **禁用**：卡片保留在配置中但不显示，方便后续重新启用 *** 使用场景 [#使用场景] * **快捷启动**：添加常用应用的卡片，方便在背屏快速打开 * **信息展示**：配置信息类组件的卡片，在背屏实时查看 * **优先级管理**：将重要的卡片排在前面，减少翻找 *** 注意事项 [#注意事项] * 目标包名和组件名称需要填写准确，否则卡片可能无法正常工作 * 修改卡片配置后，建议重启 `com.xiaomi.subscreencenter` * 部分应用的组件可能未适配背屏显示，效果取决于应用本身 * 可以通过禁用而非删除的方式临时隐藏卡片 修改目标包名或组件名称时请确认填写正确。错误的配置可能导致卡片无法显示或显示异常内容。 # 额外设置 (/docs/features/extra-settings) 功能概述 [#功能概述] 组件额外设置管理器允许你为背屏中的特定组件添加额外的显示选项。通过手动添加组件并配置其选项，可以更精细地控制背屏组件的展示行为。 *** 功能说明 [#功能说明] 支持的额外选项 [#支持的额外选项] 当前支持的额外设置包括： * **关闭通知时间显示**：为指定组件隐藏通知时间的显示 *** 使用方法 [#使用方法] 添加组件 [#添加组件] 1. 打开 **REAREye** 应用 2. 进入 **背屏中心** → **组件额外设置管理器** 3. 点击添加按钮 4. 输入目标组件的包名和组件名称 5. 确认添加 配置选项 [#配置选项] 1. 在额外设置列表中找到已添加的组件 2. 开启或关闭该组件的额外显示选项 * 例如：开启「关闭通知时间显示」可隐藏该组件的通知时间 删除组件 [#删除组件] 1. 在额外设置列表中找到要删除的组件 2. 选择删除并确认 *** 使用场景 [#使用场景] * **简化显示**：隐藏不需要的元素（如通知时间），让背屏显示更简洁 * **个性化配置**：为不同的组件应用不同的显示策略 * **兼容性调整**：针对特定组件的显示问题进行微调 *** 注意事项 [#注意事项] * 需要准确填写目标组件的包名和组件名称 * 修改额外设置后，建议重启 `com.xiaomi.subscreencenter` * 未来版本可能会增加更多额外选项 如果你不确定组件的包名和组件名称，可以通过 LSPosed 的日志或相关工具获取。 # 功能列表 (/docs/features) 功能分类 [#功能分类] 1. 系统框架 2. 背屏中心 3. 主题管理 4. 杂项 某些功能可能因设备或系统版本不同而表现有所差异 系统框架 [#系统框架] 1. **活动白名单**: * 模式: 白名单 / 全选 * 作用: 允许选中的应用在背屏中启动活动 2. **后台白名单**: * 白名单应用：允许被选中的应用不受系统限制在后台运行 * 锁定应用：以系统用户的身份锁定选中的应用 3. **阻止锁屏后背屏返回桌面**: * 开启后锁屏将不会强制让在背屏运行的应用返回桌面 4. **禁用背屏保护**: * 开启后主屏全屏播放视频时将不会锁定背屏 背屏中心 [#背屏中心] # 歌词显示 (/docs/features/lyrics) 功能概述 [#功能概述] REAREye 的歌词系统**不直接提供**背屏歌词显示功能，而是通过整合歌词数据源，让小米主题原有的歌词功能在背屏上复活。 工作原理 [#工作原理] ``` 词幕插件 (Lyricon) / SuperLyric → 获取歌词数据 → REAREye 转接 → 主题组件显示歌词 ``` 1. **歌词提供器**（Lyricon 插件 / SuperLyric）负责从音乐应用获取歌词 2. **REAREye** 作为中间层，支持切换和管理不同的歌词提供器 3. **主题组件**（如背屏音乐主题）负责在背屏上实际渲染和显示歌词 仅安装 REAREye 无法直接在背屏显示歌词。你还需要安装支持歌词显示的主题组件。 *** 前置条件 [#前置条件] 使用歌词功能前，请确保： 1. 已安装并激活 **REAREye** 模块（参考 [安装指南](/docs/basic/installation)） 2. 已安装支持歌词显示的**背屏主题组件**（见下方说明） 3. 已安装**歌词插件**（Lyricon 词幕插件或 SuperLyric） *** 背屏主题组件 [#背屏主题组件] 歌词的实际显示依赖于背屏主题组件。目前相关项目： | 项目 | 说明 | 状态 | | -------------------------------------------------------------------------------- | -------- | -------- | | [Xiaomi-RearScreen-Music](https://github.com/SiberiaApp/Xiaomi-RearScreen-Music) | 背屏音乐主题组件 | 2.0已完成适配 | 请下载其中一个组件并以组件名 `music` 添加到模块中，以启用背屏歌词显示功能。 请不要将组件添加至卡片，否则您的背屏将会显示两个音乐卡片 *** 歌词提供器 [#歌词提供器] REAREye 通过歌词提供器获取歌词数据。目前支持两种提供器。 QQ 音乐已原生支持小米歌词元数据，不推荐额外安装针对QQ音乐的歌词提供器 如需使用请使用 REAREye 1.0.5 测试版并开启 `移除由原生API提供的歌词` 功能 Lyricon（词幕） [#lyricon词幕] Lyricon 是一个模块化的歌词系统，通过**插件**从不同的音乐应用获取歌词。REAREye 对接的是 Lyricon 的插件层。 安装 [#安装] 你只需要安装**词幕插件**，无需安装 Lyricon 主体： 1. 从 [LyricProvider Releases](https://github.com/tomakino/LyricProvider/releases) 下载对应音乐应用的插件 2. 在设备上安装插件 APK 3. 在 **LSPosed** 管理器中启用插件模块 4. 确认作用域包含目标音乐应用 5. 重启设备或相关应用 Lyricon 插件按音乐应用分类，如网易云音乐、QQ 音乐等。根据你使用的音乐应用下载对应插件即可。 Lyricon 插件 和 Lyricon词幕 是分开的，**只需安装插件** 即可为 REAREye 提供歌词数据，无需安装主体 **以下内容只适用于需要同时使用词幕的用户 如果您不使用词幕不要阅读** ~~如果您需要同时使用 REAREye 1.0.4 和 Lyricon 请下载 群文件的修改版~~ 如果你正在使用REAREye 1.0.5 及以上版本 请使用 [词幕](https://github.com/tomakino/lyricon/releases) 的最新版本(v1.0.30-beta2以上) SuperLyric [#superlyric] SuperLyric 是另一个歌词提供器，同样为 REAREye 提供歌词数据。 安装 [#安装-1] 1. 从 [GitHub](https://github.com/HChenX/SuperLyric) 下载 SuperLyric 的 APK 安装包 2. 在设备上安装 APK 3. 在 **LSPosed** 管理器中启用 SuperLyric 模块 4. 确认作用域配置正确 5. 重启设备或相关应用 Lyricon 插件和 SuperLyric 可以同时安装，之后在 REAREye 设置中按需切换使用。 REAREye 1.0.5 开始 需要使用 **SuperLyric v3.1** 及以上版本 请注意该版本开始 SuperLyric 需要 **API 101** *** 音乐控件白名单 [#音乐控件白名单] 在使用歌词功能之前，需要将你的音乐应用添加到音乐控件白名单中。 设置步骤 [#设置步骤] 1. 打开 **REAREye** 应用 2. 进入 **背屏中心** → **音乐控件白名单** 3. 勾选你使用的音乐应用（如 QQ 音乐、网易云音乐等） 4. 修改后建议重启 `com.xiaomi.subscreencenter` 强制刷新音乐控件状态 [#强制刷新音乐控件状态] 部分音乐应用在切歌或播放状态变化后，背屏控件可能不会及时更新。你可以开启「强制刷新音乐控件状态」来解决此问题。 *** 歌词显示模式 [#歌词显示模式] 当歌词系统正常工作后，可以在 REAREye 中配置显示模式： 原文 [#原文] 显示歌曲的原始歌词文本。 翻译 [#翻译] 如果歌词提供器包含翻译数据，可显示歌词的翻译版本。 罗马音 [#罗马音] 显示歌词的罗马音标注（适用于日语、韩语等歌曲）。 设置方法 [#设置方法] 1. 打开 **REAREye** 应用 2. 进入 **背屏中心** → **歌词显示模式** 3. 选择你偏好的显示模式 *** 切换歌词提供器 [#切换歌词提供器] 如果你同时安装了 Lyricon 插件和 SuperLyric，可以在 REAREye 中切换使用。 1. 打开 **REAREye** 应用 2. 进入 **背屏中心** → **歌词提供器** 3. 选择 **Lyricon** 或 **SuperLyric** 不同的提供器可能支持不同的歌曲和歌词格式。如果某个提供器找不到歌词，可以尝试切换到另一个。 *** 逐行歌词显示 [#逐行歌词显示] REAREye 支持逐行歌词显示模式，可以更精确地跟随播放进度。 1. 打开 **REAREye** 应用 2. 进入 **背屏中心** → **逐行歌词显示模式** 3. 选择显示 **原文** 或 **翻译** *** 常见问题 [#常见问题] 背屏上没有显示歌词？ [#背屏上没有显示歌词] 请检查以下几点： 1. 是否安装了支持歌词显示的**主题组件** 2. 是否安装了**歌词插件**（Lyricon 插件或 SuperLyric） 3. 音乐应用是否已添加到**音乐控件白名单** 4. LSPosed 中 REAREye 作用域是否包含 `com.xiaomi.subscreencenter` 5. 尝试重启 `com.xiaomi.subscreencenter` 或重启设备 歌曲切换后没有更新？ [#歌曲切换后没有更新] * 请开启「强制刷新音乐控件状态」功能 歌词不同步或显示不完整？ [#歌词不同步或显示不完整] 1. 尝试开启「强制刷新音乐控件状态」 2. 尝试切换不同的歌词提供器 3. 部分歌曲可能暂无歌词数据，属于正常现象 Lyricon 插件和 Lyricon 主体有什么区别？ [#lyricon-插件和-lyricon-主体有什么区别] * **Lyricon（词幕）主体**：完整的状态栏歌词应用，独立于 REAREye 使用 * **Lyricon 词幕插件**：仅为 REAREye 提供歌词数据，无需安装主体 使用 REAREye 的歌词功能时，**只需安装插件**即可。 如何获取更多帮助？ [#如何获取更多帮助] * 关注 [Xiaomi-RearScreen-Music](https://github.com/SiberiaApp/Xiaomi-RearScreen-Music) 项目更新 * 加入 REAREye QQ 群获取最新信息 * 查看 [LyricProvider 仓库](https://github.com/tomakino/LyricProvider) 获取更多歌词插件 歌词功能依赖主题组件、歌词提供器和音乐应用的多方配合，不同应用和系统版本可能存在兼容性差异。 # 添加视频壁纸 (/docs/features/video-wallpaper) 功能概述 [#功能概述] REAREye 解除了系统对视频壁纸的多项限制，允许你使用更长、更高帧率的视频作为背屏壁纸，并支持带音频的视频壁纸。 视频壁纸功能属于主题管理相关功能，修改后建议重启 com.android.thememanager，必要时重启系统。 *** 功能特性 [#功能特性] 强制视频壁纸循环播放 [#强制视频壁纸循环播放] 开启后，视频壁纸播放完毕后会自动从头开始循环播放，而不是停止在最后一帧。 视频壁纸音量调节 [#视频壁纸音量调节] 支持从 **0% 到 100%** 细粒度调节视频壁纸的播放音量： * **0%**：完全静音（等同于默认行为） * **1% \~ 50%**：低音量，适合安静环境 * **51% \~ 100%**：较高音量，注意可能影响其他音频 解除视频壁纸限制 [#解除视频壁纸限制] REAREye 移除了系统对视频壁纸的多项限制： | 限制项 | 原厂限制 | 解除后 | | -------- | ------ | --------- | | **视频时长** | 有限制 | 移除时长限制 | | **帧率** | 默认帧率限制 | 按素材原始帧率加载 | | **音频** | 静音视频 | 允许带音频的视频 | *** 使用方法 [#使用方法] 添加视频壁纸 [#添加视频壁纸] 1. 确保已在 REAREye 中开启相关功能： * 打开 **REAREye** 应用 * 进入 **主题管理** → **解除视频壁纸限制** * 开启需要的功能项 2. 打开系统 **主题管理器** 3. 进入壁纸设置，选择视频作为壁纸 4. 选择你的视频文件 设置循环播放 [#设置循环播放] 1. 打开 **REAREye** 应用 2. 进入 **主题管理** → **强制视频壁纸循环播放** 3. 开启此功能 调节音量 [#调节音量] 1. 打开 **REAREye** 应用 2. 进入 **主题管理** → **视频壁纸音量调节** 3. 拖动滑块或输入数值设置音量百分比 *** 使用场景 [#使用场景] * **长视频壁纸**：使用较长的视频片段（如延时摄影、风景视频）作为壁纸 * **高帧率视频**：使用 60fps 或更高帧率的视频，获得更流畅的壁纸效果 * **带音效壁纸**：开启音频的视频壁纸，营造氛围（建议低音量或静音） * **循环动画**：使用短视频设置循环播放，实现动态壁纸效果 *** 注意事项 [#注意事项] * 解除时长和帧率限制后，较长或高帧率的视频会消耗更多系统资源 * 带音频的视频壁纸可能影响其他应用的音频播放，建议根据场景调节音量 * 部分格式的视频文件可能不被系统支持，建议使用常见的 MP4 格式 * 修改主题管理相关功能后，建议重启 `com.android.thememanager`，必要时重启系统 * 解除模板数量上限后，极端大数量模板场景建议自行测试稳定性 视频壁纸会比静态壁纸消耗更多电量。在电量敏感的场景下，建议使用较短的循环视频或适当降低帧率。 # 壁纸管理 (/docs/features/wallpaper-manager) 功能概述 [#功能概述] 壁纸管理器提供了对背屏壁纸的完整管理能力，包括查看可用壁纸、设定当前壁纸、配置壁纸轮播以及调整轮播顺序和间隔。 壁纸配置修改后，建议重启 com.xiaomi.subscreencenter 以使更改生效。 *** 功能说明 [#功能说明] 可用壁纸 [#可用壁纸] 壁纸管理器会列出当前系统中所有可用的背屏壁纸。 设定当前壁纸 [#设定当前壁纸] 从可用壁纸列表中选择一张，设为当前背屏显示的壁纸。 壁纸轮播 [#壁纸轮播] 可以将多张壁纸加入轮播列表，按设定的时间间隔自动切换。 *** 使用方法 [#使用方法] 查看可用壁纸 [#查看可用壁纸] 1. 打开 **REAREye** 应用 2. 进入 **背屏中心** → **壁纸管理器** 3. 查看当前系统中所有可用的背屏壁纸 设定当前壁纸 [#设定当前壁纸-1] 1. 在壁纸管理器中点击想要使用的壁纸 2. 选择「设为当前壁纸」 3. 背屏将立即切换到所选壁纸 配置壁纸轮播 [#配置壁纸轮播] 添加壁纸到轮播列表 [#添加壁纸到轮播列表] 1. 在壁纸管理器中选择壁纸 2. 将其加入轮播列表 调整轮播顺序 [#调整轮播顺序] 1. 在轮播列表中，长按壁纸项目 2. 拖拽到目标位置 3. 松手确认新顺序 设置切换间隔 [#设置切换间隔] 1. 在轮播设置中找到「切换间隔」选项 2. 以毫秒为单位输入间隔时间 * 例如：`5000` = 每 5 秒切换 * 例如：`30000` = 每 30 秒切换 * 例如：`60000` = 每 1 分钟切换 开启 / 关闭轮播 [#开启--关闭轮播] 1. 在轮播设置中找到「壁纸轮播」开关 2. 开启：壁纸将按设定的间隔和顺序自动切换 3. 关闭：仅显示当前设定的单张壁纸 *** 建议配置 [#建议配置] | 场景 | 建议间隔 | | ----- | ----------------- | | 快速浏览 | 3000 \~ 5000 ms | | 日常使用 | 30000 \~ 60000 ms | | 长时间展示 | 300000 ms（5 分钟） | *** 注意事项 [#注意事项] * 过短的切换间隔（如 \< 1000ms）可能导致视觉体验不佳 * 轮播列表中的壁纸数量没有严格限制，但建议控制在合理范围内 * 拖拽排序功能需要在轮播列表中操作，而非在全部壁纸列表中 * 修改壁纸相关配置后，建议重启 `com.xiaomi.subscreencenter` 如果你使用了视频壁纸，请参考「添加视频壁纸」文档了解相关设置。 # 组件管理 (/docs/features/widget-manager) 功能概述 [#功能概述] 组件模板管理器允许你管理背屏中 组件(Widget) 到模板文件的映射关系。通过导入自定义模板文件，可以扩展背屏的组件展示能力。 修改组件模板配置后，建议重启 com.xiaomi.subscreencenter 以使更改生效。 *** 功能说明 [#功能说明] 模板映射管理 [#模板映射管理] 组件模板管理器维护着 Widget 与模板文件之间的对应关系。每个 Widget 可以绑定一个模板文件，决定该组件在背屏上的呈现方式。 导入模板 [#导入模板] 1. 打开 **REAREye** 应用 2. 进入 **背屏中心** → **组件模板管理器** 3. 点击导入按钮，选择模板文件 4. 导入后会立即更新运行时映射，无需重启 请确保导入的模板文件格式正确。格式错误的模板可能导致组件显示异常。 模板文件要求 [#模板文件要求] * 模板文件需符合背屏组件的模板规范 * 文件名应具有辨识度，方便后续管理 * 建议从可信来源获取模板文件 *** 使用场景 [#使用场景] * **自定义卡片**：添加自定义组件模板，你可以在卡片管理器中注册对应的卡片，实现个性化的背屏信息展示 * **扩展组件功能**：使用社区提供的模板获取更多组件样式 * **替换默认模板**：将系统自带的组件模板替换为自己偏好的版本 *** 操作步骤 [#操作步骤] 查看当前模板 [#查看当前模板] 1. 打开 **REAREye** 应用 2. 进入 **背屏中心** → **组件模板管理器** 3. 查看当前已配置的 Widget 与模板映射列表 添加新的映射 [#添加新的映射] 1. 在组件模板管理器中选择目标 组件 2. 指定对应的模板文件 3. 确认保存 删除映射 [#删除映射] 1. 在组件模板管理器中找到要删除的映射 2. 选择删除，确认操作 *** 注意事项 [#注意事项] * 修改模板映射后，建议重启 `com.xiaomi.subscreencenter` * 解除模板数量上限后（见主题管理相关功能），可以添加更多模板 * 极端大数量模板场景建议自行测试稳定性 * 导入模板后如遇异常，可尝试删除对应映射并重启背屏中心 如果你不确定模板文件的来源和安全性，建议先在非主力设备上测试。 # 模块介绍 (/docs/get-started) 欢迎使用 **REAREye**！ 这是一个基于 Xposed 框架的模块，为您的妙想背屏提供额外的更多扩展功能。 快速开始 [#快速开始] 需求 [#需求] * HyperOS 3.0 * 已安装并激活 LSPosed 框架 * 目标应用已在 Xposed 作用域中启用 REAREye # 安装指南 (/docs/get-started/installation) 前置条件 [#前置条件] 在安装 REAREye 之前，请确保你的设备满足以下条件： 1. 已 Root 的 小米 17 Pro 或 Pro Max 设备 2. 已安装 **LSPosed** 框架 安装步骤 [#安装步骤] 1\. 下载模块 [#1-下载模块] | **版本** | 稳定版 | 测试版 | | ------ | --------------------------------------------------------------------- | ------------------------------------------------------------------- | | **特点** | 稳定版经过多轮测试的校验，
使用过程中不会遇到什么问题，
但是不会拥有最新的功能特性 | 测试版包含最新功能，
但可能未经过充分测试
**下载需要登录 GitHub 账号** | | **下载** | [GitHub Releases](https://github.com/killerprojecte/REAREye/releases) | [Github Actions](https://github.com/killerprojecte/REAREye/actions) | 或加入 [**QQ群**](https://qm.qq.com/q/h7e2si9R74) 从群文件中下载最新版本。 2\. 安装 [#2-安装] 从上面的途径获取到 APK 文件后 通过文件管理器或包管理器在您的设备中安装 3\. 在 LSPosed 中激活 [#3-在-lsposed-中激活] 1. 打开 **LSPosed** 管理器 2. 找到 **REAREye** 模块 3. 勾选启用，并选择作用域（需要Hook的目标应用） 4. 重启设备或目标应用 修改作用域后需要重启目标应用才能生效。 **如果是首次安装请重启您的设备** # 使用教程 (/docs/guides) 使用教程 [#使用教程] # 背屏歌词 (/docs/guides/lyrics) 视频教程 [#视频教程]