Android中如何仅让Fragment内的内容进入Picture-in-Picture模式？

嘿，这个问题我刚好踩过坑！其实系统原生的PIP模式本身是绑定Activity的，但我们可以用点小技巧，实现看起来只有Fragment里的SurfaceView进入PIP的效果，完全不用自定义窗口，直接用系统内置功能就行，具体步骤给你捋清楚：

1. 先给宿主Activity配置PIP基础权限 #

首先得在AndroidManifest.xml里给承载Fragment的Activity声明支持PIP，还要加上配置防止切换PIP时Activity重启：

<activity
    android:name=".YourHostActivity"
    <!-- 允许Activity调整尺寸，PIP必备 -->
    android:resizeableActivity="true"
    <!-- 声明支持PIP模式 -->
    android:supportsPictureInPicture="true"
    <!-- 避免切换PIP时Activity重启 -->
    android:configChanges="screenSize|smallestScreenSize|screenLayout|orientation">
</activity>

2. 进入PIP前的布局调整（核心步骤） #

系统PIP会把整个Activity缩成小窗口，所以我们要在进入PIP前，把Activity里的其他视图（比如顶部栏、底部导航、其他Fragment容器）全部隐藏，只保留目标Fragment的内容，让它占满整个Activity屏幕，这样PIP窗口就只会显示Fragment里的SurfaceView了：

// 在你的目标Fragment里写一个触发PIP的方法
fun triggerPipMode() {
    val hostActivity = requireActivity()
    // 隐藏Activity里的其他非必要布局（比如你的主页面容器、导航栏等）
    hostActivity.findViewById<View>(R.id.main_nav_bar).visibility = View.GONE
    hostActivity.findViewById<View>(R.id.other_fragment_container).visibility = View.GONE

    // 让当前Fragment的容器占满整个Activity
    val fragmentContainer = requireView().parent as ViewGroup
    // 提前保存原布局参数，退出PIP时要恢复
    originalLayoutParams = fragmentContainer.layoutParams
    fragmentContainer.layoutParams = ViewGroup.LayoutParams(
        ViewGroup.LayoutParams.MATCH_PARENT,
        ViewGroup.LayoutParams.MATCH_PARENT
    )

    // 配置PIP的宽高比，要和你的SurfaceView比例一致，避免黑边
    val surfaceRatio = Rational(surfaceView.width, surfaceView.height)
    val pipConfig = PictureInPictureParams.Builder()
        .setAspectRatio(surfaceRatio)
        .build()

    // 调用Activity的方法进入PIP模式
    hostActivity.enterPictureInPictureMode(pipConfig)
}

记得提前在Fragment里定义变量private var originalLayoutParams: ViewGroup.LayoutParams? = null来保存原布局参数。

3. 处理PIP切换的生命周期回调 #

当进入或退出PIP模式时，Fragment会收到回调，我们要在这里恢复布局状态，同时处理SurfaceView的渲染逻辑：

override fun onPictureInPictureModeChanged(isInPipMode: Boolean, newConfig: Configuration?) {
    super.onPictureInPictureModeChanged(isInPipMode, newConfig)
    val hostActivity = requireActivity()
    if (isInPipMode) {
        // 进入PIP时，确保SurfaceView继续工作（比如播放视频不要暂停）
        surfaceView.keepRendering()
        // 可以在这里隐藏Fragment里的非必要控件，比如按钮、标题
        requireView().findViewById<View>(R.id.fragment_title).visibility = View.GONE
    } else {
        // 退出PIP时，恢复Activity的原有布局
        hostActivity.findViewById<View>(R.id.main_nav_bar).visibility = View.VISIBLE
        hostActivity.findViewById<View>(R.id.other_fragment_container).visibility = View.VISIBLE
        // 恢复Fragment容器的原布局参数
        originalLayoutParams?.let {
            val fragmentContainer = requireView().parent as ViewGroup
            fragmentContainer.layoutParams = it
        }
        // 恢复SurfaceView的正常状态，以及Fragment里的控件显示
        surfaceView.restoreNormalRendering()
        requireView().findViewById<View>(R.id.fragment_title).visibility = View.VISIBLE
    }
}

这里的keepRendering()和restoreNormalRendering()是你自己针对SurfaceView的逻辑，比如视频播放的话就是继续播放/恢复UI控制。

4. SurfaceView的适配注意点 #

• 一定要保证SurfaceView的宽高比和PIP配置的AspectRatio一致，不然PIP窗口会出现黑边或者拉伸变形
• PIP模式下，Activity的触摸事件会受限，如果你需要SurfaceView支持触摸（比如手势控制视频），要确保逻辑适配小窗口的尺寸
• 进入PIP后，SurfaceView不要随便释放资源，除非你需要暂停内容

核心逻辑说明 #

系统原生PIP确实是Activity级别的，但通过动态调整Activity的布局，只保留目标Fragment的内容，就能达到「Fragment单独进入PIP」的视觉效果，完全复用系统的PIP功能，不用自己造轮子。

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