我正在使用最新的Android Media3库,但是我在使用它时发现了一个问题...
我创建了一个MediaSessionService,然后在Activity中获取了MediaController,然后当我尝试调用媒体控制器并添加一些MediaItem时,出现了错误:
java.lang.NullPointerException
at androidx.media3.common.util.Assertions.checkNotNull(Assertions.java:155)
at androidx.media3.exoplayer.source.DefaultMediaSourceFactory.createMediaSource(DefaultMediaSourceFactory.java:338)
at androidx.media3.exoplayer.ExoPlayerImpl.createMediaSources(ExoPlayerImpl.java:1164)
at androidx.media3.exoplayer.ExoPlayerImpl.addMediaItems(ExoPlayerImpl.java:463)
at androidx.media3.exoplayer.SimpleExoPlayer.addMediaItems(SimpleExoPlayer.java:1146)
at androidx.media3.common.BasePlayer.addMediaItems(BasePlayer.java:69)
at androidx.media3.common.BasePlayer.addMediaItem(BasePlayer.java:64)
at androidx.media3.common.ForwardingPlayer.addMediaItem(ForwardingPlayer.java:90)
at androidx.media3.session.PlayerWrapper.addMediaItem(PlayerWrapper.java:346)
at androidx.media3.session.MediaSessionStub.lambda$addMediaItem$28(MediaSessionStub.java:1052)
at androidx.media3.session.MediaSessionStub$$ExternalSyntheticLambda8.run(Unknown Source:2)
at androidx.media3.session.MediaSessionStub.lambda$getSessionTaskWithPlayerCommandRunnable$2$androidx-media3-session-MediaSessionStub(MediaSessionStub.java:234)
at androidx.media3.session.MediaSessionStub$$ExternalSyntheticLambda52.run(Unknown Source:14)
at androidx.media3.session.MediaSessionStub.lambda$flushCommandQueue$50(MediaSessionStub.java:1479)
at androidx.media3.session.MediaSessionStub$$ExternalSyntheticLambda58.run(Unknown Source:2)
at androidx.media3.common.util.Util.postOrRun(Util.java:517)
at androidx.media3.session.MediaSessionStub.flushCommandQueue(MediaSessionStub.java:1473)
at androidx.media3.session.MediaControllerImplBase$FlushCommandQueueHandler.handleMessage(MediaControllerImplBase.java:3035)
at android.os.Handler.dispatchMessage(Handler.java:106)
at android.os.Looper.loopOnce(Looper.java:201)
at android.os.Looper.loop(Looper.java:288)
at android.app.ActivityThread.main(ActivityThread.java:7813)
at java.lang.reflect.Method.invoke(Native Method)
at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:548)
at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:1003)
于是我检查了DefaultMediaSourceFactory的createMediaSource函数,发现它正在检查MediaItem的
localConfiguration
是否为null:
@Override
public MediaSource createMediaSource(MediaItem mediaItem) {
checkNotNull(mediaItem.localConfiguration);
...
}
这是本地配置:
/**
* Optional configuration for local playback. May be {@code null} if shared over process
* boundaries.
*/
@Nullable public final LocalConfiguration localConfiguration;
我非常确定我创建 MediaItem 的方式没有问题,并且它在 Service 内运行良好,但是当我尝试在 Activity 中插入 MediaItem 时,会发生错误。根据评论,我猜这可能是跨进程通信问题,但我对此没有任何线索。有人有 Media3 的经验吗?
当您从控制器添加/设置 MediaItems 时,出于
安全/隐私原因,MediaItem 的
localConfiguration
(uri、mimeType、drm 配置等)将被删除。如果没有 localConfiguration
,播放器将无法播放媒体项目。我们需要将缺失的信息添加回 MediaItem。
打开您在服务中创建 MediaLibrarySession 时定义的回调。
// My MediaLibraryService
// onCreate()
mediaLibrarySession = MediaLibrarySession.Builder(
this,
player,
librarySessionCallback // <--
).build()
// NOTE: If you are using MediaSessionService instead of MediaLibraryService,
// use `setCallback(librarySessionCallback)` from the MediaSession.Builder.
覆盖
onAddMediaItems
内的 MediaLibrarySession.Callback
。每次您从控制器使用 setMediaItem
/addMediaItem
时,您的 onAddMediaItems 将被调用,返回的 MediaItem 就是将要播放的 MediaItem。
class CustomMediaLibrarySessionCallback : MediaLibraryService.MediaLibrarySession.Callback {
// [...]
override fun onAddMediaItems(
mediaSession: MediaSession,
controller: MediaSession.ControllerInfo,
mediaItems: MutableList<MediaItem>
): ListenableFuture<List<MediaItem>> {
// NOTE: You can use the id from the mediaItems to look up missing
// information (e.g. get URI from a database) and return a Future with
// a list of playable MediaItems.
// If your use case is really simple and the security/privacy reasons
// mentioned earlier don't apply to you, you can add the URI to the
// MediaItem request metadata in your activity/fragment and use it
// to rebuild the playable MediaItem.
val updatedMediaItems = mediaItems.map { mediaItem ->
mediaItem.buildUpon()
.setUri(mediaItem.requestMetadata.mediaUri)
.build()
}
return Futures.immediateFuture(updatedMediaItems)
}
}
从活动/片段中创建并播放您的
MediaItem
。
// My Activity
val mmd = MediaMetadata.Builder()
.setTitle("Example")
.setArtist("Artist name")
.build()
// Request metadata. New in (1.0.0-beta01)
// This is optional. I'm adding a RequestMetadata to the MediaItem so I
// can get the mediaUri from my `onAddMediaItems` simple use case (see
// onAddMediaItems for more info).
// If you are going to get the final URI from a database, you can move your
// query to your `MediaLibrarySession.Callback#onAddMediaItems` and skip this.
val rmd = RequestMetadata.Builder()
.setMediaUri("...".toUri())
.build()
val mediaItem = MediaItem.Builder()
.setMediaId("123")
.setMediaMetadata(mmd)
.setRequestMetadata(rmd)
.build()
browser.setMediaItem(mediaItem)
browser.prepare()
browser.play()
当您在
MediaLibrarySession
中创建 MediaLibraryService
时,您可以添加 MediaItemFiller
。这个 MediaItemFiller
有一个 fillInLocalConfiguration
方法,将被 “调用以从控制器填充媒体项的 MediaItem.localConfiguration。”
了解这一点,您需要:
将 MediaItemFiller 添加到服务内的 MediaLibrarySession 构建器。
// My MediaLibraryService
// onCreate()
mediaLibrarySession = MediaLibrarySession.Builder(this, player, librarySessionCallback)
.setMediaItemFiller(CustomMediaItemFiller()) // <--
.setSessionActivity(pendingIntent)
.build()
创建自定义
MediaSession.MediaItemFiller
。每当您从控制器使用 setMediaItem
/addMediaItem
时,都会调用此函数,并且此处返回的 MediaItem 将是播放的 MediaItem。
class CustomMediaItemFiller : MediaSession.MediaItemFiller {
override fun fillInLocalConfiguration(
session: MediaSession,
controller: MediaSession.ControllerInfo,
mediaItem: MediaItem
): MediaItem {
// Return the media item to be played
return mediaItem.buildUpon()
// Use the metadata values to fill our media item
.setUri(mediaItem.mediaMetadata.mediaUri)
.build()
}
}
最后,从活动中创建并播放您的
MediaItem
。
// My Activity
// Fill some metadata that the MediaItemFiller
// will use to create the new MediaItem
val mmd = MediaMetadata.Builder()
.setTitle("Example")
.setArtist("Artist name")
.setMediaUri("...".toUri())
.build()
val mediaItem: MediaItem =
MediaItem.Builder()
.setMediaMetadata(mmd)
.build()
browser.setMediaItem(mediaItem)
browser.prepare()
browser.play()
我不知道为什么会这么尴尬,但是如果你看看他们在官方仓库中使用的 CustomMediaItemFiller,你会发现他们使用
mediaItem.mediaId
从媒体中获取有效的 MediaItem目录。这就是为什么当他们在活动中使用 setMediaItem 时,他们的演示会起作用。
另外,据我所知,你在 fillInLocalConfiguration
内做的任何事情都必须阻塞主线程(我相信
setMediaItem
必须从主线程调用),所以,如果可以的话,尝试移动任何繁重的工作(即,从数据库获取媒体信息)到您有更多控制权的 Activity/ViewModel,填写您需要的所有元数据,并使用您的
MediaSession.MediaItemFiller
进行简单的转换。或者将所有内容移至您的服务中并忘记所有内容。我希望流程能够被理解。我对 media3 没有太多经验,也许我错过了一些东西,但由于
MediaItemFiller
的限制,我发现它有点无用,我真的很想了解更多关于它的用途。
val mediaItem: MediaItem =
MediaItem.Builder()
.setUri("https://mediaurl".toUri())
.setMediaMetadata(mmd)
.build()