Questa pagina descrive i diversi tipi di piattaforme che possono essere utilizzate per la riproduzione di video con Media3 e come scegliere il tipo giusto per il tuo caso d'uso. Per scoprire di più sugli oggetti Surface in Android, leggi questa documentazione sulla grafica.
Imposta la superficie
Esistono quattro punti di accesso per collegare l'uscita video di Player ad alcuni Surface:
void setVideoSurface(@Nullable Surface surface)void setVideoSurfaceHolder(@Nullable SurfaceHolder surfaceHolder)void setVideoSurfaceView(@Nullable SurfaceView surfaceView)void setVideoTextureView(@Nullable TextureView textureView)
Esistono anche diversi modi per cancellarla:
void clearVideoSurface()void clearVideoSurface(@Nullable Surface surface)void clearVideoSurfaceHolder(@Nullable SurfaceHolder surfaceHolder)void clearVideoSurfaceView(@Nullable SurfaceView surfaceView)void clearVideoTextureView(@Nullable TextureView textureView)
Scegli un tipo di piattaforma per PlayerView
L'attributo surface_type di PlayerView ti consente di impostare il tipo di superficie
utilizzata per la riproduzione dei video. I valori consentiti sono:
surface_view(SurfaceView)texture_view(TextureView)spherical_gl_surface_view(SphericalGLSurfaceView) - per la riproduzione di video sfericivideo_decoder_gl_surface_view(VideoDecoderGLSurfaceView): rendering video utilizzando i renderer delle estensioninone, che serve solo per la riproduzione audio e deve essere utilizzato per evitare di dover creare una superficie, poiché questa operazione può essere costosa.
Se la visualizzazione è per la riproduzione di video standard, è necessario utilizzare surface_view o texture_view. SurfaceView offre una serie di vantaggi rispetto a TextureView
per la riproduzione di video:
- Consumo energetico notevolmente inferiore su molti dispositivi.
- Durata frame più precisa, con una riproduzione video più fluida.
- Supporto per l'output video HDR di qualità superiore sui dispositivi compatibili.
- Supporto per l'output sicuro durante la riproduzione di contenuti protetti da DRM.
- La possibilità di eseguire il rendering dei contenuti video alla risoluzione completa del display sui dispositivi Android TV che eseguono l'upscaling del livello UI.
Pertanto, se possibile, SurfaceView deve essere preferito a TextureView.
TextureView deve essere utilizzato solo se SurfaceView non soddisfa le tue esigenze. Un esempio è quando sono necessarie animazioni o scorrimento fluidi della superficie video prima di Android 7.0 (livello API 24), come descritto nelle note di seguito. In questo caso, è preferibile utilizzare TextureView solo quando SDK_INT è inferiore a 24 (Android 7.0) e SurfaceView in caso contrario.
Scegli un tipo di superficie in Compose
In Compose, la soluzione di interoperabilità utilizza il componibile AndroidView per aggregare
SurfaceView e TextureView. I due elementi componibili corrispondenti sono AndroidExternalSurface e AndroidEmbeddedExternalSurface di androidx.compose.foundation. Tuttavia, queste classi proxy forniscono una superficie API che limita l'accesso alle visualizzazioni sottostanti. Queste visualizzazioni sono necessarie a Player per gestire un ciclo di vita completo della superficie (creazione e aggiornamenti delle dimensioni).
Nel modulo media3-ui-compose, puoi trovare i componibili ContentFrame e PlayerSurface che collegano Player a Surface in modo sensibile al ciclo di vita. In questo caso, i tipi di superficie sono:
androidx.media3.ui.compose.SURFACE_TYPE_SURFACE_VIEWandroidx.media3.ui.compose.SURFACE_TYPE_TEXTURE_VIEW
Non esiste un tipo none, poiché ciò corrisponderebbe a non includere il componibile nell'albero della UI di Compose.
Per scoprire come gestire le proporzioni dei video, il dimensionamento dinamico delle finestre e la scalabilità dei contenuti in Compose, consulta Scala i contenuti multimediali in base ai fattori di forma.