媒体项

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 属性:

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();

此示例为受 Widevine 保护的内容构建媒体项。在播放器内,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