Android(Kotlin)中如何用AudioManager检测用户超最大音量按音量键

我正在Android应用中实现自定义音频管理器，使用AudioManager和监听android.media.VOLUME_CHANGED_ACTION的BroadcastReceiver来监听音量变化，但无法检测到用户在音量达到最大值后继续按下音量上键的操作。

以下是我的实现代码：

class OHAudioManagerImpl @Inject constructor(private val serviceProvider: EnvironmentServiceProvider) : OHAudioManager {
    private val context = serviceProvider.providerApplication().applicationContext

    private val audioManager = context.getSystemService(Context.AUDIO_SERVICE) as AudioManager
    private var currentVolume = audioManager.getStreamVolume(AudioManager.STREAM_MUSIC)
    private var isMuted = audioManager.isStreamMute(AudioManager.STREAM_MUSIC)
    private var listener: AudioChangeListener? = null

    val keyVolumeChangedAction = "android.media.VOLUME_CHANGED_ACTION"


    private val volumeChangeReceiver = object : BroadcastReceiver() {
        override fun onReceive(context: Context, intent: Intent) {
            if (intent.action == keyVolumeChangedAction) {
                handleVolumeChange()
            }
        }
    }

    override fun onVolumeChangeListener(listener: AudioChangeListener?) {
        this.listener = listener
    }
    
    override fun register() {
        val filter = IntentFilter(keyVolumeChangedAction)
        context.registerReceiver(volumeChangeReceiver, filter)
    }
    
    override fun unregister() {
        context.unregisterReceiver(volumeChangeReceiver)
    }
    
    private fun handleVolumeChange() {
        val newVolume = audioManager.getStreamVolume(AudioManager.STREAM_MUSIC)
        val newMuteState = audioManager.isStreamMute(AudioManager.STREAM_MUSIC)
        
        if (newMuteState != isMuted) {
            isMuted = newMuteState
            listener?.onVolumeChanged(if (isMuted) OHAudioChangeState.Mute else OHAudioChangeState.UnMute)
        }

        when {
            newVolume > currentVolume -> {
                listener?.onVolumeChanged(OHAudioChangeState.VolumeUp)
            }

            newVolume < currentVolume -> {
                listener?.onVolumeChanged(OHAudioChangeState.VolumeDown)
            }
        }
        
        currentVolume = newVolume
    }
}

问题在于我只能在音量等级变化时检测到音量改变，当用户在音量已达最大值时按下音量上键，不会触发额外事件。我希望能检测到用户在音量达到最大值后继续按下音量上键的操作，请问有什么解决方法或替代方案？

方法一：Activity/Fragment内监听物理按键事件 #

这种方式仅在应用处于前台时生效，直接捕获音量键按下动作，无需依赖系统广播：

override fun onKeyDown(keyCode: Int, event: KeyEvent?): Boolean {
    if (keyCode == KeyEvent.KEYCODE_VOLUME_UP) {
        val audioManager = getSystemService(Context.AUDIO_SERVICE) as AudioManager
        val maxVolume = audioManager.getStreamMaxVolume(AudioManager.STREAM_MUSIC)
        val currentVolume = audioManager.getStreamVolume(AudioManager.STREAM_MUSIC)
        
        if (currentVolume >= maxVolume) {
            // 音量已达最大值，用户仍按下音量上键，触发自定义回调
            listener?.onVolumeChanged(OHAudioChangeState.VolumeUpAtMax)
            // 返回true可阻止系统处理该事件（比如不播放默认提示音），按需选择
            return true
        }
    }
    return super.onKeyDown(keyCode, event)
}

方法二：使用AccessibilityService实现后台监听 #

如果需要在应用后台也能检测到按键操作，可借助AccessibilityService监听系统级按键事件：

1. 创建AccessibilityService子类：

class VolumeKeyAccessibilityService : AccessibilityService() {
    override fun onKeyEvent(event: KeyEvent?): Boolean {
        event?.takeIf { it.action == KeyEvent.ACTION_DOWN && it.keyCode == KeyEvent.KEYCODE_VOLUME_UP }?.let {
            val audioManager = getSystemService(Context.AUDIO_SERVICE) as AudioManager
            val maxVolume = audioManager.getStreamMaxVolume(AudioManager.STREAM_MUSIC)
            val currentVolume = audioManager.getStreamVolume(AudioManager.STREAM_MUSIC)
            
            if (currentVolume >= maxVolume) {
                // 通过全局回调、EventBus等方式将事件传递给自定义音频管理器
                // 示例：OHAudioManagerImpl.getInstance()?.notifyVolumeUpAtMax()
            }
            return true
        }
        return super.onKeyEvent(event)
    }

    override fun onAccessibilityEvent(event: AccessibilityEvent?) {}
    override fun onInterrupt() {}
}

2. 在AndroidManifest中注册服务并配置权限：

<service
    android:name=".VolumeKeyAccessibilityService"
    android:permission="android.permission.BIND_ACCESSIBILITY_SERVICE">
    <intent-filter>
        <action android:name="android.accessibilityservice.AccessibilityService" />
    </intent-filter>
    <meta-data
        android:name="android.accessibilityservice"
        android:resource="@xml/accessibility_service_config" />
</service>

3. 创建res/xml/accessibility_service_config.xml配置文件：

<?xml version="1.0" encoding="utf-8"?>
<accessibility-service xmlns:android="http://schemas.android.com/apk/res/android"
    android:accessibilityEventTypes="typeAllMask"
    android:accessibilityFeedbackType="feedbackGeneric"
    android:accessibilityFlags="flagDefault"
    android:canRequestFilterKeyEvents="true"
    android:description="@string/accessibility_service_desc" />

注意：使用该方案需要用户手动在系统设置中为应用开启辅助功能，需在应用内引导用户完成配置。

方法三：检查广播Intent的额外参数（兼容性有限） #

部分设备在音量已达最大时按下上键，仍会发送VOLUME_CHANGED_ACTION广播，且前后音量值相同，可尝试在广播接收器中判断：

private val volumeChangeReceiver = object : BroadcastReceiver() {
    override fun onReceive(context: Context, intent: Intent) {
        if (intent.action == keyVolumeChangedAction) {
            val streamType = intent.getIntExtra(AudioManager.EXTRA_VOLUME_STREAM_TYPE, -1)
            if (streamType == AudioManager.STREAM_MUSIC) {
                val currentVol = intent.getIntExtra(AudioManager.EXTRA_VOLUME_STREAM_VALUE, -1)
                val prevVol = intent.getIntExtra(AudioManager.EXTRA_PREV_VOLUME_STREAM_VALUE, -1)
                val maxVol = audioManager.getStreamMaxVolume(AudioManager.STREAM_MUSIC)
                
                if (currentVol == maxVol && prevVol == maxVol) {
                    // 检测到音量已达最大时的上键操作
                    listener?.onVolumeChanged(OHAudioChangeState.VolumeUpAtMax)
                } else {
                    handleVolumeChange()
                }
            }
        }
    }
}

该方案兼容性较差，不同厂商设备行为可能不一致，仅作为补充方案使用。

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