解决AndroidX Media3中设置MediaItem时出现NullPointerException的问题

在使用AndroidX Media3库进行媒体播放开发时，开发者可能会遇到一个常见的错误：在设置MediaItem时抛出NullPointerException。这个问题通常发生在没有正确配置MediaItem的情况下。

问题现象

当开发者尝试通过MediaItem.Builder构建一个MediaItem并设置给ExoPlayer时，可能会遇到如下异常堆栈：

java.lang.NullPointerException
    at androidx.media3.common.util.Assertions.checkNotNull
    at androidx.media3.exoplayer.source.DefaultMediaSourceFactory.createMediaSource
    at androidx.media3.exoplayer.ExoPlayerImpl.createMediaSources
    at androidx.media3.exoplayer.ExoPlayerImpl.setMediaItems

问题原因

这个问题的根本原因是开发者构建MediaItem时没有设置必要的URI参数。Media3库要求每个可播放的MediaItem都必须包含一个有效的媒体资源URI，这是播放内容的基础。

解决方案

正确的做法是在构建MediaItem时，必须设置媒体资源的URI。以下是正确的代码示例：

val builder = MediaMetadata.Builder()
    .setArtist(p.getFeedTitle())
    .setTitle(p.getEpisodeTitle())
    .setAlbumArtist(p.getFeedTitle())
    .setDisplayTitle(p.getEpisodeTitle())
    .setSubtitle(p.getFeedTitle())

val mediaItem = MediaItem.Builder()
    .setUri("https://example.com/media.mp3") // 必须设置URI
    .setMediaMetadata(builder.build())
    .build()

exoPlayer?.setMediaItem(mediaItem)

技术背景

在Media3架构中，MediaItem代表一个可播放的媒体项，它包含两个核心部分：

1. 媒体元数据（MediaMetadata）：用于描述媒体内容的信息
2. 媒体资源标识（URI）：用于定位和加载实际的媒体内容

ExoPlayer在创建媒体源（MediaSource）时，会检查MediaItem是否包含有效的URI。如果没有设置URI，就会抛出NullPointerException。

最佳实践

1. 始终为MediaItem设置有效的URI
2. 元数据是可选的，但建议设置以提供更好的用户体验
3. 如果是从ExoPlayer 2迁移到Media3，注意API的变化，特别是MediaItem现在是播放的核心概念
4. 不需要同时设置MediaSource和MediaItem，选择其中一种方式即可

总结

在AndroidX Media3开发中，正确配置MediaItem是确保媒体播放正常工作的关键步骤。记住为每个MediaItem设置URI可以避免NullPointerException，并确保播放器能够正确加载和播放媒体内容。