ExoPlayer, SmoothStreaming'i FMP4 kapsayıcı biçimiyle destekler. Medya akışları ayrıştırılmalıdır. Diğer bir deyişle video, ses ve metin, SmoothStreaming manifest dosyasında farklı StreamIndex öğelerinde tanımlanmalıdır. İçerdiği 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 tekilleştirilmiş akışlar |
Kapalı altyazılar | ||
TTML | EVET | FMP4'e yerleştirilmiş |
İçerik koruması | ||
PlayHazır SL2000 | EVET | Yalnızca Android TV |
Canlı oynatma | ||
Düzenli canlı oynatma | EVET | |
Common Media Client Data (CMCD) | EVET | Entegrasyon Rehberi |
MediaItem kullanma
SmoothStreaming akışı oynatmak için SmoothStreaming modülünü kullanmanız gerekir.
Kotlin
implementation("androidx.media3:media3-exoplayer-smoothstreaming:1.3.1")
Modern
implementation "androidx.media3:media3-exoplayer-smoothstreaming:1.3.1"
Daha sonra, SmoothStreaming manifest URI'sı 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(ssUri)) // 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(ssUri)); // Prepare the player. player.prepare();
URI'nız .ism/Manifest
ile bitmiyorsa içeriğin türünü açık bir şekilde belirtmek için MimeTypes.APPLICATION_SS
/ MediaItem.Builder
öğesi için setMimeType
ekleyebilirsiniz.
ExoPlayer, hem kullanılabilir bant genişliğini hem de cihaz özelliklerini dikkate alarak manifestte tanımlanan gösterimler arasında otomatik olarak uyum sağlar.
SsMediaSource'u Kullanma
Daha fazla özelleştirme seçeneği için SsMediaSource
oluşturup MediaItem
yerine doğrudan oynatıcıya aktarabilirsiniz.
Kotlin
// Create a data source factory. val dataSourceFactory: DataSource.Factory = DefaultHttpDataSource.Factory() // Create a SmoothStreaming media source pointing to a manifest uri. val mediaSource: MediaSource = SsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(ssUri)) // Create a player instance. val player = ExoPlayer.Builder(context).build() // Set the media source to be played. player.setMediaSource(mediaSource) // Prepare the player. player.prepare()
Java
// Create a data source factory. DataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory(); // Create a SmoothStreaming media source pointing to a manifest uri. MediaSource mediaSource = new SsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(ssUri)); // Create a player instance. 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
yöntemini çağırarak geçerli manifesti alabilirsiniz.
SmoothStreaming için döndürülen nesneyi SsManifest
adresine yayınlamanız gerekir. Manifest her yüklendiğinde Player.Listener
için onTimelineChanged
geri çağırması da çağrılır. Bu durum, seç-izle içeriklerde bir kez, canlı içeriklerde de pek çok kez gerçekleşir. Aşağıdaki kod snippet'i, manifest dosyası her yüklendiğinde bir uygulamanın
nasıl işlem yapabileceğini göstermektedir.
Kotlin
player.addListener( object : Player.Listener { override fun onTimelineChanged(timeline: Timeline, @TimelineChangeReason reason: Int) { val manifest = player.currentManifest if (manifest is SsManifest) { // 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) { SsManifest ssManifest = (SsManifest) 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 yollar sunar. Örnekler için Özelleştirme sayfasına bakın.