# 兼容性与验证边界

## 已验证配置

| 项目 | 配置 |
| --- | --- |
| 设备型号 | MiTV-MTSU0 |
| 机型名称 | 小米电视 S55 Mini LED 2026 至尊版 |
| Android | 14 / API 34 |
| 固件 | OS3.0.119.0.UTSMATV |
| 桌面渲染尺寸 | 1920 × 1080，density 320 |
| 最低 API | 26（Android 8），仅编译要求，不代表完成其他机型实测 |

小米 HDMI 调用使用 `com.xiaomi.mitv.tvplayer.ExternalSourceActivity`，action 为
`com.xiaomi.mitv.tvplayer.EXTSRC_PLAY`，`input=23` / `24` 分别对应已测试固件的 HDMI 1 / 2。
调用前检查机型、组件是否导出及所需权限；失败时提示，不修改系统设置。

小米原桌面必须走公开别名 `com.mitv.tvhome.MainActivity`，直接调用其实际 Activity 可能被签名权限阻止。

## 私人试用版本的实机记录（2026-10-20）

- PS5 / Apple TV 从主列表直接进入对应 HDMI，Apple TV 显示 4K 60 Hz / Dolby Vision，PS5 显示登录画面。
- 哔哩哔哩、投屏入口、相册、小米原桌面、设置与信号源面板可以打开。
- 固定壁纸设置在强制结束后保留；1 分钟自动轮播实际换图，之后恢复默认 5 分钟。
- 右下角操作区、全部应用和壁纸面板的遥控器焦点已验证。
- Home 回到小米原桌面，系统应用没有被禁用。

这些记录针对公开源码的前身。公开版更换了包名、默认背景和签名，公开版验证另见发布变更记录。

## 仍有边界

- 未验证其他电视型号或固件。未匹配机型时保留桌面与应用列表，专用 HDMI / 小米桌面入口会提示不可用，系统设置尝试标准 Android Intent。
- v0.2.0 提供需手动配置的实验性开机自动进入；不改变 Home 键。详见 [设置与验证范围](BOOT-START.md)。
- 私人同源实现已验证完整重启；公开签名 v0.2.0 APK 未重新执行完整重启测试，其他固件及实际待机唤醒未验证。
- 未完成真实小爱语音、手机投屏播放、直播播放、HDMI 音频、游戏延迟和长期待机测试。
- v0.3.0 默认入口为 6 项，可在设置中编辑为 1–9 项。名称与端口映射仍需修改源码。
- 壁纸仅支持预先打包，最多 15 张；不支持联网图库或电视端新增照片。

## 开机自动进入的新增验证（2026-10-21）

在同一配置的私人同源实现上，系统 start_3rd_app 调用一次性入口后成功进入桌面，现场观察与日志一致。Home 仍返回原桌面，重复调用不抢占原桌面或 Apple TV HDMI；关闭、开启开关均通过。没有授予悬浮窗权限，没有禁用系统应用。

公开 v0.2.0 默认关闭，应用不自行写入系统目标。启动入口仅在 MiTV-MTSU0、开关开启、开机十分钟内且本次启动尚未尝试过时转入桌面；系统更新可能改变内部启动接口。普通应用列表入口不受这些条件限制。

## v0.3.0 统一设置与 Dock（2026-10-21）

私人同源 UI 已在上述机型检查分组设置、首页预览、壁纸浏览不保存、逐层返回、Dock / 图标显示、字体与焦点样式、首页排序和撤销、纯色背景暂停轮播。更新保留原壁纸和启动偏好；没有新增系统权限。公开版构建与测试通过，公开签名包的启动验证没有重复进行。六项居中、九项向两侧滚动、首尾停留及恢复原顺序均已在私人同源版本实机验证。本次公开版仍只有实验性完整开机入口，没有合入私人待机唤醒策略。完整边界见[本次变更](changes/2026-10-21-grouped-settings.md)与[设置指南](SETTINGS.md)。