AerioTV：Android IPTV 直播播放器

项目简介

AerioTV for Android 是一款原生 IPTV 流媒体应用，基于单一 Jetpack Compose 代码库构建，可运行在 Android 手机、平板以及 Google TV / Android TV 上。它可以连接 Dispatcharr（管理员登录或 API key）、Xtream Codes 和 M3U 播放列表服务器，用来观看直播电视、电影与剧集，并在用户提供数据时显示完整的电子节目单（EPG）。

同一家族的还有 AerioTV for Apple（iPhone、iPad、Apple TV、Mac）与社区移植的 AerioTV for Roku；Apple 与 Android 版本共享同一套设计与功能，并可互相投屏。

主要功能

直播与节目单

• 基于 Media3 / ExoPlayer 的硬件加速播放（HLS、DASH、渐进式流，支持 HEVC HDR 硬解）
• 列表视图与完整 EPG 网格（TV / 平板为网格，手机可在 List / Guide 间切换）
• 按频道号、名称或收藏排序，可拖动调整收藏顺序，按分组管理可见性
• 长按即将播出的节目可设置提醒或安排录制，提醒以应用内横幅和通知形式触发
• EPG 时间窗可在 6 小时到完整可用窗口之间配置，支持缩放与「跳到当前」

Multiview 多画面

• 最多同时观看 9 路直播频道，布局随画面数量自适应（1 到 3x3）
• 仅最近加入的流播放声音，点按磁贴切换音频焦点；单磁贴菜单支持设为音频、全屏、音轨、字幕、移除
• 拖动重排、双击全屏；内置温度监控、软上限与低内存处理等资源保护

DVR 录制

• 可从直播节目单安排直播或即将播出的节目
• Dispatcharr 服务端录制即使关闭 AerioTV 也会继续；本地录制支持 Dispatcharr、Xtream Codes 与 M3U
• 每次录制可设置前录 / 后录缓冲（无、5、10、15、30、60 分钟或自定义）
• Dispatcharr 上可运行服务端 Comskip 去广告；DVR 标签页自动出现并分为已安排 / 录制中 / 已完成

电影与剧集

• 按分类浏览与筛选点播内容；Dispatcharr 上提供 TMDB 元数据（背景图、剧情、演员、导演、年份、评分、时长及分集信息）
• Continue Watching 续播电影与剧集，剧集自动播放下一集；开启 Google Drive 同步后进度跨设备同步
• 大型媒体库支持完整分页，详情缓存让二次打开更快

播放器

• 音轨与字幕轨道选择、点播内容 0.5x–2x 倍速、睡眠定时、Audio Only 模式、画中画、宽高比控制
• Stream Info 浮层实时显示编解码器、分辨率、帧率、解码方式（硬解 / 软解）、丢帧与音频信息
• 手机滑动、Android TV 按 D-pad 上下键可切换频道；支持显示刷新率匹配
• MediaStyle 媒体通知（带频道台标），支持锁屏与蓝牙控制及后台音频

投屏

• 手机可将直播频道投到网络中的 Google Cast 接收器
• 若电视上安装了 AerioTV，投屏会由 TV 端应用自行拉流，原声（含 AC-3 环绕）直通、满帧率
• 其他 Cast 接收器则由手机作为媒体源，以 HLS 分发；音频不做转码，若接收器无法解码对应音频格式，AerioTV 会拒绝投屏并说明原因

Google Drive 同步（可选）

• 服务器配置、偏好设置、点播进度、EPG 提醒、收藏及顺序、隐藏分组与主题色，可通过私有 Google Drive AppData 目录同步；不登录 Google 账号也能完整使用

Android TV 与大屏

• 完整的 D-pad 焦点导航（类似 tvOS 的焦点卡片与缩放）
• mini-player 在浏览节目单或设置时保持当前流播放
• LAN / WAN 切换：保存家庭 Wi-Fi 与每个播放列表的 LAN 地址，在家走本地地址、外出走远程地址
• 手机、平板与折叠屏适配，提供 mini-player、手势与自适应布局

安装与使用

• Google Play：目前处于封闭测试阶段，仅限邀请。
• 侧载：从 Releases 下载最新 .apk 安装（需为浏览器或文件管理器开启「允许安装未知来源应用」），或使用 adb install。侧载版本有时会领先于 Google Play 渠道。

安装后在应用内添加 Dispatcharr（管理员用户名密码或 API key）、Xtream Codes 或 M3U 播放列表即可开始使用；播放列表与 EPG 数据由用户自行提供。

注意事项

• 项目使用 GPL-3.0 许可证。
• 投屏到非 AerioTV 的 Cast 接收器时，手机是媒体源，必须与接收器处于同一网络；接收器 Wi-Fi 较弱（例如 Chromecast Ultra 使用 2.4 GHz）可能导致高码率频道缓冲，建议使用 5 GHz。
• Google Drive 同步为可选功能，不开启不影响任何核心功能。
• README 中的截图标注为「即将推出」。

---

本作品整理自 GitHub 开源项目 jonzey231/AerioTV-Android，原作者 @jonzey231，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。