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' 스킴만
광고 삽입
다중 기간 재생
서버 안내 광고 삽입(xlinks) 아니요
IMA 서버 측 및 클라이언트 측 광고 광고 삽입 가이드
라이브 재생
일반 라이브 재생
매우 짧은 지연 시간 CMAF 라이브 재생
Common Media Client Data (CMCD) CMCD 통합 가이드

MediaItem 사용

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

Kotlin

implementation("androidx.media3:media3-exoplayer-dash:1.7.1")

Groovy

implementation "androidx.media3:media3-exoplayer-dash:1.7.1"

그런 다음 DASH MPD URI의 MediaItem를 만들어 플레이어에 전달할 수 있습니다.

Kotlin

// Create a player instance.
val player = ExoPlayer.Builder(context).build()
// Set the media item to be played.
player.setMediaItem(MediaItem.fromUri(dashUri))
// 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(dashUri));
// Prepare the player.
player.prepare();

URI가 .mpd로 끝나지 않으면 MediaItem.BuildersetMimeTypeMimeTypes.APPLICATION_MPD를 전달하여 콘텐츠 유형을 명시적으로 나타낼 수 있습니다.

ExoPlayer는 사용 가능한 대역폭과 기기 기능을 모두 고려하여 매니페스트에 정의된 표현 간에 자동으로 적응합니다.

DashMediaSource 사용

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

Kotlin

val dataSourceFactory: DataSource.Factory = DefaultHttpDataSource.Factory()
// Create a dash media source pointing to a dash manifest uri.
val mediaSource: MediaSource =
  DashMediaSource.Factory(dataSourceFactory).createMediaSource(MediaItem.fromUri(dashUri))
// Create a player instance which gets an adaptive track selector by default.
val player = ExoPlayer.Builder(context).build()
// Set the media source to be played.
player.setMediaSource(mediaSource)
// Prepare the player.
player.prepare()

자바

DataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory();
// Create a dash media source pointing to a dash manifest uri.
MediaSource mediaSource =
    new DashMediaSource.Factory(dataSourceFactory)
        .createMediaSource(MediaItem.fromUri(dashUri));
// Create a player instance which gets an adaptive track selector by default.
ExoPlayer player = new ExoPlayer.Builder(context).build();
// Set the media source to be played.
player.setMediaSource(mediaSource);
// Prepare the player.
player.prepare();

매니페스트 액세스

Player.getCurrentManifest를 호출하여 현재 매니페스트를 가져올 수 있습니다. DASH의 경우 반환된 객체를 DashManifest로 캐스팅해야 합니다. 매니페스트가 로드될 때마다 Player.ListeneronTimelineChanged 콜백도 호출됩니다. 온디맨드 콘텐츠의 경우 한 번 발생하며 라이브 콘텐츠의 경우 여러 번 발생할 수 있습니다. 다음 코드 스니펫은 매니페스트가 로드될 때마다 앱이 작업을 실행하는 방법을 보여줍니다.

Kotlin

player.addListener(
  object : Player.Listener {
    override fun onTimelineChanged(timeline: Timeline, @TimelineChangeReason reason: Int) {
      val manifest = player.currentManifest
      if (manifest is DashManifest) {
        // 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) {
          DashManifest dashManifest = (DashManifest) manifest;
          // Do something with the manifest.
        }
      }
    });

재생 맞춤설정

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