ExoPlayer PlayerView使用setImageDurationMs无法渲染图片求助

问题核心原因 #

ExoPlayer默认未启用静态图片渲染组件，同时MediaItem缺少必要的资源类型标识，或存在URI权限问题，导致图片无法被正确加载渲染。

具体解决步骤 #

1. 启用图片渲染器 #

默认ExoPlayer.Builder不包含BitmapRenderer（负责静态图片渲染），需自定义渲染器工厂并启用该组件：

// 创建支持图片渲染的RenderersFactory
val renderersFactory = DefaultRenderersFactory(this)
    .setEnableBitmapRenderer(true)

// 使用该工厂构建ExoPlayer实例
player = ExoPlayer.Builder(this, renderersFactory).build()

2. 完善MediaItem配置 #

为MediaItem明确指定图片的MIME类型，帮助ExoPlayer准确识别资源类型：

val mediaItem = MediaItem.Builder()
    .setUri("content://media/external/images/media/1000005827")
    .setImageDurationMs(30000) // 设置图片展示时长
    .setMimeType(MimeTypes.IMAGE_JPEG) // 根据实际图片类型选择，如IMAGE_PNG
    .build()

3. 验证URI访问权限 #

若使用content://类型的系统媒体URI，需确保应用已获取对应权限：

• Android 10及以下：在AndroidManifest.xml中添加READ_EXTERNAL_STORAGE权限，并在运行时动态申请。
• Android 11及以上：通过MediaStore API访问图片，或仅在必要时申请MANAGE_EXTERNAL_STORAGE权限。

4. 检查PlayerView布局配置 #

确保布局中的PlayerView有合适的尺寸和缩放模式，避免因布局问题导致图片无法显示：

<com.google.android.exoplayer2.ui.PlayerView
    android:id="@+id/player_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:resize_mode="fill" /> <!-- 可根据需求选择fit、fill等缩放模式 -->

完整修复后的示例代码 #

val playlist: MutableList<MediaItem> = mutableListOf()

// 构建正确配置的MediaItem
val mediaItem = MediaItem.Builder()
    .setUri("content://media/external/images/media/1000005827")
    .setImageDurationMs(30000)
    .setMimeType(MimeTypes.IMAGE_JPEG)
    .build()
playlist.add(mediaItem)

// 启用图片渲染器的ExoPlayer实例
val renderersFactory = DefaultRenderersFactory(this)
    .setEnableBitmapRenderer(true)
player = ExoPlayer.Builder(this, renderersFactory).build()

playerView = findViewById(R.id.player_view)
player.addMediaItems(playlist)
playerView.player = player
player.prepare()
player.play()

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