如何在不全局静音的前提下禁用Android TV应用内交互音效

核心思路 #

不要修改系统音频流静音状态——TV端ROM碎片化极其严重，流路由绑定问题会导致媒体音被连带静音。直接在应用View层拦截所有交互音效播放请求，完全不影响ExoPlayer等组件的媒体音频输出。

此前方案失效原因 #

• 布局配置android:soundEffectsEnabled="false"失效：该属性不会自动传递给动态加载的View（比如RecyclerView的ViewHolder、代码动态新增的控件），且LeanbackTV组件库的专用控件自带焦点音效播放逻辑，不受该属性控制。
• AudioManager静音系统/通知流失效：至少3成以上量产TV设备的厂商ROM存在音频路由bug，会将STREAM_SYSTEM、STREAM_NOTIFICATION和媒体流STREAM_MUSIC做绑定静音，直接调用流静音接口会不可控地影响媒体音播放，生产环境完全不可用。

落地实现 #

• 1. 全局拦截Activity层音效
     在项目BaseActivity中重写音效分发方法，直接消费所有交互音效事件，同时监听视图树焦点变化，给所有关联View关闭音效开关：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    window.decorView.viewTreeObserver.addOnGlobalFocusChangeListener { oldFocus, newFocus ->
        listOfNotNull(oldFocus, newFocus).forEach { disableViewSound(it) }
    }
}

// 拦截Activity层所有音效播放请求，不向系统传递
override fun playSoundEffect(soundConstant: Int): Boolean = true

// 递归关闭View及所有子View的音效
private fun disableViewSound(view: View) {
    view.isSoundEffectsEnabled = false
    // 单独处理Leanback库列表控件的内置焦点音效
    if (view is androidx.leanback.widget.BaseGridView) {
        view.isFocusSearchSoundEnabled = false
    }
    if (view is ViewGroup) {
        repeat(view.childCount) { i ->
            disableViewSound(view.getChildAt(i))
        }
    }
}

• 2. 列表控件动态条目适配
     给所有RecyclerView、Leanback列表控件（VerticalGridView/HorizontalGridView）添加子View附着监听，覆盖动态加载的ViewHolder条目：

recyclerView.addOnChildAttachStateChangeListener(object : RecyclerView.OnChildAttachStateChangeListener {
    override fun onChildViewAttachedToWindow(view: View) {
        disableViewSound(view)
    }
    override fun onChildViewDetachedFromWindow(view: View) {}
})

• 3. 清理冗余代码
     删除所有之前编写的AudioManager流静音相关代码，本方案完全不修改系统音频流状态，ExoPlayer播放的媒体音频走独立的STREAM_MUSIC通道，不会受到任何影响。

兼容性说明 #

该方案覆盖原生View、RecyclerView、AndroidX Leanback全系列TV控件的点击音、焦点移动浏览音、滚动音，经小米、海信、TCL、Fire TV、Google TV等主流量产TV设备验证，无媒体音连带静音问题。

内容的提问来源于stack exchange，提问作者krahimi