Compare commits

..
15 Commits
Author SHA1 Message Date
余生 49e08e3e24 fix(release): align candidate source metadata 2026-08-08 18:01:15 +08:00
余生 47dafdf839 fix(release): publish debug APK filenames 2026-08-08 17:59:59 +08:00
余生 394db69387 release: publish v0.20.0 metadata 2026-08-08 17:51:25 +08:00
余生andClaude Opus 5 e92af5d83d release: mobile 0.19.1 signing fix, TV 0.17.0, Windows 0.17.0 (v0.19.1)
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-07-30 01:32:18 +08:00
余生 78f6683ff1 release: mobile 0.19.0, TV 0.17.0, Windows 0.17.0 2026-07-30 00:56:20 +08:00
余生 eac5511e86 docs: update README for multi-platform with v0.18.1 downloads and website link 2026-07-25 22:06:06 +08:00
余生 bede8a7a14 release: mobile 0.18.0, TV 0.16.1, Windows 0.16.0 (v0.18.1) 2026-07-23 18:35:16 +08:00
余生 bc51ab8f46 release: v0.18.0 ships Android debug builds (pre-1.0 convention) 2026-07-22 21:31:08 +08:00
余生 3bbc259f04 release: mobile 0.18.0, TV 0.16.1, Windows 0.15.0 2026-07-22 21:00:12 +08:00
余生 51df07d54f release: mobile 0.17.0, TV 0.16.0, Windows 0.14.0 2026-07-20 19:36:27 +08:00
余生 88620603c9 Release Entryway mobile 0.16.0 and TV 0.15.0 2026-07-19 21:50:06 +08:00
余生 4821a3a247 Release Entryway mobile 0.15.0 and TV 0.14.0 2026-07-19 14:24:55 +08:00
余生 f8d3dab6b2 Release Entryway mobile 0.14.0 2026-07-11 22:41:51 +08:00
余生 3d420ff52b Refine Entryway 0.8.2 release notes 2026-04-26 13:22:09 +08:00
余生 f2ea05ce91 Release notes for Entryway 0.8.2 2026-04-26 13:15:17 +08:00
2 changed files with 102 additions and 74 deletions
+68 -58
View File
@@ -3,14 +3,13 @@
</p>
<p align="center"><strong>Entryway</strong></p>
<p align="center">多服务器聚合管理的 Android 媒体客户端,支持 Jellyfin 和 Emby。</p>
<p align="center">A multi-server aggregation Android media client for Jellyfin & Emby.</p>
<p align="center">多服务器聚合管理的跨平台媒体客户端,支持 Jellyfin 和 Emby。</p>
<p align="center">A multi-server aggregation media client for Jellyfin & Emby — Android, Android TV & Windows.</p>
<p align="center"><a href="https://www.yamby.cn">官方网站 | Official Website</a></p>
<p align="center">
<img src="https://img.shields.io/badge/Platform-Android-3DDC84?style=flat-square&logo=android&logoColor=white" alt="Android">
<img src="https://img.shields.io/badge/Kotlin-2.0-7F52FF?style=flat-square&logo=kotlin&logoColor=white" alt="Kotlin">
<img src="https://img.shields.io/badge/Jetpack_Compose-Material_3-4285F4?style=flat-square&logo=jetpackcompose&logoColor=white" alt="Compose">
<img src="https://img.shields.io/badge/Min_SDK-27_(Android_8.1)-34A853?style=flat-square" alt="MinSDK">
<img src="https://img.shields.io/badge/Platform-Android%20%7C%20Android_TV%20%7C%20Windows-3DDC84?style=flat-square" alt="Platform">
<img src="https://img.shields.io/badge/Server-Jellyfin%20%7C%20Emby-AA0000?style=flat-square" alt="Server">
<img src="https://img.shields.io/badge/License-MIT-blue?style=flat-square" alt="License">
</p>
@@ -18,79 +17,90 @@
## 最新版本 | Latest Release
- **v0.8.1**:优化首页和服务器详情页加载速度,媒体库先展示前 6 个后异步补齐完整列表,精选轮播背景图优先展示、Logo 后补
- **APK**[`entryway-debug-0.8.1.apk`](https://github.com/JackYucongjia/Entryway_Release/releases/download/v0.8.1/entryway-debug-0.8.1.apk)
**全局标签 `v0.20.0`**(各端应用版本独立)
| 平台 | 应用版本 | 构建号 | 下载 |
| --- | --- | --- | --- |
| Android 手机版 | 0.20.0 | 40 | [`entryway-debug-0.20.0.apk`](https://gitea.yamby.cn/yusheng/Entryway_Release/releases/download/v0.20.0/entryway-debug-0.20.0.apk) |
| Android TV 版 | 0.18.0 | 38 | [`Entryway-tv-debug-0.18.0.apk`](https://gitea.yamby.cn/yusheng/Entryway_Release/releases/download/v0.20.0/Entryway-tv-debug-0.18.0.apk) |
| Windows x64 | 0.18.0 | 37 | [`Entryway_0.18.0+37_Windows_x64_Setup.exe`](https://gitea.yamby.cn/yusheng/Entryway_Release/releases/download/v0.20.0/Entryway_0.18.0+37_Windows_x64_Setup.exe) |
> Android 手机版与 TV 版沿用 1.0 前的调试证书签名约定,Windows 安装包未签名;首次运行可能触发系统安全提示,需手动确认。
>
> ⚠️ v0.19.0 的手机安装包误用了正式发布证书,无法覆盖安装。0.18.x 及更早版本可直接覆盖安装 0.20.0;若已安装 v0.19.0,需先卸载再安装。
- **变更日志**[`RELEASE_NOTES.md`](RELEASE_NOTES.md)
- **全部版本**[Gitea Releases](https://gitea.yamby.cn/yusheng/Entryway_Release/releases) [GitHub Releases](https://github.com/JackYucongjia/Entryway_Release/releases)
## 概述 | Overview
**Entryway** 是一个面向自建媒体服务器用户的 Android 客户端,核心设计理念是 **多服务器聚合**——在一个统一的界面中管理和浏览你所有的 Jellyfin / Emby 服务器。
**Entryway** 是一个面向自建媒体服务器用户的跨平台客户端,覆盖 **Android 手机**、**Android TV** 和 **Windows** 三端。核心设计理念是 **多服务器聚合**——在一个统一的界面中管理和浏览你所有的 Jellyfin / Emby 服务器。
Entryway is an Android client designed for self-hosted media server users. Its core philosophy is **multi-server aggregation** — managing and browsing all your Jellyfin / Emby servers from a single, unified interface.
Entryway is a cross-platform client for self-hosted media server users, available on **Android Mobile**, **Android TV**, and **Windows**. Its core philosophy is **multi-server aggregation** — managing and browsing all your Jellyfin / Emby servers from a single, unified interface.
**官网**[www.yamby.cn](https://www.yamby.cn)
## 核心特性 | Features
### 🖥️ 多服务器管理
- 添加多个 Jellyfin / Emby 服务器,一键快速切换
- 服务器卡片显示用户头像、用户名、服务器地址
- 长按菜单:重新登录、服务器线路、修改图标、修改备注、设为私密、修改密码、编辑、删除
- 溢出菜单:搜索、排序(默认/名称/最近使用)、网格/列表布局切换、显示选项
- 私密服务器:标记后默认隐藏,需手动开启显示
- 冷启动离线恢复:服务器不可用时不清除账号
### 🏠 首页即服务器
- 首页直接展示当前活跃服务器的媒体库内容
- 左上角显示当前服务器名,点击即可切换到其他非私密服务器
- 支持精选轮播(Featured Carousel)和无轮播两种模式
### 🎬 双引擎播放器(Android
- **ExoPlayer**:默认引擎,基于 Media3 + FFmpeg 扩展
- **mpv**:高兼容性引擎,含 libdvdread/libdvdnav/libbluray
- 自动容错切换,保留播放进度
- 解码模式:SW / HW / HW+ / DV-SW
### 🎬 双引擎播放器
- **ExoPlayer 引擎**:默认播放引擎,基于 Media3 + Jellyfin FFmpeg 扩展
- **mpv 引擎**:备用高兼容性引擎,基于 libmpv,支持更多编解码格式
- 播放失败时自动提供引擎切换建议,支持手动一键切换
- 切换引擎时自动保持播放进度
- 统一 User-Agent`Entryway/{version} (android; {api})`
### 💬 多弹幕服务
- 弹弹Play 官方、LogVar 弹幕 API、其他弹弹Play 兼容服务
- 按优先级有序故障回退,数据源严格隔离
- 自动匹配、手动搜索、本地弹幕、LRU 缓存
- 三端支持(手机 / TV / Windows
### ⏩ 播放控制
- **倍速播放**0.1x ~ 5.0x 滑动条 + 快速预设(0.5x / 1.0x / 1.5x / 2.0x / 3.0x
- **长按快速倍速**:长按屏幕进入手动短时间高速播放
- **手势控制**:左右滑动快进快退、左侧上下滑动调亮度、右侧上下滑动调音量
- **画面比例**:循环切换适应/填充/16:9/4:3 等比例模式
- **锁屏**:锁定控制界面,防止误触
- **剧集导航**:上一集/下一集,播放列表(仅剧集)
### 💿 实验性 DVD / Blu-ray ISO
- 未加密原盘本地与远程播放
- 不支持时自动回退服务器转码
### 🔧 mpv 引擎专属
- **解码模式切换**:SW(软解)/ HW(硬解)/ HW+(硬解+拷贝)一键循环切换
- 字体自动加载,支持字幕渲染
### 📺 Android TV
- 遥控器全键盘搜索、二维码手机输入
- 完整弹幕、扫码录入服务器、首页缓存兜底
### 🔊 高级音频
- Apple Spatial Audio 空间音频检测与启用
- HDR / Dolby Vision 能力检测与自动适配
### 🪟 Windows
- Flutter + MediaKit (libmpv) + Rust 弹幕引擎
- 多服务器、收藏、详情、跨服搜索、离线下载
- Chromecast/DLNA 投屏、Inno Setup 安装器
### 🎨 全局主题系统
- 支持 **跟随系统** / **浅色** / **深色** 三种主题模式
- 基于 Material 3 动态配色方案
### 🌐 完整国际化
- 界面支持中文(简体/繁体)和英文
- 50+ 影视类型名称客户端翻译
- 根据系统语言自动切换
### 🎨 设计与国际化
- 空间化 / 玻璃态视觉语言,Material 3 动态配色
- 完整中文(简体/繁体)和英文本地化
### 📥 离线下载
- 队列化下载管理,支持暂停/恢复/取消
- 季度/剧集批量下载,下载前显示存储空间预估
- 无网络时自动切换到离线内容模式
- 队列化管理,批量下载,存储空间预估
- 无网络时自动切换离线内容模式
## 技术栈 | Tech Stack
## 平台要求 | Requirements
| 类别 | 技术 |
|------|------|
| **语言** | Kotlin 2.0, Coroutines, Flow |
| **UI** | Jetpack Compose + Material 3 + Navigation Compose |
| **网络** | Retrofit 3 + OkHttp 5 |
| **图片** | Coil 3 |
| **播放器** | Media3 ExoPlayer + FFmpeg 扩展 / libmpv (双引擎) |
| **存储** | SharedPreferences + DataStore |
| **构建** | Gradle 9.4, AGP, KSP |
| 平台 | 最低要求 |
| --- | --- |
| Android 手机版 | Android 8.1 (API 27) |
| Android TV 版 | Android 8.1 (API 27) |
| Windows | Windows 10 x64 |
## 贡献 | Contributing
## 更新检测 | Update Check
欢迎提交 Issue 和 Pull Request。较大的功能开发建议先开 Issue 讨论范围
客户端内置更新检测,优先从 Gitea 获取最新版本,连接失败时自动降级到 GitHub
## 源码仓库 | Source Code
- **GitHub**[github.com/JackYucongjia/Entryway](https://github.com/JackYucongjia/Entryway)
- **Gitea**[gitea.yamby.cn/yusheng/Entryway](https://gitea.yamby.cn/yusheng/Entryway)
## 许可证 | License
本项目基于 MIT 许可证开源。
手机端弹幕实现参考了 MIT 许可的 [AimesSoft/NipaPlay-Reload](https://github.com/AimesSoft/NipaPlay-Reload)。
Windows 客户端基于 NipaPlay-Reload `v1.10.13` 构建,保留上游 MIT 许可。
+34 -16
View File
@@ -1,25 +1,43 @@
# Entryway Release Notes
# Entryway v0.20.0
## v0.8.1 - 2026-04-23
本批次同步发布 Android 手机版、Android TV 和 Windows x64。各端应用版本独立维护:Mobile `0.20.0`、TV `0.18.0`、Windows `0.18.0+37`
### 首页与服务器详情页加载优化
## 版本信息
- **媒体库两段式加载**:首页和服务器详情页先快速展示前 6 个媒体库,随后后台异步补齐完整媒体库列表,避免首屏等待过久或后续媒体库完全不显示
- **精选轮播提速**:精选轮播不再强制等待 Logo 与背景图全部解析完成;背景图可用后即展示内容,Logo 后续加载补齐
- **轮播兜底展示优化**:当条目没有 Logo 或 Logo 加载较慢时,使用片名文字兜底,减少空白骨架停留时间
- **图片预取降噪**:收紧首页图片预取并发和首批预取数量,降低进入首页时的网络与解码竞争,让关键内容优先加载
- **精选数据轻量化**:精选轮播请求数量从 10 条缩减为 6 条,减少随机推荐和首屏图片解析成本
| 平台 | 应用版本 | 构建号 | 安装包 | SHA-256 |
| --- | --- | ---: | --- | --- |
| Android 手机版 | 0.20.0 | 40 | `entryway-debug-0.20.0.apk` | `e20dcb43fe2c4e880215fbdc97713c37db864b163d6f55ec2cd900e95e338829` |
| Android TV 版 | 0.18.0 | 38 | `Entryway-tv-debug-0.18.0.apk` | `0f51f2030f558d950262ed143551a91bb30e8f4a877ce0f9eb4632beb0cbca86` |
| Windows x64 | 0.18.0 | 37 | `Entryway_0.18.0+37_Windows_x64_Setup.exe` | `b744a11a186350461dc6b4143df1fd5ee833bcc0ae1df6bff4339e1824333477` |
### 播放与调试链路收敛
## 跨端改进
- **起播诊断写盘关闭**:默认关闭 debug 包中的播放诊断文件写入,避免起播阶段产生额外 I/O
- **既有播放修复保留**:延续 v0.8.0 的 NextEmby 稳定流入口、认证参数补齐、Exo 外挂字幕修复和字幕浮窗文案修正
- 多弹幕 API 支持在 Android 和 Windows 端并行获取、来源切换和后台加载;TV 端同步完善弹幕菜单与设置。
- Android 播放器控制布局、弹幕热力图、字幕/弹幕交互层、投屏路径和倍速传递功能升级。
- Android TV 增强弹幕缓存、继续观看去重、媒体库缓存和黑色主题可读性。
### APK
## Android 手机版 0.20.0
- GitHub Release 资产:`entryway-debug-0.8.1.apk`
- 播放器控制面板重新布局,辅助按钮缩小并减少误触,进度条加入弹幕热力图。
- 支持多弹幕 API 并行请求、来源切换、Google Cast、DLNA 和局域网中继投屏。
- 新增“倍速播放传递”设置,切换下一集时可沿用当前倍速。
- 使用 Android Debug 变体和证书签名;`v0.19.0` 正式证书包仍需先卸载。
### 构建信息
## Android TV 版 0.18.0
- `versionName`: `0.8.1`
- `versionCode`: `24`
- 完善多来源弹幕设置、加载缓存和播放器菜单交互。
- 继续观看去重、媒体库缓存、数量显示和异常服务器隔离逻辑同步改进。
- 优化黑色主题下弹窗文字、遥控焦点和弹幕显示可读性。
## Windows x64 0.18.0+37
- 支持多个弹幕 API 来源、轨道管理和手动匹配。
- 弹幕搜索后台执行,视频优先进入播放/缓冲流程,服务端剧集按剧名和集号自动匹配。
- 安装包未进行代码签名,SmartScreen 可能显示未知发布者提示。
- Windows 安装包构建于 `f35a0e384b5619008aa25c1acbff1fcd31656ce7`;该提交与发布候选 `7fce5a8` 的 Windows 文件一致。
## 兼容性
- Android 手机和 TVAndroid 8.1API 27)及以上。
- WindowsWindows 10 或更高版本,x64。
- Android 安装包使用项目 1.0 前的 Debug 变体和证书签名,Windows 安装包未签名。