Esta página descreve os diferentes tipos de superfícies que podem ser usadas para reprodução de vídeo com o Media3 e como escolher o tipo certo para seu caso de uso. Para saber mais sobre objetos Surface no Android, leia esta documentação de gráficos.
Definir a plataforma
Há quatro pontos de entrada para o Player conectar a saída de vídeo a algum
Surface:
void setVideoSurface(@Nullable Surface surface)void setVideoSurfaceHolder(@Nullable SurfaceHolder surfaceHolder)void setVideoSurfaceView(@Nullable SurfaceView surfaceView)void setVideoTextureView(@Nullable TextureView textureView)
Também há maneiras diferentes de limpar:
void clearVideoSurface()void clearVideoSurface(@Nullable Surface surface)void clearVideoSurfaceHolder(@Nullable SurfaceHolder surfaceHolder)void clearVideoSurfaceView(@Nullable SurfaceView surfaceView)void clearVideoTextureView(@Nullable TextureView textureView)
Escolher um tipo de superfície para PlayerView
O atributo surface_type de PlayerView permite definir o tipo de superfície
usada para a reprodução de vídeo. Os valores permitidos são:
surface_view(SurfaceView)texture_view(TextureView)spherical_gl_surface_view(SphericalGLSurfaceView): para reprodução de vídeo esféricovideo_decoder_gl_surface_view(VideoDecoderGLSurfaceView): renderização de vídeo usando renderizadores de extensãonone: é apenas para reprodução de áudio e deve ser usado para evitar a criação de uma superfície, já que isso pode ser caro.
Se a visualização for para reprodução de vídeo normal, use surface_view ou texture_view. SurfaceView tem vários benefícios em relação ao TextureView
para reprodução de vídeo:
- Consumo de energia significativamente menor em muitos dispositivos.
- Tempo para a renderização do frame mais preciso, resultando em uma reprodução de vídeo mais suave.
- Suporte para saída de vídeo HDR de maior qualidade em dispositivos compatíveis.
- Suporte para saída segura ao reproduzir conteúdo protegido por DRM.
- A capacidade de renderizar conteúdo de vídeo na resolução total da tela em dispositivos Android TV que aumentam a camada da interface.
Portanto, SurfaceView deve ser preferido em relação a TextureView sempre que possível.
TextureView só deve ser usado se SurfaceView não atender às suas necessidades. Um
exemplo é quando animações suaves ou rolagem da superfície de vídeo são necessárias
antes do Android 7.0 (nível 24 da API), conforme descrito nas notas a seguir. Nesse
caso, é preferível usar TextureView somente quando SDK_INT for menor
que 24 (Android 7.0) e SurfaceView caso contrário.
Escolher um tipo de superfície no Compose
No Compose, a solução de interoperabilidade usa o elemento combinável AndroidView para unir
SurfaceView e TextureView. Os dois elementos que correspondem a isso
são AndroidExternalSurface e AndroidEmbeddedExternalSurface de
androidx.compose.foundation. No entanto, essas classes de proxy fornecem uma superfície de API
que limita o acesso das visualizações subjacentes. Essas visualizações são necessárias para que
o Player processe um ciclo de vida completo da superfície (criação e atualizações
de tamanho).
No módulo media3-ui-compose, você encontra os elementos combináveis ContentFrame e
PlayerSurface, que vinculam o Player a um Surface de maneira
compatível com o ciclo de vida. Os tipos de superfície nesse caso são:
androidx.media3.ui.compose.SURFACE_TYPE_SURFACE_VIEWandroidx.media3.ui.compose.SURFACE_TYPE_TEXTURE_VIEW
Não há o tipo none, porque isso corresponderia a não incluir o
elemento combinável na árvore da interface do Compose.
Para saber como gerenciar proporções de vídeo, dimensionamento dinâmico de janelas e dimensionamento de conteúdo no Compose, consulte Dimensionar conteúdo de mídia em vários formatos.