“播放列表 API”基于 MediaItem
实例,可以使用 MediaItem.Builder
方便地构建。在播放器内部,一个 MediaItem
由 MediaSource.Factory
转换成可播放的 MediaSource
。在没有自定义配置的情况下,此转换由 DefaultMediaSourceFactory
执行,它能够根据媒体项的属性构建复杂的媒体源。可以在媒体项上设置的一些属性如下所述。
简单媒体项
仅包含流 URI 的媒体项可以使用 fromUri
便捷方法构建
Kotlin
val mediaItem = MediaItem.fromUri(videoUri)
Java
MediaItem mediaItem = MediaItem.fromUri(videoUri);
对于所有其他情况,可以使用 MediaItem.Builder
。在以下示例中,构建了一个带有 ID 和一些附加元数据的媒体项
Kotlin
val mediaItem = MediaItem.Builder().setMediaId(mediaId).setTag(myAppData).setUri(videoUri).build()
Java
MediaItem mediaItem = new MediaItem.Builder().setMediaId(mediaId).setTag(myAppData).setUri(videoUri).build();
附加元数据对于在播放列表转换发生时更新您的应用 UI 很有用。
图片
图片播放要求媒体项中包含时长,以指定图片在播放期间应显示多长时间。请参阅图片指南页面,了解有关Motion Photos和图片加载库(例如 Glide)的更多信息。
Kotlin
val mediaItem = MediaItem.Builder().setUri(imageUri).setImageDurationMs(3000).build()
Java
MediaItem mediaItem = new MediaItem.Builder().setUri(imageUri).setImageDurationMs(3_000).build();
自适应媒体的非标准文件扩展名
ExoPlayer 为 DASH、HLS 和 SmoothStreaming 提供自适应媒体源。如果此类自适应媒体项的 URI 以标准文件扩展名结尾,则会自动创建相应的媒体源。如果 URI 具有非标准扩展名或根本没有扩展名,则可以显式设置 MIME 类型以指示媒体项的类型
Kotlin
val mediaItem = MediaItem.Builder().setUri(hlsUri).setMimeType(MimeTypes.APPLICATION_M3U8).build()
Java
MediaItem mediaItem = new MediaItem.Builder().setUri(hlsUri).setMimeType(MimeTypes.APPLICATION_M3U8).build();
对于渐进式媒体流,不需要 MIME 类型。
受保护内容
对于受保护内容,应设置媒体项的 DRM 属性。UUID 是必需的,所有其他属性都是可选的。
一个示例配置,用于播放受 Widevine DRM 保护的项,其中许可证 URI 在媒体中不可直接获取(例如在 DASH 播放列表中),并且需要多个会话(例如由于密钥轮换)
Kotlin
val mediaItem = MediaItem.Builder() .setUri(videoUri) .setDrmConfiguration( MediaItem.DrmConfiguration.Builder(C.WIDEVINE_UUID) .setLicenseUri(licenseUri) .setMultiSession(true) .setLicenseRequestHeaders(httpRequestHeaders) .build() ) .build()
Java
MediaItem mediaItem = new MediaItem.Builder() .setUri(videoUri) .setDrmConfiguration( new MediaItem.DrmConfiguration.Builder(C.WIDEVINE_UUID) .setLicenseUri(licenseUri) .setMultiSession(true) .setLicenseRequestHeaders(httpRequestHeaders) .build()) .build();
在播放器内部,DefaultMediaSourceFactory
会将这些属性传递给 DrmSessionManagerProvider
以获取一个 DrmSessionManager
,然后将其注入到创建的 MediaSource
中。DRM 行为可以进一步自定义以满足您的需求。
旁加载字幕轨道
要旁加载字幕轨道,可以在构建媒体项时添加 MediaItem.Subtitle
实例
Kotlin
val subtitle = SubtitleConfiguration.Builder(subtitleUri) .setMimeType(mimeType) // The correct MIME type (required). .setLanguage(language) // The subtitle language (optional). .setSelectionFlags(selectionFlags) // Selection flags for the track (optional). .build() val mediaItem = MediaItem.Builder().setUri(videoUri).setSubtitleConfigurations(listOf(subtitle)).build()
Java
MediaItem.SubtitleConfiguration subtitle = new MediaItem.SubtitleConfiguration.Builder(subtitleUri) .setMimeType(mimeType) // The correct MIME type (required). .setLanguage(language) // The subtitle language (optional). .setSelectionFlags(selectionFlags) // Selection flags for the track (optional). .build(); MediaItem mediaItem = new MediaItem.Builder() .setUri(videoUri) .setSubtitleConfigurations(ImmutableList.of(subtitle)) .build();
在内部,DefaultMediaSourceFactory
将使用 MergingMediaSource
来将内容媒体源与每个字幕轨道的 SingleSampleMediaSource
结合起来。DefaultMediaSourceFactory
不支持多时段 DASH 的字幕旁加载。
剪辑媒体流
要剪辑媒体项引用的内容,请设置自定义起始和结束位置
Kotlin
val mediaItem = MediaItem.Builder() .setUri(videoUri) .setClippingConfiguration( MediaItem.ClippingConfiguration.Builder() .setStartPositionMs(startPositionMs) .setEndPositionMs(endPositionMs) .build() ) .build()
Java
MediaItem mediaItem = new MediaItem.Builder() .setUri(videoUri) .setClippingConfiguration( new ClippingConfiguration.Builder() .setStartPositionMs(startPositionMs) .setEndPositionMs(endPositionMs) .build()) .build();
在内部,DefaultMediaSourceFactory
将使用 ClippingMediaSource
来封装内容媒体源。还有其他剪辑属性。请参阅 MediaItem.Builder
Javadoc 以了解更多详情。
广告插入
要插入广告,应设置媒体项的广告代码 URI 属性
Kotlin
val mediaItem = MediaItem.Builder() .setUri(videoUri) .setAdsConfiguration(MediaItem.AdsConfiguration.Builder(adTagUri).build())
Java
MediaItem mediaItem = new MediaItem.Builder() .setUri(videoUri) .setAdsConfiguration(new MediaItem.AdsConfiguration.Builder(adTagUri).build()) .build();
在内部,DefaultMediaSourceFactory
会将内容媒体源封装在 AdsMediaSource
中,以插入广告代码定义的广告。为此,播放器还需要将其 DefaultMediaSourceFactory
进行相应配置。