Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
bede8a7a14 | ||
|
|
bc51ab8f46 | ||
|
|
3bbc259f04 | ||
|
|
51df07d54f | ||
|
|
88620603c9 | ||
|
|
4821a3a247 | ||
|
|
f8d3dab6b2 | ||
|
|
3d420ff52b | ||
|
|
f2ea05ce91 |
@@ -1,9 +1,9 @@
|
||||
<p align="center">
|
||||
<p align="center">
|
||||
<img src="entryway_logo.png" alt="Entryway Logo" width="120">
|
||||
</p>
|
||||
|
||||
<p align="center"><strong>Entryway</strong></p>
|
||||
<p align="center">多服务器聚合管理的 Android 媒体客户端,支持 Jellyfin 和 Emby。</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">
|
||||
@@ -16,81 +16,86 @@
|
||||
|
||||
---
|
||||
|
||||
## 最新版本 | Latest Release
|
||||
## 鏈€鏂扮増鏈?| 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)
|
||||
- **变更日志**:[`RELEASE_NOTES.md`](RELEASE_NOTES.md)
|
||||
- **鎵嬫満鐗?v0.17.0**锛氬畬鏁村寮瑰箷 API 绠$悊銆佺獎灞忓竷灞€淇涓庢寜鏈嶅姟闅旂鐨勫尮閰嶅拰缂撳瓨
|
||||
- **TV 鐗?v0.16.0**锛氱Щ妞嶅寮瑰箷 API銆侀噸鎺掗仴鎺у櫒寮圭獥骞朵慨澶嶅脊骞曠┛閫忚彍鍗曚笌鐒︾偣闂
|
||||
- **Windows v0.16.0**:首页横向滚动箭头、查看全部入口、下载页返回按钮
|
||||
- **鎵嬫満鐗?APK**锛歔`entryway-debug-0.17.0.apk`](https://github.com/JackYucongjia/Entryway_Release/releases/download/v0.17.0/entryway-debug-0.17.0.apk)
|
||||
- **TV 鐗?APK**锛歔`Entryway-tv-debug-0.16.0.apk`](https://github.com/JackYucongjia/Entryway_Release/releases/download/v0.17.0/Entryway-tv-debug-0.16.0.apk)
|
||||
- **Windows x64**锛歔`Entryway_0.14.0+33_Windows_x64_Setup.exe`](https://github.com/JackYucongjia/Entryway_Release/releases/download/v0.17.0/Entryway_0.14.0%2B33_Windows_x64_Setup.exe)
|
||||
- **鍙樻洿鏃ュ織**锛歔`RELEASE_NOTES.md`](RELEASE_NOTES.md)
|
||||
|
||||
## 概述 | Overview
|
||||
## 姒傝堪 | Overview
|
||||
|
||||
**Entryway** 是一个面向自建媒体服务器用户的 Android 客户端,核心设计理念是 **多服务器聚合**——在一个统一的界面中管理和浏览你所有的 Jellyfin / Emby 服务器。
|
||||
**Entryway** 鏄竴涓潰鍚戣嚜寤哄獟浣撴湇鍔″櫒鐢ㄦ埛鐨?Android 瀹㈡埛绔紝鏍稿績璁捐鐞嗗康鏄?**澶氭湇鍔″櫒鑱氬悎**鈥斺€斿湪涓€涓粺涓€鐨勭晫闈腑绠$悊鍜屾祻瑙堜綘鎵€鏈夌殑 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 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.
|
||||
|
||||
## 核心特性 | Features
|
||||
## 鏍稿績鐗规€?| Features
|
||||
|
||||
### 🖥️ 多服务器管理
|
||||
- 添加多个 Jellyfin / Emby 服务器,一键快速切换
|
||||
- 服务器卡片显示用户头像、用户名、服务器地址
|
||||
- 长按菜单:重新登录、服务器线路、修改图标、修改备注、设为私密、修改密码、编辑、删除
|
||||
- 溢出菜单:搜索、排序(默认/名称/最近使用)、网格/列表布局切换、显示选项
|
||||
- 私密服务器:标记后默认隐藏,需手动开启显示
|
||||
### 馃枼锔?澶氭湇鍔″櫒绠$悊
|
||||
- 娣诲姞澶氫釜 Jellyfin / Emby 鏈嶅姟鍣紝涓€閿揩閫熷垏鎹?
|
||||
- 鏈嶅姟鍣ㄥ崱鐗囨樉绀虹敤鎴峰ご鍍忋€佺敤鎴峰悕銆佹湇鍔″櫒鍦板潃
|
||||
- 闀挎寜鑿滃崟锛氶噸鏂扮櫥褰曘€佹湇鍔″櫒绾胯矾銆佷慨鏀瑰浘鏍囥€佷慨鏀瑰娉ㄣ€佽涓虹瀵嗐€佷慨鏀瑰瘑鐮併€佺紪杈戙€佸垹闄?
|
||||
- 婧㈠嚭鑿滃崟锛氭悳绱€佹帓搴忥紙榛樿/鍚嶇О/鏈€杩戜娇鐢級銆佺綉鏍?鍒楄〃甯冨眬鍒囨崲銆佹樉绀洪€夐」
|
||||
- 绉佸瘑鏈嶅姟鍣細鏍囪鍚庨粯璁ら殣钘忥紝闇€鎵嬪姩寮€鍚樉绀?
|
||||
|
||||
### 🏠 首页即服务器
|
||||
- 首页直接展示当前活跃服务器的媒体库内容
|
||||
- 左上角显示当前服务器名,点击即可切换到其他非私密服务器
|
||||
- 支持精选轮播(Featured Carousel)和无轮播两种模式
|
||||
### 馃彔 棣栭〉鍗虫湇鍔″櫒
|
||||
- 棣栭〉鐩存帴灞曠ず褰撳墠娲昏穬鏈嶅姟鍣ㄧ殑濯掍綋搴撳唴瀹?
|
||||
- 宸︿笂瑙掓樉绀哄綋鍓嶆湇鍔″櫒鍚嶏紝鐐瑰嚮鍗冲彲鍒囨崲鍒板叾浠栭潪绉佸瘑鏈嶅姟鍣?
|
||||
- 鏀寔绮鹃€夎疆鎾紙Featured Carousel锛夊拰鏃犺疆鎾袱绉嶆ā寮?
|
||||
|
||||
### 🎬 双引擎播放器
|
||||
- **ExoPlayer 引擎**:默认播放引擎,基于 Media3 + Jellyfin FFmpeg 扩展
|
||||
- **mpv 引擎**:备用高兼容性引擎,基于 libmpv,支持更多编解码格式
|
||||
- 播放失败时自动提供引擎切换建议,支持手动一键切换
|
||||
- 切换引擎时自动保持播放进度
|
||||
- 统一 User-Agent:`Entryway/{version} (android; {api})`
|
||||
### 馃幀 鍙屽紩鎿庢挱鏀惧櫒
|
||||
- **ExoPlayer 寮曟搸**锛氶粯璁ゆ挱鏀惧紩鎿庯紝鍩轰簬 Media3 + Jellyfin FFmpeg 鎵╁睍
|
||||
- **mpv 寮曟搸**锛氬鐢ㄩ珮鍏煎鎬у紩鎿庯紝鍩轰簬 libmpv锛屾敮鎸佹洿澶氱紪瑙g爜鏍煎紡
|
||||
- 鎾斁澶辫触鏃惰嚜鍔ㄦ彁渚涘紩鎿庡垏鎹㈠缓璁紝鏀寔鎵嬪姩涓€閿垏鎹?
|
||||
- 鍒囨崲寮曟搸鏃惰嚜鍔ㄤ繚鎸佹挱鏀捐繘搴?
|
||||
- 缁熶竴 User-Agent锛歚Entryway/{version} (android; {api})`
|
||||
|
||||
### ⏩ 播放控制
|
||||
- **倍速播放**:0.1x ~ 5.0x 滑动条 + 快速预设(0.5x / 1.0x / 1.5x / 2.0x / 3.0x)
|
||||
- **长按快速倍速**:长按屏幕进入手动短时间高速播放
|
||||
- **手势控制**:左右滑动快进快退、左侧上下滑动调亮度、右侧上下滑动调音量
|
||||
- **画面比例**:循环切换适应/填充/16:9/4:3 等比例模式
|
||||
- **锁屏**:锁定控制界面,防止误触
|
||||
- **剧集导航**:上一集/下一集,播放列表(仅剧集)
|
||||
### 鈴?鎾斁鎺у埗
|
||||
- **鍊嶉€熸挱鏀?*锛?.1x ~ 5.0x 婊戝姩鏉?+ 蹇€熼璁撅紙0.5x / 1.0x / 1.5x / 2.0x / 3.0x锛?
|
||||
- **闀挎寜蹇€熷€嶉€?*锛氶暱鎸夊睆骞曡繘鍏ユ墜鍔ㄧ煭鏃堕棿楂橀€熸挱鏀?
|
||||
- **鎵嬪娍鎺у埗**锛氬乏鍙虫粦鍔ㄥ揩杩涘揩閫€銆佸乏渚т笂涓嬫粦鍔ㄨ皟浜害銆佸彸渚т笂涓嬫粦鍔ㄨ皟闊抽噺
|
||||
- **鐢婚潰姣斾緥**锛氬惊鐜垏鎹㈤€傚簲/濉厖/16:9/4:3 绛夋瘮渚嬫ā寮?
|
||||
- **閿佸睆**锛氶攣瀹氭帶鍒剁晫闈紝闃叉璇Е
|
||||
- **鍓ч泦瀵艰埅**锛氫笂涓€闆?涓嬩竴闆嗭紝鎾斁鍒楄〃锛堜粎鍓ч泦锛?
|
||||
|
||||
### 🔧 mpv 引擎专属
|
||||
- **解码模式切换**:SW(软解)/ HW(硬解)/ HW+(硬解+拷贝)一键循环切换
|
||||
- 字体自动加载,支持字幕渲染
|
||||
### 馃敡 mpv 寮曟搸涓撳睘
|
||||
- **瑙g爜妯″紡鍒囨崲**锛歋W锛堣蒋瑙o級/ HW锛堢‖瑙o級/ HW+锛堢‖瑙?鎷疯礉锛変竴閿惊鐜垏鎹?
|
||||
- 瀛椾綋鑷姩鍔犺浇锛屾敮鎸佸瓧骞曟覆鏌?
|
||||
|
||||
### 🔊 高级音频
|
||||
- Apple Spatial Audio 空间音频检测与启用
|
||||
- HDR / Dolby Vision 能力检测与自动适配
|
||||
### 馃攰 楂樼骇闊抽
|
||||
- Apple Spatial Audio 绌洪棿闊抽妫€娴嬩笌鍚敤
|
||||
- HDR / Dolby Vision 鑳藉姏妫€娴嬩笌鑷姩閫傞厤
|
||||
|
||||
### 🎨 全局主题系统
|
||||
- 支持 **跟随系统** / **浅色** / **深色** 三种主题模式
|
||||
- 基于 Material 3 动态配色方案
|
||||
### 馃帹 鍏ㄥ眬涓婚绯荤粺
|
||||
- 鏀寔 **璺熼殢绯荤粺** / **娴呰壊** / **娣辫壊** 涓夌涓婚妯″紡
|
||||
- 鍩轰簬 Material 3 鍔ㄦ€侀厤鑹叉柟妗?
|
||||
|
||||
### 🌐 完整国际化
|
||||
- 界面支持中文(简体/繁体)和英文
|
||||
- 50+ 影视类型名称客户端翻译
|
||||
- 根据系统语言自动切换
|
||||
### 馃寪 瀹屾暣鍥介檯鍖?
|
||||
- 鐣岄潰鏀寔涓枃锛堢畝浣?绻佷綋锛夊拰鑻辨枃
|
||||
- 50+ 褰辫绫诲瀷鍚嶇О瀹㈡埛绔炕璇?
|
||||
- 鏍规嵁绯荤粺璇█鑷姩鍒囨崲
|
||||
|
||||
### 📥 离线下载
|
||||
- 队列化下载管理,支持暂停/恢复/取消
|
||||
- 季度/剧集批量下载,下载前显示存储空间预估
|
||||
- 无网络时自动切换到离线内容模式
|
||||
### 馃摜 绂荤嚎涓嬭浇
|
||||
- 闃熷垪鍖栦笅杞界鐞嗭紝鏀寔鏆傚仠/鎭㈠/鍙栨秷
|
||||
- 瀛e害/鍓ч泦鎵归噺涓嬭浇锛屼笅杞藉墠鏄剧ず瀛樺偍绌洪棿棰勪及
|
||||
- 鏃犵綉缁滄椂鑷姩鍒囨崲鍒扮绾垮唴瀹规ā寮?
|
||||
|
||||
## 技术栈 | Tech Stack
|
||||
## 鎶€鏈爤 | Tech Stack
|
||||
|
||||
| 类别 | 技术 |
|
||||
| 绫诲埆 | 鎶€鏈?|
|
||||
|------|------|
|
||||
| **语言** | Kotlin 2.0, Coroutines, Flow |
|
||||
| **璇█** | 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 |
|
||||
| **缃戠粶** | Retrofit 3 + OkHttp 5 |
|
||||
| **鍥剧墖** | Coil 3 |
|
||||
| **鎾斁鍣?* | Media3 ExoPlayer + FFmpeg 鎵╁睍 / libmpv (鍙屽紩鎿? |
|
||||
| **瀛樺偍** | SharedPreferences + DataStore |
|
||||
| **鏋勫缓** | Gradle 9.4, AGP, KSP |
|
||||
|
||||
## 贡献 | Contributing
|
||||
## 璐$尞 | Contributing
|
||||
|
||||
娆㈣繋鎻愪氦 Issue 鍜?Pull Request銆傝緝澶х殑鍔熻兘寮€鍙戝缓璁厛寮€ Issue 璁ㄨ鑼冨洿銆?
|
||||
|
||||
欢迎提交 Issue 和 Pull Request。较大的功能开发建议先开 Issue 讨论范围。
|
||||
|
||||
+25
-16
@@ -1,25 +1,34 @@
|
||||
# Entryway Release Notes
|
||||
# Entryway Mobile 0.18.0 / TV 0.16.1 / Windows 0.16.0+35
|
||||
|
||||
## v0.8.1 - 2026-04-23
|
||||
本批次仅 Windows 端有代码更新,Android 手机版和 TV 版沿用 v0.18.0 已验证安装包。Android 为 1.0 前的 debug 构建。
|
||||
|
||||
### 首页与服务器详情页加载优化
|
||||
## 版本与校验
|
||||
|
||||
- **媒体库两段式加载**:首页和服务器详情页先快速展示前 6 个媒体库,随后后台异步补齐完整媒体库列表,避免首屏等待过久或后续媒体库完全不显示
|
||||
- **精选轮播提速**:精选轮播不再强制等待 Logo 与背景图全部解析完成;背景图可用后即展示内容,Logo 后续加载补齐
|
||||
- **轮播兜底展示优化**:当条目没有 Logo 或 Logo 加载较慢时,使用片名文字兜底,减少空白骨架停留时间
|
||||
- **图片预取降噪**:收紧首页图片预取并发和首批预取数量,降低进入首页时的网络与解码竞争,让关键内容优先加载
|
||||
- **精选数据轻量化**:精选轮播请求数量从 10 条缩减为 6 条,减少随机推荐和首屏图片解析成本
|
||||
| 平台 | 应用版本 | 构建号 | 文件名 | SHA-256 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| Android Mobile | 0.18.0 | 37 | entryway-debug-0.18.0.apk | `0157c126c61d79767952ed995414eb5d8a1239bb2013a2406996468356c7b820` |
|
||||
| Android TV | 0.16.1 | 36 | Entryway-tv-debug-0.16.1.apk | `09d2a29d65f37cfc62c85b4fb0a7ce9a8386fac9712fb4653b0cec2f7ad69e9f` |
|
||||
| Windows x64 | 0.16.0 | 35 | Entryway_0.16.0+35_Windows_x64_Setup.exe | `4f4652d5773b383291e0469c2e5a03f03cc0b25a707ebe34b02653fd958f3a14` |
|
||||
|
||||
### 播放与调试链路收敛
|
||||
> Android 为 debug 构建(1.0 前约定),Windows 安装包未签名;首次运行可能触发系统安全提示,需手动确认。
|
||||
|
||||
- **起播诊断写盘关闭**:默认关闭 debug 包中的播放诊断文件写入,避免起播阶段产生额外 I/O
|
||||
- **既有播放修复保留**:延续 v0.8.0 的 NextEmby 稳定流入口、认证参数补齐、Exo 外挂字幕修复和字幕浮窗文案修正
|
||||
## Android Mobile 0.18.0
|
||||
|
||||
### APK
|
||||
本批次无变化,沿用 v0.18.0 的 0.18.0。
|
||||
|
||||
- GitHub Release 资产:`entryway-debug-0.8.1.apk`
|
||||
## Android TV 0.16.1
|
||||
|
||||
### 构建信息
|
||||
本批次无变化,沿用 v0.18.0 的 0.16.1。
|
||||
|
||||
- `versionName`: `0.8.1`
|
||||
- `versionCode`: `24`
|
||||
## Windows 0.16.0
|
||||
|
||||
- 首页所有横向媒体行新增浮动左右滚动箭头,鼠标悬停时显示,点击可平滑横向浏览。
|
||||
- "继续观看"和"我的媒体"分区新增"查看全部"入口。
|
||||
- "我的媒体"查看全部改为库目录选择页,先选库再看内容。
|
||||
- 子媒体库行最大条目数从 12 提升至 24,最大化窗口时可展示更多内容。
|
||||
- 修复离线下载页面进入后无法退出的问题(新增返回按钮)。
|
||||
|
||||
## 已知问题
|
||||
|
||||
- 图形字幕(PGS/VOBSUB)在 ExoPlayer 下颜色不可调,属播放器框架限制,可切换 mpv 内核。
|
||||
- Windows 安装包未签名。
|
||||
|
||||
Reference in New Issue
Block a user