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) 통합 가이드

MediaItem 사용

HLS 스트림을 재생하려면 HLS 모듈에 종속되어야 합니다.

Kotlin

implementation("androidx.media3:media3-exoplayer-hls:1.5.0")

Groovy

implementation "androidx.media3:media3-exoplayer-hls:1.5.0"

그런 다음 HLS 재생목록 URI의 MediaItem를 만들고 이를 플레이어에 전달할 수 있습니다.

Kotlin

// Create a player instance.
val player = ExoPlayer.Builder(context).build()
// Set the media item to be played.
player.setMediaItem(MediaItem.fromUri(hlsUri))
// Prepare the player.
player.prepare()

자바

// Create a player instance.
ExoPlayer player = new ExoPlayer.Builder(context).build();
// Set the media item to be played.
player.setMediaItem(MediaItem.fromUri(hlsUri));
// Prepare the player.
player.prepare();

URI가 .m3u8로 끝나지 않으면 MediaItem.BuildersetMimeTypeMimeTypes.APPLICATION_M3U8를 전달하여 콘텐츠 유형을 명시적으로 표시할 수 있습니다.

미디어 항목의 URI는 미디어 재생목록 또는 다중 변형 재생목록을 가리킬 수 있습니다. URI가 여러 #EXT-X-STREAM-INF 태그를 선언하는 다중 변형 재생목록을 가리키는 경우 ExoPlayer는 사용 가능한 대역폭과 기기 기능을 모두 고려하여 변형 간에 자동으로 조정합니다.

HlsMediaSource 사용

더 많은 맞춤설정 옵션을 사용하려면 MediaItem 대신 HlsMediaSource를 만들어 플레이어에 직접 전달하면 됩니다.

Kotlin

// Create a data source factory.
val dataSourceFactory: DataSource.Factory = DefaultHttpDataSource.Factory()
// Create a HLS media source pointing to a playlist uri.
val hlsMediaSource =
  HlsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(hlsUri))
// Create a player instance.
val player = ExoPlayer.Builder(context).build()
// Set the HLS media source as the playlist with a single media item.
player.setMediaSource(hlsMediaSource)
// Prepare the player.
player.prepare()

자바

// Create a data source factory.
DataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory();
// Create a HLS media source pointing to a playlist uri.
HlsMediaSource hlsMediaSource =
    new HlsMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(hlsUri));
// Create a player instance.
ExoPlayer player = new ExoPlayer.Builder(context).build();
// Set the HLS media source as the playlist with a single media item.
player.setMediaSource(hlsMediaSource);
// Prepare the player.
player.prepare();

매니페스트 액세스

Player.getCurrentManifest를 호출하여 현재 매니페스트를 검색할 수 있습니다. HLS의 경우 반환된 객체를 HlsManifest로 변환해야 합니다. Player.ListeneronTimelineChanged 콜백은 매니페스트가 로드될 때마다 호출됩니다. 주문형 콘텐츠의 경우 한 번, 라이브 콘텐츠의 경우 여러 번 발생할 수 있습니다. 다음 코드 스니펫은 매니페스트가 로드될 때마다 앱이 작업을 실행하는 방법을 보여줍니다.

Kotlin

player.addListener(
  object : Player.Listener {
    override fun onTimelineChanged(timeline: Timeline, @TimelineChangeReason reason: Int) {
      val manifest = player.currentManifest
      if (manifest is HlsManifest) {
        // Do something with the manifest.
      }
    }
  }
)

자바

player.addListener(
    new Player.Listener() {
      @Override
      public void onTimelineChanged(
          Timeline timeline, @Player.TimelineChangeReason int reason) {
        Object manifest = player.getCurrentManifest();
        if (manifest != null) {
          HlsManifest hlsManifest = (HlsManifest) manifest;
          // Do something with the manifest.
        }
      }
    });

재생 맞춤설정

ExoPlayer는 앱의 요구사항에 맞게 재생 환경을 조정할 수 있는 여러 가지 방법을 제공합니다. 예시는 맞춤설정 페이지를 참고하세요.

청크 없는 준비 사용 중지

기본적으로 ExoPlayer는 청크 없는 준비를 사용합니다. 즉, ExoPlayer는 스트림을 준비하는 데만 다중 변형 재생목록의 정보를 사용합니다. 이는 #EXT-X-STREAM-INF 태그에 CODECS 속성이 포함된 경우에 작동합니다.

미디어 세그먼트에 #EXT-X-MEDIA:TYPE=CLOSED-CAPTIONS 태그로 다중 변형 재생목록에 선언되지 않은 멀티플렉스 자막 트랙이 포함된 경우 이 기능을 사용 중지해야 할 수 있습니다. 그렇지 않으면 자막 트랙이 감지되고 재생되지 않습니다. 다음 스니펫과 같이 HlsMediaSource.Factory에서 청크 없는 준비를 사용 중지할 수 있습니다. 이렇게 하면 ExoPlayer가 이러한 추가 트랙을 검색하기 위해 미디어 세그먼트를 다운로드해야 하므로 시작 시간이 늘어나므로 대신 대안 재생목록에서 자막 트랙을 선언하는 것이 좋습니다.

Kotlin

val hlsMediaSource =
  HlsMediaSource.Factory(dataSourceFactory)
    .setAllowChunklessPreparation(false)
    .createMediaSource(MediaItem.fromUri(hlsUri))

자바

HlsMediaSource hlsMediaSource =
    new HlsMediaSource.Factory(dataSourceFactory)
        .setAllowChunklessPreparation(false)
        .createMediaSource(MediaItem.fromUri(hlsUri));

고품질 HLS 콘텐츠 제작

ExoPlayer를 최대한 활용하려면 HLS 콘텐츠를 개선하기 위해 따라야 할 몇 가지 가이드라인이 있습니다. 자세한 내용은 ExoPlayer의 HLS 재생에 관한 Medium 게시물을 참고하세요. 주요 사항은 다음과 같습니다.

  • 정확한 세그먼트 길이를 사용합니다.
  • 연속 미디어 스트림을 사용합니다. 세그먼트 간에 미디어 구조가 변경되지 않도록 합니다.
  • #EXT-X-INDEPENDENT-SEGMENTS 태그를 사용합니다.
  • 동영상과 오디오가 모두 포함된 파일보다는 디뮤싱된 스트림을 사용하는 것이 좋습니다.
  • 다변형 재생목록에 가능한 한 많은 정보를 포함합니다.

다음 가이드라인은 라이브 스트림에만 적용됩니다.

  • #EXT-X-PROGRAM-DATE-TIME 태그를 사용합니다.
  • #EXT-X-DISCONTINUITY-SEQUENCE 태그를 사용합니다.
  • 긴 실시간 기간을 제공합니다. 1분 이상이면 좋습니다.