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.4.1")

Groovy

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

그런 다음 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로 끝나지 않으면 MimeTypes.APPLICATION_M3U8을 전달할 수 있습니다. 유형을 MediaItem.BuildersetMimeType로 지정하여 있습니다.

미디어 항목의 URI는 미디어 재생목록 또는 다중 변형 재생목록을 가리킬 수 있습니다. URI가 여러 변형을 선언하는 다중 변형 재생목록을 가리키는 경우 #EXT-X-STREAM-INF 태그 사용 시 ExoPlayer가 자동으로 옵션을 모두 고려합니다.

HlsMediaSource 사용

더 많은 맞춤설정 옵션을 위해 HlsMediaSource를 만들어 전달하면 됩니다. MediaItem 대신 플레이어에 바로 전달할 수 있습니다.

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 콘텐츠를 개선하세요. HLS 재생에 관한 중간 게시물 ExoPlayer를 참고하세요. 주요 사항은 다음과 같습니다.

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

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

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