You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Jetpack Compose中Media3 ExoPlayer全屏视频拉伸问题求助

Jetpack Compose中Media3 PlayerView全屏时画面拉伸问题修复

你遇到的问题核心是:PlayerView在Compose布局中首次渲染或切换视频时,还未获取到视频的实际宽高比,只能按fillMaxSize()强制拉伸;而屏幕旋转会触发全局重布局,此时PlayerView已拿到视频尺寸,因此能正确适配比例。以下是针对性的修复方案:

修复步骤

1. 避免重复触发媒体文件加载

首先把viewModel.openMediaFile(mediaFile)放到LaunchedEffect中,防止Compose重组时重复调用:

Scaffold(
    topBar = { MyAppBar() },
    content = { innerPadding ->
        // 仅当mediaFile变化时执行媒体加载
        LaunchedEffect(mediaFile) {
            viewModel.openMediaFile(mediaFile)
        }
        Box(
            modifier = Modifier
                .fillMaxSize()
                .padding(innerPadding)
                .background(MyTheme.colors.background),
            contentAlignment = Alignment.Center
        ) {
            // ... PlayerView代码
        }
    }
)

2. 配置PlayerView的视频缩放模式

PlayerView继承自AspectRatioFrameLayout,需设置resizeMode控制视频的适配逻辑(之前你设置的artworkDisplayMode仅针对封面图):

AndroidView(
    modifier = Modifier.fillMaxSize(),
    factory = { context ->
        PlayerView(context).apply {
            player = viewModel.player
            artworkDisplayMode = PlayerView.ARTWORK_DISPLAY_MODE_FIT
            // 核心:设置视频按比例适配容器
            resizeMode = AspectRatioFrameLayout.RESIZE_MODE_FIT
            artworkPlaceHolder?.let { defaultArtwork = it }
        }
    },
    update = { playerView ->
        // 监听视频尺寸变化和媒体项切换,触发重布局
        val playerListener = object : Player.Listener {
            override fun onVideoSizeChanged(videoSize: VideoSize) {
                super.onVideoSizeChanged(videoSize)
                // 拿到视频尺寸后,异步触发PlayerView重布局
                playerView.post { playerView.requestLayout() }
            }

            override fun onMediaItemTransition(mediaItem: MediaItem?, reason: Int) {
                super.onMediaItemTransition(mediaItem, reason)
                // 切换视频后强制重绘,确保新视频尺寸生效
                playerView.post { playerView.requestLayout() }
            }
        }
        // 先移除旧监听,避免内存泄漏和重复回调
        viewModel.player.removeListener(playerListener)
        viewModel.player.addListener(playerListener)
    }
)

3. 保持播放器的缩放模式配置

保留你之前对ExoPlayer的缩放模式设置,和PlayerView的resizeMode形成双重保障:

val player = ExoPlayer.Builder(context)
    .setVideoScalingMode(C.VIDEO_SCALING_MODE_SCALE_TO_FIT)
    .build()

为什么这样能解决问题?

  • LaunchedEffect确保媒体文件仅在必要时加载,避免多次重置播放器状态
  • resizeMode = RESIZE_MODE_FIT明确告诉PlayerView要按视频原始比例适配容器,而非强制拉伸
  • 监听onVideoSizeChanged和onMediaItemTransition事件,在视频尺寸就绪或切换后主动触发重布局,让PlayerView能基于正确的视频宽高比重新计算布局参数,解决首次加载时尺寸缺失导致的拉伸问题

内容的提问来源于stack exchange,提问作者Monica Ivan

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.27 16:30:32