Media3 ExoPlayer PlayerView进度条无法调整、快进快退按钮禁用问题咨询

我尝试播放.m4a音频文件（采用DocumentProvider/SAF URI，示例：content://com.android.externalstorage.documents/tree/primary%3AVoiceRecorder/document/primary%3AVoiceRecorder%2F2024-02-09%2017h%2016m%2040s.m4a），但无法通过进度条调整播放位置，且快进/快退按钮被禁用，请问这是什么原因？

代码实现 #

播放器初始化代码 #

val player = ExoPlayer.Builder(context).build()
player.setMediaItem(MediaItem.fromUri(audioFileUri))
player.playWhenReady = true
player.prepare()

UI代码 #

AndroidView(
    modifier = Modifier
        .fillMaxSize(),
    factory = {
        // androidx.media3.ui.PlayerView
        PlayerView(it).also { playerView ->
            playerView.controllerHideOnTouch = false
            playerView.controllerAutoShow = true
            playerView.controllerShowTimeoutMs = 0
            playerView.player = player
            playerView.setShowRewindButton(true)
            playerView.setShowFastForwardButton(true)
            playerView.showController()
        }
    },
)

依赖版本 #

val media3Version = "1.2.1"
implementation("androidx.media3:media3-exoplayer:$media3Version")
implementation("androidx.media3:media3-session:$media3Version")
implementation("androidx.media3:media3-ui:$media3Version")

原因分析与解决方案 #

核心原因 #

• 媒体时长无法获取：ExoPlayer需要明确的媒体总时长才能启用Seek（拖动进度、快进快退）功能。通过SAF URI直接加载时，若播放器无法读取文件的时长元数据，会默认将媒体标记为不可Seek的流式内容，进而禁用相关控件。
• SAF权限或文件访问限制：即使拿到了SAF URI，若没有获取持久化读取权限，或者文件描述符的访问方式不支持随机读取，播放器无法跳转到指定位置，导致Seek功能失效。

解决方案 #

1. 通过文件描述符构建MediaSource
   不要直接用URI创建MediaItem，而是通过ContentResolver打开文件描述符，确保播放器能完整读取文件信息：

   val resolver = context.contentResolver
   resolver.openFileDescriptor(audioFileUri, "r")?.use { fd ->
       val dataSourceFactory = DefaultDataSource.Factory(context)
       val mediaSource = ProgressiveMediaSource.Factory(dataSourceFactory)
           .createMediaSource(MediaItem.fromUri(audioFileUri))
       player.setMediaSource(mediaSource)
       player.playWhenReady = true
       player.prepare()
   }
   

2. 获取SAF持久化权限
   如果是通过文件选择器获取的URI，需要调用takePersistableUriPermission确保后续访问不受限：

   val takeFlags = Intent.FLAG_GRANT_READ_URI_PERMISSION or Intent.FLAG_GRANT_WRITE_URI_PERMISSION
   context.contentResolver.takePersistableUriPermission(audioFileUri, takeFlags)
   

3. 检查文件元数据完整性
   部分录制的.m4a文件可能缺失时长等关键元数据，导致播放器无法识别总时长。可以用第三方音频工具打开文件，确认元数据是否完整。若缺失，可重新导出或修复文件元数据。

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