@@ -1,9 +1,9 @@
<p align="center">
<p align="center">
<img src="entryway_logo.png" alt="Entryway Logo" width="120">
<img src="entryway_logo.png" alt="Entryway Logo" width="120">
</p>
</p>
<p align="center"><strong>Entryway</strong></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">A multi-server aggregation Android media client for Jellyfin & Emby.</p>
<p align="center">
<p align="center">
@@ -16,142 +16,86 @@
---
---
## 概述 | Overview
## 鏈€鏂扮増鏈?| Latest Release
**Entryway ** 是一个面向自建媒体服务器用户的 Android 客户端，核心设计理念是 **多服务器聚合 ** ——在一个统一的界面中管理和浏览你所有的 Jellyfin / Emby 服务器。
- **鎵嬫満鐗?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)
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.
## 姒傝堪 | Overview
## 核心特性 | Features
**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.
- 添加多个 Jellyfin / Emby 服务器，一键快速切换
- 服务器卡片显示用户头像、用户名、服务器地址
- 长按菜单：重新登录、服务器线路、修改图标、修改备注、设为私密、修改密码、编辑、删除
- 溢出菜单：搜索、排序（默认/名称/最近使用）、网格/列表布局切换、显示选项
- 私密服务器：标记后默认隐藏，需手动开启显示
### 🏠 首页即服务器
## 鏍稿績鐗规€?| Features
- 首页直接展示当前活跃服务器的媒体库内容
- 左上角显示当前服务器名，点击即可切换到其他非私密服务器
- 支持精选轮播（Featured Carousel）和无轮播两种模式
### 🎬 双引擎播放器
### 馃枼锔?澶氭湇鍔″櫒绠＄悊
- **ExoPlayer 引擎**：默认播放引擎，基于 Media3 + Jellyfin FFmpeg 扩展
- 娣诲姞澶氫釜 Jellyfin / Emby 鏈嶅姟鍣紝涓€閿揩閫熷垏鎹?
- **mpv 引擎**：备用高兼容性引擎，基于 libmpv，支持更多编解码格式
- 鏈嶅姟鍣ㄥ崱鐗囨樉绀虹敤鎴峰ご鍍忋€佺敤鎴峰悕銆佹湇鍔″櫒鍦板潃
- 播放失败时自动提供引擎切换建议，支持手动一键切换
- 闀挎寜鑿滃崟锛氶噸鏂扮櫥褰曘€佹湇鍔″櫒绾胯矾銆佷慨鏀瑰浘鏍囥€佷慨鏀瑰娉ㄣ€佽涓虹瀵嗐€佷慨鏀瑰瘑鐮併€佺紪杈戙€佸垹闄?
- 切换引擎时自动保持播放进度
- 婧㈠嚭鑿滃崟锛氭悳绱€佹帓搴忥紙榛樿/鍚嶇О/鏈€杩戜娇鐢級銆佺綉鏍?鍒楄〃甯冨眬鍒囨崲銆佹樉绀洪€夐」
- 统一 User-Agent： `Entryway/{version} (android; {api})` - 绉佸瘑鏈嶅姟鍣細鏍囪鍚庨粯璁ら殣钘忥紝闇€鎵嬪姩寮€鍚樉绀?
### ⏩ 播放控制
### 馃彔 棣栭〉鍗虫湇鍔″櫒
- **倍速播放**： ）
- 棣栭〉鐩存帴灞曠ず褰撳墠娲昏穬鏈嶅姟鍣ㄧ殑濯掍綋搴撳唴瀹?
- **长按快速倍速**：长按屏幕进入手动短时间高速播放
- 宸︿笂瑙掓樉绀哄綋鍓嶆湇鍔″櫒鍚嶏紝鐐瑰嚮鍗冲彲鍒囨崲鍒板叾浠栭潪绉佸瘑鏈嶅姟鍣?
- **手势控制**：左右滑动快进快退、左侧上下滑动调亮度、右侧上下滑动调音量
- 鏀寔绮鹃€夎疆鎾紙Featured Carousel锛夊拰鏃犺疆鎾袱绉嶆ā寮?
- **画面比例**：循环切换适应/填充/16:9/4:3 等比例模式
- **锁屏**：锁定控制界面，防止误触
- **剧集导航**：上一集/下一集，播放列表（仅剧集）
### 🔧 mpv 引擎专属
### 馃幀 鍙屽紩鎿庢挱鏀惧櫒
- **解码模式切换**：SW（软解）/ HW（硬解）/ HW+（硬解+拷贝）一键循环切换
- **ExoPlayer 寮曟搸**锛氶粯璁ゆ挱鏀惧紩鎿庯紝鍩轰簬 Media3 + Jellyfin FFmpeg 鎵╁睍
- 字体自动加载，支持字幕渲染
- **mpv 寮曟搸**锛氬鐢ㄩ珮鍏煎鎬у紩鎿庯紝鍩轰簬 libmpv锛屾敮鎸佹洿澶氱紪瑙ｇ爜鏍煎紡
- 鎾斁澶辫触鏃惰嚜鍔ㄦ彁渚涘紩鎿庡垏鎹㈠缓璁紝鏀寔鎵嬪姩涓€閿垏鎹?
- 鍒囨崲寮曟搸鏃惰嚜鍔ㄤ繚鎸佹挱鏀捐繘搴?
- 缁熶竴 User-Agent锛歚Entryway/{version} (android; {api})`
### 🔊 高级音频
### 鈴?鎾斁鎺у埗
- Apple Spatial Audio 空间音频检测与启用
- **鍊嶉€熸挱鏀?*锛?.1x ~ 5.0x 婊戝姩鏉?+ 蹇€熼璁撅紙0.5x / 1.0x / 1.5x / 2.0x / 3.0x锛?
- HDR / Dolby Vision 能力检测与自动适配
- **闀挎寜蹇€熷€嶉€?*锛氶暱鎸夊睆骞曡繘鍏ユ墜鍔ㄧ煭鏃堕棿楂橀€熸挱鏀?
- **鎵嬪娍鎺у埗**锛氬乏鍙虫粦鍔ㄥ揩杩涘揩閫€銆佸乏渚т笂涓嬫粦鍔ㄨ皟浜害銆佸彸渚т笂涓嬫粦鍔ㄨ皟闊抽噺
- **鐢婚潰姣斾緥**锛氬惊鐜垏鎹㈤€傚簲/濉厖/16:9/4:3 绛夋瘮渚嬫ā寮?
- **閿佸睆**锛氶攣瀹氭帶鍒剁晫闈紝闃叉璇Е
- **鍓ч泦瀵艰埅**锛氫笂涓€闆?涓嬩竴闆嗭紝鎾斁鍒楄〃锛堜粎鍓ч泦锛?
### 🎨 全局主题系统
### 馃敡 mpv 寮曟搸涓撳睘
- 支持 **跟随系统 ** / **浅色 ** / **深色 ** 三种主题模式
- **瑙ｇ爜妯″紡鍒囨崲**锛歋W锛堣蒋瑙ｏ級/ HW锛堢‖瑙ｏ級/ HW+锛堢‖瑙?鎷疯礉锛変竴閿惊鐜垏鎹?
- 基于 Material 3 动态配色方案
- 瀛椾綋鑷姩鍔犺浇锛屾敮鎸佸瓧骞曟覆鏌?
### 🌐 完整国际化
### 馃攰 楂樼骇闊抽
- 界面支持中文（简体/繁体）和英文
- Apple Spatial Audio 绌洪棿闊抽妫€娴嬩笌鍚敤
- 50+ 影视类型名称客户端翻译
- HDR / Dolby Vision 鑳藉姏妫€娴嬩笌鑷姩閫傞厤
- 根据系统语言自动切换
### 📥 离线下载
### 馃帹 鍏ㄥ眬涓婚绯荤粺
- 队列化下载管理，支持暂停/恢复/取消
- 鏀寔 **璺熼殢绯荤粺 ** / **娴呰壊 ** / **娣辫壊 ** 涓夌涓婚妯″紡
- 季度/剧集批量下载，下载前显示存储空间预估
- 鍩轰簬 Material 3 鍔ㄦ€侀厤鑹叉柟妗?
- 无网络时自动切换到离线内容模式
## 项目架构 | Architecture
### 馃寪 瀹屾暣鍥介檯鍖?
- 鐣岄潰鏀寔涓枃锛堢畝浣?绻佷綋锛夊拰鑻辨枃
- 50+ 褰辫绫诲瀷鍚嶇О瀹㈡埛绔炕璇?
- 鏍规嵁绯荤粺璇█鑷姩鍒囨崲
```
### 馃摜 绂荤嚎涓嬭浇
entryway/
- 闃熷垪鍖栦笅杞界鐞嗭紝鏀寔鏆傚仠/鎭㈠/鍙栨秷
├── app/ # Android 应用层
- 瀛ｅ害/鍓ч泦鎵归噺涓嬭浇锛屼笅杞藉墠鏄剧ず瀛樺偍绌洪棿棰勪及
│ ├── ui/
- 鏃犵綉缁滄椂鑷姩鍒囨崲鍒扮绾垮唴瀹规ā寮?
│ │ ├── activity/ # EntryWayActivity（主入口）
│ │ ├── screens/
│ │ │ ├── dashboard/ # 首页、搜索、设置
│ │ │ │ ├── home/ # Dashboard + FeatureTab + 类目翻译
│ │ │ │ └── settings/
│ │ │ ├── servers/ # 服务器列表、管理、切换
│ │ │ ├── detail/ # 影片详情页
│ │ │ └── player/ # 双引擎播放器
│ │ │ ├── PlayerScreen # 播放器主界面 + 手势
│ │ │ ├── PlayerViewModel # 播放状态、引擎管理
│ │ │ ├── ControlsOverlay # 控制覆盖层 UI
│ │ │ └── MpvPlaybackEngine # mpv 引擎封装
│ │ ├── theme/ # Material 3 主题（支持深色/浅色）
│ │ └── splash/ # 启动页
│ └── util/ # 图片加载、日志
│
├── data/ # 数据层
│ ├── api/ # Jellyfin / Emby API 客户端
│ ├── model/ # 数据模型（BaseItemDto 等）
│ ├── repository/ # AuthRepository, MediaRepository
│ ├── preferences/ # AppPreferences, NetworkPreferences
│ └── network/ # 网络模块、连接检测
│
└── core/ # 核心工具层
├── auth/ # 认证状态管理
├── player/ # PlayerState、引擎类型、编解码器偏好
└── detail/ # 编解码器能力检测（HDR/Dolby/Spatial）
```
## 技术栈 | Tech Stack
## 鎶€鏈爤 | Tech Stack
| 类别 | 技术 |
| 绫诲埆 | 鎶€鏈? |
|------|------|
|------|------|
| **语言 ** | Kotlin 2.0, Coroutines, Flow |
| **璇█ ** | Kotlin 2.0, Coroutines, Flow |
| **UI ** | Jetpack Compose + Material 3 + Navigation Compose |
| **UI ** | Jetpack Compose + Material 3 + Navigation Compose |
| **网络 ** | Retrofit 3 + OkHttp 5 |
| **缃戠粶 ** | Retrofit 3 + OkHttp 5 |
| **图片 ** | Coil 3 |
| **鍥剧墖 ** | Coil 3 |
| **播放器 ** 扩展 / libmpv (双引擎) |
| **鎾斁鍣?* | Media3 ExoPlayer + FFmpeg 鎵╁睍 / libmpv (鍙屽紩鎿? |
| **存储 ** | SharedPreferences + DataStore |
| **瀛樺偍 ** | SharedPreferences + DataStore |
| **构建 ** | Gradle 9.4, AGP, KSP |
| **鏋勫缓 ** | Gradle 9.4, AGP, KSP |
## 构建 | Build
## 璐＄尞 | Contributing
### 前置要求
娆㈣繋鎻愪氦 Issue 鍜?Pull Request銆傝緝澶х殑鍔熻兘寮€鍙戝缓璁厛寮€ Issue 璁ㄨ鑼冨洿銆?
- Android Studio (最新稳定版)
- JDK 17
- Android SDK API 36
### 构建步骤
``` bash
# 克隆
git clone https://github.com/JackYucongjia/Entryway_Release.git
cd Entryway_Release
# 构建 Debug APK
./gradlew :app:assembleDebug
# 输出路径
# app/build/outputs/apk/debug/entryway-debug-*.apk
```
### 安装到设备
``` bash
adb install -r app/build/outputs/apk/debug/entryway-debug-*.apk
```
## 贡献 | Contributing
欢迎提交 Issue 和 Pull Request。较大的功能开发建议先开 Issue 讨论范围。
## 许可证 | License
本项目基于 MIT 许可证开源。详见 [LICENSE ](LICENSE )。
余生
余生
YuSheng