playlist API 基于 MediaItem
实例,可使用 MediaItem.Builder
方便地构建该实例。在播放器内,MediaItem
会被 MediaSource.Factory
转换为可播放的 MediaSource
。如果没有自定义配置,此转换将由 DefaultMediaSourceFactory
执行,后者能够构建与媒体项的属性相对应的复杂媒体来源。下文概述了可在媒体项上设置的一些属性。
简单的媒体项
您可以使用 fromUri
便捷方法构建仅包含数据流 URI 的媒体项:
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();
在发生播放列表转换时,附加元数据对于更新应用的界面会很有帮助。
处理非标准文件扩展名
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
。