簡(jiǎn)介這份《新駱駝IPTV完美版后端源碼 APP源碼》面向安卓手機(jī)與電視盒子端的電視直播應(yīng)用開發(fā)者提供前后端完整代碼參考便于理解IPTV系統(tǒng)結(jié)構(gòu)并進(jìn)行二次開發(fā)或功能定制。壓縮包體積約21.72MB文件總數(shù)登記為0、類型明細(xì)暫未提供但從標(biāo)題與描述可確認(rèn)主體為后端服務(wù)源碼與安卓APP源碼兩部分涉及頻道與播放列表接口、數(shù)據(jù)庫存儲(chǔ)、認(rèn)證授權(quán)、流媒體分發(fā)以及客戶端界面、播放器集成、網(wǎng)絡(luò)請(qǐng)求和遙控器適配等模塊。已有約4600人學(xué)習(xí)下載具備一定參考熱度。讀者可據(jù)此梳理IPTV源接入到客戶端播放的調(diào)用鏈路學(xué)習(xí)RESTful API設(shè)計(jì)、用戶權(quán)限控制、視頻流協(xié)議與播放緩沖處理后端側(cè)可參考服務(wù)器請(qǐng)求處理、頻道數(shù)據(jù)組織與流媒體服務(wù)配置前端側(cè)可關(guān)注播放器緩沖策略、JSON數(shù)據(jù)解析與遙控器焦點(diǎn)控制適合具備安卓或后端基礎(chǔ)、希望搭建電視直播平臺(tái)的中級(jí)開發(fā)者查閱。1. 一套 IPTV 雙端源碼省掉的是什么從源管理到客戶端起播的最小閉環(huán)某園區(qū)要做一面內(nèi)部電視墻采購按點(diǎn)位報(bào)價(jià)算下來不如自己搭一套。這類需求最后大多落到同一個(gè)東西上一套 IPTV 雙端源碼后端 APP。后端負(fù)責(zé)把 iptv 源也就是 m3u / m3u8 播放列表收進(jìn)來做分類、去重、排序?qū)ν庵槐┞兜卿?、頻道列表、取播放地址、節(jié)目單四五個(gè)接口APP 端拿列表渲染成頻道格子點(diǎn)進(jìn)去直接起播。這套包真正省時(shí)間的地方不在于播放器寫得多漂亮而在于「源 → 頻道 → 客戶端」這條鏈路的骨架已經(jīng)搭好了數(shù)據(jù)庫表、接口字段、鑒權(quán)頭都是通的你只需要往里填自己的源和自己想要的界面。適合想自建可控直播/點(diǎn)播系統(tǒng)、想研究雙端接口對(duì)接、手里有現(xiàn)成播放源要管的開發(fā)者不適合只想雙擊裝個(gè) App 就能看的人那類需求用現(xiàn)成播放器就夠了。2. 拆包先認(rèn)三層后端目錄、APP 工程與數(shù)據(jù)庫核心表壓縮包解開之后別急著找啟動(dòng)腳本。這類「后端 APP」的雙端包結(jié)構(gòu)通常分成三個(gè)互相獨(dú)立的部分認(rèn)清楚哪層歸哪層后面改代碼才不至于在后端目錄里找 Android 的布局文件。我拿到一個(gè)新包的習(xí)慣是先把頂層目錄列一遍再用文件大小排個(gè)序看看有沒有明顯的「大頭」——通常那個(gè)大頭就是后臺(tái)管理前端或者播放器 SDK。2.1 后端目錄入口文件、應(yīng)用層與擴(kuò)展層后端絕大多數(shù)是 PHP 系ThinkPHP 5.x 或 Laravel 風(fēng)格或者 Spring Boot看根目錄有沒有composer.json、pom.xml、artisan、think這幾個(gè)文件就能判斷。PHP 包的典型目錄長(zhǎng)這樣你的包里名字可能略有出入但分層邏輯一致backend/ ├── public/ # Web 根目錄index.php 是唯一入口 ├── application/ # 應(yīng)用層api 模塊、admin 模塊分開 │ ├── api/ # 給 APP 用的接口 │ │ ├── controller/ # 控制器Channel.php、User.php、Epg.php │ │ ├── service/ # 業(yè)務(wù)層SourceService、SignService │ │ └── middleware/ # AuthToken.php 鑒權(quán)中間件 │ └── admin/ # 后臺(tái)管理加頻道、導(dǎo)源、看設(shè)備 ├── config/ # 數(shù)據(jù)庫、緩存、簽名密鑰 ├── extend/ # 第三方擴(kuò)展播放器 SDK、m3u 解析庫常在這 ├── runtime/ # 緩存和日志注意要可寫 └── .env # 數(shù)據(jù)庫四件套跑之前必改這里有個(gè)容易看漏的點(diǎn)application/api和application/admin是兩套控制器共用同一批 model。很多新手改接口改到admin目錄下的方法去了結(jié)果 APP 行為紋絲不動(dòng)查半天以為是緩存問題。判斷方法很簡(jiǎn)單看路由文件里api/v1這個(gè)分組綁的是哪個(gè)模塊。另外extend/里常常塞了去廣告、源探測(cè)之類的腳本二次開發(fā)前先掃一眼不用的刪掉能少一堆依賴沖突。2.2 APP 工程Android 模塊劃分與播放器依賴APP 端以 Android 原生 Java/Kotlin 工程居多也有 uni-app 或 Flutter 的殼。原生工程看settings.gradle里 include 了幾個(gè)模塊常見的拆法是app主殼player播放器封裝common網(wǎng)絡(luò)、工具。播放器依賴是重點(diǎn)看build.gradle里引的是 ExoPlayer、ijkplayer 還是系統(tǒng) MediaPlayerdependencies { // 版本以你包里的 gradle 為準(zhǔn)別照抄先看本地緩存有沒有 implementation com.google.android.exoplayer:exoplayer-core:2.19.1 implementation com.google.android.exoplayer:exoplayer-hls:2.19.1 // 播 m3u8 必須有 implementation com.google.android.exoplayer:exoplayer-ui:2.19.1 implementation com.github.bumptech.glide:glide:4.16.0 implementation com.squareup.okhttp3:okhttp:4.11.0 }exoplayer-core只負(fù)責(zé)容器和音視頻軌m3u8 的切片解析在exoplayer-hls這個(gè)獨(dú)立擴(kuò)展里。見過不少人只引 core起播轉(zhuǎn)圈到超時(shí)日志里報(bào)UnrecognizedInputFormatException其實(shí)就是少這一行。Glide 用來加載頻道臺(tái)標(biāo)很多包為了省體積自己寫了個(gè)圖片緩存效果一般換成 Glide 是常見改造點(diǎn)。OkHttp 一般被包在common模塊的網(wǎng)絡(luò)封裝里留意它有沒有做統(tǒng)一加 headertoken 通常在那注入。2.3 數(shù)據(jù)庫三張表頻道、源、用戶設(shè)備數(shù)據(jù)庫結(jié)構(gòu)決定你后面改功能順不順手。這類項(xiàng)目核心表其實(shí)就三張頻道表、源表、用戶設(shè)備表。源表存著 m3u 解析后的原始地址頻道表通過source_id引用源這樣一個(gè)頻道可以掛主備兩條源CREATE TABLE iptv_channel ( id int unsigned NOT NULL AUTO_INCREMENT, name varchar(64) NOT NULL COMMENT 頻道名對(duì)應(yīng) m3u 里的 tvg-name, group_id int unsigned NOT NULL DEFAULT 0 COMMENT 分類 id, logo varchar(255) NOT NULL DEFAULT , source_id int unsigned NOT NULL DEFAULT 0 COMMENT 主用源, backup_source_id int unsigned NOT NULL DEFAULT 0 COMMENT 備用源主源超時(shí)切這條, sort int NOT NULL DEFAULT 0, status tinyint NOT NULL DEFAULT 1 COMMENT 1 上架 0 下架, PRIMARY KEY (id), KEY idx_group (group_id, status, sort) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;idx_group這個(gè)聯(lián)合索引是列表接口的性能命門。APP 首頁一次請(qǐng)求就是「按分類取上架頻道按 sort 排」沒這個(gè)索引幾百個(gè)頻道加幾千條源首次加載能拖到兩三秒。backup_source_id這個(gè)字段很多粗糙的包干脆沒有只有一條源源一掛頻道就廢。如果你的包里缺這個(gè)字段加字段 在取地址邏輯里做降級(jí)是性價(jià)比最高的一個(gè)改造具體寫法在第 3 章。2.4 環(huán)境清單與啟動(dòng)命令跑之前先對(duì)齊版本環(huán)境這件事別嫌啰嗦PHP 7.4 的包丟到 PHP 8.2 上跑each()、動(dòng)態(tài)屬性這些老寫法會(huì)直接白屏。先看composer.json里的require段和README或部署說明把 PHP 版本、MySQL 版本對(duì)上。常見組合是 PHP 7.4 / MySQL 5.7 / Redis 5Redis 不是必須的但列表緩存基本都靠它沒有的話要把緩存配置改成 file。# 1. 裝依賴不要帶 dev能少一半體積 cd backend composer install --no-dev # 2. 復(fù)制配置并修改數(shù)據(jù)庫連接 cp .env.example .env # 編輯器打開 .env改 DB_HOST / DB_DATABASE / DB_USERNAME / DB_PASSWORD # 3. 導(dǎo)入表結(jié)構(gòu)和初始數(shù)據(jù) mysql -u root -p your_db database/install.sql # 4. 起服務(wù)0.0.0.0 是為了讓手機(jī)能連進(jìn)來 php think run -H 0.0.0.0 -p 8000Laravel 風(fēng)格的包把第 3、4 步換成php artisan migrate和php artisan serve --host0.0.0.0 --port8000。-H 0.0.0.0這參數(shù)特別關(guān)鍵默認(rèn)只監(jiān)聽127.0.0.1模擬器能通、真機(jī)一定連不上這個(gè)坑后面還會(huì)提。runtime/或storage/目錄記得給寫權(quán)限不然日志寫不進(jìn)去報(bào)錯(cuò)信息全丟排查的時(shí)候就是黑匣子。3. 后端鏈路一次頻道列表請(qǐng)求從鑒權(quán)到簽名的完整走法后端的活兒說到底就一句話把數(shù)據(jù)庫里的頻道變成客戶端能直接setMediaItem的地址。聽著簡(jiǎn)單中間有三道關(guān)——請(qǐng)求得先被放行源得被解析成結(jié)構(gòu)化數(shù)據(jù)地址還得帶上過期簽名防止被人抓包外傳。這三段串起來就是整個(gè)后端最值得看的部分。3.1 路由與 token 鑒權(quán)請(qǐng)求怎么被放行先把入口收斂。APP 端不需要知道你有多少控制器它只需要四五個(gè)固定路徑。路由文件通常長(zhǎng)這樣?php // route/route.php Route::group(api/v1, function () { Route::post(login, api/User/login); // 設(shè)備號(hào)/賬號(hào)換 token Route::get (channel, api/Channel/lists); // 分類 頻道列表 Route::get (channel/:id/play, api/Channel/play); // 取單個(gè)頻道的可播地址 Route::get (epg, api/Epg/today); // 當(dāng)日節(jié)目單 })-middleware(AuthToken); // 整組掛鑒權(quán)別一個(gè)個(gè)加把中間件掛在group上而不是單個(gè)路由上是為了防止以后加接口忘了加鑒權(quán)——這種事我見過不止一次新加一個(gè)channel/hot接口忘了掛被人掃到直接白嫖帶寬。鑒權(quán)本身通常不用查庫token 里自帶 uid、過期時(shí)間、簽名驗(yàn)簽就行?php namespace app\api\middleware; class AuthToken { public function handle($request, \Closure $next) { $token $request-header(X-Token, ); if ($token ) { return json([code 401, msg missing token], 401); } $parts explode(., base64_decode($token)); if (count($parts) ! 3) { return json([code 401, msg bad token], 401); } [$uid, $expire, $sign] $parts; // 用和登錄時(shí)相同的 key 重算簽名再做定長(zhǎng)比較 $expect hash_hmac(sha256, $uid . . . $expire, config(app.token_key)); if ((int)$expire time() || !hash_equals($expect, $sign)) { return json([code 401, msg token expired], 401); } $request-uid (int)$uid; // 往后傳給控制器 return $next($request); } }幾個(gè)參數(shù)說明一下。X-Token是自定義頭有的包用Authorization: Bearer改的時(shí)候兩邊要一起改后端改了 APP 沒改就是全量 401。$expire是絕對(duì)時(shí)間戳APP 端要處理 401 后重新登錄別把 token 寫死進(jìn)代碼。hash_equals而不是是為了防時(shí)序攻擊雖然這種項(xiàng)目一般沒人盯但寫上不費(fèi)事。簽名的 key 放config/app.php里別硬編碼在中間件換 key 的時(shí)候你會(huì)感謝自己。3.2 iptv 源聚合把 m3u 解析成客戶端直接能播的結(jié)構(gòu)這是整個(gè)后端最有含金量的部分。iptv 源一般是 m3u 文本格式是#EXTINF描述行加一行地址交替出現(xiàn)。解析器要能扛住各種不規(guī)范寫法描述行里可能帶tvg-name、group-title、tvg-logo也可能什么都沒有只有一個(gè)逗號(hào)后的名字?php namespace app\api\service; class SourceService { /** * 解析 m3u 文本返回 [頻道名 播放地址] * param string $raw m3u 文件全文 */ public function parseM3u(string $raw): array { $out []; $name ; foreach (preg_split(/\r\n|\r|\n/, $raw) as $line) { $line trim($line); if ($line ) { continue; } if (stripos($line, #EXTINF) 0) { // 優(yōu)先取 tvg-name沒有就取最后一個(gè)逗號(hào)之后的內(nèi)容 if (preg_match(/tvg-name([^]*)/i, $line, $m)) { $name trim($m[1]); } elseif (($pos strrpos($line, ,)) ! false) { $name trim(substr($line, $pos 1)); } continue; } if ($line[0] #) { continue; // #EXTVLCOPT 之類的附加指令直接跳過 } if ($name ! ) { $out[$name] $line; // 同名頻道后出現(xiàn)的覆蓋前面的 $name ; } } return $out; } }preg_split同時(shí)兼容\r\n和\n因?yàn)楹芏嘣词窃?Windows 上生成的。stripos(...) 0判斷行首用是因?yàn)閟tripos返回 0 時(shí)用判斷會(huì)踩假值坑。同名覆蓋這個(gè)策略是刻意的——一個(gè)源文件里同一個(gè)頻道出現(xiàn)多次很常見后面的通常是更新過的地址。解析完還不算完地址可能是相對(duì)路徑要拼上源站域名這一步漏了客戶端拿到的就是/live/xxx.m3u8這種廢地址。聚合到頻道列表時(shí)主源取不到就降級(jí)到備用源兩條都沒有的直接不下發(fā)public function lists(int $groupId 0): array { $key ch:list: . $groupId; $data cache($key); if ($data) { return $data; } $query db(iptv_channel)-where(status, 1)-order(sort desc, id asc); if ($groupId 0) { $query-where(group_id, $groupId); } $rows $query-field(id,name,group_id,logo,source_id,backup_source_id)-select(); $data []; foreach ($rows as $r) { $url $this-resolveUrl($r[source_id]); // 先試主源 if (!$url) { $url $this-resolveUrl($r[backup_source_id]); // 主源掛了走備用 } if (!$url) { continue; // 兩條都不可用這個(gè)頻道不下發(fā)避免客戶端點(diǎn)進(jìn)去轉(zhuǎn)圈 } $data[] [ id $r[id], name $r[name], logo $r[logo], url $this-sign-signUrl($url, 600), // 10 分鐘有效期 ]; } cache($key, $data, 300); // 緩存 5 分鐘別讓每個(gè)用戶都打庫 return $data; }$groupId 0表示取全部分類APP 首頁一般先請(qǐng)求一次全量再本地分組比每個(gè)分類發(fā)一次請(qǐng)求省事。緩存 300 秒是個(gè)經(jīng)驗(yàn)值太短起不到作用太長(zhǎng)后臺(tái)改了頻道要等五分鐘才生效調(diào)試階段可以把cache()那行先注釋掉。注意signUrl的 TTL 用的是 600 秒比緩存時(shí)間長(zhǎng)是為了讓緩存里的地址在緩存有效期內(nèi)始終可用這個(gè)配合關(guān)系別搞反。3.3 播放地址簽名防盜鏈與過期控制頻道列表里的地址如果原樣給出被人抓一次包就能長(zhǎng)期白用你的帶寬。常見做法是給地址加過期時(shí)間和簽名由 Nginx 或 CDN 側(cè)做校驗(yàn)?php namespace app\api\service; class SignService { /** * param string $url 原始播放地址 * param int $ttl 有效秒數(shù)至少覆蓋一次完整觀看 */ public function signUrl(string $url, int $ttl 600): string { $expire time() $ttl; $path parse_url($url, PHP_URL_PATH) ?: /; // 只簽路徑不簽 query $sign md5(config(app.play_key) . $path . $expire); $sep strpos($url, ?) false ? ? : ; return $url . $sep . e . $expire . sign . $sign; } }只對(duì)path簽名而不是整個(gè) URL是因?yàn)樵嫉刂烦３Ｗ詭?tokenxxx這類參數(shù)整個(gè)簽會(huì)把 query 順序也算進(jìn)去源站稍微一變簽名就全廢。$ttl給 600 秒看著短但要想到 HLS 是分片播放客戶端每拉一個(gè) ts 分片都會(huì)帶著同一個(gè) manifest 地址參數(shù)如果只簽 manifest 不簽分片600 秒夠看很久如果分片地址也要單獨(dú)簽?zāi)?TTL 就得按單次觀看時(shí)長(zhǎng)來給至少 3600 秒否則看到一半斷流這個(gè)現(xiàn)象在第 5 章會(huì)展開。密鑰play_key要和 Nginx 的secure_link_md5或 CDN 的鑒權(quán)配置完全一致字符差一個(gè)就是全量 403。4. APP 端鏈路從列表點(diǎn)擊到 HLS 起播的三個(gè)關(guān)鍵封裝后端把數(shù)據(jù)準(zhǔn)備好之后客戶端的活兒看著輕其實(shí)坑都藏在生命周期里。列表刷新、圖片加載、播放器創(chuàng)建銷毀、切臺(tái)時(shí)的資源回收哪一環(huán)沒處理好表現(xiàn)出來都是「用一會(huì)兒就卡」。這一章按一次真實(shí)點(diǎn)擊的順序走一遍。4.1 列表頁RecyclerView 綁定與本地緩存頻道列表一般用 RecyclerView 加 GridLayoutManager三列或四列。Adapter 寫起來沒什么花活關(guān)鍵是別在onBindViewHolder里做網(wǎng)絡(luò)請(qǐng)求或解析public class ChannelAdapter extends RecyclerView.AdapterChannelAdapter.VH { private final ListChannel data new ArrayList(); private final OnItemClick click; public interface OnItemClick { void onPlay(Channel c); } public ChannelAdapter(OnItemClick click) { this.click click; } public void submit(ListChannel list) { data.clear(); data.addAll(list); notifyDataSetChanged(); // 幾百條規(guī)模全量刷新夠用 } Override public VH onCreateViewHolder(ViewGroup parent, int type) { View v LayoutInflater.from(parent.getContext()) .inflate(R.layout.item_channel, parent, false); return new VH(v); } Override public void onBindViewHolder(VH h, int pos) { Channel c data.get(pos); h.name.setText(c.name); Glide.with(h.logo) .load(c.logo) .placeholder(R.mipmap.ic_channel) .into(h.logo); h.itemView.setOnClickListener(v - click.onPlay(c)); } Override public int getItemCount() { return data.size(); } static class VH extends RecyclerView.ViewHolder { TextView name; ImageView logo; VH(View v) { super(v); name v.findViewById(R.id.tv_name); logo v.findViewById(R.id.iv_logo); } } }submit里用notifyDataSetChanged而不是 DiffUtil是因?yàn)轭l道列表一次全量替換沒有局部更新場(chǎng)景用 DiffUtil 反而增加復(fù)雜度。臺(tái)標(biāo)一定要給placeholder否則圖片沒加載出來那幾秒是一片白塊觀感很差。列表數(shù)據(jù)建議在SharedPreferences或本地文件里存一份 JSON冷啟動(dòng)先渲染緩存再請(qǐng)求網(wǎng)絡(luò)這樣斷網(wǎng)時(shí)至少還能看到上次的列表——很多人第一次打開 App 看到空白頁就是沒做這層兜底。4.2 播放器封裝ExoPlayer 生命周期與切臺(tái)不黑屏播放器這塊最容易翻車。最常見的寫法是每次點(diǎn)擊new ExoPlayer退出頁面不 release切十幾個(gè)臺(tái)之后內(nèi)存飆升、解碼器被占滿直接黑屏。正確姿勢(shì)是單例復(fù)用切臺(tái)只換 MediaItempublic class PlayerHolder { private ExoPlayer player; private final PlayerView view; public PlayerHolder(PlayerView view) { this.view view; } public void play(String url) { if (player null) { player new ExoPlayer.Builder(view.getContext()) .setLoadControl(new DefaultLoadControl.Builder() // 最小緩沖 3s、最大 15s、起播 1s、斷流重緩沖 2s .setBufferDurationsMs(3000, 15000, 1000, 2000) .build()) .build(); view.setPlayer(player); } player.stop(); // 先停舊的再換新的 player.setMediaItem(MediaItem.fromUri(Uri.parse(url))); // 帶簽名的新地址 player.prepare(); player.setPlayWhenReady(true); } public void release() { if (player ! null) { player.release(); player null; view.setPlayer(null); // 必須解綁否則 Surface 泄漏 } } }setMediaItem是 ExoPlayer 2.13 之后的 API老包里可能是prepare(mediaSource)那種寫法改造時(shí)注意版本。setBufferDurationsMs四個(gè)參數(shù)依次是最小緩沖、最大緩沖、起播緩沖、重緩沖弱網(wǎng)環(huán)境下把起播緩沖調(diào)小能讓首幀更快出來代價(jià)是更容易卡頓要按自己源的質(zhì)量調(diào)。release()里view.setPlayer(null)這一行很多人漏掉PlayerView 持有 Surface不解綁就是實(shí)打?qū)嵉膬?nèi)存泄漏反復(fù)進(jìn)出播放頁幾次就 OOM。生命周期上onPause調(diào)player.pause()onDestroy調(diào)release()別在onStop里 release切后臺(tái)回來看個(gè)消息就得重新緩沖。4.3 聯(lián)調(diào)改 baseUrl、打 release 包、真機(jī)驗(yàn)證APP 連后端只有一處要改就是接口根地址。這類工程一般把它抽在ApiConfig或Constants里public class ApiConfig { // 真機(jī)調(diào)試寫局域網(wǎng) IP寫 localhost 手機(jī)連的是它自己 public static final String BASE_URL http://192.168.1.20:8000/api/v1/; public static final String HEADER_TOKEN X-Token; }192.168.1.20換成你開發(fā)機(jī)在局域網(wǎng)里的實(shí)際地址電腦和手機(jī)必須在同一個(gè)網(wǎng)段。Android 9 以后默認(rèn)禁止明文 HTTPAndroidManifest.xml里要加android:usesCleartextTraffictrue或者配 network security config只對(duì)調(diào)試域名放行。打包用./gradlew assembleReleasedebug 包和 release 包的簽名、混淆配置不一樣有些包在 release 下因?yàn)榛煜逊瓷溆玫降?model 字段名改掉了JSON 解析全變 null這個(gè)必須在真機(jī)上用 release 包驗(yàn)一遍別只在模擬器 debug 跑通就交付。5. 避坑排查五個(gè)把人卡到半夜的現(xiàn)場(chǎng)問題下面這幾條都是這類雙端項(xiàng)目里高頻出現(xiàn)的現(xiàn)場(chǎng)故障按「現(xiàn)象 → 原因 → 解決」寫遇到了可以直接對(duì)照。5.1 接口 200 但頻道列表是空的現(xiàn)象Postman 請(qǐng)求頻道接口返回code: 0data是空數(shù)組日志里也沒有報(bào)錯(cuò)。原因九成出在源解析。要么.m3u文件里的地址是相對(duì)路徑解析出來是/live/xxx.m3u8resolveUrl拼域名那步?jīng)]做客戶端拿到廢地址要么源地址后綴不是.m3u8而聚合邏輯里寫死了只認(rèn).m3u8結(jié)尾把.flv、.ts全過濾掉了還有一種情況是頻道表status字段默認(rèn) 0導(dǎo)入數(shù)據(jù)時(shí)沒置 1查詢條件where(status, 1)直接把全部記錄篩沒了。解決在parseM3u之后、入庫之前打個(gè)日志把解析出的前十條地址打出來看格式resolveUrl里判斷strpos($url, http) ! 0就補(bǔ)源站域名去掉后綴過濾改成協(xié)議白名單http/https導(dǎo)入 SQL 之后跑一句UPDATE iptv_channel SET status 1。這三步查完基本能定位。5.2 起播只有聲音沒有畫面現(xiàn)象點(diǎn)進(jìn)頻道聲音正常出來畫面一直黑或者停在臺(tái)標(biāo)進(jìn)度條在走。原因編碼格式不支持。源是 H.265/HEVC 編碼而工程里引的 ExoPlayer 版本沒開 HEVC 軟解或者干脆是缺exoplayer-hls擴(kuò)展core 模塊不認(rèn) m3u8 的切片描述音頻軌能勉強(qiáng)解析出來視頻軌直接失敗。解決先看build.gradle里有沒有exoplayer-hls沒有就加加了還不行用ffprobe看一下源的編碼H.265 的話要么換源要么在 ExoPlayer 里配置DefaultRenderersFactory.setExtensionRendererMode(EXTENSION_RENDERER_MODE_PREFER)并引入 ffmpeg 擴(kuò)展。最省事的辦法是后端做一層轉(zhuǎn)碼統(tǒng)一輸出 H.264 的 HLS客戶端就不用管編碼差異了代價(jià)是服務(wù)器要扛轉(zhuǎn)碼開銷。5.3 真機(jī)連不上后端現(xiàn)象模擬器一切正常裝到真機(jī)上所有接口超時(shí)APP 里提示網(wǎng)絡(luò)錯(cuò)誤。原因三個(gè)高頻點(diǎn)。一是BASE_URL寫的localhost或127.0.0.1在手機(jī)上指向手機(jī)自己二是后端php think run沒加-H 0.0.0.0只監(jiān)聽本機(jī)回環(huán)三是開發(fā)機(jī)防火墻攔了 8000 端口或者手機(jī)和電腦不在同一個(gè) Wi-Fi一個(gè)連 5G 一個(gè)連 2.4G跨了網(wǎng)段。解決先用手機(jī)瀏覽器直接訪問http://開發(fā)機(jī)IP:8000/api/v1/channel能看到 JSON 說明網(wǎng)絡(luò)通問題在 APP看不到就查后端監(jiān)聽地址和防火墻。Windows 上netstat -ano | findstr 8000看監(jiān)聽的是不是0.0.0.0:8000是127.0.0.1:8000就說明啟動(dòng)參數(shù)不對(duì)。5.4 切臺(tái)幾次就黑屏或卡死現(xiàn)象連續(xù)切十幾個(gè)頻道之后畫面不再刷新或者直接閃退日志里有OutOfMemoryError或者M(jìn)ediaCodec相關(guān)報(bào)錯(cuò)。原因每次播放都new ExoPlayer頁面退出沒release解碼器實(shí)例越積越多。Android 的硬件解碼器數(shù)量有限超過上限就申請(qǐng)不到新的表現(xiàn)就是黑屏。解決按 4.2 節(jié)的寫法改成單例復(fù)用play()里先stop()再換MediaItemrelease()里解綁PlayerView。可以用 Android Studio 的 Profiler 看內(nèi)存曲線正常復(fù)用的情況下切臺(tái)內(nèi)存是一條平穩(wěn)的線不復(fù)用就是一格格往上跳。5.5 播到一半突然斷開現(xiàn)象頻道看五六分鐘之后畫面卡住重連幾次又好了或者直接報(bào) 403。原因播放地址簽名過期。簽名 TTL 設(shè)了 600 秒但 HLS 播放器在播放過程中會(huì)不斷請(qǐng)求新的分片如果分片地址也走同一套簽名校驗(yàn)超過 600 秒之后的請(qǐng)求全部 403。另一種情況是 CDN 側(cè)的時(shí)間和你服務(wù)器時(shí)間差了十幾分鐘簽名算出來的過期時(shí)間在 CDN 看來已經(jīng)過了。解決把 TTL 調(diào)到覆蓋單次觀看時(shí)長(zhǎng)比如 3600 秒或者只對(duì) manifest 簽名分片地址由 manifest 里的相對(duì)路徑推導(dǎo)不單獨(dú)校驗(yàn)。服務(wù)器裝個(gè) NTP 同步時(shí)間CDN 和源站時(shí)間差控制在 1 分鐘內(nèi)。查的時(shí)候看 Nginx 訪問日志里 403 的請(qǐng)求是不是都帶著同一個(gè)e參數(shù)是的話就是過期不是的話再查簽名算法對(duì)不對(duì)。6. 二次開發(fā)換源、加分類、加緩存的三步改法拿到這套東西之后最常見的三個(gè)改造方向按投入產(chǎn)出比排一下改造點(diǎn)改哪里工作量收益換自有源SourceService::parseM3u 后臺(tái)導(dǎo)入半天直接決定能不能用加頻道分類iptv_group表 列表接口 group 參數(shù)一天客戶端體驗(yàn)提升明顯加接口緩存lists()里的 cache Redis 配置兩小時(shí)并發(fā)上來不崩換源是最先要做的。后臺(tái)一般有「導(dǎo)入 m3u」的入口把文件傳上去走一遍解析入庫。如果你的源格式不標(biāo)準(zhǔn)比如描述行里沒有tvg-name只有,頻道名那 3.2 節(jié)的解析器已經(jīng)兜住了。導(dǎo)入之后別急著在 APP 上看先在數(shù)據(jù)庫里SELECT COUNT(*) FROM iptv_channel WHERE status 1確認(rèn)數(shù)量對(duì)得上再清一次緩存cache(ch:list:0, null)不然看到的還是舊列表。加分類要?jiǎng)觾商帞?shù)據(jù)庫加iptv_group表存分類名和排序接口的lists($groupId)已經(jīng)支持按分類篩只要把group_id傳對(duì)就行。APP 端在頂部加一個(gè)橫向的 TabLayout切換時(shí)帶上group_id重新請(qǐng)求。這里有個(gè)小技巧首次進(jìn)頁面請(qǐng)求一次全量groupId0客戶端自己按group_id分組渲染 Tab切 Tab 不發(fā)請(qǐng)求體驗(yàn)會(huì)順很多代價(jià)是首屏數(shù)據(jù)量稍大幾百條 JSON 也就幾十 KB。加緩存則是并發(fā)上來的救命稻草。默認(rèn)的 file 緩存單機(jī)還行多實(shí)例部署就得換 Redis。改config/cache.php的type為redis填上地址和密碼lists()里那兩行cache()不用動(dòng)。驗(yàn)證方法很直接壓測(cè)工具打 100 并發(fā)看數(shù)據(jù)庫的SHOW PROCESSLIST里是不是只有零星幾條查詢?nèi)绻€是滿屏的 SELECT說明緩存沒命中八成是 key 拼錯(cuò)了或者緩存驅(qū)動(dòng)沒生效。我自己的習(xí)慣是每次改完接口先用 curl 打一遍把返回的 JSON 存成文件改完再打一遍做diff字段少了、類型變了立刻能看出來——這比在 APP 上點(diǎn)半天靠譜得多。有一次就是靠這個(gè) diff 發(fā)現(xiàn)加分類之后logo字段被漏選了客戶端臺(tái)標(biāo)全空查了半小時(shí)以為是圖片服務(wù)掛了。從那以后我每次動(dòng)列表接口都強(qiáng)制走一遍 curl diff再上真機(jī)。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取