Tipos de plataforma

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:

Também há maneiras diferentes de limpar:

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érico
  • video_decoder_gl_surface_view (VideoDecoderGLSurfaceView): renderização de vídeo usando renderizadores de extensão
  • none: é 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_VIEW
  • androidx.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.