KONTROL ET

ExoPlayer, birden fazla kapsayıcı biçimiyle DASH'ı 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). İçerdiği ses ve video örnek biçimleri de desteklenmelidir (ayrıntılar için örnek biçimleri 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 ve üzeri; "cbcs" şeması: API 25 ve üzeri
PlayReady SL2000	EVET	Android TV, yalnızca "cenc" şeması
ClearKey	EVET	API 21 ve üzeri, 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.5.0")

Groovy

implementation "androidx.media3:media3-exoplayer-dash:1.5.0"

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'yi MediaItem.Builder'ın setMimeType bölümüne 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();

Manifeste erişme

Player.getCurrentManifest işlevini çağırarak geçerli manifest dosyasını 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'inde, bir uygulamanın manifest yüklendiğinde nasıl bir işlem yapabileceği gösterilmektedir.

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.