Android开发如何在PiP画中画模式下仅显示指定布局视图

首先明确核心误区：
setSourceRectHint() 仅为系统提供进入PiP的过渡动画位置参考，不会自动裁剪Activity内容、隐藏其他布局，这是你之前代码不生效的根本原因。PiP模式本质是把当前Activity的窗口整体缩小，所有可见的View都会被缩小显示，要只展示指定视图，必须主动控制其他元素的显隐。

具体实现步骤 #

1. 监听PiP状态切换，动态控制布局显隐 #

重写Activity的onPictureInPictureModeChanged回调，在进入PiP时隐藏非目标元素，退出时恢复：

override fun onPictureInPictureModeChanged(isInPiP: Boolean, newConfig: Configuration) {
    super.onPictureInPictureModeChanged(isInPiP, newConfig)
    if (isInPiP) {
        // 隐藏头部布局
        mBinding.headerLayout.visibility = View.GONE
        // 隐藏所有动态自定义弹窗：Dialog/PopupWindow直接dismiss，addView到根布局的浮层设GONE或移除
        dismissAllCustomFloatingViews()
    } else {
        // 退出PiP时恢复原有布局
        mBinding.headerLayout.visibility = View.VISIBLE
        // 按需恢复之前的弹窗状态
    }
}

2. 修正PiP参数配置，解决setSourceRectHint不生效问题 #

你之前的参数配置有两个错误，按如下方式调整：

• 不要在onUserLeaveHint中临时构建全量PiP参数，基础参数（自动进入、宽高比、源矩形）在Activity布局加载完成后提前设置给系统，onUserLeaveHint中仅触发进入逻辑即可
• setSourceRectHint需要传入视频布局相对于当前Activity窗口的相对坐标，不要用全局屏幕坐标，否则动画位置错乱、参数失效
  参考代码：

// 在onCreate/onStart布局完成后初始化PiP基础参数
private fun initPipParams() {
    val pipRect = Rect()
    // 获取视频布局相对于父容器的正确坐标
    mBinding.videoStreamLayout.getHitRect(pipRect)

    val pipParams = PictureInPictureParams.Builder()
        .setAspectRatio(Rational(9, 16)) // 必须和视频布局实际宽高比完全一致
        .setAutoEnterEnabled(true)
        .setSourceRectHint(pipRect)
        .setSeamlessResizeEnabled(false)
        .build()
    // 提前把参数设置给系统
    setPictureInPictureParams(pipParams)
}

override fun onUserLeaveHint() {
    super.onUserLeaveHint()
    // 触发进入PiP即可，不需要重复构建参数
    enterPictureInPictureMode()
}

3. 动态弹窗特殊处理 #

你提到的代码动态控制的自定义弹窗，不要依赖系统自动隐藏：

• 如果是Dialog/PopupWindow类型组件，进入PiP时统一调用dismiss()
• 如果是直接addView到Activity根布局的自定义浮层，进入PiP时设置visibility = View.GONE或者从父容器移除，避免遮挡视频内容

问题场景参考 #

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