HLS

ExoPlayer는 여러 컨테이너 형식으로 HLS를 지원합니다. 포함된 오디오와 동영상 샘플 형식도 지원해야 합니다 (자세한 내용은 샘플 형식 섹션을 참조하세요.) HLS 콘텐츠 제작자가 고품질 HLS 스트림을 생성하도록 강력하게 권장하고 설명대로 여기에서 확인할 수 있습니다.

기능 지원됨 비고
컨테이너
MPEG-TS
FMP4/CMAF
ADTS (AAC)
MP3
자막
CEA-608 : CEA-608
CEA-708 : 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.0")

Groovy

implementation "androidx.media3:media3-exoplayer-hls:1.4.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로 끝나지 않으면 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분 이상은 좋습니다.