# 使用指南
本页截图保留 1.2.4 真机来源；下载版本以[安装页](https://beatsad.github.io/quiet-tv/)为准。下文注明的电脑 AI 配置方式属于当前源码，尚未随新 APK 发布；旧包按对应界面使用，文档更新不改变已安装应用。
[English](USAGE.en.md) [返回首页](../README.md)
## 遥控器
| 操作 | 行为 |
| --- | --- |
| 左／右 | 普通浏览在行末停止；第二屏移动排序时可跨行，列表首尾停止 |
| 上／下 | 在快捷按钮、Dock 与应用网格之间逐行移动 |
| 确定 | 当前源码：桌面短按后等待约400ms，再打开选中的应用或入口；设置页保持原操作 |
| 桌面双击确定 | 当前源码：400ms内两次短按进入屏保，自动进入关闭时也可使用 |
| 长按确定 | 当前开发源码中打开应用操作菜单，松开不启动应用 |
| 网格中按返回 | 返回 Dock |
| 按 HOME | 回到 Quiet TV 首屏，焦点落在常用应用区 |
| 从应用按返回回桌面 | 保留离开桌面前的位置和焦点 |
当前开发源码中，未配置按键映射时，桌面收到标准菜单键时打开系统设置，收到标准信号源键时打开信号源入口；均在松开按键时执行，取消的按键不触发。厂商系统直接处理的按键和私有键码仍需按实际机型、固件验证。 电脑 AI 首次配置可按[逐键校准](agent/remote.md)确认 HOME、信号源和菜单的动作，三键全部确认后在本机按机型、固件和用户保存。
全部应用与首页排序均按每行五项显示。最后一行不足五项时，焦点落到最近的有效列。焦点会保存到本地，桌面恢复时可还原；1.2.4 中，新的 HOME 请求始终优先回首屏，普通返回保留原位置。历史版本曾在一台索尼电视完成一次整机重启；该历史记录不作为本次 1.2.4 的重启或完整升级保留验收。
进入“全部应用”时，首页问候、时间日期、天气、右上角快捷按钮和 Dock 一起滚出画面；经典布局和艺术画廊使用相同规则。全部应用收紧顶部间距，每个封面下方显示居中的单行名称，过长时末尾省略，各行间距一致。更多应用随焦点按行连续滚动，不显示滚动条、应用数量或底部辅助文字。当前源码第二屏不显示“全部应用”标题或分类栏，从第一行按上直接回 Dock；网格中按返回也恢复首页原有布局及离开前的 Dock 焦点。
截图直接取自索尼 BRAVIA VH1 / Android 12 上的历史 [1.2.4 测试版](https://github.com/BeatsAD/quiet-tv/releases/tag/v1.2.4)，实际安装包为公开 ARM32 构建64；截图不代替当前功能或其他机型验收，见[素材来源](assets/README.md)。
当前开发源码提供“桌面设置 → 桌面显示 → 操作反馈 → 按键音”，默认关闭。开启后，移动、确认和返回分别播放轻柔提示音；关闭立即静音，设置保存在本机。到达边界及自动恢复焦点时不播放，长按移动音最多每 100 毫秒一次。仅作用于 Quiet TV 自身界面，跟随媒体音量及媒体静音状态，不改变系统音量或申请音频焦点。本次媒体音量与开机解锁兼容修复尚未随新 APK 发布，电视和外接音响的实际听感与延迟需单独验收。
当前开发源码中，长按首页“网络”或“系统设置”的确定键可进入入口测试。先测试当前入口；若没有正常打开，返回后长按同一按钮，标记失败并主动测试下一个入口。确认已正常打开对应设置后，才会记住本次路径。网络按钮若只能打开系统设置首页，会明确提示，不能记作网络入口成功；仍可主动测试下一入口。普通点击和快速返回不会自动确认或自动切换菜单。记忆按网络／系统设置分别保存，固件或相关系统包更新后需重新测试。此功能尚未发布，具体固件仍需真机验证。
首页信号源与“看电视”的 HDMI 选择共用发现规则：标准框架仅登记调谐器时，也会补查现有厂商接口返回的 HDMI。当前开发源码增加老极米产品配置、海信 Jamdeo 原生输入和小米显式端口记录。标准框架已登记的输入类型优先保留；有完整端口对应关系时才补齐同类型缺口，隐藏端口不会通过厂商别名重新出现。映射随固件和相关系统组件版本隔离，详见[本机信号源配置](agent/inputs.md)。未找到入口时不代表电视没有输入接口；新增协议尚待具体固件真机验证。
## 应用管理与 Dock
在首页下方“全部应用”选择“应用管理”。顶部默认显示信号源、网络和系统设置，可在“桌面设置”中分别隐藏。
当前开发源码已提供就地长按菜单：Dock 可移动、替换、添加、移出首页、隐藏和卸载；第二屏可移动、添加到首页、隐藏和卸载。“桌面设置 → 应用管理”中紧跟“预装应用”的“隐藏应用”Tab 可恢复普通隐藏，儿童模式隐藏仍需从家长管理恢复。Dock 不显示添加卡片，添加入口保留在长按菜单中；添加／替换列表的应用封面统一尺寸与圆角。Dock 五项已满时，“添加应用”和“添加到首页”置灰，腾出空位后恢复；添加不再弹出选择替换位置，仍可通过“替换应用”主动替换。恢复遇到 Dock 满位时不会自动覆盖已有入口。第二屏采用插入式移动，保持其他应用的相对顺序；排序时左右可跨行，列表首尾停止，上下逐行移动。Dock 保持左右排序。方向键预览、确定放下保存、返回取消，和下方历史 1.2.4 的每步保存行为不同。详见[当前应用操作规则](APP_MANAGEMENT.md#常用应用--dock)。
- **首页应用（历史 1.2.4 设置页）**：最多 5 个。选位置后可替换、移除，或进入左右排序；1.2.4 中每次移动自动保存，确定或返回结束移动，不撤销已保存顺序。空位从已安装、已启用且有启动入口的应用中添加。移除只改变快捷入口。
- **首页排序**：1.2.4 中，在“应用管理 → 应用排序”调整首页下方应用，包括壁纸设置、桌面设置和应用管理入口。确定选中，方向键移动，每次位置变化自动保存；再次确定或返回结束移动。无需保存按钮，离开页面不再询问保存。历史安装包请按对应版本说明操作。
- **应用管理**：当前开发源码提供全部、用户应用、预装应用、隐藏应用、已禁用、可恢复六个筛选，以及详情、封面、自启和按规则开放的禁用、重新启用、卸载、恢复安装。
- **系统维护**：首次 TCP ADB 配置、机型适配及原桌面接管由电脑 AI 完成；日常操作在电视“连接管理”后执行。预装卸载仅影响当前用户，恢复安装不恢复已删除数据。已发布117/118包尚无恢复后的日常按钮。
- **恢复**：在“应用管理 → 更多 → 帮助与恢复”暂停接管或按保存的原桌面恢复；系统不允许直接恢复、原桌面已禁用或记录不完整时，由电脑继续处理。
- **数据保护**：保留原桌面和操作记录；禁用保留数据，历史卸载已删除的数据不能通过启用恢复。断连后先检查，不自动重放修改。
Dock 编辑不依赖 ADB。禁用的 Dock 应用暂时隐藏并保留顺序，启用后恢复；核对卸载成功后移除其快捷配置。设置在电视本地保存，APK 更新不会覆盖用户的 Dock，包括主动清空的配置。
1.2.4 提供“应用列表 → 更换封面”：同网手机扫码后选图、拖动或缩放裁剪，上传后在电视确认才应用。“恢复默认”需确认，使用应用当前自带封面。推荐 720 × 406 px，最低 360 × 203 px；JPG、PNG、静态 WebP，单张不超过 2 MB，可用 AI 按尺寸辅助制作。无需 ADB；应用原始图标和系统操作保护保留。当前源码三个筛选常驻列表上方，右上角保留“更多”；截图中的旧 ADB 等入口不代表当前源码。详见[自定义应用封面](APP_MANAGEMENT.md#自定义应用封面)。
首页排序同样不依赖 ADB，顶部 Dock 保持独立。保存自定义顺序后，新出现的应用追加到末尾；应用改名或更新保持位置。禁用或加入 Dock 时保留原位置记录，恢复显示后按记录排列；卸载后清除记录。尚未设置自定义顺序时，桌面设置、壁纸设置和应用管理在前，其余按名称排列。配置保留在本机，正常覆盖更新不清除；真实电视的遥控、重启与更新保留情况需在对应设备上验收。
实机证据与支持边界见[管理功能验收](APP_MANAGEMENT.md)。
“应用列表”中的详情提供“更换封面”和“设为开机自启”；截图仅展示入口，未改变应用状态。
## 儿童模式
在“应用管理 → 儿童模式”进入。首次设置6位数字家长密码，以后重新进入需验证；按屏幕数字键盘用方向键和确定输入。“忘记密码”使用自己的恢复方式，不公开家长密码或恢复码。
家长验证后可隐藏或锁定应用，设置单次限时、循环限时或不限制。循环限时像重复闹钟一样设置一次后长期生效，可选每天、工作日、周末或自定义星期；选中日期每天自动恢复额度，未选日期不可使用。额度用完进入休息页，家长可验证后追加当天时间；跨天恢复无需密码，待机及重启不清零当天用量。计时需单独启用“儿童模式计时”无障碍服务，与桌面兼容守护分开。详见[儿童模式](APP_MANAGEMENT.md#儿童模式)。
以下仅展示空白家长验证入口；未输入密码、修改规则或开启计时。
## 开机自启
在“桌面设置 → 应用管理”选择应用，在详情点击“设为开机自启”并确认，当前目标可“关闭开机自启”。“更多 → 应用自启”可查看和关闭，包括已卸载的目标。每次只设置一个应用；开机或有效待机唤醒进入 Quiet TV 后启动，普通按 HOME 返回不会重复。开启会提示并关闭“开机自动看电视”，电视信号源仍保留。详见[应用自启](APP_MANAGEMENT.md#开机自启开发源码)。
## 看电视（开发源码）
“桌面设置 → 看电视”提供显示看电视、电视信号源、开机自动看电视、立即观看四项。“显示看电视”默认关闭，首次使用或尚未保存此项选择时，从首页、全部应用和添加／替换应用列表隐藏，仍可进入此设置页手动开启。已有手动保存的显示或隐藏选择继续沿用。开关保存在本机，不影响信号源和开机自动看电视。选择可直达的 HDMI，首页“看电视”和开机自动进入共用该目标；未选择时首页点击进入设置。首页位置通过长按菜单添加、移出或替换，不自动替换其他首页应用。
首次开启自动进入会试播，返回设置后确认画面和声音即可开启；也可先“立即观看”，返回确认后再开启。关闭自动进入保留手动观看；更换信号源需重新确认。它与应用自启互斥。HDMI 仅在完整开机进入 Quiet TV 后尝试一次，普通 HOME 返回不重跳，待机唤醒不主动切源。未找到可直达的 HDMI 时，“电视信号源”提供可用的原厂面板，TCL 快捷面板与系统面板可分别选择。打开面板不保存为 HDMI，也不开启自动进入；没有可用面板时提示使用遥控器信号源键。详见[看电视](APP_MANAGEMENT.md#hdmi-开机直达与看电视开发源码)。
## 开机广告管理
当前源码不在电视提供开机广告管理页面；电脑 AI 仅在用户明确选择、精确规则与本机条件满足时处理，保存原状态并提供恢复。当前尚无通过 Quiet TV 真机验收的开机广告执行规则，不承诺移除所有品牌广告。历史版本可能仍显示旧入口，详见[应用管理](APP_MANAGEMENT.md#开机广告)。
## 语言与初始配置
修改 `app/src/main/assets/launcher.json` 后重新构建并更新安装：
```json
{
"language": "zh",
"greeting": "time",
"dock": ["com.trim.tv", "com.xiaodianshi.tv.yst", "top.yogiczy.slcs.tv", "com.xunlei.downloadprovider.hd"],
"hidden": ["com.dangbei.TVHomeLauncher", "com.android.tv.settings", "com.sony.dtv.settings"]
}
```
这是当前索尼机型的配置示例，包名需按自己的已安装应用调整。`dock` 为首次迁移使用的最多五个应用包名，顺序从左到右；首次迁移后请使用界面管理，修改资源不会覆盖已保存的 Dock。`hidden` 只影响桌面显示，不禁用包。`language` 使用 `zh` 或 `en`；`greeting` 使用 `time` 或 `home`。当前代码不支持提示词中规划的 `system` 自动语言模式。
## 壁纸
在“全部应用”中进入“壁纸设置”。当前开发源码中，方向键聚焦素材卡片只预览；单击或按确认键直接保存为桌面壁纸，不再显示“设为壁纸”按钮，底部居中胶囊工具栏的“设为屏保”只保存屏保素材。卡片分别标记“壁纸”“屏保”，同一素材可以同时使用。按返回丢弃未应用的预览。长按卡片确认删除；已完成的删除不会因返回而撤销。历史安装包仍按原操作使用。
- **默认颜色主题**：纯黑背景加主题色光晕，随选中应用换色，始终保留且不可删除。
- **轮播频率**：顶部“轮播”胶囊下拉框支持关闭、1／5／15／30 分钟及 1 小时；上下移动仅预选，按确定保存，按返回取消并回到胶囊。选择时间后从当前预览素材开始，静态图片与动态视频各自在当前分类按列表顺序轮播，不混播，默认颜色和每日壁纸不参与。同类素材不足两项时入口置灰并提示。旧版本已开启轮播的设置保留 5 分钟，关闭状态不变；频率保存后重启保留。打开选择页、进入屏保或离开桌面时暂停，回来后重新计时；手动确认单个壁纸关闭轮播，但保留频率。
- **每日壁纸**：默认颜色主题后的“每日壁纸”卡片，左右聚焦仅预览，在卡片上单击或按确认键后应用并开启每日更新。固定使用必应中国，不再提供每日设置、来源选择或检查更新弹窗。标题下方依次显示“必应中国 每天自动更新”及当前已缓存图片的名称；无名称时省略，长名称末尾省略。每日模式与本地轮播互斥；选择本地壁纸后退出每日模式。
- **每日更新与离线**：桌面打开、跨日或网络恢复时按需更新，成功保存新图后再切换；断网或更新失败保留当前壁纸。旧版本正在使用的搏天缓存仅作为过渡背景保留，后续只请求必应，必应图片保存成功后切换。每日入口不能删除。接口与图片地址均需网络可达，不保证所有运营商或电视固件可用。
- **必应筛选与存储**：先检查最近 8 张的资料，跳过未开放壁纸下载的图片，只下载最近可用的一张；当前必应缓存相同或更新时直接复用，不退回更早的图片。必应按两个固定图片位交替覆盖，不按日期累积；单张最多 8 MiB。请求结束时释放原始下载临时文件，显示图保留供断网使用；关闭每日模式不会自动清空缓存。旧搏天缓存不再更新，不自动删除用户现有文件。
- **删除**：聚焦图片或视频卡片，长按遥控器确定键弹出删除确认框，默认聚焦“取消”；选择“删除”才删除这一张，松开长按键不会应用壁纸或自动确认删除。删除用户图片或视频时只移除电视中保存的副本。默认颜色主题和每日壁纸不可删除。删除当前固定图片后回到默认颜色主题，轮播当前图片被删除时切到下一张；同类素材不足两项时自动关闭轮播；视频轮播中删除当前项会选用剩余视频。
- **文件传输**：进入“应用管理 → 文件传输”，可从手机／电脑上传，也可浏览已授权的本地或 U 盘文件。接收后选择“预览并设为壁纸”，确认后应用；单纯接收不更换壁纸。上传 APK 后，在电视选中文件并点击“安装应用”，查看应用信息后由系统确认安装；上传不会自动安装。选中文件后点击“传到手机或电脑”，才会向本次会话提供下载。接收区单文件最多200 MB、总计500 MB；壁纸导入保留单文件规格与实际剩余空间检查，不再限制图库数量及总容量。安卓5及以上可在“选择文件 → 授权目录”后记住对应来源的目录，重启后重新进入即可浏览；授权失效或存储离线时按提示重新授权或连接。详情见[文件传输助手](APP_MANAGEMENT.md#文件传输助手)。
支持 JPG、PNG、静态 WebP；单次输入最多 60 MB、4000 万像素，当前开发源码不再限制静态壁纸数量及图库总容量，并保留实际剩余空间检查。上传和本地导入的图片最高保留 4K：长边不超过 3840、短边不超过 2160 像素，超出时等比缩小，不拉伸或裁切；范围内保留原字节，不放大或重新编码。缩图会校正 EXIF 旋转和镜像，带透明通道的图片保存为 PNG，其余保存为质量 90 的 JPEG；手机、本地或 U 盘中的源文件不变。显示时根据应用实际绘制尺寸和内存条件生成独立的内存显示图，最长边不超过 3840 像素；低内存或内存档位低于 256 MB 时最多 1920 像素。显示用的等比铺满、居中裁切和透明区域黑底不改写已保存文件。已有壁纸保持原样，重新导入时采用新规则。HEIC 照片请先转换为 JPG。
手机上传页选好图片或视频后，可修改“壁纸名称”，默认使用原文件名并隐藏扩展名；不修改即可直接上传。名称不能为空，最多 48 个字符，不含斜杠；上传后显示在电视壁纸列表中，不改动手机原文件。更换文件会更新默认名称，上传失败后重试保留已填写名称；电视端不增加重命名入口或确认弹窗。
1.2.4 支持动态视频壁纸，默认关闭。进入“动态壁纸”分类，移动焦点到卡片即静音播放预览，在卡片上单击或按确认键后应用；若仍在加载，首帧成功后自动保存，无需再次确认。未确认的预览不改变当前壁纸；加载期间切换卡片或退出会取消待应用操作。关闭开关或删除当前视频，恢复此前的图片、每日壁纸或轮播状态。视频默认静音，未开启轮播时单个循环；动态轮播按停留时间换片，新视频首帧成功后保存选择，失败保留原选择，不参加图片轮播；离开桌面或熄屏时释放播放器。播放失败保留原壁纸，可在该卡片上按确定键重试并应用。
视频导入不设固定文件大小、帧率、分辨率、位深或 HDR 上限；文件需包含可识别的视频轨道且未加密。支持常见视频扩展名及 video/* 类型，实际容器由对应系统的解析器识别；多视频轨道交给播放器选择，未知帧率或时长不会单独阻止导入。当前开发源码不再限制动态壁纸数量或视频及封面的总容量，并保留实际剩余空间检查。上传时检查文件可解析性，系统声明的解码能力仅写入诊断，不据此拒绝导入；返回电视后由预览实际尝试解码，首帧成功后才允许应用。Android 5+ 使用 Media3 和有界缓冲，按本机实际解码器自动选择：优先使用支持当前视频的硬解码器，硬解声明不支持时先尝试系统软解；初始化失败会尝试其他可用解码器，硬解运行中发生视频解码错误或首帧超时，会在旧播放器确认释放或退出后进行一次软件解码尝试。切换保留声音与暂停设置，离开页面会取消尚未开始的软解。该策略适用于所有品牌，不要求用户预先转换视频；系统需提供对应的软件解码器，实际帧率由设备性能决定。文件读取、音频、加密和画面输出错误不触发视频软解重试；软解仍失败时显示对应提示并保留原壁纸。当前开发源码在 Android 8.1/API27 及以上的全屏壁纸与屏保中使用 SurfaceView 独立输出，Android 5.0–8.0 保留 TextureView，文件传输页的小窗口预览继续使用 TextureView。首页与第二屏切换模糊、亮度和淡入参数时复用播放器及视频输出。API27+ 保留 SurfaceView 的独立输出路径，模糊层通过异步 PixelCopy 获取有界小图，不缩小原视频解码或无模糊时的视频输出；实际输出分辨率和流畅度须单独验收。淡入设为 0 仅关闭动画，仍等待首帧和封面窗口帧交接；取帧失败保留上一有效模糊画面。亮度和淡入使用覆盖层，不依赖 SurfaceView 的半透明支持。安卓4.x兼容档默认在私有播放进程中使用系统 MediaPlayer。安卓4.1–4.4（API16–19）在系统播放器解码失败或首帧超时、且存在对应系统软件解码器时，确认旧播放器释放后进行一次显式软解尝试；使用纯 Java 的 ExoPlayer 2.18.7 适配音画同步与循环，不增加原生解码库。声音、暂停和取消流程共用上述切换逻辑。安卓4.0／4.0.3（API14／15）保持系统 MediaPlayer 选择解码器。API17–19 的普通全屏视频使用 SurfaceView 并等待首帧渲染回调；API14–16、小窗口和带旋转元数据的旧安卓视频保留 TextureView；API24 以下的原生输出以视频封面提供模糊背景。首帧超时会退役播放器；原生操作超过 2.5 秒未返回时仅终止播放子进程，确认退出后恢复后续播放资格，不自动反复重试失败素材。桌面及用户数据保留，厂商系统解码服务异常仍需真机排查。实际编码、分辨率、帧率和色彩组合须由电视支持；1080p60 不代表 4K60 同样可用。允许 HDR、10-bit 等素材导入不代表电视已验证正确显示，HDR 颜色、模糊和桌面合成须对应机型验收。不支持 GIF、动态 WebP 或壁纸工程，不在电视上转码。建议横屏、首尾可衔接的素材；竖屏按实际宽高解码并居中裁切。
视频数量、视频库总容量和视频时长没有固定上限；单文件大小由电视实际剩余空间决定，保留 32 MiB 空间，未提供文件长度的本地输入也按可用空间预算流式复制。视频传输没有固定十分钟总时限，持续传输会刷新会话活动时间；退出电视上传页、连接中断或空闲会话过期仍会结束。导入失败明确提示空文件、无视频轨道、加密、读取不完整、空间不足或容器解析问题；通过导入检查不等于电视已成功解码播放。
手机选择及上传成功后均可使用本机视频预览；浏览器不支持该编码时提示返回电视确认，不阻止支持格式的上传。本机预览使用手机原文件，不代表电视已成功播放。电视将首帧超时、文件读取、格式不支持、解码和画面输出错误分别提示，失败保留原壁纸和用户视频，诊断日志记录系统或 Media3 错误码。4K 标记仅表示素材规格，完整输出、持续流畅度、屏保与待机须对应电视验收；缩小显示不减少原视频解码负载，弱设备请上传真实的低规格版本。旧系统的 4K 视频可能使用占位封面。
上传服务仅在电视上传弹窗打开期间运行，关闭、进入后台、网络地址变化或空闲 10 分钟后结束；旧二维码和连接码随会话失效，重新连接后刷新。连接码连续输错 5 次会暂停验证 30 秒。连接失败时请检查访客网络／设备隔离，并尝试在系统浏览器中打开短地址。上传失败或空间不足不会替换已有壁纸。
1.2.4 不再附带大苏尔静态壁纸、金门大桥视频及封面，也不再提供“恢复内置壁纸”。首次使用动态分类时可上传自己的视频。升级时，已移除的内置壁纸选择会回到此前有效图片或默认颜色主题；用户上传的图片、视频和每日壁纸缓存保留。
覆盖更新保留用户壁纸；卸载或清除 Quiet TV 数据会移除用户图片。旧版本的壁纸选择和轮播模式在首次启动时迁移。1.2.4 两档提供上述管理与上传；本次索尼截图仅展示页面，完整上传、删除恢复及升级保留验收仍待完成。图片来源与使用边界见[第三方资源说明](../THIRD_PARTY_NOTICES.md)。
上传窗口包含本机地址、连接码和二维码，公开文档不展示其原始截图。按电视当次窗口操作，关闭后原会话失效。
## 桌面内屏保（开发源码）
壁纸页底部加宽的单行胶囊工具栏提供“设为屏保”、自动进入（关闭、1、5、10、15分钟）、时间和天气开关。等待时间和开关立即保存，无保存/取消弹窗。时间、天气只显示文字和开关，不使用独立的常驻背景框；遥控聚焦时显示焦点框。首次升级默认关闭自动进入，屏保素材取当时的桌面壁纸，时间和天气开启；以后两个用途独立保存。本地、U盘和上传素材进入同一素材库，屏保只引用素材ID，不复制文件。删除屏保素材后使用默认颜色背景；保存失败保留之前的配置并提示。
仅在桌面前台、窗口可交互且没有设置或弹窗时计时；遥控器、触摸和鼠标操作重新计时，离开桌面、弹窗遮挡、移动应用排序或熄屏时停止，回来后重新开始。桌面400ms内双击确认键可进入屏保，关闭自动进入后仍有效；单击因此最多延后约400ms。焦点移动、返回、离开桌面会取消待执行的确认，长按、重复和取消事件不作为双击。
普通按键或点击首次只退出屏保，消费整次按下/抬起，恢复原焦点，避免误启动应用。电源、HOME和音量键保留系统职责。屏保暂停壁纸轮播、复用原播放通道，视频静音并在首帧前保留封面；退出恢复原壁纸和声音设置，背景准备好后恢复桌面。天气复用现有城市、来源与缓存，显示开关独立于桌面，无可用数据时隐藏。
标准版与Android 4.x使用相同状态、配置和输入逻辑，视频使用Media3或平台MediaPlayer，API16–19另有系统软解回退。当前功能的索尼遥控器手感、重复上报、长时间播放及待机唤醒仍需目标电视验收；本节不代表公开APK已经包含本功能。
## 桌面设置
当前源码共用七个标签：桌面显示、天气设置、应用管理、儿童模式、文件传输、版本更新、诊断日志。“首页应用”和“应用排序”标签已移除，使用桌面长按菜单添加、替换、移出首页和移动应用；旧页面入口及保存状态转到“应用管理”，原有应用配置和排序保留。“桌面显示”中的首屏应用和 Dock 背景开关继续保留。
在“全部应用”中打开“桌面设置”。当前源码使用上方所列的统一设置标签，技术配置由电脑 AI 完成。历史 1.2.4 标准包还有“桌面配置”标签；旧截图保持原样。方向键左右切换标签，下键进入内容，返回保留设置。
当前未发布源码为桌面与设置往返、设置标签和弹窗统一了轻量动效：设置进入 180 毫秒、退出 140 毫秒，标签内容轻移 160 毫秒，弹窗进入 160 毫秒、退出 100 毫秒。标签切换保持背景和标题稳定，连续按键可立即切到最新目标，返回及弹窗操作不等待动画结束。从桌面进入设置时复用已有的小尺寸背景；直接进入设置时后台读取壁纸，先显示控件。普通返回桌面不重播从黑色开始的壁纸渐显，预览在首页与第二屏之间切换时复用已加载画面。这些动效不改变主壁纸和原生视频输出分辨率；厂商电视的实际窗口过渡与流畅度仍需验收。
当前源码通过“应用管理 → 更多 → 帮助与恢复”暂停接管或恢复原桌面；配置、修复和适配在电脑完成。暂停不改变系统默认 HOME，恢复原桌面不关闭已选择的 ADB 保持。仅更新沿用原配置和暂停选择，不重新执行首次配置，详见[配置与恢复](SETUP.md)。
“桌面显示”左侧选择经典布局或艺术画廊，并分别显示／隐藏问候语、时间、日期、天气，以及信号源、网络、设置按钮；右侧默认显示当前壁纸、常用应用与有效天气缓存的首页预览。焦点进入“第二屏应用”的应用名称、模糊度、亮度或淡入时间控件时，自动切换为第二屏预览，按本机实际应用、排序和首页显示状态绘制应用网格；焦点回到其他桌面控件时恢复首页预览。调整立即保存并更新对应预览。预览不可聚焦或打开应用，不额外请求天气。天气设置使用完整内容区，不显示首页预览。返回首页后使用相同布局；切换布局保留各项显示偏好和问候语文字。
当前开发源码在同一进程内保留一份有效预览素材，再次打开桌面设置或返回桌面显示时直接复用。壁纸、封面、应用状态、排序或隐藏规则变化时更新对应内容，时间、天气缓存、网络及显示参数继续实时刷新。页面关闭后释放监听和页面引用；内存紧张、配置变化或进程重启后，首次进入重新加载。此行为仍需厂商真机验收。
升级时，旧版“时间与日期”的状态分别作为时间和日期的初始值，之后可独立调整。尚未单独设置的快捷按钮继承原总开关状态；隐藏后其余按钮保持原顺序靠右排列，遥控器跳过隐藏按钮。即使三个按钮全部隐藏，仍可从“全部应用 → 桌面设置”重新开启。1.2.4 提供上述布局、实时预览与独立显示设置；正常覆盖更新保留本地选择，厂商真机的遥控、重启与升级数据保留仍需验收。
“桌面显示 → 应用标题”控制 Dock 上方当前选中应用的大标题，默认开启。关闭后 Dock 位置保持不变，右侧预览同步变化；返回首页即生效，选择保存在本地，重启后保留。
“桌面显示 → 第二屏应用 → 应用名称”控制第二屏卡片下方的名称，默认显示，与首页“应用标题”独立。关闭后卡片间距和顺序保持不变；返回桌面生效，重启后保留。经典布局与艺术画廊共用此设置，安卓4.4兼容档同样提供。
当前未发布源码在“首页应用”和“第二屏应用”分组分别提供“模糊度”滑块，范围 0–100%，默认均为 0（清晰原图）。遥控器左右键每次调整 5%，也可触摸拖动；两个数值独立保存在本机。首页和第二屏模糊度分别同步更新对应预览，返回桌面后分别用于首页和第二屏壁纸，滚动时逐步过渡，图标和文字保持清晰。图片和动态壁纸共用此设置，经典布局与艺术画廊一致；壁纸选择器和屏保仍显示原来的画面。静态背景在 Android 12 及以上使用系统 GPU 模糊，旧系统使用后台处理的小尺寸画面。支持原生视频取样的设备将复制与模糊处理放到后台，保留原生视频输出尺寸；首页和第二屏分别缓存对应强度的模糊图，切屏时混合缓存，按键和转场期间暂停新增取样，停稳后恢复更新。模糊可见时最高约每秒更新 10 次，清晰页面的备用缓存约每秒更新 1 次；不支持视频取样的旧系统沿用封面。厂商电视的实际流畅度仍需验收。
“首页应用”和“第二屏应用”还分别提供“亮度”和“淡入时间”滑块，与各自的模糊度独立保存。亮度为 20–100%，默认 100%，左右键每次调整 5%，只调节壁纸及 Dock 的背景取样；淡入时间为 0–1.2 秒，默认 0.6 秒，每次调整 0.1 秒，0 秒在目标画面准备好后直接显示。首次展示桌面时使用当前页面的时长渐显壁纸，普通离开后返回保持连续显示；图片轮播和视频封面到首帧的过渡也使用该时长。滚动切屏时亮度逐步过渡，并选取当前页面的淡入时长。当前页面预览即时更新亮度，调整对应淡入时间并停止操作 200 毫秒后重播背景渐显；所有滑块均支持触摸拖动，图标、文字和应用卡片保持清晰及原有亮度。壁纸选择器、屏保沿用各自的显示方式。此功能尚未随 APK 发布，物理遥控、视频持续播放和待机唤醒仍需真机验收。
当前未发布源码在“桌面显示 → 首页应用”分组提供“首屏应用”和“Dock 背景”两个独立开关，默认开启。关闭 Dock 背景只隐藏托盘底板，保留应用卡片；关闭首屏应用会隐藏卡片、应用标题和空托盘，保留壁纸与首页信息。第二屏始终显示全部可显示应用，包含首页常用应用，顺序独立保存。添加、替换或移出首页，以及开关首屏应用显示，均不会移除第二屏中的应用或改变其已保存顺序。此操作不修改 Dock 固定配置；儿童模式隐藏的应用不会因此显示。首页保留完整首屏，按下可进入第二屏，按上或返回可回首屏；顶部快捷按钮全部隐藏时仍能从第二屏进入桌面设置。经典布局与艺术画廊使用相同规则，布局按钮等宽等高，右侧预览即时同步，返回首页及重新启动后保留选择。
## 首页问候语
在“全部应用 → 桌面设置 → 桌面显示 → 首页问候语”编辑。“显示问候语”开关可独立隐藏文字，天气和时间仍按各自设置显示。关闭时保留原文字，重新开启即可恢复。
使用遥控器选中输入框，通过系统输入法输入；电视已安装拼音输入法时可输入中文。也可选择“手机输入”，手机与电视连接同一局域网，扫码后编辑并发送；无法扫码时，在手机浏览器打开电视显示的地址并输入连接码。发送只回填电视编辑框，仍需在电视上选择“保存”；“取消”或返回均丢弃本次开关与文字改动。
留空并保存后按时间显示早上好、下午好或晚上好，长文字在首页单行省略，编辑时保留完整内容。未编辑过的旧固定欢迎配置继续显示“欢迎回家”。扫码连接在返回编辑、应用进入后台、网络地址变化或空闲 10 分钟后失效，每次只接收一次发送。文字仅保存在电视本地，无需账号或云服务。
“头像”一行可用手机上传、更换、移除，并独立控制显示。手机选择 JPG、PNG 或静态 WebP 原图（最大 10 MB），拖动或双指缩放调整圆形取景后发送；裁剪结果为 512 × 512，实际上传最大 2 MB。首次上传默认在草稿中开启头像显示，隐藏会保留图片。头像显示在问候文字左侧，也可以单独显示；未设置或图片不可用时不留空圆圈。
上传只更新当前草稿，电视点击“保存”才同时应用文字、头像及开关；“取消”或返回保留原设置。上传会话沿用临时二维码和连接码，离开上传页面、应用进入后台、网络变化或超时后结束。头像只保存在电视应用私有目录，不保存原始照片和照片定位信息；覆盖升级保留已保存设置，旧版本升级不自动设置头像。
## 首页天气
经典布局在问候语旁显示天气图标、温度、天气描述与城市；艺术画廊布局将首页信息居中排列。在“全部应用 → 桌面设置 → 桌面显示”开关天气；顶部“天气设置”标签提供自动定位、选择城市、刷新天气与服务说明。关闭自动定位时固定已识别的城市；尚无可固定城市时先选城，取消则保留自动定位。手动选城会关闭自动定位。天气隐藏时仍可调整城市偏好，但不会定位或刷新天气。设置不依赖 ADB，右侧系统设置入口保持原样。
当前开发源码支持和风天气、UAPI、OpenWeather 和 Open-Meteo。在“天气设置 → 天气来源”选择自动切换或指定一个来源；指定来源失败时保留有效缓存，不悄悄换源。自动模式按和风、UAPI、OpenWeather 的顺序尝试，跳过未配置和不支持当前地点的来源。Open-Meteo 免费接口仅限非商业使用，默认关闭；可在来源列表单独选择，或启用“Open-Meteo 备用”后作为自动模式最后一项。启用时显示使用限制，服务说明提供来源、许可和官网链接。各服务分别处理限流，不并发请求全部来源。和风、OpenWeather 使用可选私有构建配置，普通用户不需要填写密钥；新克隆无配置时仍可使用 UAPI。详见[私有天气配置](../CONTRIBUTING.md#可选天气源配置--optional-weather-configuration)。
天气地点保存独立名称与可用坐标，不把现行行政区代码作为唯一标识。长岛支持“长岛”“长岛县”“长岛综合试验区”等别名，使用原县城附近的参考坐标查询，不将蓬莱天气改名显示；这一个参考点不代表长岛各岛逐一验收。UAPI 只支持行政区天气，不能表示此类独立地点时跳过或提示换源。Open-Meteo 的当前天气是模型估算，服务商返回时间按数据时间展示，不能作为当地气象站观测证明。境外服务的国内连接、旧固件 HTTPS 和海岛准确性仍需实际网络及电视验收。
已有手动城市和缓存继续兼容；具备网络时补充独立地区服务提供的坐标，后续按坐标查询；解析失败仍保留原选择，并可使用和风按名称的兼容路径。系统坐标可直接获取和风、OpenWeather 或 Open-Meteo 天气，无需先找到对应区县；无法解析地名时显示“当前位置”。系统位置不可用时，按出口 IP 估算仍依赖 UAPI。所有请求保留 HTTPS 证书与主机名验证；不以 0°C 或其他地区代替。服务会接收出口 IP 和请求地点。
自动定位优先使用系统网络位置；定位服务缺失、提供者不可用、权限不足或调用异常时，直接回退到出口 IP 估算，正常请求最多等待 5 秒。定位取消失败也不会阻断桌面启动或返回，迟到的定位回调不会重复刷新。手动城市和关闭天气时不获取系统定位服务；IP 城市不准确时可手动选择。
“选择城市”保留省、市、区县逐级下拉和中文关键词模糊搜索，例如“武汉”“武昌”“湖北 武昌”；输入时只搜索本地快照与补充地点，主动点击“搜索”才向 UAPI 联网查询。联网结果包含可用坐标，乡镇、街道作为独立天气地点，不冒用上级区县数据。两端共用包内地区及别名，候选展示上级地区以区分同名地点；手机发送的是电视已提供的候选，不接收任意坐标或密钥。区划库包含大陆 31 个省级单位，行政调整可能存在滞后，港澳台完整地区选择未收录。离线选择仍可保存，联网搜索不可用时可继续使用本地结果。
“手机扫码输入”沿用问候语输入的弹窗和手机页面风格，手机与电视连接同一局域网后扫码，或打开电视显示的地址并输入六位连接码。手机也能下拉到区县或模糊搜索；发送后只更新电视草稿，必须在电视点“保存”才应用，取消不会更换原地区。会话十分钟无操作过期，离开设置或重新连接会关闭旧会话；手机不会获得天气密钥。
首页可见时约每 30 分钟刷新，返回首页优先使用缓存，离开首页停止定位及定时请求。首页显示天气图标、温度、天气描述与地区；天气来源以独立小字集中显示在“天气设置 → 服务说明”中，并提供对应官网入口。正在刷新或更新失败时保留有效缓存，不追加“未更新”等状态文字。尚无有效数据、缓存超过 6 小时或关闭天气时，首页隐藏天气区域。超过 1 小时的数据状态、刷新失败原因及更新时间可在天气设置中查看；无法识别接口数据时间时，以缓存获取时间控制保留期，设置页明确显示数据时间未提供。不以默认城市或 0°C 代替真实结果。免费服务有动态限流，不承诺永久可用；429 按服务等待时间与至少 30 分钟暂停刷新，不自动密集重试。
安卓 4.4 仅为该 HTTPS 连接启用 TLS 1.2，保留系统证书和主机名校验，不回退到明文 HTTP；旧固件证书库及各品牌真实定位能力仍需真机验证。天气图标是包内原生静态绘制，无视频、WebView 或持续动画。
## 信号源、网络与设置
信号源菜单来自电视真实 TV Input 列表。当前索尼机型列出 HDMI 1–4、AV 和电视直播；其他设备以实际输入为准。频道为空时提供设置入口，不自动搜台。网络按钮打开网络设置，另一个设置按钮打开系统设置。
标准档会在标准输入服务缺失、受限或返回空列表时，检查已知的原厂信号源面板。只有实际存在、已启用且允许 Quiet TV 调用的系统组件才会作为入口；只有一个可用面板时直接打开，多个面板时显示选项。有正常输入列表时保留该列表，并提供可用的系统信号源入口。BYINTEK U4 上游报告的虚假标准列表采用原厂面板优先策略。标准切换调用报错时，可选择系统信号源面板；画面黑屏但调用未报错时，可返回菜单手动选择系统入口。
没有可用入口时显示具体原因并提供系统设置，不能据此判断电视没有 HDMI／AV。面板被禁用或权限受限时不会自动启用组件或修改权限。海信、TCL、BYINTEK 的候选入口与验收边界见[信号源兼容](COMPATIBILITY.md#信号源兼容)。标准档包含此回退；安卓4.4档使用系统设置／遥控器。存在入口不代表目标电视已经可以切换。
有线网络已验证。Wi-Fi 名称依赖位置权限与定位开关，当前未完成实机切换验收。应用能打开不代表账号、播放、声音或第三方服务已经验收。
## 更新与恢复
当前源码从“应用管理 → 版本更新 → 检查更新”主动查询（旧版入口为“关于”）；首页前台每24小时也会自动检查。1.2.4 签名清单已上线，有匹配的新软件版本时显示角标。用户选择下载后依次尝试可用下载源，核对完整 SHA-256、包名、版本、系统、架构及签名，再由用户通过系统安装器确认。
同软件版本不会因构建号不同重复提示升级；旧版没有更新入口时按[安装指南](INSTALL.zh-CN.md)手动安装。电视限制来源安装或没有匹配包时显示原因，不卸载、清数据或强制降级。详见[应用内更新](UPDATES.md)。
第三方应用通过各自渠道更新。原桌面恢复见[桌面配置与恢复](SETUP.md)，使用目标设备自己的原始记录，不运行其他电视的系统包清单。
### 应用入口与图片兼容
当前版本提供部分厂商应用和设置入口，首页、常用应用选择及排序使用同一应用目录。已禁用、未导出或需要未授予权限的入口不显示；不是将全部系统包都变成可启动应用。
当前开发源码将新上传和本地导入的图片限制为最高 4K（长边 3840、短边 2160 像素），范围内原样保存且不放大；显示图仍按实际绘制尺寸和内存条件生成，最高 3840 像素长边，低内存设备上限 1920。已有图片不重写，重新导入时采用新规则。高清源图、4K 面板和应用实际以 4K 渲染是不同条件。
部分 TCL 系统可显示快捷信号源面板；两个已知小米/红米型号有限定端口修正。未匹配设备继续用标准列表或系统面板。实际画面与适用范围见[兼容说明](COMPATIBILITY.md#本轮源码兼容改进)，标准档包含这些路由；安卓4.4仍使用系统设置／遥控器。
## 遥控器按钮状态
Quiet TV 自有页面和弹窗的按钮共用焦点反馈：白色外框与内容之间保留深色间隔，焦点停留时持续显示，按下确认键时压暗，松开恢复。标签、布局、时长和连接方式等选择类按钮以白底表示已生效；保存、取消、返回、更多和弹窗确认等操作按钮不保留选中白底。复选框和开关保留勾选、开启标记；不可用按钮不显示焦点外框。电视系统设置、权限弹窗及第三方应用仍使用各自界面。
### 当前源码补充：壁纸与家长验证
壁纸设置中的“本地 / U盘”可选择图片或视频，导入后预览并应用；文件会复制到应用存储，原件不变。优先在应用内浏览已授权的本地存储与 U 盘，不要求电视预装文件选择器；需要时可使用“系统选择文件”取得单个文件授权。取消系统选择后返回本地列表，不退出导入。动态壁纸的“声音”默认关闭，设置会保存；离开桌面或息屏后停止播放。
家长密码输入满 6 位后自动校验，设置新密码仍需确认。恢复码由家长事先保存，忘记密码页不显示或提供免验证的查看入口。版本更新页查看恢复码需验证家长密码。儿童计时的时长可先保存，服务未就绪时会标明未生效；进入无障碍中的管理页不等于启用服务，到时限制效果需在本机验证。
## 信号源自动检测（开发源码）
点击首页“信号源”后，程序自动读取本机输入列表，并检测可调用的原厂信号源入口，无需选择机型。有标准输入时显示实际项目，并列出可用的原厂面板；标准列表为空且只有一个可用面板时可直接打开，多个面板由用户选择，不会总是调用第一个。已有明确面板优先规则的设备沿用原规则。只支持原厂面板时仍由面板选择端口，不会生成未经确认的 HDMI 快捷项。
失败提示会区分服务缺失、列表为空、项目被隐藏或过滤、读取受限/异常、原厂入口未适配/停用/受限。可点击“重新检测”，或使用系统设置和电视遥控器信号源键。安卓4.x仅检测原厂入口。具体兼容路径及未完成的真机验收见[兼容说明](COMPATIBILITY.md#信号源自动发现与原厂入口开发源码)。
信号源读取、已保存 HDMI 校验和频道查询在后台执行；返回、HOME、离开页面、窗口失去焦点或熄屏会取消尚未完成的首页任务。“看电视”设置页离开后也不再执行迟到的切源或确认。厂商接口已经收到的请求未必能撤回，Quiet TV 不会据此声称画面或声音成功，也不会自动重试。