Jenis platform

Halaman ini menjelaskan berbagai jenis platform yang dapat digunakan untuk pemutaran video dengan Media3, dan cara memilih jenis yang tepat untuk kasus penggunaan Anda. Untuk mengetahui lebih lanjut objek Surface di Android, baca dokumentasi grafis ini.

Pilih jenis platform untuk PlayerView

Atribut surface_type dari PlayerView memungkinkan Anda menetapkan jenis platform yang digunakan untuk pemutaran video. Nilai yang diizinkan adalah:

  • surface_view (SurfaceView)
  • texture_view (TextureView)
  • spherical_gl_surface_view (SphericalGLSurfaceView) - untuk pemutaran video sferis
  • video_decoder_gl_surface_view (VideoDecoderGLSurfaceView) - rendering video menggunakan perender ekstensi
  • none - yang hanya untuk pemutaran audio dan harus digunakan untuk menghindari pembuatan platform karena tindakan tersebut dapat memakan biaya yang besar.

Jika tampilan ditujukan untuk pemutaran video biasa, surface_view atau texture_view harus digunakan. SurfaceView memiliki sejumlah manfaat dibandingkan TextureView untuk pemutaran video:

  • Mengurangi konsumsi daya secara signifikan di banyak perangkat.
  • Waktu frame yang lebih akurat, sehingga pemutaran video lebih lancar.
  • Dukungan untuk output video HDR berkualitas lebih tinggi di perangkat yang kompatibel.
  • Dukungan untuk output yang aman saat memutar konten yang dilindungi DRM.
  • Kemampuan untuk merender konten video pada resolusi penuh layar di perangkat Android TV yang meng-upscale lapisan UI.

Oleh karena itu, SurfaceView harus lebih diutamakan daripada TextureView jika memungkinkan. TextureView hanya boleh digunakan jika SurfaceView tidak memenuhi kebutuhan Anda. Salah satu contohnya adalah saat animasi atau scrolling yang lancar pada permukaan video diperlukan sebelum Android 7.0 (level API 24), seperti yang dijelaskan dalam catatan berikut. Untuk kasus ini, sebaiknya gunakan TextureView hanya jika SDK_INT kurang dari 24 (Android 7.0) dan SurfaceView jika tidak.

Memilih jenis platform di Compose

Di Compose, solusi interop menggunakan Composable AndroidView untuk memaketkan SurfaceView dan TextureView. Dua Composable yang sesuai dengan hal tersebut adalah AndroidExternalSurface dan AndroidEmbeddedExternalSurface.

Modul Media3 ui-compose menyediakan Composable PlayerSurface yang menautkan Player ke Surface dengan cara yang berbasis siklus proses. Jenis permukaan dalam hal ini adalah:

Tidak ada jenis none, karena jenis tersebut akan sesuai dengan tidak menyertakan PlayerSurface dalam hierarki UI Compose Anda.