为何onPictureInPictureModeChanged方法无法正常触发？

问题分析 #

你遇到的两个核心问题：

• 进入PiP模式时onPictureInPictureModeChanged未被调用：原因是API版本兼容漏洞——Android 8.0-8.1（API26-27）只触发单参数版本的回调，而你当前仅重写了Android 9.0+（API28+）的双参数版本，导致系统找不到对应回调入口。
• 提示需调用super.onPictureInPictureModeChanged：你代码里已调用该方法，大概率是Lint工具的临时误报，或单参数版本的回调未补全super调用导致。

解决步骤 #

1. 配置Activity清单（必做） #

打开AndroidManifest.xml，给启用PiP的Activity添加以下属性：

<activity
    android:name=".YourVideoActivity"
    android:supportsPictureInPicture="true"
    android:configChanges="screenSize|smallestScreenSize|screenLayout|orientation"
    >
    <!-- 其他原有配置 -->
</activity>

• supportsPictureInPicture="true"：告知系统该Activity支持PiP模式，这是回调触发的前置条件。
• configChanges：避免进入/退出PiP时Activity重建，保证状态稳定。

2. 兼容不同API版本的回调方法 #

同时重写单参数（适配API26-27）和双参数（适配API28+）的回调方法，把业务逻辑抽成单独方法避免重复代码：

// 适配Android 8.0-8.1（API26-27）
override fun onPictureInPictureModeChanged(isInPictureInPictureMode: Boolean) {
    super.onPictureInPictureModeChanged(isInPictureInPictureMode)
    updatePipUi(isInPictureInPictureMode)
}

// 适配Android 9.0及以上（API28+）
override fun onPictureInPictureModeChanged(
    isInPictureInPictureMode: Boolean,
    newConfig: Configuration?
) {
    super.onPictureInPictureModeChanged(isInPictureInPictureMode, newConfig)
    updatePipUi(isInPictureInPictureMode)
}

// 统一处理PiP模式切换的UI逻辑
private fun updatePipUi(isInPiP: Boolean) {
    if (isInPiP) {
        Log.d(TAG, "进入画中画模式")
        pipButton.visibility = View.GONE
    } else {
        Log.d(TAG, "退出画中画模式")
        pipButton.visibility = View.VISIBLE
    }
}

3. 修复PiP启动方法的潜在问题 #

你的pictureInPictureMode()方法存在两个隐患，修改后代码如下：

// 直接初始化Builder，避免空指针风险
private val pipParamsBuilder = PictureInPictureParams.Builder()

private fun pictureInPictureMode() {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        Log.d(TAG, "设备支持画中画功能")
        // 确保VideoView已完成测量，避免宽高为0导致比例错误
        if (videoView.width == 0 || videoView.height == 0) {
            videoView.post { enterPipProperly() }
            return
        }
        enterPipProperly()
    } else {
        Toast.makeText(this, "你的设备不支持画中画功能", Toast.LENGTH_LONG).show()
    }
}

private fun enterPipProperly() {
    val aspectRatio = Rational(videoView.width, videoView.height)
    val pipParams = pipParamsBuilder.setAspectRatio(aspectRatio).build()
    enterPictureInPictureMode(pipParams)
}

4. 解决Lint提示错误 #

如果仍出现需调用super的提示：

• 确认两个版本的回调方法都已调用对应super方法（上述代码已处理）。
• 重启Android Studio或清理缓存（File → Invalidate Caches...），可解决多数Lint误报问题。

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