ExoPlayer에서 지원하는 형식을 정의할 때 '미디어 형식'은 여러 수준에서 정의된다는 점에 유의해야 합니다. 가장 낮은 수준에서 가장 높은 수준까지 다음과 같습니다.
- 개별 미디어 샘플의 형식입니다 (예: 동영상 프레임 또는 오디오 프레임). 샘플 형식입니다. 일반적인 동영상 파일에는 동영상 (예: H.264)과 오디오용 (예: AAC) 등 최소 두 가지 샘플 형식의 미디어가 포함됩니다.
- 미디어 샘플 및 관련 메타데이터가 있는 컨테이너의 형식입니다. 바로 컨테이너 형식입니다. 미디어 파일에는 일반적으로 파일 확장자로 표시되는 단일 컨테이너 형식 (예: MP4)이 있습니다. 일부 오디오 전용 형식 (예: MP3)의 경우 샘플과 컨테이너 형식이 동일할 수 있습니다.
- DASH, SmoothStreaming, HLS와 같은 적응형 스트리밍 기술 이는 미디어 형식은 아니지만 ExoPlayer에서 제공하는 지원 수준을 정의해야 합니다.
다음 섹션에서는 가장 높은 것부터 가장 낮은 수준에 이르기까지 각 수준에서 ExoPlayer의 지원을 정의합니다. 마지막 두 섹션에서는 독립형 자막 형식과 HDR 동영상 재생 지원을 설명합니다.
가변 품질 스트리밍
DASH
ExoPlayer는 여러 컨테이너 형식으로 DASH를 지원합니다. 미디어 스트림은 역다중화되어야 합니다. 즉, 동영상, 오디오 및 텍스트는 DASH 매니페스트의 고유한 AdaptationSet
요소에 정의되어야 합니다 (CEA-608은 아래 표에 설명된 예외임). 포함된 오디오 및 동영상 샘플 형식도 지원되어야 합니다 (자세한 내용은 샘플 형식 섹션 참고).
기능 | 지원됨 | 의견 |
---|---|---|
컨테이너 | ||
FMP4 | 예 | 디믹스된 스트림만 |
WebM | 예 | 디믹스된 스트림만 |
마트로스카 | 예 | 디믹스된 스트림만 |
MPEG-TS | 아니요 | 지원 예정 없음 |
자막 | ||
TTML : ML | 예 | 원시 데이터 또는 ISO/IEC 14496-30에 따라 FMP4에 삽입됨 |
WebVTT | 예 | 원시 데이터 또는 ISO/IEC 14496-30에 따라 FMP4에 삽입됨 |
CEA-608 | 예 | SCTE 접근성 설명어를 사용하여 신호를 보낼 때 FMP4에 삽입됨 |
CEA-708 | 예 | SCTE 접근성 설명어를 사용하여 신호를 보낼 때 FMP4에 삽입됨 |
Metadata | ||
EMSG 메타데이터 | 예 | FMP4에 삽입됨 |
콘텐츠 보호 | ||
Widevine | 예 | 'cenc' 스키마: API 19 이상, 'cbcs' 스키마: API 25 이상 |
PlayReady SL2000 | 예 | Android TV, 'cenc' 스키마만 해당 |
키 삭제 | 예 | API 21 이상, 'cenc' 스키마만 해당 |
실시간 재생 | ||
정기 라이브 재생 | 예 | |
지연 시간이 매우 짧은 CMAF 실시간 재생 | 예 | |
Common Media Client Data (CMCD) | 예 | 통합 가이드 |
SmoothStreaming
ExoPlayer는 FMP4 컨테이너 형식으로 SmoothStreaming을 지원합니다. 미디어 스트림은 역다중화되어야 합니다. 즉, 동영상, 오디오, 텍스트가 SmoothStreaming 매니페스트의 고유한 StreamIndex 요소로 정의되어야 합니다. 포함된 오디오 및 동영상 샘플 형식도 지원되어야 합니다 (자세한 내용은 샘플 형식 섹션 참고).
기능 | 지원됨 | 의견 |
---|---|---|
컨테이너 | ||
FMP4 | 예 | 디믹스된 스트림만 |
자막 | ||
TTML : ML | 예 | FMP4에 삽입됨 |
콘텐츠 보호 | ||
PlayReady SL2000 | 예 | Android TV만 |
실시간 재생 | ||
정기 라이브 재생 | 예 | |
Common Media Client Data (CMCD) | 예 | 통합 가이드 |
HLS
ExoPlayer는 여러 컨테이너 형식으로 HLS를 지원합니다. 포함된 오디오 및 동영상 샘플 형식도 지원되어야 합니다 (자세한 내용은 샘플 형식 섹션 참고). 여기에 설명된 대로 HLS 콘텐츠 제작자가 고품질 HLS 스트림을 생성할 것을 적극 권장합니다.
기능 | 지원됨 | 의견 |
---|---|---|
컨테이너 | ||
MPEG-TS | 예 | |
FMP4/CMAF | 예 | |
ADTS (AAC) | 예 | |
MP3 | 예 | |
자막 | ||
CEA-608 | 예 | |
CEA-708 | 예 | |
WebVTT | 예 | |
Metadata | ||
ID3 | 예 | |
SCTE-35 | 아니요 | |
콘텐츠 보호 | ||
AES-128 | 예 | |
샘플 AES-128 | 아니요 | |
Widevine | 예 | API 19 이상 ('cenc' 체계) 및 25 이상 ('cbcs' 체계) |
PlayReady SL2000 | 예 | Android TV만 |
서버 제어 | ||
델타 업데이트 | 예 | |
재생목록 새로고침 차단 중 | 예 | |
미리 로드 힌트 로드 차단 | 예 | 길이가 정의되지 않은 byterange 제외 |
실시간 재생 | ||
정기 라이브 재생 | 예 | |
지연 시간이 짧은 HLS (Apple) | 예 | |
지연 시간이 짧은 HLS (커뮤니티) | 아니요 | |
Common Media Client Data (CMCD) | 예 | 통합 가이드 |
프로그레시브 컨테이너 형식
다음 컨테이너 형식의 스트림은 ExoPlayer에서 직접 재생할 수 있습니다. 포함된 오디오 및 동영상 샘플 형식도 지원되어야 합니다 (자세한 내용은 샘플 형식 섹션 참고).
컨테이너 형식 | 지원됨 | 의견 |
---|---|---|
MP4 | 예 | |
M4A : M4A | 예 | |
FMP4 | 예 | |
WebM | 예 | |
마트로스카 | 예 | |
MP3 | 예 | 일부 스트림은 상수 비트 전송률 탐색을 통해서만 탐색할 수 있습니다.** |
오그 | 예 | Vorbis, Opus, FLAC 포함 |
웹 애플리케이션 | 예 | |
MPEG-TS | 예 | |
MPEG-PS | 예 | |
FLV | 예 | 탐색 불가* |
ADTS (AAC) | 예 | 상수 비트 전송률 탐색을 통해서만 검색할 수 있습니다.** |
FLAC | 예 | FLAC 라이브러리 또는 ExoPlayer 라이브러리의 FLAC 추출기 사용*** |
AMR | 예 | 상수 비트 전송률 탐색을 통해서만 검색할 수 있습니다.** |
JPEG 모션 사진 | 예 | MP4 콘텐츠만 추출됩니다. |
* 탐색은 미디어 플레이어가 효율적인 방법으로 탐색을 실행할 수 있도록 메타데이터 (예: 샘플 색인)를 제공하지 않으므로 지원되지 않습니다. 탐색이 필요한 경우 더 적합한 컨테이너 형식을 사용하는 것이 좋습니다.
** 이러한 추출기에는 일정한 비트 전송률 가정을 사용하여 근사치 탐색을 사용 설정하는 FLAG_ENABLE_CONSTANT_BITRATE_SEEKING
플래그가 있습니다. 이 기능은 기본적으로 사용 설정되어 있지 않습니다. 이 기능을 지원하는 모든 추출기에 이 기능을 사용 설정하는 가장 간단한 방법은 여기에 설명된 대로 DefaultExtractorsFactory.setConstantBitrateSeekingEnabled
를 사용하는 것입니다.
*** FLAC 라이브러리 추출기는 모든 API 수준에서 프레임워크가 처리할 수 있는 원시 오디오를 출력합니다. ExoPlayer 라이브러리 FLAC 추출기는 FLAC 오디오 프레임을 출력하므로 FLAC 디코더 (예: FLAC를 처리하는 MediaCodec
디코더 (API 수준 27에서 필요) 또는 FLAC가 사용 설정된 FFmpeg 라이브러리)가 있어야 합니다. DefaultExtractorsFactory
는 애플리케이션이 FLAC 라이브러리로 빌드된 경우 확장 프로그램 추출기를 사용합니다.
그 외의 경우에는 ExoPlayer 라이브러리 추출기를 사용합니다.
RTSP
ExoPlayer는 실시간 및 주문형 RTSP를 모두 지원합니다. 지원되는 샘플 형식 및 네트워크 유형은 아래에 나와 있습니다.
지원되는 샘플 형식
- H264 (SDP 미디어 설명에는 디코더 초기화를 위해 fmtp 속성에 SPS/PPS 데이터가 포함되어야 함).
- AAC (ADS 비트스트림 포함).
- AC3.
지원되는 네트워크 유형
- RTP/UDP 유니캐스트 (멀티캐스트는 지원되지 않음)
- 인터리브 처리된 RTSP, TCP를 사용하여 RTSP를 통한 RTP
샘플 형식
기본적으로 ExoPlayer는 Android의 플랫폼 디코더를 사용합니다. 따라서 지원되는 샘플 형식은 ExoPlayer가 아닌 기본 플랫폼에 따라 다릅니다. Android 기기에서 지원하는 샘플 형식에 관한 문서는 지원되는 미디어 형식을 참고하세요. 개별 기기는 나열된 형식 이외의 추가 형식을 지원할 수도 있습니다.
ExoPlayer는 Android의 플랫폼 디코더 외에도 소프트웨어 디코더 확장 프로그램을 활용할 수 있습니다. 이는 수동으로 빌드해야 하며 이를 사용하려는 프로젝트에 포함해야 합니다. 현재 AV1, VP9, FLAC, Opus, FFmpeg용 소프트웨어 디코더 라이브러리가 제공됩니다.
FFmpeg 라이브러리
FFmpeg 라이브러리는 다양한 오디오 샘플 형식 디코딩을 지원합니다. 라이브러리의 README.md에 설명된 대로 라이브러리를 빌드할 때 포함할 디코더를 선택할 수 있습니다. 다음 표는 오디오 샘플 형식과 이에 상응하는 FFmpeg 디코더 이름으로의 매핑을 제공합니다.
샘플 형식 | 디코더 이름 |
---|---|
Vorbis | Vorbis |
Opus | opus |
FLAC | FLAC |
알렉스 | Alac |
PCM 마이크로 법칙 | pcm_mulaw |
PCM A법 | pcm_alaw |
MP1, MP2, MP3 | mp3 |
AMR-NB | Amrnb |
AMR-WB | AMRWB |
AAC | aac |
AC-3 | AC3 |
냉방-3 | EAC3 |
DTS, DTS-HD | DCA |
트루 HD | MLP Truehd |
독립형 자막 형식
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 플랫폼 및 기기의 지원 여부에 따라 다릅니다. HDR 디코딩/디스플레이 기능 확인과 여러 Android 버전에서 HDR 지원 제한사항을 자세히 알아보려면 HDR 동영상 재생을 참고하세요.
특정 코덱 프로필을 지원해야 하는 HDR 스트림을 재생할 때 ExoPlayer의 기본 MediaCodec
선택기는 이 프로필을 지원하는 디코더를 선택합니다 (사용 가능한 경우). 해당 프로필을 지원하지 않는 동일한 MIME 유형의 다른 디코더가 코덱 목록 상위에 표시되더라도 마찬가지입니다. 그 결과 스트림이 동일한 MIME 유형의 하드웨어 디코더 기능을 초과하는 경우 소프트웨어 디코더가 선택될 수 있습니다.