Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
681fb2d6a0 | ||
|
|
c4248f8cc5 | ||
|
|
2de521154c | ||
|
|
e02b2fbaa7 | ||
|
|
a74eefa394 | ||
|
|
49e08e3e24 | ||
|
|
47dafdf839 | ||
|
|
394db69387 | ||
|
|
e92af5d83d | ||
|
|
78f6683ff1 | ||
|
|
eac5511e86 | ||
|
|
bede8a7a14 | ||
|
|
bc51ab8f46 |
@@ -3,14 +3,13 @@
|
|||||||
</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">多服务器聚合管理的跨平台媒体客户端,支持 Jellyfin 和 Emby。</p>
|
||||||
<p align="center">A multi-server aggregation Android media client for 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">
|
<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/Platform-Android%20%7C%20Android_TV%20%7C%20Windows-3DDC84?style=flat-square" alt="Platform">
|
||||||
<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/Server-Jellyfin%20%7C%20Emby-AA0000?style=flat-square" alt="Server">
|
||||||
<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/License-MIT-blue?style=flat-square" alt="License">
|
<img src="https://img.shields.io/badge/License-MIT-blue?style=flat-square" alt="License">
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
@@ -18,83 +17,90 @@
|
|||||||
|
|
||||||
## 最新版本 | Latest Release
|
## 最新版本 | Latest Release
|
||||||
|
|
||||||
- **手机版 v0.17.0**:完整多弹幕 API 管理、窄屏布局修复与按服务隔离的匹配和缓存
|
**全局标签 `v0.23.0`**(各端应用版本独立;本批次为 Debug 持续发布)
|
||||||
- **TV 版 v0.16.0**:移植多弹幕 API、重排遥控器弹窗并修复弹幕穿透菜单与焦点问题
|
|
||||||
- **Windows v0.14.0**:提供 Windows x64 安装器、硬件解码策略与字幕/资源作用域修复
|
| 平台 | 应用版本 | 构建号 | 下载 |
|
||||||
- **手机版 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)
|
| Android 手机版 | 0.23.0 | 44 | [`entryway-debug-0.23.0.apk`](https://gitea.yamby.cn/yusheng/Entryway_Release/releases/download/v0.23.0/entryway-debug-0.23.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)
|
| Android TV 版 | 0.18.1 | 39 | [`Entryway-tv-debug-0.18.1.apk`](https://gitea.yamby.cn/yusheng/Entryway_Release/releases/download/v0.23.0/Entryway-tv-debug-0.18.1.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.23.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)
|
- **变更日志**:[`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
|
## 概述 | 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
|
## 核心特性 | Features
|
||||||
|
|
||||||
### 🖥️ 多服务器管理
|
### 🖥️ 多服务器管理
|
||||||
- 添加多个 Jellyfin / Emby 服务器,一键快速切换
|
- 添加多个 Jellyfin / Emby 服务器,一键快速切换
|
||||||
- 服务器卡片显示用户头像、用户名、服务器地址
|
- 服务器卡片显示用户头像、用户名、服务器地址
|
||||||
- 长按菜单:重新登录、服务器线路、修改图标、修改备注、设为私密、修改密码、编辑、删除
|
|
||||||
- 溢出菜单:搜索、排序(默认/名称/最近使用)、网格/列表布局切换、显示选项
|
|
||||||
- 私密服务器:标记后默认隐藏,需手动开启显示
|
- 私密服务器:标记后默认隐藏,需手动开启显示
|
||||||
|
- 冷启动离线恢复:服务器不可用时不清除账号
|
||||||
|
|
||||||
### 🏠 首页即服务器
|
### 🎬 双引擎播放器(Android)
|
||||||
- 首页直接展示当前活跃服务器的媒体库内容
|
- **ExoPlayer**:默认引擎,基于 Media3 + FFmpeg 扩展
|
||||||
- 左上角显示当前服务器名,点击即可切换到其他非私密服务器
|
- **mpv**:高兼容性引擎,含 libdvdread/libdvdnav/libbluray
|
||||||
- 支持精选轮播(Featured Carousel)和无轮播两种模式
|
- 自动容错切换,保留播放进度
|
||||||
|
- 解码模式:SW / HW / HW+ / DV-SW
|
||||||
|
|
||||||
### 🎬 双引擎播放器
|
### 💬 多弹幕服务
|
||||||
- **ExoPlayer 引擎**:默认播放引擎,基于 Media3 + Jellyfin FFmpeg 扩展
|
- 弹弹Play 官方、LogVar 弹幕 API、其他弹弹Play 兼容服务
|
||||||
- **mpv 引擎**:备用高兼容性引擎,基于 libmpv,支持更多编解码格式
|
- 按优先级有序故障回退,数据源严格隔离
|
||||||
- 播放失败时自动提供引擎切换建议,支持手动一键切换
|
- 自动匹配、手动搜索、本地弹幕、LRU 缓存
|
||||||
- 切换引擎时自动保持播放进度
|
- 三端支持(手机 / TV / Windows)
|
||||||
- 统一 User-Agent:`Entryway/{version} (android; {api})`
|
|
||||||
|
|
||||||
### ⏩ 播放控制
|
### 💿 实验性 DVD / Blu-ray ISO
|
||||||
- **倍速播放**:0.1x ~ 5.0x 滑动条 + 快速预设(0.5x / 1.0x / 1.5x / 2.0x / 3.0x)
|
- 未加密原盘本地与远程播放
|
||||||
- **长按快速倍速**:长按屏幕进入手动短时间高速播放
|
- 不支持时自动回退服务器转码
|
||||||
- **手势控制**:左右滑动快进快退、左侧上下滑动调亮度、右侧上下滑动调音量
|
|
||||||
- **画面比例**:循环切换适应/填充/16:9/4:3 等比例模式
|
|
||||||
- **锁屏**:锁定控制界面,防止误触
|
|
||||||
- **剧集导航**:上一集/下一集,播放列表(仅剧集)
|
|
||||||
|
|
||||||
### 🔧 mpv 引擎专属
|
### 📺 Android TV
|
||||||
- **解码模式切换**:SW(软解)/ HW(硬解)/ HW+(硬解+拷贝)一键循环切换
|
- 遥控器全键盘搜索、二维码手机输入
|
||||||
- 字体自动加载,支持字幕渲染
|
- 完整弹幕、扫码录入服务器、首页缓存兜底
|
||||||
|
|
||||||
### 🔊 高级音频
|
### 🪟 Windows
|
||||||
- Apple Spatial Audio 空间音频检测与启用
|
- Flutter + MediaKit (libmpv) + Rust 弹幕引擎
|
||||||
- HDR / Dolby Vision 能力检测与自动适配
|
- 多服务器、收藏、详情、跨服搜索、离线下载
|
||||||
|
- Chromecast/DLNA 投屏、Inno Setup 安装器
|
||||||
|
|
||||||
### 🎨 全局主题系统
|
### 🎨 设计与国际化
|
||||||
- 支持 **跟随系统** / **浅色** / **深色** 三种主题模式
|
- 空间化 / 玻璃态视觉语言,Material 3 动态配色
|
||||||
- 基于 Material 3 动态配色方案
|
- 完整中文(简体/繁体)和英文本地化
|
||||||
|
|
||||||
### 🌐 完整国际化
|
|
||||||
- 界面支持中文(简体/繁体)和英文
|
|
||||||
- 50+ 影视类型名称客户端翻译
|
|
||||||
- 根据系统语言自动切换
|
|
||||||
|
|
||||||
### 📥 离线下载
|
### 📥 离线下载
|
||||||
- 队列化下载管理,支持暂停/恢复/取消
|
- 队列化管理,批量下载,存储空间预估
|
||||||
- 季度/剧集批量下载,下载前显示存储空间预估
|
- 无网络时自动切换离线内容模式
|
||||||
- 无网络时自动切换到离线内容模式
|
|
||||||
|
|
||||||
## 技术栈 | Tech Stack
|
## 平台要求 | Requirements
|
||||||
|
|
||||||
| 类别 | 技术 |
|
| 平台 | 最低要求 |
|
||||||
|------|------|
|
| --- | --- |
|
||||||
| **语言** | Kotlin 2.0, Coroutines, Flow |
|
| Android 手机版 | Android 8.1 (API 27) |
|
||||||
| **UI** | Jetpack Compose + Material 3 + Navigation Compose |
|
| Android TV 版 | Android 8.1 (API 27) |
|
||||||
| **网络** | Retrofit 3 + OkHttp 5 |
|
| Windows | Windows 10 x64 |
|
||||||
| **图片** | Coil 3 |
|
|
||||||
| **播放器** | Media3 ExoPlayer + FFmpeg 扩展 / libmpv (双引擎) |
|
|
||||||
| **存储** | SharedPreferences + DataStore |
|
|
||||||
| **构建** | Gradle 9.4, AGP, KSP |
|
|
||||||
|
|
||||||
## 贡献 | 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 许可。
|
||||||
|
|||||||
+35
-24
@@ -1,36 +1,47 @@
|
|||||||
# Entryway Mobile 0.18.0 / TV 0.16.1 / Windows 0.15.0+34
|
# Entryway v0.23.0
|
||||||
|
|
||||||
本次批次为 Android 手机、Android TV 与 Windows 三端同批发布。各端应用版本不同,全局标签 `v0.18.0` 仅为本批次 ID。
|
本批次为 Android 手机版弹幕曲线和全屏显示更新,采用 Debug 持续发布规则;Android TV 和 Windows 无代码变化,沿用已验证安装包。各端应用版本独立维护:Mobile `0.23.0`、TV `0.18.1`、Windows `0.18.0+37`。
|
||||||
|
|
||||||
## 版本与校验
|
> 本批次是持续发布用的 **Debug 版本**,不是正式 Release 版本。正式版将在用户明确确认后单独构建和发布。
|
||||||
|
|
||||||
| 平台 | 应用版本 | 构建号 | 文件名 | SHA-256 |
|
## 版本信息
|
||||||
| --- | --- | --- | --- | --- |
|
|
||||||
| Android Mobile | 0.18.0 | 37 | entryway-release-0.18.0.apk | `e3c1813d37aebee4612db0436e22a8894236e0d04dcb9e787a9b8f11b39e07fd` |
|
|
||||||
| Android TV | 0.16.1 | 36 | Entryway-tv-release-0.16.1.apk | `8bb5d9a2787755469af3cc66839c32be318035d353f22a66620798026ba6953c` |
|
|
||||||
| Windows x64 | 0.15.0 | 34 | Entryway_0.15.0+34_Windows_x64_Setup.exe | `e9e45536fe981d117f8f261fe82a4e1fbd5b01a1ff515dfdc110253b8992f21b` |
|
|
||||||
|
|
||||||
> Windows 安装包为**未签名**产物,首次运行可能触发 SmartScreen 提示,需手动确认。
|
| 平台 | 应用版本 | 构建号 | 安装包 | SHA-256 |
|
||||||
|
| --- | --- | ---: | --- | --- |
|
||||||
|
| Android 手机版 | 0.23.0 | 44 | `entryway-debug-0.23.0.apk` | `3348b2b4de53e8bf3d14e5a154ee774cbc7db37cd5a9a57c0cfd8a47f31dd523` |
|
||||||
|
| Android TV 版 | 0.18.1 | 39 | `Entryway-tv-debug-0.18.1.apk`(沿用 `v0.22.0`) | `f9a7ef9f71a92df4c0469e75c1e36863062631a9735da417b7b237d54b97e4ba` |
|
||||||
|
| Windows x64 | 0.18.0 | 37 | `Entryway_0.18.0+37_Windows_x64_Setup.exe`(沿用 `v0.22.0`) | `b744a11a186350461dc6b4143df1fd5ee833bcc0ae1df6bff4339e1824333477` |
|
||||||
|
|
||||||
## Android Mobile 0.18.0
|
## Android 手机版 0.23.0
|
||||||
|
|
||||||
- 详情页多版本影片可选择要播放的版本,选择贯穿播放全链路(Emby / Jellyfin 均生效)。
|
### 弹幕曲线样式
|
||||||
- 音轨/字幕弹窗内可按文件调节音频延迟和字幕延迟,按媒体项持久化。
|
|
||||||
- 带样式 ASS 字幕在 ExoPlayer 下提示样式降级,并提供「覆盖字幕自带样式」开关;PGS/VOBSUB 图形字幕单独提示。
|
|
||||||
- 完整简体中文 / 英文本地化;语言切换改用应用自有存储,切换即时生效。
|
|
||||||
- 修复登录页浅色模式文字不可见;修复字幕样式设置需重开播放器才生效;去除详情页海报毛玻璃。
|
|
||||||
|
|
||||||
## Android TV 0.16.1
|
- 弹幕设置新增“弹幕曲线样式”开关。
|
||||||
|
- 关闭时使用平滑曲线,适合观察整段视频的弹幕密度趋势。
|
||||||
|
- 开启时使用峰谷曲线,以更细的时间采样和折线表现突出弹幕密集时刻与剧情高潮。
|
||||||
|
|
||||||
- 详情页对含多个版本的影片显示版本切换按钮,所选版本贯穿播放链路。
|
### 全屏弹幕显示
|
||||||
- 注:本版 TV 多版本选择尚未在电视端真机充分验证。
|
|
||||||
|
|
||||||
## Windows 0.15.0
|
- 修复播放器隐藏控制栏进入全屏后,第一行弹幕被顶部区域遮挡的问题。
|
||||||
|
- 控制栏显示时继续保留完整避让距离;控制栏隐藏时仅保留必要顶部安全区,减少画面上方空白。
|
||||||
|
|
||||||
- 首页各分区新增“查看全部”浏览页。
|
## Android TV 0.18.1
|
||||||
- 更新检测与安装策略完善。
|
|
||||||
|
|
||||||
## 已知问题
|
- 本批次无代码变化,沿用 `v0.22.0` 的 Debug 安装包。
|
||||||
|
|
||||||
- 图形字幕(PGS/VOBSUB)在 ExoPlayer 下颜色不可调,属播放器框架限制,可切换 mpv 内核。
|
## Windows x64 0.18.0+37
|
||||||
- Windows 安装包未签名。
|
|
||||||
|
- 本批次无代码变化,沿用 `v0.22.0` 的 Debug 安装包。
|
||||||
|
- 安装包未进行代码签名,SmartScreen 可能显示未知发布者提示。
|
||||||
|
|
||||||
|
## 兼容性
|
||||||
|
|
||||||
|
- Android 手机和 TV:Android 8.1(API 27)及以上。
|
||||||
|
- Windows:Windows 10 或更高版本,x64。
|
||||||
|
- Android 安装包使用项目 1.0 前的 Debug 变体和证书签名,Windows 安装包未签名。
|
||||||
|
|
||||||
|
## 构建信息
|
||||||
|
|
||||||
|
- 源码提交:`8d6778b42b7a5f351921248d3a3debde99142aad`
|
||||||
|
- 源码标签:`v0.23.0`
|
||||||
|
- 自动验证:`:app:assembleDebug`、官网静态页 65 项测试
|
||||||
|
|||||||
Reference in New Issue
Block a user