# 使用教程

## 使用前

请先阅读首页的设备兼容范围。安装门槛是 Android 13，但当前用于减少系统切屏淡入的显示器挂载路径需要 Android 14+，只有 README 中列出的测试固件经过验证。系统允许安装不代表已经适配。

从 GitHub Release 下载 APK。首次安装按手机提示允许当前文件管理器或浏览器安装应用；无需 root。请不要同时启用其他开合动画应用的无障碍服务。

**v0.4.30 与 v0.4.27 / v0.4.28 / v0.4.29 同签名，可以覆盖升级，保留设置与配对。** GitHub v0.4.11 / v0.4.16 / v0.4.17 等异签名旧版需要先记录参数，再卸载安装；卸载会清除设置与配对。详见 [v0.4.28 更新说明](RELEASE-v0.4.28.md)。

v0.4.30 在首页右上角提供「检查更新」。进入应用自动检查，有新版本显示红点；短时间重复进入合并检查，不后台定时轮询。点击下载后，按钮下方显示百分比、进度条和已下载大小，下载期间按钮置灰。

下载可在离开设置页或切换其他应用后继续，通知栏显示进度并提供暂停。暂停、断网或进程退出后保留 APK 片段，再次点击「继续下载 APK」续传；镜像不支持续传时从头下载。完成后验证大小、哈希和签名，再自动打开安装确认；系统拦截后台界面时，可点击完成通知或返回应用继续安装。

更新流程现在仅暂停投影和助手，不主动关闭无障碍；取消安装后恢复原服务。**由 0.4.29 或更早版本升级到本版，仍会运行旧版的关闭逻辑，安装后需要再开启一次；此改进从使用新版执行下一次更新开始生效。** 系统自行重置权限或禁止重新绑定时，仍需在系统设置检查无障碍状态。手动安装前先暂停动画；早期版本遗留投影层时，可重启后重新连接助手。

## 配对并启动助手

1. 小米没有开发者选项时，进入 **设置 → 我的设备 → 连续点击 OS 版本**，直到提示进入开发者模式。应用也提供说明和系统设置入口。
2. 开启无线调试；小米还需要单独开启 **USB 调试（安全设置）**。
3. 在玻璃投影中点 **配对**，默认打开配对小窗应用。在无线调试中选择「使用配对码配对设备」，保持系统配对窗口打开，在小窗中输入 6 位码。地址和端口自动发现，不用抄写。也可从页面底部 **更多配对方式 → 通知配对** 允许通知后，在通知栏输入配对码。v0.4.27 保留默认的小窗应用，仅删除悬浮窗配对及悬浮窗权限。
4. 等待提示助手已连接，再进行下一步无障碍设置。已有有效配对时提示无需重复配对；授权失效时重新进入配对流程。无线调试关闭或网络不可用不会直接清除配对记录。

不需要安装 Shizuku、root 或电脑持续连接。旧版在 Shizuku 中建立的配对不会自动成为玻璃投影的配对，需要在本应用完成一次。系统不支持直达时可从开发者选项进入无线调试；详见[本机无线启动](WIRELESS-SETUP.zh-CN.md)。

## 开启无障碍

助手连接成功后，在玻璃投影中点击「开启无障碍」，找到「玻璃投影」并打开。v0.4.26 起，小米系手机的「开启无障碍 / 管理无障碍服务」优先直达「辅助功能 → 已下载的应用」列表。其他系统或入口不可用时使用系统无障碍总页。

如果系统阻止开启并提示受限设置，先进入玻璃投影的应用信息页，按系统提示允许受限设置，再返回无障碍页面。此确认应由设备使用者完成。

返回玻璃投影，状态应变成「动画已就绪」。回到系统桌面开合手机；如需在应用内也生效，打开「作用范围 → 全局启用」。锁屏动画在屏幕点亮、系统锁屏可见时工作，不会绕过锁屏认证。

## 小米后台设置

应用内「后台运行设置」进入本应用的系统信息页。确认：

- **自启动**：允许。
- **省电策略**：无限制。
- **后台锁定 / 清理保护**：开启。不同版本入口不同，可在手机管家的设置中寻找内存加速的锁定应用名单。不要把它与要求密码的“应用锁”混淆。

菜单以当前手机显示为准。默认无线启动路径不依赖 Shizuku 后台服务。

完成后执行一次自己平常使用的一键清理，再回桌面开合，确认动画仍在。隐藏最近任务卡片本身并不能防止系统终止进程。

## 调整效果

- **模糊强度**：100% 是当前默认效果；0% 只去掉模糊；200% 更强。
- **动画起始角度**：1～30°，默认 1°。超过设定角度后逐渐增加视差和模糊，合拢时反向收尾；v0.4.11 修复透明动画层与原位图标叠加产生的起步重影。设置自动保存，「恢复默认」会还原为 1°，不改变切屏角度。完全合拢保护优先：支持物理开合检测的手机必须先上报已展开，因此设为 1° 不保证在物理 1° 时已经可见；其他设备的传感器行为仍需适配。

0.3.19 修正已验证的 lhasa 机型小角度不起动画：系统的 `CLOSED` 状态在已经打开一条缝时仍可能保持，直到约 31° 才切换，不能等同于完全合拢。该机型改用实测的接触分离状态，让起始角度设置在小角度展开时生效，同时保留合拢倾斜保护。实际响应仍受传感器精度和上报时机限制。
- **展开时切到内屏**：默认 60°。
- **合拢时切到外屏**：默认 120°。
- **全局启用**：默认关闭。打开后，动画也用于应用内。
- **悬停等待时间**：1～10 秒，默认 3 秒。整段时间内角度摆幅不超过 10° 时，约 220 毫秒平滑恢复正常画面。
- **滑动恢复正常画面**：默认关闭。开启后手指滑动即可提前恢复，静态空白处也有效；轻点和小幅抖动不触发。
- **恢复默认**：模糊和切屏角度恢复默认值，等待时间恢复 3 秒、关闭滑动恢复；保留全局作用范围选择。
- **暂停动画**：关闭本应用无障碍并停止助手，释放系统切屏覆盖。重新使用时需要再次开启无障碍。

完全合拢约为 0°、平整约为 180°。角度控制带有方向判断；打开一半再合回去时，不会简单地按同一阈值反复切屏。自定义切屏在所选作用范围内接管；关闭全局时，只用于支持的桌面/锁屏场景。悬停或滑动恢复只退出视觉效果，不释放切屏控制，避免半折使用时突然切屏。继续开合超过 10° 后重新出现动画。

## 常见问题

### 完全合拢后倾斜手机仍然模糊

请升级到当前版本：测试机型使用接触分离状态区分完全合拢与小角度展开，避免倾斜误模糊，同时修复早先闭合判断过宽导致动画出现太晚的问题。按安装说明重启手机、重新连接助手。

### 安装后锁屏与桌面重叠

这是旧进程可能遗留的投影图层。**安装后重启手机一次**，再连接助手并检查本应用无障碍状态。仅重装 APK 或重新打开应用可能无法清除旧残影。新版增加了进程退出回收，但无法替已经退出的旧版进程清理失效的图层句柄。

### 开了无障碍却没有动画

确认应用中的助手已连接。尚未连接时开启无线调试，返回应用点「配对」检查已有授权；系统授权被移除时重新配对。被系统强行停止后，应重新打开应用并检查无障碍。若仍不恢复，手动关闭再开启本应用的无障碍服务。

### 滑动恢复没有触发

先确认该开关已开启、助手已连接。需在半折动画仍可见时测试；如果已经恢复正常，先继续开合超过 10° 让动画重新出现，再在静态区域滑动。轻点不触发。系统必须支持只观察触摸的接口并授予 shell 相应权限；其他设备不保证支持，悬停计时仍可使用。

### 一键清理后无障碍掉了

小米某些清理策略会把清理处理为强行停止。确认自启动、无限制省电、后台锁定三项，不要只设置省电。主动在应用信息页点“结束运行”仍可能关闭服务，应用不会自动推翻这个操作。

### 退出应用或重启后还可用吗

正常离开应用界面不会主动停止动画。手机重启后需要重新开启无线调试并打开应用，让保存的身份自动连接，再检查无障碍状态；一般不需要重新配对。系统关闭无线调试时不承诺无操作恢复。默认启动路径不依赖 Shizuku。

### 外屏偶尔闪过另一页

这是当前已知的系统桌面切屏交接问题，尚未完全解决。此版本没有引入桌面分页截图缓存，也没有常亮双屏方案。可以先恢复默认参数；如影响使用，暂停动画即可。

### 要升级或卸载

同包名、同签名的 APK 可以覆盖安装并保留设置。如果提示签名不一致，不要直接清除数据：先记录模糊和角度设置，再决定是否卸载重装。自己编译的 debug 密钥通常与发布包不同。

新版应用内更新：**下载并校验 APK → 暂停投影和助手但保留无障碍 → 系统确认安装 → 新版由系统重新绑定服务**。手动安装或从旧版升级时，先暂停动画，安装后检查无障碍；只有遗留投影层等异常时需要重启清理。

卸载前建议在应用里暂停动画；也可在系统无障碍中关闭服务，再卸载 APK。用户不需要手工清理系统文件或修改全局动画倍率。