API danh sách phát dựa trên các thực thể MediaItem, có thể được tạo một cách thuận tiện bằng MediaItem.Builder. Bên trong trình phát, MediaItem được chuyển đổi thành MediaSource có thể phát bằng MediaSource.Factory. Nếu không có cấu hình tuỳ chỉnh, thì quá trình chuyển đổi này sẽ được thực hiện bằng DefaultMediaSourceFactory, có khả năng tạo các nguồn nội dung nghe nhìn phức tạp tương ứng với các thuộc tính của mục nội dung nghe nhìn. Một số thuộc tính có thể đặt trên mục nội dung nghe nhìn được trình bày trong các phần sau.
Mục nội dung nghe nhìn đơn giản
Bạn có thể tạo một mục nội dung nghe nhìn chỉ bao gồm URI của luồng bằng phương thức tiện lợi fromUri:
Kotlin
val mediaItem = MediaItem.fromUri(videoUri)
Java
MediaItem mediaItem = MediaItem.fromUri(videoUri);
Đối với tất cả các trường hợp khác, bạn có thể sử dụng MediaItem.Builder. Trong ví dụ sau, một mục nội dung nghe nhìn được tạo bằng mã nhận dạng và một số siêu dữ liệu đính kèm:
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();
Việc đính kèm siêu dữ liệu có thể hữu ích cho việc cập nhật giao diện người dùng của ứng dụng khi quá trình chuyển đổi danh sách phát diễn ra.
Hình ảnh
Để phát hình ảnh, bạn cần có thời lượng trong mục nội dung nghe nhìn để chỉ định thời gian hiển thị hình ảnh trong khi phát. Hãy xem trang hướng dẫn về Hình ảnh để biết thêm thông tin về Ảnh chuyển động và Thư viện tải hình ảnh (ví dụ: Glide).
Kotlin
val mediaItem = MediaItem.Builder().setUri(imageUri).setImageDurationMs(3000).build()
Java
MediaItem mediaItem = new MediaItem.Builder().setUri(imageUri).setImageDurationMs(3_000).build();
Đuôi tệp không chuẩn cho nội dung nghe nhìn thích ứng
ExoPlayer cung cấp các nguồn nội dung nghe nhìn thích ứng cho DASH, HLS và SmoothStreaming. Nếu URI của một mục nội dung nghe nhìn thích ứng như vậy kết thúc bằng một đuôi tệp chuẩn, thì nguồn nội dung nghe nhìn tương ứng sẽ tự động được tạo. Nếu URI có đuôi không chuẩn hoặc không có đuôi, thì bạn có thể đặt loại MIME một cách rõ ràng để cho biết loại mục nội dung nghe nhìn:
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();
Đối với luồng nội dung nghe nhìn lũy tiến, bạn không cần phải có loại MIME.
Nội dung được bảo vệ
Đối với nội dung được bảo vệ, bạn nên đặt các thuộc tính DRM của mục nội dung nghe nhìn. UUID là bắt buộc, tất cả các thuộc tính khác là không bắt buộc.
Ví dụ về cấu hình để phát một mục được bảo vệ bằng Widevine DRM, trong đó URI giấy phép không có sẵn trực tiếp trong nội dung nghe nhìn (ví dụ: trong danh sách phát DASH) và cần có nhiều phiên (ví dụ: do xoay vòng khoá):
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();
Bên trong trình phát, DefaultMediaSourceFactory sẽ truyền các thuộc tính này đến DrmSessionManagerProvider để lấy DrmSessionManager, sau đó được chèn vào MediaSource đã tạo. Bạn có thể tuỳ chỉnh thêm hành vi DRM cho phù hợp với nhu cầu của mình.
Tải các bản phụ đề không qua cửa hàng ứng dụng
Để tải các bản phụ đề không qua cửa hàng ứng dụng, bạn có thể thêm các thực thể MediaItem.Subtitle khi tạo một mục nội dung nghe nhìn:
Kotlin
val subtitle = 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() 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();
Trong nội bộ, DefaultMediaSourceFactory sẽ sử dụng MergingMediaSource để kết hợp nguồn nội dung nghe nhìn với SingleSampleMediaSource cho mỗi bản phụ đề. DefaultMediaSourceFactory không hỗ trợ tải phụ đề không qua cửa hàng ứng dụng cho DASH nhiều giai đoạn.
Cắt một đoạn trong luồng nội dung nghe nhìn
Để cắt nội dung mà một mục nội dung nghe nhìn tham chiếu đến, hãy đặt vị trí bắt đầu và kết thúc tuỳ chỉnh:
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();
Trong nội bộ, DefaultMediaSourceFactory sẽ sử dụng ClippingMediaSource để gói nguồn nội dung nghe nhìn. Có các thuộc tính cắt khác. Hãy xem
MediaItem.Builder Javadoc để biết thêm thông tin chi tiết.
Chèn quảng cáo
Để chèn quảng cáo, bạn cần đặt thuộc tính URI thẻ quảng cáo của mục nội dung nghe nhìn:
Kotlin
val mediaItem = MediaItem.Builder() .setUri(videoUri) .setAdsConfiguration(MediaItem.AdsConfiguration.Builder(adTagUri).build()) .build()
Java
MediaItem mediaItem = new MediaItem.Builder() .setUri(videoUri) .setAdsConfiguration(new MediaItem.AdsConfiguration.Builder(adTagUri).build()) .build();
Trong nội bộ, DefaultMediaSourceFactory sẽ gói nguồn nội dung nghe nhìn trong một AdsMediaSource để chèn quảng cáo theo định nghĩa của thẻ quảng cáo. Để tính năng này hoạt động,
trình phát cũng cần có DefaultMediaSourceFactory
được định cấu hình tương ứng.