KONTROL ET

ExoPlayer, birden çok kapsayıcı biçimiyle DASH'i destekler. Medya akışları devre dışı bırakılmalıdır. Diğer bir deyişle, video, ses ve metin, DASH manifestinde ayrı AdaptationSet öğelerinde tanımlanmalıdır (CEA-608, aşağıdaki tabloda açıklanan 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 devre dışı bırakılan akışlar
WebM	EVET	Yalnızca devre dışı bırakılan akışlar
Matroska	EVET	Yalnızca devre dışı bırakılan akışlar
MPEG-TS	HAYIR	Planlanmış destek yok
Altyazılar
TTML	EVET	ISO/IEC 14496-30'a uygun olarak ham veya FMP4'e yerleştirilmiştir
WebVTT	EVET	ISO/IEC 14496-30'a uygun olarak ham veya FMP4'e yerleştirilmiştir
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 verildiğ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ı
Anahtarı Temizle	EVET	API 21+, yalnızca "cenc" şeması
Canlı oynatma
Düzenli canlı oynatma	EVET
Ultra düşük gecikmeli CMAF canlı oynatma	EVET
Ortak Medya İstemci Verileri (CMCD)	EVET	Entegrasyon Kılavuzu

MediaItem'i Kullanma

DASH akışı oynatmak için DASH modülüne güvenmeniz gerekir.

Kotlin

implementation("androidx.media3:media3-exoplayer-dash:1.3.1")

Eski

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

Daha sonra, DASH MPD URI'si için bir MediaItem oluşturabilir ve bunu oynatıcıya aktarabilirsiniz.

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 manifestte tanımlanan gösterimler arasında otomatik olarak uyum sağlar.

DashMediaSource'u Kullanma

Daha fazla özelleştirme seçeneği için DashMediaSource oluşturabilir ve bunu bir MediaItem yerine doğrudan oynatıcıya aktarabilirsiniz.

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 öğesine yayınlamanız gerekir. Manifest her yüklendiğinde Player.Listener için onTimelineChanged geri çağırması da yapılır. Bu durum seç-izle içeriklerde bir kez, canlı içeriklerde ise 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.
        }
      }
    });

Oynatmayı özelleştirme

ExoPlayer, oynatma deneyimini uygulamanızın ihtiyaçlarına göre uyarlamanız için çeşitli yöntemler sunar. Örnekler için Özelleştirme sayfasına göz atın.