適用於 Android TV 與手機的影音應用程式,整合媒體瀏覽與播放體驗,並支援外部配置與 CatVod Spider 介面擴充。
App 本身不內建或提供任何內容來源。 外部內容需自行配置,也可開啟本地媒體檔案或推送媒體網址。
- 安裝適合裝置的 APK:
leanback為電視版,mobile為手機版;依 Android 系統支援的 ABI 選擇arm64-v8a或armeabi-v7a。最低需求為 Android 7.0(API 24)。 - 在設定中加入自己的配置,格式與欄位見配置範例。
- 也可從系統檔案管理員開啟媒體檔案,或透過推送入口播放媒體網址。
- 播放: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。
先準備以下環境與檔案:
- 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:assembleMobileReleaseAPK 按 ABI 分包並輸出至 Release/apk/。簽章不同的 APK 不能直接覆蓋既有安裝。網站位於 website/,可獨立建置,不需編譯 Android App。