影視TV

適用於 Android TV 與手機的影音應用程式，整合媒體瀏覽與播放體驗，並支援外部配置與 CatVod Spider 介面擴充。

App 本身不內建或提供任何內容來源。 外部內容需自行配置，也可開啟本地媒體檔案或推送媒體網址。

使用與開發指南 · 討論群組

開始使用

1. 安裝適合裝置的 APK：leanback 為電視版，mobile 為手機版；依 Android 系統支援的 ABI 選擇 arm64-v8a 或 armeabi-v7a。最低需求為 Android 7.0（API 24）。 2. 在設定中加入自己的配置，格式與欄位見配置範例。 3. 也可從系統檔案管理員開啟媒體檔案，或透過推送入口播放媒體網址。

主要功能

• 播放：Media3／ExoPlayer、mpv、硬解與 FFmpeg 軟解；字幕、彈幕、音軌、倍速與片頭／片尾跳過。
• 瀏覽與管理：分類篩選、搜尋、播放記錄、收藏與無痕模式。
• 播放清單：M3U／TXT／JSON 格式、清單分組與 XMLTV 節目資訊。
• 操作：電視遙控器、手機手勢、畫中畫與背景音訊。
• 互通：DLNA 投放／接收、Android Auto、本地 HTTP 控制與裝置同步。

實際能力依配置、媒體、播放引擎與裝置而異；本地 HTTP API 僅供可信任區域網路使用，不要直接轉發到公網。

開發文件

| 文件 | 內容 | | --- | --- | | App 功能 | 操作與功能介紹 | | 配置字典 | 配置欄位、網路設定與 JSON 範例 | | 擴充介接 | Java／Python／JavaScript 範例、方法與回傳格式 | | 本地 API | 播放控制、推送、檔案與同步端點 | | 網站維護 | 靜態網站建置與 GitHub Pages 發布 |

app/src/main/ 為共用邏輯，app/src/leanback/、app/src/mobile/ 為各自的 UI。模組清單見 settings.gradle，SDK 與依賴版本見 libs.versions.toml。

Windows 建置

先準備以下環境與檔案：

• JDK 21、Android SDK、Python 3.10。SDK 平台版本依 compileSdk 設定；Python 可用 py -3.10 --version 確認，找不到時在 chaquo/build.gradle 的 Python 區塊設定 buildPython。
• 配套 AAR：放入 app/libs/。lib-*.aar 未納入 Git，單純 clone 不包含完整播放器依賴。
• 自己的簽章檔與 local.properties：在儲存庫根目錄建立下列設定，將所有範例值替換成自己的資料。

sdk.dir=C:/Android/Sdk
storeFile=C:/keys/yingshi-tv.jks
keyAlias=your-key-alias
storePassword=your-keystore-password

金鑰密碼與 keystore 密碼共用 storePassword；不要提交簽章檔或真實密碼。

在儲存庫根目錄以 PowerShell 執行：

# 電視版
.\gradlew.bat :app:assembleLeanbackRelease
手機版
.\gradlew.bat :app:assembleMobileRelease

APK 按 ABI 分包並輸出至 Release/apk/。簽章不同的 APK 不能直接覆蓋既有安裝。網站位於 website/，可獨立建置，不需編譯 Android App。

Star History