企业官网建设流程全解析

简介：这是一款面向Android TV开发者与家庭影音爱好者打造的原生电视直播应用源码，专为Android 5.0及以上系统设计，解决智能电视/盒子端缺乏轻量、可控、可定制直播方案的痛点。资源包共176个文件，含104个Kotlin源码（.kt）、23个XML布局与配置文件、25个PNG图标资源，以及HTML/CSS/JS构成的Web管理界面（index.html等），整体仅4.15MB，结构清晰、模块解耦，便于二次开发与功能裁剪。已有168人下载学习，适合中高级Android开发者快速掌握TV端遥控器交互、IPv6直播流调度、多源多线路容灾切换、节目单动态加载等实战技术。源码完整实现换台反转、数字键选台、频道收藏、开机自启、Web端远程配置（含m3u/tvbox订阅源与XML节目单管理）及自动线路降级播放等核心能力，配套lib-decoder-ffmpeg-release.aar等关键依赖已内嵌，开箱即用。

1. 项目概述与核心价值

最近在折腾家里的旧电视盒子，发现很多市面上的直播应用要么广告满天飞，要么功能臃肿，要么对老旧设备支持不佳。于是萌生了自己动手写一个纯净、高效、功能聚焦的电视直播软件的想法。这个项目就是一个基于Android原生开发的电视直播应用源码，它没有花里胡哨的界面和冗余功能，核心目标就是流畅、稳定地看电视直播。它支持换台反转、数字选台、节目单（EPG）、开机自启、多直播源与多线路、频道收藏等电视用户最关心的功能。特别需要注意的是，它仅支持Android 5.0（Lollipop）及以上系统，并且其内置的默认直播源需要网络环境支持IPv6才能正常播放。对于开发者或有一定动手能力的用户来说，这份源码提供了一个绝佳的起点，你可以基于它定制自己的专属直播应用，理解一个电视直播App从播放内核到用户交互的完整实现逻辑。

2. 项目整体架构与技术选型解析

2.1 为什么选择Android原生开发？

在跨平台框架（如Flutter、React Native）大行其道的今天，选择纯Java/Kotlin进行Android原生开发，主要是出于对性能、稳定性和对Android TV/盒子设备深度定制的考量。电视应用与手机应用有显著不同：用户通过遥控器操作，焦点管理至关重要；界面需要为大屏和远距离观看优化；视频解码与渲染的流畅度直接决定用户体验。原生开发能让我们直接调用MediaPlayer、ExoPlayer等底层媒体框架，精细控制解码、渲染流程，实现极低的换台延迟。同时，对于ContentProvider（用于数据共享，如直播源）、BroadcastReceiver（用于监听开机广播实现自启）等系统级特性的集成也更为直接和稳定。虽然热词中提到了“android中协调布局+banner”，但在TV开发中，我们更常使用Leanback支持库来构建符合TV交互规范的界面，而非简单的协调布局。

2.2 核心功能模块拆解

整个应用可以划分为几个核心模块：

1. 播放器模块：这是应用的心脏。通常我们会选用功能强大、扩展性好的ExoPlayer作为播放内核，而非系统自带的MediaPlayer。ExoPlayer支持DASH、HLS、SmoothStreaming等多种流媒体协议，并且能够更好地处理直播流的缓冲与切换。我们需要围绕它封装一个播放器控制器，负责视频源的加载、播放、暂停、停止以及音轨、字幕轨道的管理。
2. 数据层模块：负责频道列表、节目单（EPG）数据的获取、解析、缓存与管理。直播源（M3U8或M3U格式）和EPG源（XMLTV格式）通常从网络或本地文件加载。这里会涉及网络请求（如使用OkHttp）、文件解析、以及数据库（如Room）或SharedPreferences进行本地缓存。热词中提到的“ipv6 容易超时 okhttp”提醒我们，在处理IPv6源时，需要合理配置OkHttp的超时和重试策略。
3. UI层模块：基于TV的交互范式构建。主界面可能是一个频道列表（RecyclerView），一个正在播放的视频窗口，以及一个节目信息面板。焦点移动、按键事件处理（上下换台、数字键选台、菜单键调出功能）是这里的重点。Leanback库中的BrowseFragment、DetailsFragment等组件能极大简化开发。
4. 业务逻辑层模块：将上述模块串联起来，实现“换台反转”、“收藏频道”、“开机自启”等具体功能。例如，“开机自启”通过监听ACTION_BOOT_COMPLETED广播实现；“数字选台”需要监听遥控器的数字键事件，并映射到对应的频道索引。

2.3 关于IPv6直播源的特别说明

项目提到“默认直播源需IPv6支持”，这是一个非常关键且符合趋势的技术点。随着IPv4地址耗尽，越来越多的网络服务，包括一些流媒体直播源，开始部署在IPv6网络上。如果你的家庭网络或运营商网络没有正确配置IPv6，那么应用将无法连接这些默认源。对于开发者而言，在代码中需要确保网络栈支持IPv6。使用OkHttp等现代网络库，它们通常对IPv6有良好的支持。但在测试时，务必在支持IPv6的网络环境下进行，或者准备备用的IPv4直播源。对于最终用户，如果无法播放，首要的排查点就是检查网络环境的IPv6连通性。

3. 核心功能实现细节与实操要点

3.1 播放器集成与多线路切换

播放器是直播应用的核心，我们选择ExoPlayer。首先在build.gradle中添加依赖。

implementation 'com.google.android.exoplayer:exoplayer-core:2.19.1' implementation 'com.google.android.exoplayer:exoplayer-hls:2.19.1' // 如果直播源是HLS协议 implementation 'com.google.android.exoplayer:exoplayer-ui:2.19.1'

初始化一个简单的播放器实例：

val trackSelector = DefaultTrackSelector(context) val loadControl = DefaultLoadControl.Builder() .setBufferDurationsMs(5000, 10000, 1500, 2000) // 最小缓冲、最大缓冲等参数 .build() val exoPlayer = ExoPlayer.Builder(context) .setTrackSelector(trackSelector) .setLoadControl(loadControl) .build() // 将播放器绑定到SurfaceView或TextureView playerView.player = exoPlayer

多线路切换的实现：一个频道往往有多个播放源（线路），我们可以在数据模型中为每个Channel对象设置一个List<String>类型的playbackUrls字段。当用户切换线路时，我们只需重新为ExoPlayer设置一个新的MediaItem，其URI指向选中的线路URL，然后调用player.prepare()和player.play()即可。为了体验流畅，可以在切换时先隐藏视频画面，等新线路缓冲几帧后再显示。

实操心得：ExoPlayer的DefaultLoadControl参数对直播体验影响巨大。setBufferDurationsMs中的“最小回放缓冲”不宜设置过小，否则网络稍有波动就会卡顿；但也不宜过大，否则换台等待时间过长。对于电视直播，经过实测，将其设置在2000-5000毫秒是一个比较均衡的选择。另外，务必在onDestroy中释放播放器资源（exoPlayer.release()），否则会引起内存泄漏。

3.2 频道列表、节目单(EPG)与数据解析

频道列表（M3U8解析）：直播源通常是一个M3U或M3U8格式的文本文件。我们需要解析它来获取频道名和播放地址。

data class Channel( val id: String, val name: String, val logoUrl: String?, val group: String, val playbackUrls: List<String>, // 多线路 val currentUrlIndex: Int = 0 )

解析过程就是逐行读取文件，识别#EXTINF:行获取频道信息，其后的行就是播放URL。需要处理分组（#EXTGRP:）和台标（tvg-logo）等信息。

电子节目指南（EPG）解析：EPG通常采用XMLTV格式。我们需要解析一个庞大的XML文件，将其中的<programme>元素与频道进行匹配（通过channelId），并存储开始时间、结束时间和节目名称。

data class Program( val channelId: String, val title: String, val startTime: Long, // Unix timestamp val endTime: Long, val desc: String? = null )

数据缓存策略：频繁网络请求EPG和直播源文件是不可取的。我们可以使用Room数据库缓存解析后的频道和节目单数据。为Channel和Program表建立实体和DAO。直播源M3U文件可以缓存在本地文件系统中，并记录其最后更新时间，定期（如每天）在后台检查更新。

注意事项：EPG数据量可能很大，解析XML是一个耗时操作（IO）。务必在后台线程（如Dispatchers.IO）中进行，并使用高效的XML解析器（如XmlPullParser）。解析完成后，通过LiveData或Flow通知UI层更新。对于频道列表的展示，使用RecyclerView并配合DiffUtil可以高效地更新数据变化。

3.3 TV专属交互：换台反转、数字选台与焦点控制

换台反转：这个功能非常实用，指按“下”键切换到上一个频道，按“上”键切换到下一个频道，与列表滚动方向相反，符合“频道列表在侧边，视频在主区域”的布局直觉。实现关键在于重写播放界面的onKeyDown方法。

override fun onKeyDown(keyCode: Int, event: KeyEvent?): Boolean { return when (keyCode) { KeyEvent.KEYCODE_DPAD_UP -> { // 切换到上一个频道 switchToPreviousChannel() true } KeyEvent.KEYCODE_DPAD_DOWN -> { // 切换到下一个频道 switchToNextChannel() true } KeyEvent.KEYCODE_0, KeyEvent.KEYCODE_1, ..., KeyEvent.KEYCODE_9 -> { // 数字选台逻辑 handleNumberInput(keyCode) true } else -> super.onKeyDown(keyCode, event) } }

数字选台：这是传统电视的经典功能。我们需要维护一个输入缓冲区。当用户按下数字键时，将对应的数字追加到一个临时字符串中。可以设置一个超时时间（如2秒），如果在超时内用户没有继续输入，则根据这个数字字符串（如“101”）直接跳转到对应的频道索引。如果频道总数不足100，可以直接映射；如果超过100，则需要精确匹配频道编号或进行智能搜索。

焦点控制：TV界面必须明确指示当前获得焦点的元素。使用Leanback库的组件会自动处理很多焦点逻辑。自定义视图时，务必为可点击元素设置android:focusable="true"和android:background="?attr/selectableItemBackgroundBorderless"，并在代码中监听焦点变化来改变其外观（如放大、加边框）。

3.4 开机自启与频道收藏

开机自启：实现此功能需要以下步骤：

1. 在AndroidManifest.xml中声明接收开机广播的权限：<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />。
2. 创建一个BootReceiver继承自BroadcastReceiver。
3. 在BootReceiver的onReceive方法中，启动你的应用的主Activity或一个启动服务（Service）。
4. 在AndroidManifest.xml中静态注册这个Receiver，并添加开机广播的intent-filter。

<receiver android:name=".BootReceiver" android:enabled="true" android:exported="true"> <intent-filter> <action android:name="android.intent.action.BOOT_COMPLETED" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </receiver>

重要提示：从Android 8.0（API 26）开始，对静态注册广播接收器有了更严格的限制。BOOT_COMPLETED广播仍然可以静态注册，但为了确保可靠性，特别是在某些深度定制的系统上，建议在应用启动后，动态检查并引导用户将应用加入系统的“自启动管理”白名单中。这是一个很重要的避坑点。

频道收藏：这是一个简单的CRUD操作。在Channel实体中增加一个isFavorite字段。在UI上提供一个“收藏”按钮（如星形图标），点击后更新该频道在数据库中的isFavorite状态。收藏列表可以通过一个独立的Fragment或Activity来展示，只需查询数据库中isFavorite = 1的频道即可。为了持久化，这个状态必须保存在数据库中。

4. 开发环境搭建与关键配置

4.1 Android Studio与项目配置

开发工具首选Android Studio。确保安装最新的稳定版本，并下载对应的Android SDK。项目的最低SDK版本（minSdkVersion）应设置为21（对应Android 5.0 Lollipop），以符合项目要求。目标SDK版本（targetSdkVersion）应设置为当前最新的API级别，以确保应用能利用新系统的特性并符合商店上架要求。

在build.gradle (Module: app)中，需要正确配置依赖。除了前面提到的ExoPlayer，可能还需要以下库：

• Leanback支持库：用于构建TV界面。
• Room：用于数据库操作。
• OkHttp&Retrofit：用于网络请求和直播源/EPG获取。
• Glide或Coil：用于加载频道Logo等图片。

android { compileSdk 34 defaultConfig { applicationId "com.yourcompany.tvlive" minSdk 21 targetSdk 34 versionCode 1 versionName "1.0" } buildFeatures { viewBinding true // 或 dataBinding } } dependencies { implementation 'androidx.leanback:leanback:1.2.0-alpha04' implementation 'androidx.room:room-runtime:2.6.0' kapt 'androidx.room:room-compiler:2.6.0' // 如果使用Kotlin implementation 'com.squareup.okhttp3:okhttp:4.12.0' implementation 'com.github.bumptech.glide:glide:4.16.0' // ... ExoPlayer dependencies }

4.2 针对TV设备的清单文件(AndroidManifest.xml)配置

TV应用有特殊的配置要求，必须在AndroidManifest.xml中声明。

1. 声明为TV应用：在<application>标签内，添加一个<uses-feature>声明，指出应用不需要触摸屏，但需要电视设备。

   <uses-feature android:name="android.hardware.touchscreen" android:required="false" /> <uses-feature android:name="android.software.leanback" android:required="true" />

2. 设置横幅(Banner)：TV应用的主Activity必须提供一个横幅图片，用于在Android TV主屏幕上展示。在<activity>标签内添加：

   <activity android:name=".MainActivity" android:banner="@drawable/tv_banner" <!-- 一张320x180的图片 --> android:theme="@style/Theme.Leanback"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LEANBACK_LAUNCHER" /> </intent-filter> </activity>

   注意，这里的intent-filter使用了CATEGORY_LEANBACK_LAUNCHER，这是TV应用的入口标志。

4.3 处理IPv6网络请求

由于默认直播源依赖IPv6，确保你的网络请求库能正确处理IPv6地址。OkHttp默认支持双栈（IPv4/IPv6）。但在某些网络环境下，可能需要更精细的控制。一个常见问题是IPv6 DNS解析超时，这可以通过配置OkHttp的Dns组件来解决，例如使用一个同时支持IPv4和IPv6的DNS解析器，或设置备用DNS。

import okhttp3.Dns import java.net.InetAddress class DualStackDns : Dns { override fun lookup(hostname: String): List<InetAddress> { return try { // 尝试获取所有地址，包括IPv4和IPv6 InetAddress.getAllByName(hostname).toList() } catch (e: Exception) { // 失败则返回系统默认解析 Dns.SYSTEM.lookup(hostname) } } } // 在创建OkHttpClient时使用 val okHttpClient = OkHttpClient.Builder() .dns(DualStackDns()) .connectTimeout(10, TimeUnit.SECONDS) // 适当延长超时时间 .readTimeout(15, TimeUnit.SECONDS) .build()

踩坑记录：在测试IPv6源时，务必确认你的测试设备所处的网络环境（Wi-Fi或有线）是否真的获取到了全球单播IPv6地址（通常以2xxx:开头），而不仅仅是链路本地地址（fe80:开头）。你可以在设备的网络设置中查看，或使用一些网络测试App。如果只有链路本地地址，是无法访问公网IPv6资源的。这是排查播放失败的首要步骤。

5. 核心界面构建与TV UI设计规范

5.1 主界面布局与Leanback组件应用

TV应用的主界面通常采用经典的“内容聚焦”式布局。推荐使用AndroidX Leanback库中的BrowseFragment作为主界面框架。BrowseFragment天然提供了标题、导航侧边栏和内容网格/列表区域，非常适合展示频道分组。

1. 创建主Activity：继承自LeanbackActivity，并在onCreate中设置BrowseFragment。
2. 构建数据模型与Presenter：Leanback库使用ArrayObjectAdapter来管理数据，并使用Presenter来定义每个列表项的视图样式。你需要为频道行（ListRow）和频道项（Channel）分别创建Presenter。
   • RowPresenter：负责渲染一整行（一个频道分组）。
   • ItemPresenter：负责渲染行内的每个频道（包括Logo和频道名）。
3. 填充数据：将分好组的频道列表，转换成ListRow对象，添加到ArrayObjectAdapter中，并设置给BrowseFragment。

class MainActivity : LeanbackActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) val browseFragment = supportFragmentManager.findFragmentById(R.id.browse_fragment) as BrowseFragment browseFragment.title = "电视直播" browseFragment.headersState = BrowseFragment.HEADERS_DISABLED // 如果不想要左侧导航栏可以禁用 setupRowsAdapter(browseFragment) } private fun setupRowsAdapter(browseFragment: BrowseFragment) { val rowsAdapter = ArrayObjectAdapter(ListRowPresenter()) // 假设 channelList 是按组分类的 Map<String, List<Channel>> channelList.forEach { (groupName, channels) -> val listRowAdapter = ArrayObjectAdapter(ChannelPresenter()) listRowAdapter.addAll(0, channels) val header = HeaderItem(groupName) rowsAdapter.add(ListRow(header, listRowAdapter)) } browseFragment.adapter = rowsAdapter browseFragment.setOnItemViewClickedListener { itemViewHolder, item, rowViewHolder, row -> // 处理频道点击事件 if (item is Channel) { playChannel(item) } } } }

5.2 播放器界面与控件

播放界面通常是一个全屏的Fragment或Activity。使用PlayerView（ExoPlayer UI库的一部分）可以快速获得一个带有基础控件的播放界面。但TV上，我们通常需要自定义控件，使其能用遥控器方便操作。

1. 布局：一个FrameLayout包含PlayerView（用于视频渲染）和一个自定义的ControlView（用于显示频道信息、播放状态、音量等）。ControlView默认隐藏，当用户按下“确定”或“菜单”键时显示，几秒后自动隐藏。
2. 自定义ControlView：继承自FrameLayout，包含必要的TextView（显示频道名、节目名、时间）和ProgressBar（显示播放缓冲进度）。通过Handler或View.postDelayed实现自动隐藏逻辑。
3. 按键事件传递：在播放界面，需要正确处理按键事件。例如，左右键用于调节音量或进度（对于直播，进度调节可能无效），上下键用于换台，确定键用于显示/隐藏控件，返回键退出全屏回到列表。注意事件冲突的处理，当控件显示时，方向键可能用于在控件内部导航。

5.3 节目单(EPG)界面展示

EPG界面通常以时间轴的形式展示。可以是一个横向滚动的RecyclerView，每一列代表一个时间块（如30分钟），每一行代表一个频道。每个单元格显示该频道在该时间段的节目名称。

实现起来稍复杂：

1. 数据准备：将Program数据按频道分组，并按时间排序。计算每个节目的起始位置和宽度（基于时间跨度）。
2. 自定义LayoutManager：可能需要一个自定义的GridLayoutManager，或者使用RecyclerView配合ItemDecoration来绘制时间轴刻度线。
3. Item视图：每个节目单元格是一个TextView，背景色区分正在播出、即将播出等状态。点击单元格可以查看节目详情或设置提醒。

一个更简单的替代方案是“当前/下一个”模式，只在播放界面下方显示当前频道正在播放和下一个即将播放的节目信息。这对于实现来说更轻量，用户体验也足够直观。

6. 数据持久化、网络请求与后台服务

6.1 使用Room持久化频道与收藏数据

Room是Android官方推荐的SQLite ORM库，它能极大简化数据库操作。

1. 定义实体(Entity)：

   @Entity(tableName = "channels") data class ChannelEntity( @PrimaryKey val id: String, val name: String, val logoUrl: String?, val group: String, val playbackUrlsJson: String, // 将List<String>序列化为JSON字符串存储 val isFavorite: Boolean = false, val lastPlayedTime: Long? = null )

   注意，Room不能直接存储List<String>，我们需要将其转换为JSON字符串。可以使用Gson或Moshi库。

2. 定义数据访问对象(DAO)：

   @Dao interface ChannelDao { @Query("SELECT * FROM channels ORDER BY group ASC, name ASC") fun getAllChannels(): Flow<List<ChannelEntity>> @Query("SELECT * FROM channels WHERE isFavorite = 1 ORDER BY lastPlayedTime DESC") fun getFavoriteChannels(): Flow<List<ChannelEntity>> @Insert(onConflict = OnConflictStrategy.REPLACE) suspend fun insertAll(channels: List<ChannelEntity>) @Update suspend fun update(channel: ChannelEntity) }

3. 创建数据库：

   @Database(entities = [ChannelEntity::class, ProgramEntity::class], version = 1, exportSchema = false) abstract class AppDatabase : RoomDatabase() { abstract fun channelDao(): ChannelDao abstract fun programDao(): ProgramDao companion object { @Volatile private var INSTANCE: AppDatabase? = null fun getInstance(context: Context): AppDatabase { return INSTANCE ?: synchronized(this) { val instance = Room.databaseBuilder( context.applicationContext, AppDatabase::class.java, "tv_live_database" ).build() INSTANCE = instance instance } } } }

6.2 直播源与EPG的获取与更新策略

直播源和EPG数据需要从网络获取。我们可以在应用启动时，或定时在后台检查更新。

1. 定义数据源：将默认的直播源M3U8 URL和EPG XML URL作为配置项，可以放在buildConfigField或一个配置类中，方便后续替换。

2. 使用WorkManager进行后台更新：WorkManager是处理后台任务的首选。我们可以定义一个PeriodicWorkRequest，每隔一段时间（如12小时）在后台检查并更新直播源和EPG。

   val updateWorkRequest = PeriodicWorkRequestBuilder<UpdateWorker>( repeatInterval = 12, TimeUnit.HOURS, flexTimeInterval = 1, TimeUnit.HOURS ).setConstraints( Constraints.Builder() .setRequiredNetworkType(NetworkType.CONNECTED) .build() ).build() WorkManager.getInstance(context).enqueueUniquePeriodicWork( "update_live_source", ExistingPeriodicWorkPolicy.KEEP, updateWorkRequest )

   在UpdateWorker的doWork()方法中，执行网络请求、解析数据并更新数据库。

3. 多源与容错：不要只依赖一个直播源URL。可以在应用中内置几个备用的源地址。当主源获取失败时，按顺序尝试备用源。同样，EPG源也可以有备选。

6.3 播放状态管理与后台播放

电视直播应用通常不支持真正的后台播放（即应用退到后台后视频继续播放），因为这会消耗大量流量和电量，且不符合电视使用场景。但我们需要管理播放状态。

1. 生命周期绑定：在播放界面的onResume中开始播放，在onPause中暂停播放。这样当用户切换到其他应用或按Home键时，播放会暂停。
2. 使用Service进行播放：如果你希望实现画中画（PiP）功能，或者更复杂的后台音频播放（虽然不常见），则需要将播放逻辑放在一个Service中（如前台服务）。ExoPlayer可以在Service中运行。当应用进入后台时，你可以选择停止视频渲染，但保持音频播放，或者启动画中画模式。
3. 状态保存与恢复：当系统因内存不足销毁Activity时，需要保存当前播放的频道、播放位置等信息。可以在onSaveInstanceState中保存，在onCreate或onRestoreInstanceState中恢复。对于ExoPlayer，可以使用Player.STATE_READY等状态来判断是否需要重新准备媒体。

7. 测试、调试与发布准备

7.1 在模拟器与真机（电视/盒子）上测试

Android TV模拟器：在Android Studio的AVD Manager中，可以选择“TV”设备类型来创建模拟器。这是最方便的初步测试方式，可以测试界面布局和基础交互。

真机测试：这是必不可少的环节。你需要一台Android TV或电视盒子。通过ADB连接设备进行调试。

• 连接：确保设备和电脑在同一局域网。在设备的“开发者选项”中开启“网络ADB调试”，记下显示的IP地址和端口。在电脑终端执行adb connect IP:端口。
• 安装与调试：连接成功后，就可以像调试手机应用一样，从Android Studio直接运行应用到电视上。可以使用Logcat查看日志，进行断点调试。

测试重点：

1. 焦点导航：使用键盘或遥控器（模拟）测试所有可操作元素的焦点移动是否顺畅、符合预期。
2. 播放测试：在不同网络环境下（特别是IPv6网络）测试播放流畅度、换台速度、多线路切换。
3. 内存与性能：使用Android Profiler监控应用的内存占用和CPU使用情况，确保长时间播放无内存泄漏。
4. 按键响应：测试所有物理按键（方向键、确认、返回、Home、菜单、数字键等）的响应是否正确。

7.2 常见问题排查与解决

1. 问题：直播源加载失败，提示“无法播放此视频”或“加载失败”。

   • 排查：首先检查网络连接。如果是IPv6源，使用网络测试工具检查设备IPv6连通性。查看Logcat中ExoPlayer和OkHttp的详细错误日志。可能是URL失效、格式不支持、或服务器限制。
   • 解决：尝试更换其他线路。检查M3U8文件内容是否有效。如果是网络问题，引导用户检查网络设置。

2. 问题：换台时卡顿、黑屏时间过长。

   • 排查：检查ExoPlayer的LoadControl缓冲参数。检查是否在切换频道时进行了不必要的UI重绘或数据重新加载。
   • 解决：优化缓冲策略。在切换前预加载下一个频道的流媒体数据（ExoPlayer的MediaSource可以预加载）。确保频道列表数据已缓存，切换时无需等待网络请求。

3. 问题：EPG节目单不显示或显示错乱。

   • 排查：检查EPG XML文件是否成功下载和解析。检查channelId的匹配逻辑是否正确（M3U中的tvg-id与XML中的channel id是否对应）。检查时区处理是否正确。
   • 解决：确保解析EPG的代码健壮，能处理格式不标准的XML。提供手动刷新EPG的按钮。在UI上清晰显示“暂无节目信息”而不是空白或错乱。

4. 问题：在特定品牌盒子上无法开机自启。

   • 排查：许多国内安卓盒子厂商修改了系统，增加了自启动管理。即使应用注册了BOOT_COMPLETED广播，也可能被系统拦截。
   • 解决：这是一个已知的兼容性问题。在应用内添加一个“自启动设置指南”页面，图文并茂地引导用户去该品牌盒子的系统设置中，手动允许你的应用自启动。这是提升用户体验的必要步骤。

7.3 应用打包、签名与发布

1. 生成签名密钥：使用Android Studio的Generate Signed Bundle / APK向导，或命令行keytool工具，生成一个签名密钥（.jks文件）。务必妥善保管此文件及其密码，它是你应用的身份凭证，未来更新应用必须使用相同的密钥。
2. 构建发布版本：在build.gradle中配置签名信息，然后构建Release版本的APK或App Bundle。
3. 混淆与优化：启用代码混淆（ProGuard或R8）以减小APK体积并保护代码。在app/proguard-rules.pro中为ExoPlayer、OkHttp、Room等库添加必要的keep规则，防止混淆导致运行时错误。

   -keep class com.google.android.exoplayer2.** { *; } -keep class androidx.room.** { *; } -keep class * extends androidx.room.RoomDatabase -keepclasseswithmembers class * { @androidx.room.* <methods>; }

4. 发布渠道：可以将APK直接分享给用户安装。若要上架到应用商店，Google Play Store有专门的Android TV类别。国内各大电视厂商（如小米、当贝、天猫魔盒等）也有自己的应用商店，需要分别提交审核，并可能需适配其特定的SDK或规范。

开发这样一个电视直播应用，从技术选型到细节打磨，是一个系统工程。它要求开发者不仅熟悉Android开发，还要理解TV交互的特殊性、流媒体播放的复杂性以及网络协议的细节。这份源码提供了一个坚实的骨架，但真正的稳定、流畅和用户友好，还需要你在实际开发和测试中不断迭代和优化。最重要的是，始终从用户坐在沙发上、拿着遥控器的场景出发去思考每一个功能细节。

本文还有配套的精品资源，点击获取