이 페이지에서는 Media3로 동영상을 재생하는 데 사용할 수 있는 다양한 유형의 표시 영역과 사용 사례에 적합한 유형을 선택하는 방법을 설명합니다. Android의 Surface 객체에 관해 자세히 알아보려면 이 그래픽 문서를 참고하세요.
표시 영역 설정
Player에서 동영상 출력을 Surface에 연결하는 진입점은 네 가지입니다.
void setVideoSurface(@Nullable Surface surface)void setVideoSurfaceHolder(@Nullable SurfaceHolder surfaceHolder)void setVideoSurfaceView(@Nullable SurfaceView surfaceView)void setVideoTextureView(@Nullable TextureView textureView)
설정을 삭제하는 방법도 다양합니다.
void clearVideoSurface()void clearVideoSurface(@Nullable Surface surface)void clearVideoSurfaceHolder(@Nullable SurfaceHolder surfaceHolder)void clearVideoSurfaceView(@Nullable SurfaceView surfaceView)void clearVideoTextureView(@Nullable TextureView textureView)
PlayerView의 표시 영역 유형 선택
PlayerView의 surface_type 속성을 사용하면 동영상 재생에 사용되는 표시 영역 유형을 설정할 수 있습니다. 허용되는 값은 다음과 같습니다.
surface_view(SurfaceView)texture_view(TextureView)spherical_gl_surface_view(SphericalGLSurfaceView) - 구형 동영상 재생에 사용합니다.video_decoder_gl_surface_view(VideoDecoderGLSurfaceView) - 확장 프로그램 렌더러를 통한 동영상 렌더링에 사용합니다.none- 오디오만을 재생할 때 사용합니다. 비용이 많이 들 수 있어 표시 영역을 만들지 않으려는 경우에는 이 값을 사용해야 합니다.
뷰가 일반 동영상 재생용인 경우 surface_view 또는 texture_view를 사용해야 합니다. SurfaceView는 동영상 재생 시 TextureView에 비해 다음과 같은 여러 이점이 있습니다.
- 많은 기기에서 전력 소비량이 크게 감소합니다.
- 프레임 시간이 더 정확해져 동영상 재생이 더 원활해집니다.
- 지원되는 기기에서 보다 높은 화질의 HDR 동영상 출력을 지원합니다.
- DRM으로 보호된 콘텐츠를 재생할 때 보안 출력을 지원합니다.
- UI 레이어를 업스케일하는 Android TV 기기에서 디스플레이의 원본 해상도로 동영상 콘텐츠를 렌더링할 수 있습니다.
따라서 가능한 경우 TextureView보다 SurfaceView를 사용해야 합니다.
SurfaceView가 요구사항을 충족하지 않는 경우에만 TextureView를 사용해야 합니다. 다음 참고사항에 설명된 대로 Android 7.0(API 수준 24) 이전에 동영상 표시 영역의 부드러운 애니메이션이나 스크롤이 필요한 경우가 여기에 해당합니다. 이 경우 SDK_INT가 24(Android 7.0) 미만일 때만 TextureView를 사용하고 그 외에는 SurfaceView를 사용하는 것이 좋습니다.
Compose에서 표시 영역 유형 선택
Compose에서 상호 운용성 솔루션은 AndroidView 컴포저블을 사용하여 SurfaceView 및 TextureView를 래핑합니다. 해당하는 두 개의 컴포저블은 androidx.compose.foundation의 AndroidExternalSurface와 AndroidEmbeddedExternalSurface입니다. 하지만 이러한 프록시 클래스는 기본 뷰의 액세스를 제한하는 API 표시 영역을 제공합니다. 뷰는 Player가 표시 영역의 전체 수명 주기(생성 및 크기 업데이트)를 처리하는 데 필요합니다.
Player를 수명 주기 인식 방식으로 Surface에 연결하는 ContentFrame 및 PlayerSurface 컴포저블을 media3-ui-compose 모듈에서 찾을 수 있습니다. 이 경우의 표시 영역 유형은 다음과 같습니다.
androidx.media3.ui.compose.SURFACE_TYPE_SURFACE_VIEWandroidx.media3.ui.compose.SURFACE_TYPE_TEXTURE_VIEW
none 유형은 없습니다. 이는 Compose UI 트리에 컴포저블을 포함하지 않는 것에 해당하기 때문입니다.
Compose에서 동영상 가로세로 비율, 동적 창 크기 조절, 콘텐츠 조정을 관리하는 방법을 알아보려면 다양한 폼 팩터에서 미디어 콘텐츠 조정을 참고하세요.