Medya oynatan bir uygulama, medyayı görüntülemek için kullanıcı arayüzü bileşenleri ve çalmayı kontrol ediyor. Media3 kitaplığı, çeşitli kullanıcı arayüzü bileşenleri içeren bir kullanıcı arayüzü modülü içerir. Kullanıcı arayüzü modülüne bağımlı olmak için aşağıdakini ekleyin: bağımlılık:
implementation("androidx.media3:media3-ui:1.5.1")
implementation "androidx.media3:media3-ui:1.5.1"
En önemli bileşen, medya oynatmalarına yönelik bir görünüm olan PlayerView'tir.
PlayerView, oynatma sırasında video, resim, altyazı ve albüm kapağını gösterir.
yanı sıra oynatma
kontrollerine de erişebilirsiniz.
PlayerView, eklemek ve çıkarmak için setPlayer yöntemini kullanır (
null) oynatıcı örneği geçiliyor.
PlayerView
PlayerView hem video, resim ve ses oynatmaları için kullanılabilir. Oluşturduğu
Video oynatılırken video ve altyazılar, görüntü oynatma için bit eşlemler
ve ses dosyalarına meta veri olarak eklenen posterleri gösterebilir. URL'yi
diğer kullanıcı arayüzü bileşenlerinde olduğu gibi
düzenleyebilirsiniz. Örneğin, aşağıdaki XML'e bir PlayerView dahil edilebilir:
<androidx.media3.ui.PlayerView
android:id="@+id/player_view"
android:layout_width="match_parent"
android:layout_height="match_parent"
app:show_buffering="when_playing"
app:show_shuffle_button="true"/>
Yukarıdaki snippet, PlayerView ürününün birkaç
özellikleri hakkında daha fazla bilgi edinin. Bu özellikler görünümün davranışını özelleştirmek için kullanılabilir. Örneğin,
hem de görünüm ve izlenimi. Bu özelliklerin çoğu, çalışma zamanında görünümü özelleştirmek için kullanılabilecek karşılık gelen ayarlama yöntemlerine sahiptir. PlayerView Javadoc'da bu özellikler ve ayarlayıcı yöntemleri daha ayrıntılı olarak listelenir.
Görünüm, düzen dosyasında tanımlandıktan sonra etkinliğin onCreate yönteminde aranabilir:
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) // ... playerView = findViewById(R.id.player_view) }
@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); // ... playerView = findViewById(R.id.player_view); }
Bir oynatıcı başlatıldıktan sonra setPlayer çağrılarak görünüme eklenebilir:
// Instantiate the player. val player = ExoPlayer.Builder(context).build() // Attach player to the view. playerView.player = player // Set the media item to be played. player.setMediaItem(mediaItem) // Prepare the player. player.prepare()
// Instantiate the player. player = new ExoPlayer.Builder(context).build(); // Attach player to the view. playerView.setPlayer(player); // Set the media item to be played. player.setMediaItem(mediaItem); // Prepare the player. player.prepare();
Yüzey türü seçin
PlayerView öğesinin surface_type özelliği, video oynatma için kullanılan yüzeyin türünü ayarlamanıza olanak tanır. spherical_gl_surface_view değerlerinin yanında
Küresel video oynatma için özel bir değerdir) ve
video_decoder_gl_surface_view (uzantı kullanarak video oluşturma içindir)
oluşturucuları) izin verilen değerler: surface_view, texture_view ve none. Eğer
Görünüm yalnızca ses oynatma amaçlı olduğundan, birden fazla kez ses göndermemek için none kullanılmalıdır.
Pahalı olabileceği için bir yüzey oluşturmak.
Görünüm normal video oynatma içinse surface_view veya texture_view kullanılmalıdır. SurfaceView, şunun için TextureView ile karşılaştırıldığında çok sayıda avantaj sunar:
video oynatma:
- Birçok cihazda düşük güç tüketimi
- Daha doğru kare zamanlaması, daha akıcı video oynatma sağlar.
- Uygun özellikli cihazlarda daha yüksek kaliteli HDR video çıkışı desteği.
- DRM korumalı içerik oynatılırken güvenli çıkış desteği.
- Kullanıcı arayüzü katmanını ölçeklendiren Android TV cihazlarda video içeriğini ekranın tam çözünürlüğünde oluşturma olanağı.
Bu nedenle, mümkün olduğunda SurfaceView yerine TextureView tercih edilmelidir.
TextureView yalnızca SurfaceView ihtiyaçlarınızı karşılamıyorsa kullanılmalıdır. Örneğin, aşağıdaki notlarda açıklandığı gibi Android 7.0 (API düzeyi 24) öncesinde video yüzeyinin sorunsuz animasyonlarla veya kaydırmayla gösterilmesi gerekir. Örneğin,
bu durumda, yalnızca SDK_INT daha az olduğunda TextureView kullanılması tercih edilir
24'ten (Android 7.0) ve aksi takdirde SurfaceView.
Android TV'de D-pad gezinme
Android TV'nin uzaktan kumandasında, D-pad kontrolüne sahip olan
Activity saatinizin dispatchKeyEvent(KeyEvent) olanına önemli etkinlik olarak varacaksınız. Bu
oynatıcı görünümüne yetki verilmesi gerekir:
override fun dispatchKeyEvent(event: KeyEvent?): Boolean{ return playerView.dispatchKeyEvent(event!!) || super.dispatchKeyEvent(event) }
@Override public boolean dispatchKeyEvent(KeyEvent event) { return playerView.dispatchKeyEvent(event) || super.dispatchKeyEvent(event); }
Oynatıcı görünümü için odaklanma isteğinde bulunmak, oynatma kontrollerinde gezinmek ve reklamları atlamak için önemlidir. Activity'teki onCreate alanında odaklanmayı isteyebilirsiniz:
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) // ... playerView.requestFocus() // ... }
@Override public void onCreate(@Nullable Bundle savedInstanceState) { super.onCreate(savedInstanceState); // ... playerView.requestFocus(); // ... }
Android TV'de Oluştur'u kullanıyorsanız AndroidView öğesini odaklanılabilir hale getirmeniz ve değiştirici parametresini AndroidView öğesine uygun şekilde ileterek etkinliği devretmeniz gerekir:
AndroidView(
modifier = modifier
.focusable()
.onKeyEvent { playerView.dispatchKeyEvent(it.nativeKeyEvent) },
factory = { playerView }
)
Çizilebilir öğeleri geçersiz kılma
PlayerView, oynatmayı görüntülemek için PlayerControlView kullanıyor
kontrol düğmeleri ve ilerleme çubuğu. PlayerControlView tarafından kullanılan çekilebilirler
uygulamanızda tanımlı aynı adlara sahip çekilebilir öğeler tarafından geçersiz kılınır. Görüntüleyin
kontrol çekilebilirlerinin listesi için PlayerControlView Javadoc
geçersiz kılınabilir.
Daha fazla özelleştirme
Yukarıda açıklananların ötesinde özelleştirmenin gerekli olduğu durumlarda, uygulamanın geliştiriciler, sağlananlar yerine kendi kullanıcı arayüzü bileşenlerini uygular kullanıcı arayüzü modülü tarafından oluşturulabilir.