@@ -1,5 +1,95 @@
# Entryway Release Notes
## 手机版 v0.15.0 / TV 版 v0.14.0 - 2026-07-19
> 💿 **双端播放内核与 ISO 能力增强** — 手机版和 TV 版接入可解析 DVD / Blu-ray 的自构建 mpv 内核、JNI 主标题读取与本地 Range 代理；同时补齐 TV 弹幕、MPV 字幕、直链播放性能和跨端视觉统一。
### DVD / Blu-ray ISO 与双内核
- **实验性原盘 ISO 播放**：支持未加密 DVD / Blu-ray ISO。手机版可识别已下载到本机的原盘文件；手机和 TV 可对支持 HTTP Range 的远程 ISO 建立可随机读取的播放链路。
- **原盘增强 mpv 内核**：以兼容现有 `mpv-android-lib 0.1.12` API 的自构建 AAR 替换 Maven 版本，加入 `libdvdread` 、`libdvdnav` 、`libudfread` 与 `libbluray` ，覆盖四种 Android ABI，并保留 16 KiB 页面兼容。
- **JNI 主标题代理**：新增原生 JNI 模块，自动选择 Blu-ray 主标题或 DVD 最长标题，再通过仅监听 `127.0.0.1` 、带随机令牌的 HTTP Range 代理交给 mpv 播放。
- **失败回退**：上游不支持 Range、原盘解析失败或检测到加密时，在用户允许服务器转码的前提下自动回退到服务器媒体流。
- **内核路由统一**：新增共享播放内核能力模型和选择策略；原始 ISO 不再误交给 ExoPlayer，普通视频仍按用户首选内核起播。
- **自动容错切换**：ExoPlayer 遇到不支持的封装或解码器故障时，可保留进度并单次切换至 mpv；鉴权、网络和普通 I/O 错误不会触发无意义的内核循环。
- **安全退出与切片取消**：切集、切内核和退出播放器会中止尚未结束的 Range 探测、头尾预取及原生打开，并按安全顺序释放 mpv、代理和原盘源。
### 手机版播放体验
- **默认内核设置**：播放器设置新增 ExoPlayer / mpv 默认播放内核选择；播放器内临时切换不会覆盖默认偏好。
- **Dolby Vision 软件回退**： `DV-SW` 模式，通过 `gpu-next` 和软件解码为部分显示异常的 Dolby Vision / HDR 文件提供会话级诊断回退。
- **mpv 卡顿优化**：减少主线程 JNI 属性读取，改进状态缓存、轨道刷新与字幕切换调度，降低起播、拖动和切换字幕时的停顿。
- **播放进度上报修复**：严格保证 Start、Progress、Stopped 顺序，并在退出前捕获最终位置，避免快速暂停或销毁时向服务器回报错误进度。
- **首页过渡修复**：从当前精选背景图底缘提取环境色，使 Hero、渐隐区和下方内容共享同一背景，消除轮播与媒体分区之间的色带接缝。
### TV 弹幕与字幕
- **完整 DandanPlay 弹幕**：TV 播放器新增自动匹配、动漫搜索、剧集选择、本地弹幕、缓存与重新匹配，视频播放不再等待弹幕网络请求。
- **遥控器弹幕设置**：新增滚动 / 顶部 / 底部弹幕、字号、透明度、速度、显示区域、时间偏移、屏蔽词、重复合并、防重叠、热力图、简繁转换及 Canvas / SurfaceView 等设置。
- **双内核弹幕连续性**：暂停、倍速、跳转、切集以及 ExoPlayer / mpv 切换均跟随实际播放时钟，保留已匹配弹幕和设置。
- **MPV 字幕链路补齐**：同步手机版的 CJK 字体、编码回退和 ASS 兼容配置；外挂字幕等待真实轨道出现后再选择，手动切换立即生效。
- **原生字幕格式保留**：继续由 mpv/libass 渲染 ASS、PGS、VobSub 等格式，并改进服务器字幕索引到 mpv 轨道的精确映射。
- **播放结束判定修复**：替换文件、停止和错误事件不再被误判为自然播放完成，避免错误跳集或重复上报。
### 直链、网络与兼容性
- **双端直链提速**：手机和 TV 统一通过带鉴权的稳定播放入口解析最终 CDN 地址，减少重复探测，并避免把服务端凭据带到外部 CDN。
- **短效链接刷新**：切换内核或重载播放器时可刷新过期的签名直链，降低长时间停留后起播失败。
- **子路径服务器修复**：修复 Emby / Jellyfin 部署在 `/emby` 等子路径时，服务端返回的根相对播放地址丢失前缀的问题。
- **日志脱敏与 UA 统一**：播放探测日志不再输出完整鉴权 URL、Token 或服务端错误正文，手机和 TV 使用统一 Entryway User-Agent。
- **更新源容错**：应用更新检查优先使用 Gitea Release，失败时回退 GitHub。
### 视觉与产品入口
- **跨端设计统一**：手机和 TV 统一语义颜色、排版、卡片、焦点环、进度色和空间层级；TV 搜索、媒体库、详情、播放器菜单等页面同步调整。
- **TV 登录页精简**：扫码录入区域收敛为二维码与局域网扫码提示，减少无关说明。
- **双语产品官网**：新增响应式中英文官网、下载入口、无 JavaScript 兜底、SEO / 分享元数据、无障碍规则和 NAS 部署配置；本次同步更新双端版本与下载地址。
### 兼容性与验证说明
- 不包含 `libdvdcss` 、`libaacs` 或 `libbdplus` ，仅支持未加密原盘。
- 远程 ISO 的源站必须正确支持单段 HTTP Range；不支持时需开启服务器转码。
- 未提供 DVD / Blu-ray 类型元数据的通用 ISO 不会猜测盘型，将走服务器回退链路。
- 原盘模块已通过 Range/JNI/回退策略单元测试和双端 APK 构建；真实设备上的 DVD / Blu-ray ISO 端到端样本验证尚待完成，因此本版本仍将该能力标记为实验性。
### APK
- 手机版：`entryway-debug-0.15.0.apk`
- TV 版：`Entryway-tv-debug-0.14.0.apk`
### 构建信息
- 手机版：`versionName 0.15.0` ， `versionCode 34`
- TV 版：`versionName 0.14.0` ， `versionCode 33`
## 手机版 v0.14.0 / TV 版 v0.13.2 - 2026-07-11
> 💬 **手机版弹幕功能正式上线** — 接入 DandanPlay 弹幕匹配、加载、显示和完整设置体系，同时改善 MPV 字幕渲染与切换体验。TV 版本次无代码变更，继续提供 v0.13.2。
### 手机版弹幕
- 支持按文件哈希与文件名自动匹配，也可搜索动漫、手动选择剧集或载入本地弹幕。
- 完整设置集中到弹幕设置页，支持行数、字号、透明度、速度、显示区域、时间偏移、关键词屏蔽、重复合并、防重叠、热力图、简繁转换及 Canvas / SurfaceView 模式。
- 修复 SurfaceView 弹幕阻断播放器点击和手势的问题。
- 已匹配媒体复用持久化映射，候选详情并发获取，大体积 JSON 后台解析。
- 弹幕内容改用跟随播放器缓存上限的 LRU 缓存，仅超限时逐出，映射关系永久保留。
### 手机版 MPV 字幕
- 修复 Android 字体族配置，补充 CJK 回退、编码识别与 ASS 兼容参数。
- 字幕切换直接写入 `sid` ，后台校验状态，减少切换时的界面卡顿。
- 保留 MPV/libass 对 ASS 特效和 PGS、VobSub 位图字幕的原生支持。
### APK
- 手机版：`entryway-debug-0.14.0.apk`
- TV 版（本次无变更）：`Entryway-tv-debug-0.13.2.apk`
### 构建信息
- 手机版：`versionName 0.14.0` ， `versionCode 33`
- TV 版：`versionName 0.13.2` ， `versionCode 32`
## v0.8.2 - 2026-04-26
### 手机版更新
余生