my-tv 電視直播應(yīng)用上手遙控器換臺、數(shù)字選臺到 EPG5 分鐘裝好就能看【免費(fèi)下載鏈接】my-tv我的電視 電視直播軟件安裝即可使用項(xiàng)目地址: https://gitcode.com/GitHub_Trending/my/my-tv家里的智能電視裝了十幾個(gè)視頻 App想直接看個(gè)直播卻總被會(huì)員頁和廣告攔住。my-tv 是一個(gè) Android 電視直播應(yīng)用定位就一句話安裝即可使用——裝上 APK遙控器上下鍵換臺、數(shù)字鍵直選頻道央視和地方衛(wèi)視的直播流和節(jié)目單全部內(nèi)置在應(yīng)用里不需要注冊、不需要登錄。這篇文章從你按下遙控器第一個(gè)鍵開始講清楚它是怎么工作的頻道表怎么組織、播放地址怎么拿到、按鍵怎么映射以及遇到黑屏、看不了某臺時(shí)該怎么排查。從一次換臺開始應(yīng)用啟動(dòng)后發(fā)生了什么打開 App 后你會(huì)看到直播畫面同時(shí)左上角有頻道信息條、右上角有時(shí)間。按一次上/下就換臺按數(shù)字鍵直接跳到對應(yīng)頻道這個(gè)體驗(yàn)背后是一條固定的啟動(dòng)鏈路MainActivity把 6 個(gè) Fragment 全部add進(jìn)同一個(gè)容器初始只顯示播放器其余隱藏見 MainActivity.kt 的onCreateMainFragment基于 Leanback 的BrowseSupportFragment加載頻道列表Leanback 是 Android TV 官方的大屏交互庫提供焦點(diǎn)管理和卡片列表每個(gè)頻道對應(yīng)一個(gè)TVViewModel負(fù)責(zé)該頻道的播放地址、EPG電子節(jié)目單和重試計(jì)數(shù)ready 6時(shí)判定啟動(dòng)就緒界面才允許換臺這個(gè)播放器常開、其余界面浮層的結(jié)構(gòu)是換臺不黑屏的關(guān)鍵切臺只是換 URL播放器實(shí)例不銷毀。頻道表怎么組織一條數(shù)據(jù)決定一臺臺所有頻道定義在 TVList.kt 里按央視 / 地方 / 港澳臺 / 國際四組懶加載。每個(gè)頻道是一條TV數(shù)據(jù)字段不多但各管一攤TV( 0, CCTV1 綜合, CCTV1, listOf(), 央視, ...webp, // logo 600001859, // pid換播放地址用 2022576801, // sid拉節(jié)目單用 ProgramType.Y_PROTO, false, // needToken mustToken false )三個(gè)字段值得記住pid / sid上游接口的節(jié)目身份證播放和 EPG 都靠它們programTypeY_PROTO/Y_JCE/F決定走哪套取流協(xié)議不同頻道的接口結(jié)構(gòu)不一樣needToken / mustToken該頻道是否需要先換令牌再取地址、令牌失效時(shí)能否降級重試構(gòu)建列表時(shí)會(huì)給每個(gè)頻道分配全局連續(xù)id從 0 開始——這就是你按1能選到第 1 臺的依據(jù)。改頻道順序或增刪臺只動(dòng)這一個(gè)文件即可。關(guān)鍵實(shí)現(xiàn)逐條拆1. 遙控器按鍵全映射兼容各家遙控器不同電視廠商遙控器上菜單鍵的 keyCode 不一樣。項(xiàng)目在 MainActivity.kt 的onKeyDown里把 6 個(gè)可能值全部指向同一個(gè)動(dòng)作保證任何盒子都能打開設(shè)置when (keyCode) { KeyEvent.KEYCODE_0 - showChannel(0) // 數(shù)字鍵直選臺 KeyEvent.KEYCODE_DPAD_UP - channelUp() // 上鍵換上一臺 KeyEvent.KEYCODE_DPAD_DOWN - channelDown() // 下鍵換下一臺 KeyEvent.KEYCODE_DPAD_LEFT - switchMainFragment() // 左鍵頻道列表 KeyEvent.KEYCODE_DPAD_RIGHT - showSetting() // 右鍵設(shè)置 KeyEvent.KEYCODE_BACK - back() // 連按兩次退出 }BOOKMARK、HELP、SETTINGS、MENU、UNKNOWN也都映射到showSetting()——這是很多菜單鍵無效投訴的通用解法。返回值用你電視原裝遙控器實(shí)測左、右、上、下四鍵應(yīng)該分別對應(yīng)列表、設(shè)置、上下?lián)Q臺。2. 播放地址是先換令牌再取流失敗自動(dòng)重試直播地址不能硬編碼每次都要向服務(wù)端換取。Request.kt 里的流程是fetchAuth換 token →fetchVideo取 playurl再從中解析出加密參數(shù)拼出最終 URL。每個(gè)環(huán)節(jié)失敗都會(huì)累加retryTimes上限 8 次retryMaxTimes 8定義在 TVViewModel.kt令牌類失敗走獨(dú)立的tokenYSPRetryTimes計(jì)數(shù)耗盡后對mustTokenfalse的頻道降級為無令牌請求。拿到地址后還有一個(gè)容易被忽略的細(xì)節(jié)BtraceRunnable每60 秒發(fā)一次心跳上報(bào)handler.postDelayed(btraceRunnable, 60 * 1000)用于維持地址有效性。你長時(shí)間看同一個(gè)臺不卡靠的就是這個(gè)后臺循環(huán)。3. 播放器強(qiáng)制 16:9盒子機(jī)型有降級方案PlayerFragment.kt 里寫死了aspectRatio 16f / 9f視頻尺寸回調(diào)時(shí)如果屏幕寬高比與 16:9 不符就按短邊收縮播放器尺寸避免在 16:10 面板的電視上畫面被拉變形v1.2.8 就是專門兼容這類分辨率的。另外它做了雙播放器默認(rèn)用 media3 的ExoPlayer檢測到天貓魔盒Utils.isTmallDevice()則切換到SurfaceView SimpleExoPlayer老方案——這是針對個(gè)別盒子硬解異常的兜底。播放出錯(cuò)時(shí)回調(diào)tvViewModel.changed()會(huì)觸發(fā)重新取地址而不是讓你盯著黑屏。4. 界面 10 秒自動(dòng)隱藏頻道記憶存本地?fù)Q臺時(shí)彈出的信息條、頻道列表10 秒不操作就自動(dòng)收起delayHideMain 10000見MainActivity設(shè)置頁同理。退出前你在哪一臺下次啟動(dòng)回到哪一臺靠的是 SP.kt 里的itemPositionSharedPreferences 存取無需網(wǎng)絡(luò)。設(shè)置頁還提供換臺方向反轉(zhuǎn)channelReversal上鍵下一臺的習(xí)慣也能適應(yīng)。5. 頻道列表是 Leanback 的行列結(jié)構(gòu)MainFragment把四組頻道裝進(jìn)ArrayObjectAdapter的ListRow支持網(wǎng)格 / 行兩種樣式切換SP.grid重啟后生效見 TVListViewModel.kt 的數(shù)據(jù)供給。列表樣式只影響瀏覽體驗(yàn)不影響換臺鏈路。常見坑與對策打開黑屏或提示狀態(tài)錯(cuò)誤現(xiàn)象啟動(dòng)后畫面一直黑著或彈出狀態(tài)錯(cuò)誤原因這類取流接口對時(shí)間敏感設(shè)備系統(tǒng)時(shí)間不準(zhǔn)很多盒子常年不走 NTP會(huì)直接讓鑒權(quán)失敗。v1.5.6 更新日志里就專門修了系統(tǒng)時(shí)間不對導(dǎo)致播放失敗處理進(jìn)設(shè)置頁右鍵點(diǎn)恢復(fù)默認(rèn)它會(huì)同步系統(tǒng)時(shí)間或在電視系統(tǒng)設(shè)置里先校準(zhǔn)時(shí)間再打開 App某些臺提示應(yīng)版權(quán)方要求暫停提供直播信號現(xiàn)象個(gè)別頻道不重試直接彈錯(cuò)誤文案原因服務(wù)端返回了明確的errinfoRequest.kt 里對該文案做了特判走setErrInfo而不是重試——這是上游信號停了不是你的網(wǎng)絡(luò)問題處理換臺即可這類提示別反復(fù)刷等待上游恢復(fù)換臺后頻道號 / 列表一直擋在屏幕上現(xiàn)象切完臺信息條不消失原因自動(dòng)隱藏任務(wù)被某些按鍵路徑打斷v1.5.2 / v1.5.5 修過同類問題處理按一次返回鍵back()會(huì)優(yōu)先執(zhí)行隱藏當(dāng)前浮層而不是退出或升級最新版電視裝不了或重啟后不自動(dòng)打開現(xiàn)象應(yīng)用商店里找不到U 盤安裝失敗部分盒子重啟后需手動(dòng)點(diǎn)開原因電視沒有開放應(yīng)用商店安裝源自動(dòng)開機(jī)依賴系統(tǒng)對BootReceiver的放行README 里記錄了斐訊 N1Android 7.1.2無法自啟處理優(yōu)先 U 盤安裝小米電視可用小米電視助手裝電視開了 ADB 的話執(zhí)行adb install my-tv.apk自啟失敗就設(shè)電視開機(jī)自啟應(yīng)用上手清單按順序做一遍每步 1 分鐘下載最新版 APK從項(xiàng)目發(fā)布頁獲取U 盤拷入電視存儲用文件管理器安裝或adb install my-tv.apk打開 App確認(rèn)畫面出流、左上角有頻道信息按上 / 下鍵換臺按數(shù)字鍵 1~9 驗(yàn)證直選按左鍵出頻道列表右鍵進(jìn)設(shè)置在設(shè)置里按需打開頻道號顯示、時(shí)間顯示、開機(jī)自啟、換臺方向反轉(zhuǎn)看不了某臺時(shí)先右鍵進(jìn)設(shè)置點(diǎn)恢復(fù)默認(rèn)同步時(shí)間再試一次驗(yàn)證退出連按兩次返回鍵第二次才會(huì)真正退出全部通過后這臺電視就多了一個(gè) 5 個(gè)鍵就能看完所有直播的入口。延伸資源與小結(jié)安裝方式和已知設(shè)備問題README.mdTODO 里列了音量調(diào)節(jié)、軟解等計(jì)劃中功能每個(gè)版本的修復(fù)記錄HISTORY.md排障前先查這里往往能對上號頻道數(shù)據(jù)TVList.kt取流與重試Request.kt界面骨架MainFragment.kt、PlayerFragment.kt小結(jié)my-tv 把看電視壓縮成了一條很短的鏈路——本地頻道表定臺、令牌換流帶 8 次重試、播放器強(qiáng)制 16:9 常開、按鍵全映射。它解決的不是功能多少而是把打開就能看做到位。想繼續(xù)深入建議順著TVViewModel的 LiveDatavideoUrl/ready/change三個(gè)信號讀完一次完整換臺的數(shù)據(jù)流向那是這個(gè)應(yīng)用最核心的一段代碼?！久赓M(fèi)下載鏈接】my-tv我的電視 電視直播軟件安裝即可使用項(xiàng)目地址: https://gitcode.com/GitHub_Trending/my/my-tv創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考