拆解 my-tv 播放失败的恢复链路:8 次重取与 3 条错误路径【免费下载链接】my-tv我的电视 电视直播软件安装即可使用项目地址: https://gitcode.com/GitHub_Trending/my/my-tv打开直播频道,画面停在黑屏,弹出状态错误或网络错误,重按一次又好了。my-tv 的错误恢复由三条独立链路组成,各有独立计数器、各自的重试边界,失败时有的弹窗有的静默,搞混了排查方向就错了。错误检测链路:从 PlaybackException 到错误页播放器异常从哪个回调抛出播放侧唯一的异常入口是 Player.Listener 的 onPlayerError,定义在 PlayerFragment.kt。回调只干两件事:打日志、通知 ViewModel:override fun onPlayerError(error: PlaybackException) { super.onPlayerError(error) Log.e(TAG, PlaybackException $error) tvViewModel?.changed() }changed()本身不带任何错误信息,真正的恢复动作在 MainFragment.kt 的 change 观察者里:重新走Request.fetchData拉取地址后再次play(),即错误即重取,而不是在本地重播。两条独立的失败入口会落到同一张错误页MainActivity.kt 的onRequestFinished是错误页的唯一挂入口,message非空才弹:override fun onRequestFinished(message: String?) { if (message ! null !errorFragment.isVisible) { supportFragmentManager.beginTransaction() .add(R.id.main_browse_fragment, errorFragment) .commitNow() errorFragment.setErrorContent(message) } fragmentReady(Request) }会传非空 message 的来源只有 Request.kt 的fetchInfoV2:token 拉取状态码异常传状态错误,请求失败传网络错误。另一条文案应版权方要求,暂停提供直播信号不走错误页,而是经setErrInfo进errInfoLiveData,由 MainFragment 以 Toast 提示,且仅当出错频道正是当前选中频道时才显示。用户看到的只有一个按钮,关掉错误页的兜底在 Activity 层ErrorFragment.kt 继承ErrorSupportFragment,用 leanback 自带的lb_ic_sad_cloud图标、黑色背景、按钮文案取R.string.dismiss_error:internal fun setErrorContent(message: String) { imageDrawable ContextCompat.getDrawable( context!!, androidx.leanback.R.drawable.lb_ic_sad_cloud) this.message message buttonText resources.getString(R.string.dismiss_error) buttonClickListener View.OnClickListener { fragmentManager!!.beginTransaction().remove(thisErrorFragment).commit() } }按钮只移除自身、不重试,恢复靠下一条链路自动完成。MainActivity.kt 里还有一处兜底:一旦真正开始播放,若错误页还挂着就顺手移除:fun isPlaying() { if (errorFragment.isVisible) { supportFragmentManager.beginTransaction() .remove(errorFragment).commit() } }重试机制:四个计数器各自设了哪些边界8 次上限设在哪,什么时候归零重取上限定义在 TVViewModel.kt,每个频道一份,随频道切换天然隔离:var retryTimes 0 var retryMaxTimes 8 var tokenFHRetryTimes 0 var tokenFHRetryMaxTimes 8Request.kt 中fetchAuth/fetchVideo的每一个onResponse失败分支和onFailure都走同一套逻辑:计数器加一后在 Retrofit 回调里递归重发,中间没有延时。每次重发前先cancelCall()掐掉在途请求,防止旧回调和新一轮交叉。地址成功到手那行tvModel.retryTimes 0把计数归零,所以 8 次是每次拉地址尝试的预算,不是全局配额。港澳台频道用的是另一组计数fetchData开头按频道分流,channel 港澳台直接进fetchFAuth:fun fetchData(tvModel: TVViewModel) { if (tvModel.getTV().channel 港澳台) { fetchFAuth(tvModel) return } ... }该链路用tokenFHRetryTimes / tokenFHRetryMaxTimes(同样 8 次)独立计数,拿到live_url后归零,与央视频 token 链路的retryTimes互不干扰。一个上限被设成 0 的死分支tokenYSPRetryMaxTimes初始为 0。凡是需要刷新 token 的分支,判断tokenYSPRetryTimes tokenYSPRetryMaxTimes永远不成立,直接落到mustToken的 else 侧,用不带vusession的 cookie 重发fetchAuth:if (needToken tvModel.tokenYSPRetryTimes tvModel.tokenYSPRetryMaxTimes) { tvModel.tokenYSPRetryTimes tvModel.needGetToken true fetchAuth(tvModel) } else { if (!tvModel.getTV().mustToken) { fetchAuth(tvModel, cookie) } }所以改 token 重试上限要动 TVViewModel.kt 的字段,改 Request.kt 里的判断不会生效。恢复路径:静默重取与前台自动重播黑屏后为什么没有任何提示onPlayerError只打日志和触发changed(),不弹窗、不 Toast;8 次重取耗尽后同样只停,不提示。用户感知到的错误只有启动期 token 失败那一类。这意味着排查播放失败必须读 Log 里 TAG 为PlaybackVideoFragment和Request的输出,界面上什么都看不到。天猫魔盒为什么换渲染路径Utils.kt 里isTmallDevice()只比较Build.MANUFACTURER Tmall,PlayerFragment.kt 据此二选一:if (Utils.isTmallDevice()) { _binding!!.playerView.visibility View.GONE surfaceView _binding!!.surfaceView surfaceHolder.addCallback(this) } else { _binding!!.surfaceView.visibility View.GONE playerView _binding!!.playerView }魔盒走裸SurfaceViewSimpleExoPlayer,由surfaceCreated时建播放器并setVideoSurfaceHolder;其余设备走 media3 的PlayerView。同一套 URL 逻辑挂两个播放器上,排查设备相关问题前先确认走的是哪条渲染路径。前台恢复后的自动重播靠生命周期对偶onPause里对正在播放的播放器执行stop(),onStart检测到isPlaying false就prepare()play():override fun onStart() { super.onStart() if (playerView ! null playerView!!.player?.isPlaying false) { playerView!!.player?.prepare() playerView!!.player?.play() } ... }应用回前台即自动续播,不依赖任何错误事件。启动期同理,用ready计数卡门槛:网络回调、5 个 Fragment 各自调fragmentReady()加一,ready 6才调mainFragment.fragmentReady()拉起首个频道;N 以上设备的网络就绪要等registerDefaultNetworkCallback的onAvailable回调才计入。常见坑点tokenYSPRetryMaxTimes初值为 0,token 刷新分支是死代码,调上限要改 TVViewModel.kt 的字段而非 Request.kt 的判断。onPlayerError不弹任何提示,8 次重取耗尽后只停在日志里,排查播放失败不能只看界面。手动切源的nextSource/prevSource在 MainActivity.kt 中已被注释,多地址列表实际靠错误重取驱动,而不是手势切换。ready 6在网络不可用时可能一直凑不齐,启动卡在加载态;先看 Log 里ready $tag $ready停在哪个 tag。NetworkChangeReceiver的onReceive实际是空的,网络感知以 MainActivity 里的registerDefaultNetworkCallback为准。排查播放失败,从 Request.kt 的fetchData入口顺计数器读起,比从 UI 层倒推更快。【免费下载链接】my-tv我的电视 电视直播软件安装即可使用项目地址: https://gitcode.com/GitHub_Trending/my/my-tv创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考