Yamby 画中画 PiP 模式无法开启排查

PiP 的前提条件

画中画（PiP）功能对系统版本和应用设置有硬性要求。以下条件全部满足才能正常使用：

1. Android 8.0 及以上（Oreo）
2. 系统级 PiP 权限已授予 Yamby
3. 设备硬件支持 PiP（极少数老设备不支持）
4. Yamby 版本较新（早期版本可能有 bug）

缺任何一条都会导致 PiP 功能不可用。

情况一：PiP 按钮灰掉、点不了

排查步骤：

1. 确认 Android 版本

设置 → 关于手机 → Android 版本。低于 8.0 → 硬件不支持，无解。

2. 授予系统级 PiP 权限

Android 设置 → 应用 → Yamby → 画中画 → 勾选「允许」。

很多人不知道 Android 的 PiP 权限和存储/网络权限不一样，需要手动去「画中画」这个单独的权限入口开启。不是弹窗请求的那种动态权限。

3. 重启 Yamby

授予 PiP 权限后需要完全关闭 Yamby 再重新打开，新权限才能生效。

情况二：按 Home 键没有自动进入 PiP

Android 12+ 支持「自动 PiP」——从播放器界面按 Home 键自动进入 PiP。如果没生效：

1. 检查自动 PiP 开关

Yamby 设置 → 播放器 → 画中画 → 自动 PiP（Android 12+）。确认开启。

2. 检查 Android 版本

Android 11 及以下不支持自动 PiP，只能手动点击 PiP 按钮进入。

3. 某些设备的定制 ROM 限制

小米 MIUI、华为 EMUI、OPPO ColorOS 等定制系统可能对 PiP 做了额外限制。如果确认系统版本够、权限已开、但就是不自动 PiP，可以试试：

• 手动点击 Yamby 播放器里的 PiP 图标
• 如果手动也不行 → 可能是 ROM 层面屏蔽了，无解

情况三：PiP 小窗无声

排查：

1. 检查系统媒体音量（不是铃声音量）是否被调低或静音
2. 检查 Yamby 播放器内的音量滑块是否在静音位置
3. 某些设备的 PiP 模式会临时降低音量（系统省电策略），手动调高即可

情况四：PiP 小窗关闭后无法再次开启

偶尔遇到 PiP 悬浮小窗关闭后，需要等几秒才能再次开启的情况。这是 Android 系统层的状态重置延迟，不是 Yamby 的 bug。

如果频繁出现，尝试：

1. 完全关闭 Yamby 应用后重新打开
2. 重启手机（最后手段）

PiP 与分屏的关系

Android 的 PiP 和分屏是两个不同的多窗口特性：

• 分屏（Split Screen）：上下/左右各占一半屏幕，两个应用同时显示
• PiP（画中画）：一个小窗悬浮在其他应用之上，可拖动位置

Yamby 同时支持两种模式。如果 PiP 不能用但分屏可以用，说明 Android 版本够但 PiP 权限没开或设备不支持 PiP。