当屏幕关闭后，App的Activity会进入暂停或停止状态，无法通过Activity.onKeyDown捕获按键事件，需要改用后台可用的监听机制，以下是两种可行方案：

方案一：使用MediaSession捕获全局按键事件 #

MediaSession是Android官方推荐的多媒体按键监听方案，即使App处于后台或屏幕关闭状态，也能稳定捕获音量键事件，兼容性更强。

步骤1：在VolumeModule中集成MediaSession #

修改VolumeModule类，添加MediaSession相关初始化与回调逻辑：

class VolumeModule(private val reactContext: ReactApplicationContext) :
    ReactContextBaseJavaModule(reactContext), LifecycleEventListener, MediaSessionCompat.Callback() {

    private val TAG = "VolumeManagerModule"
    private var isListening = false
    private var mediaSession: MediaSessionCompat? = null

    init {
        reactContext.addLifecycleEventListener(this)
        initMediaSession()
    }

    private fun initMediaSession() {
        mediaSession = MediaSessionCompat(reactContext, TAG).apply {
            // 标记处理媒体按键与传输控制
            setFlags(MediaSessionCompat.FLAG_HANDLES_MEDIA_BUTTONS or MediaSessionCompat.FLAG_HANDLES_TRANSPORT_CONTROLS)
            setCallback(this@VolumeModule)
            isActive = true
        }
    }

    // 重写MediaSession的按键回调，捕获音量键事件
    override fun onMediaButtonEvent(mediaButtonEvent: Intent): Boolean {
        val keyEvent = mediaButtonEvent.getParcelableExtra<KeyEvent>(Intent.EXTRA_KEY_EVENT) ?: return super.onMediaButtonEvent(mediaButtonEvent)
        
        if (keyEvent.action == KeyEvent.ACTION_DOWN) {
            when (keyEvent.keyCode) {
                KeyEvent.KEYCODE_VOLUME_UP -> {
                    Log.d(TAG, "Volume Up pressed (screen off)")
                    sendEventToJS("onVolumeUp", null)
                    return true // 消费事件，可阻止系统默认调整音量
                }
                KeyEvent.KEYCODE_VOLUME_DOWN -> {
                    Log.d(TAG, "Volume Down pressed (screen off)")
                    sendEventToJS("onVolumeDown", null)
                    return true
                }
            }
        }
        return super.onMediaButtonEvent(mediaButtonEvent)
    }

    // 保留原有其他方法...

    override fun onHostDestroy() {
        Log.d(TAG, "onHostDestroy called")
        stopListening()
        mediaSession?.release() // 释放MediaSession资源
    }
}

步骤2：统一按键处理逻辑（可选） #

如果希望屏幕点亮时也用MediaSession处理，可调整Activity的onKeyDown方法，避免重复逻辑：

override fun onKeyDown(keyCode: Int, event: KeyEvent?): Boolean {
    mediaSession?.dispatchMediaButtonEvent(KeyEvent(KeyEvent.ACTION_DOWN, keyCode))
    return true
}

方案二：使用BroadcastReceiver监听音量变化广播 #

通过监听系统音量变化的广播，间接捕获音量键操作，但无法区分是手动按键还是系统自动调整音量，适合对精度要求不高的场景。

步骤1：定义音量变化广播接收器 #

在VolumeModule中添加广播接收器逻辑：

private val volumeChangeReceiver = object : BroadcastReceiver() {
    override fun onReceive(context: Context?, intent: Intent?) {
        if (intent?.action == AudioManager.ACTION_VOLUME_CHANGED_ACTION) {
            val volumeType = intent.getIntExtra(AudioManager.EXTRA_VOLUME_STREAM_TYPE, -1)
            val direction = intent.getIntExtra(AudioManager.EXTRA_VOLUME_STREAM_TYPE, 0)
            
            // 仅处理媒体音量的变化
            if (volumeType == AudioManager.STREAM_MUSIC) {
                if (direction > 0) {
                    sendEventToJS("onVolumeUp", null)
                } else {
                    sendEventToJS("onVolumeDown", null)
                }
            }
        }
    }
}

步骤2：注册/注销广播接收器 #

修改startListening和stopListening方法，管理广播的生命周期：

@ReactMethod
fun startListening() {
    Log.d(TAG, "startListening called")
    if (!isListening) {
        sendEventToJS("onListeningStarted", null)
        val filter = IntentFilter(AudioManager.ACTION_VOLUME_CHANGED_ACTION)
        reactContext.registerReceiver(volumeChangeReceiver, filter)
        isListening = true
    }
}

@ReactMethod
fun stopListening() {
    Log.d(TAG, "stopListening called")
    if (isListening) {
        reactContext.unregisterReceiver(volumeChangeReceiver)
        isListening = false
    }
}

关键注意事项 #

• 权限与后台存活：两种方案均无需额外权限，但Android 12+对后台应用限制严格，若需长期后台监听，建议将App设置为前台服务，避免被系统回收。
• 系统行为控制：使用MediaSession时返回true会阻止系统调整音量，若需保留系统默认音量调整，改为返回false即可。
• 资源释放：务必在App销毁时释放MediaSession或注销广播接收器，避免内存泄漏。

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