ExoPlayer에서 지원하는 형식을 정의할 때는 '미디어 형식'이 여러 수준에서 정의된다는 점에 유의해야 합니다. 가장 낮은 수준에서 가장 높은 수준까지 다음 작업을 할 수 있습니다.
- 개별 미디어 샘플의 형식 (예: 동영상 프레임 또는 오디오 프레임)입니다. 다음은 샘플 형식입니다. 일반적인 동영상 파일에는 동영상용 (예: H.264) 샘플 형식과 오디오용 (예: AAC) 샘플 형식 등 두 개 이상의 샘플 형식의 미디어가 포함됩니다.
- 미디어 샘플과 연결된 메타데이터를 보관하는 컨테이너의 형식입니다. 컨테이너 형식입니다. 미디어 파일에는 단일 컨테이너 형식 (예: MP4)이 있으며 이는 일반적으로 파일 확장자로 표시됩니다. 일부 오디오 전용 형식 (예: MP3)의 경우 샘플 형식과 컨테이너 형식이 동일할 수 있습니다.
- DASH, SmoothStreaming, HLS와 같은 적응형 스트리밍 기술 이러한 형식은 미디어 형식이 아니지만 ExoPlayer에서 제공하는 지원 수준을 정의해야 합니다.
다음 섹션에서는 각 수준에서 ExoPlayer의 지원을 최고 수준에서 최저 수준으로 정의합니다. 마지막 두 섹션에서는 독립형 자막 형식 및 HDR 동영상 재생 지원에 관해 설명합니다.
가변 품질 스트리밍
DASH
ExoPlayer는 여러 컨테이너 형식으로 DASH를 지원합니다. 미디어 스트림을 디뮤싱해야 합니다. 즉, 동영상, 오디오, 텍스트가 DASH 매니페스트의 고유한 AdaptationSet 요소로 정의되어야 합니다 (아래 표에 설명된 대로 CEA-608은 예외임). 포함된 오디오 및 동영상 샘플 형식도 지원되어야 합니다 (자세한 내용은 샘플 형식 섹션 참고).
| 기능 | 지원됨 | 비고 |
|---|---|---|
| 컨테이너 | ||
| FMP4 | 예 | 디뮤싱된 스트림만 |
| WebM | 예 | 디뮤싱된 스트림만 |
| Matroska | 예 | 디뮤싱된 스트림만 |
| MPEG-TS | 아니요 | 지원 계획 없음 |
| 자막 | ||
| TTML | 예 | 원시 또는 ISO/IEC 14496-30에 따라 FMP4에 삽입됨 |
| WebVTT | 예 | 원시 또는 ISO/IEC 14496-30에 따라 FMP4에 삽입됨 |
| CEA-608 | 예 | SCTE 접근성 설명자를 사용하여 신호를 보낼 때 FMP4에 삽입됨 |
| CEA-708 | 예 | SCTE 접근성 설명자를 사용하여 신호를 보낼 때 FMP4에 삽입됨 |
| 메타데이터 | ||
| EMSG 메타데이터 | 예 | FMP4에 삽입됨 |
| 콘텐츠 보호 | ||
| Widevine | 예 | 'cenc' 스키마: API 19 이상, 'cbcs' 스키마: API 25 이상 |
| PlayReady SL2000 | 예 | Android TV, 'cenc' 스킴만 |
| ClearKey | 예 | API 21 이상, 'cenc' 스키마만 해당 |
| 실시간 재생 | ||
| 일반 라이브 재생 | 예 | |
| 매우 짧은 지연 시간 CMAF 라이브 재생 | 예 | |
| CMCD (Common Media Client Data) | 예 | 통합 가이드 |
SmoothStreaming
ExoPlayer는 FMP4 컨테이너 형식으로 SmoothStreaming을 지원합니다. 미디어 스트림을 디뮤싱해야 합니다. 즉, 동영상, 오디오, 텍스트가 SmoothStreaming 매니페스트의 고유한 StreamIndex 요소에 정의되어야 합니다. 포함된 오디오 및 동영상 샘플 형식도 지원되어야 합니다 (자세한 내용은 샘플 형식 섹션 참고).
| 기능 | 지원됨 | 비고 |
|---|---|---|
| 컨테이너 | ||
| FMP4 | 예 | 디뮤싱된 스트림만 |
| 자막 | ||
| TTML | 예 | FMP4에 삽입됨 |
| 콘텐츠 보호 | ||
| PlayReady SL2000 | 예 | Android TV만 |
| 실시간 재생 | ||
| 일반 라이브 재생 | 예 | |
| CMCD (Common Media Client Data) | 예 | 통합 가이드 |
HLS
ExoPlayer는 여러 컨테이너 형식으로 HLS를 지원합니다. 포함된 오디오 및 동영상 샘플 형식도 지원되어야 합니다 (자세한 내용은 샘플 형식 섹션 참고). HLS 콘텐츠 제작자는 여기에 설명된 대로 고품질 HLS 스트림을 생성하는 것이 좋습니다.
| 기능 | 지원됨 | 비고 |
|---|---|---|
| 컨테이너 | ||
| MPEG-TS | 예 | |
| FMP4/CMAF | 예 | |
| ADTS (AAC) | 예 | |
| MP3 | 예 | |
| 자막 | ||
| CEA-608 | 예 | |
| CEA-708 | 예 | |
| WebVTT | 예 | |
| 메타데이터 | ||
| ID3 | 예 | |
| SCTE-35 | 아니요 | |
| 콘텐츠 보호 | ||
| AES-128 | 예 | |
| 샘플 AES-128 | 아니요 | |
| Widevine | 예 | API 19 이상 ('cenc' 스키마) 및 25 이상 ('cbcs' 스키마) |
| PlayReady SL2000 | 예 | Android TV만 |
| 서버 제어 | ||
| 델타 업데이트 | 예 | |
| 재생목록 새로고침 차단 | 예 | |
| 미리 로드 힌트 로드 차단 | 예 | 길이가 정의되지 않은 바이트 범위 제외 |
| 실시간 재생 | ||
| 일반 라이브 재생 | 예 | |
| 지연 시간이 짧은 HLS (Apple) | 예 | |
| 지연 시간이 짧은 HLS (커뮤니티) | 아니요 | |
| CMCD (Common Media Client Data) | 예 | 통합 가이드 |
프로그레시브 컨테이너 형식
다음 컨테이너 형식의 스트림은 ExoPlayer에서 직접 재생할 수 있습니다. 포함된 오디오 및 동영상 샘플 형식도 지원되어야 합니다 (자세한 내용은 샘플 형식 섹션 참고). 이미지 컨테이너 및 형식 지원에 관한 자세한 내용은 이미지를 참고하세요.
| 컨테이너 형식 | 지원됨 | 비고 |
|---|---|---|
| MP4 | 예 | |
| M4A | 예 | |
| FMP4 | 예 | |
| WebM | 예 | |
| Matroska | 예 | |
| MP3 | 예 | 일부 스트림은 일정한 비트 전송률 탐색을 사용하여서만 탐색할 수 있습니다.** |
| Ogg | 예 | Vorbis, Opus, FLAC 포함 |
| WAV | 예 | |
| MPEG-TS | 예 | |
| MPEG-PS | 예 | |
| FLV | 예 | 탐색 불가* |
| ADTS (AAC) | 예 | 일정한 비트 전송률 탐색을 사용하여만 탐색 가능** |
| FLAC | 예 | ExoPlayer 라이브러리에서 FLAC 라이브러리 또는 FLAC 추출기 사용*** |
| AMR | 예 | 일정한 비트 전송률 탐색을 사용하여만 탐색 가능** |
* 컨테이너가 미디어 플레이어가 효율적인 방식으로 탐색을 실행할 수 있도록 하는 메타데이터 (예: 샘플 색인)를 제공하지 않으므로 탐색이 지원되지 않습니다. 탐색이 필요한 경우 더 적절한 컨테이너 형식을 사용하는 것이 좋습니다.
** 이러한 추출기에는 일정한 비트 전송률 가정을 사용하여 대략적인 탐색을 사용 설정하기 위한 FLAG_ENABLE_CONSTANT_BITRATE_SEEKING 플래그가 있습니다. 이 기능은 기본적으로 사용 설정되어 있지 않습니다. 이 기능을 지원하는 모든 추출기에 이 기능을 사용 설정하는 가장 간단한 방법은 여기에 설명된 대로 DefaultExtractorsFactory.setConstantBitrateSeekingEnabled를 사용하는 것입니다.
*** FLAC 라이브러리 추출기는 모든 API 수준에서 프레임워크에서 처리할 수 있는 원시 오디오를 출력합니다. ExoPlayer 라이브러리 FLAC 추출기는 FLAC 오디오 프레임을 출력하므로 FLAC 디코더 (예: FLAC을 처리하는 MediaCodec 디코더 (API 수준 27부터 필요), 또는 FLAC이 사용 설정된 FFmpeg 라이브러리)가 있어야 합니다. 애플리케이션이 FLAC 라이브러리로 빌드된 경우 DefaultExtractorsFactory는 확장자 추출기를 사용합니다.
그렇지 않으면 ExoPlayer 라이브러리 추출기를 사용합니다.
RTSP
ExoPlayer는 실시간 RTSP와 주문형 RTSP를 모두 지원합니다. 지원되는 샘플 형식 및 네트워크 유형은 다음과 같습니다.
지원되는 샘플 형식
- H264 (SDP 미디어 설명은 디코더 초기화를 위한 fmtp 속성에 SPS/PPS 데이터를 포함해야 함)
- AAC (ADTS 비트스트림 포함)
- AC3.
지원되는 네트워크 유형
- UDP unicast를 통한 RTP (멀티캐스트는 지원되지 않음)
- 인터리빙된 RTSP, TCP를 사용한 RTSP를 통한 RTP
샘플 형식
기본적으로 ExoPlayer는 Android의 플랫폼 디코더를 사용합니다. 따라서 지원되는 샘플 형식은 ExoPlayer가 아닌 기본 플랫폼에 따라 다릅니다. Android 기기에서 지원하는 샘플 형식에 관한 문서는 지원되는 미디어 형식을 참고하세요. 개별 기기에서는 나열된 형식 외에도 추가 형식을 지원할 수 있습니다.
ExoPlayer는 Android의 플랫폼 디코더 외에도 소프트웨어 디코더 확장 프로그램을 사용할 수 있습니다. 이러한 라이브러리는 수동으로 빌드하고 이를 사용하려는 프로젝트에 포함해야 합니다. 현재 AV1, VP9, FLAC, Opus, FFmpeg, MIDI, IAMF용 소프트웨어 디코더 라이브러리를 제공하고 있습니다.
FFmpeg 라이브러리
FFmpeg 라이브러리는 다양한 오디오 샘플 형식의 디코딩을 지원합니다. 라이브러리의 README.md에 설명된 대로 라이브러리를 빌드할 때 포함할 디코더를 선택할 수 있습니다. 다음 표에는 오디오 샘플 형식과 해당하는 FFmpeg 디코더 이름 간의 매핑이 나와 있습니다.
| 샘플 형식 | 디코더 이름 |
|---|---|
| Vorbis | vorbis |
| Opus | opus |
| FLAC | flac |
| ALAC | alac |
| PCM μ-law | pcm_mulaw |
| PCM A-law | pcm_alaw |
| MP1, MP2, MP3 | mp3 |
| AMR-NB | amrnb |
| AMR-WB | amrwb |
| AAC | aac |
| AC-3 | ac3 |
| E-AC-3 | eac3 |
| DTS, DTS-HD | dca |
| TrueHD | mlp truehd |
이미지
ExoPlayer는 다음 이미지 형식을 지원합니다. 다른 형식을 지원할 수 있는 외부 라이브러리와 통합하는 방법은 이미지 로드 라이브러리를 참고하세요.
| 이미지 형식 | 지원됨 | 참고 |
|---|---|---|
| BMP | 예 | |
| GIF | 아니요 | 추출기 지원 없음 |
| JPEG | 예 | |
| JPEG 모션 포토 | 예 | 정지 이미지 및 동영상 지원 |
| JPEG 울트라 HDR | 예 | Android 14 이전 또는 HDR이 아닌 디스플레이에서는 SDR로 대체됩니다. |
| PNG | 예 | |
| WebP | 예 | |
| HEIF/HEIC | 예 | |
| HEIC 모션 사진 | 일부만 | 정지 이미지만 지원됨* |
| AVIF (기준) | 예 | Android 14 이상에서만 디코딩됨 |
* HEIC 모션 포토의 동영상 부분은 MetadataRetriever로 가져와 독립형 파일로 재생할 수 있습니다.
독립형 자막 형식
ExoPlayer는 다양한 형식의 독립형 자막 파일을 지원합니다. 자막 파일은 미디어 항목 페이지에 설명된 대로 사이드로드할 수 있습니다.
| 컨테이너 형식 | 지원됨 | MIME 유형 |
|---|---|---|
| WebVTT | 예 | MimeTypes.TEXT_VTT |
| TTML / SMPTE-TT | 예 | MimeTypes.APPLICATION_TTML |
| SubRip | 예 | MimeTypes.APPLICATION_SUBRIP |
| SubStationAlpha (SSA/ASS) | 예 | MimeTypes.TEXT_SSA |
HDR 동영상 재생
ExoPlayer는 MP4의 Dolby Vision, Matroska/WebM의 HDR10+ 등 다양한 컨테이너에서 HDR (High Dynamic Range) 동영상 추출을 처리합니다. HDR 콘텐츠의 디코딩 및 표시는 Android 플랫폼 및 기기의 지원에 따라 달라집니다. Android 버전에서 HDR 디코딩/디스플레이 기능을 확인하고 HDR 지원의 제한사항을 알아보려면 HDR 동영상 재생을 참고하세요.
특정 코덱 프로필을 지원해야 하는 HDR 스트림을 재생할 때 ExoPlayer의 기본 MediaCodec 선택기는 해당 프로필을 지원하는 디코더 (있는 경우)를 선택합니다. 이때 해당 프로필을 지원하지 않는 동일한 MIME 유형의 다른 디코더가 코덱 목록 상단에 표시되더라도 마찬가지입니다. 이렇게 하면 스트림이 동일한 MIME 유형의 하드웨어 디코더의 기능을 초과하는 경우 소프트웨어 디코더가 선택될 수 있습니다.