ExoPlayer, birden çok kapsayıcı biçimiyle DASH'i destekler. Medya akışları, video, ses ve metnin DASH manifest'inde ayrı AdaptationSet
öğelerinde tanımlanması gerektiği anlamına gelen bir şekilde demuxed olmalıdır (CEA-608, aşağıdaki tabloda açıklandığı gibi bir istisnadır). İçerikteki ses ve video örnek biçimleri de desteklenmelidir (ayrıntılar için örnek biçimler bölümüne bakın).
Özellik | Destekleniyor | Yorumlar |
---|---|---|
Kapsayıcılar | ||
FMP4 | EVET | Yalnızca demuxed akışlar |
WebM | EVET | Yalnızca demuxed akışlar |
Matroska | EVET | Yalnızca demuxed akışlar |
MPEG-TS | HAYIR | Planlanmış destek yok |
Altyazılar | ||
TTML | EVET | Ham veya ISO/IEC 14496-30'a göre FMP4'e yerleştirilmiş |
WebVTT | EVET | Ham veya ISO/IEC 14496-30'a göre FMP4'e yerleştirilmiş |
CEA-608 | EVET | SCTE Erişilebilirlik tanımlayıcıları kullanılarak sinyal verildiğinde FMP4'e yerleştirilir |
CEA-708 | EVET | SCTE Erişilebilirlik tanımlayıcıları kullanılarak sinyal gönderildiğinde FMP4'e yerleştirilir. |
Meta veri | ||
EMSG meta verileri | EVET | FMP4'e yerleştirilmiş |
İçerik koruması | ||
Widevine | EVET | "cenc" şeması: API 19+; "cbcs" şeması: API 25+ |
PlayReady SL2000 | EVET | Android TV, yalnızca "cenc" şeması |
ClearKey | EVET | API 21+, yalnızca "cenc" şeması |
Canlı oynatma | ||
Normal canlı oynatma | EVET | |
Ultra düşük gecikmeli CMAF canlı oynatma | EVET | |
Ortak Medya İstemcisi Verileri (CMCD) | EVET | Entegrasyon Kılavuzu |
MediaItem'i kullanma
DASH akışı oynatmak için DASH modülüne ihtiyacınız vardır.
Kotlin
implementation("androidx.media3:media3-exoplayer-dash:1.4.1")
Groovy
implementation "androidx.media3:media3-exoplayer-dash:1.4.1"
Ardından, DASH MPD URI için bir MediaItem
oluşturup oynatıcıya iletebilirsiniz.
Kotlin
// Create a player instance. val player = ExoPlayer.Builder(context).build() // Set the media item to be played. player.setMediaItem(MediaItem.fromUri(dashUri)) // Prepare the player. player.prepare()
Java
// Create a player instance. ExoPlayer player = new ExoPlayer.Builder(context).build(); // Set the media item to be played. player.setMediaItem(MediaItem.fromUri(dashUri)); // Prepare the player. player.prepare();
URI'niz .mpd
ile bitmiyorsa içeriğin türünü açıkça belirtmek için MimeTypes.APPLICATION_MPD
öğesini setMimeType
/MediaItem.Builder
öğesine iletebilirsiniz.
ExoPlayer, hem mevcut bant genişliğini hem de cihaz özelliklerini dikkate alarak manifest dosyasında tanımlanan temsiller arasında otomatik olarak uyum sağlar.
DashMediaSource'ı kullanma
Daha fazla özelleştirme seçeneği için MediaItem
yerine DashMediaSource
oluşturup doğrudan oynatıcıya iletebilirsiniz.
Kotlin
val dataSourceFactory: DataSource.Factory = DefaultHttpDataSource.Factory() // Create a dash media source pointing to a dash manifest uri. val mediaSource: MediaSource = DashMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(dashUri)) // Create a player instance which gets an adaptive track selector by default. val player = ExoPlayer.Builder(context).build() // Set the media source to be played. player.setMediaSource(mediaSource) // Prepare the player. player.prepare()
Java
DataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory(); // Create a dash media source pointing to a dash manifest uri. MediaSource mediaSource = new DashMediaSource.Factory(dataSourceFactory) .createMediaSource(MediaItem.fromUri(dashUri)); // Create a player instance which gets an adaptive track selector by default. ExoPlayer player = new ExoPlayer.Builder(context).build(); // Set the media source to be played. player.setMediaSource(mediaSource); // Prepare the player. player.prepare();
Manifest dosyasına erişme
Player.getCurrentManifest
öğesini çağırarak geçerli manifesti alabilirsiniz.
DASH için döndürülen nesneyi DashManifest
olarak yayınlamanız gerekir. Manifest her yüklendiğinde Player.Listener
için onTimelineChanged
geri çağırma işlevi de çağrılır. Bu işlem, istek üzerine içerikler için bir kez, canlı içerikler için ise muhtemelen birçok kez gerçekleşir. Aşağıdaki kod snippet'i, manifest yüklendiğinde bir uygulamanın nasıl bir işlem yapabileceğini gösterir.
Kotlin
player.addListener( object : Player.Listener { override fun onTimelineChanged(timeline: Timeline, @TimelineChangeReason reason: Int) { val manifest = player.currentManifest if (manifest is DashManifest) { // Do something with the manifest. } } } )
Java
player.addListener( new Player.Listener() { @Override public void onTimelineChanged( Timeline timeline, @Player.TimelineChangeReason int reason) { Object manifest = player.getCurrentManifest(); if (manifest != null) { DashManifest dashManifest = (DashManifest) manifest; // Do something with the manifest. } } });
Oynatma ayarlarını özelleştirme
ExoPlayer, oynatma deneyimini uygulamanızın ihtiyaçlarına göre özelleştirmenize olanak tanıyan birden fazla yöntem sunar. Örnekler için Özelleştirme sayfasına bakın.