이미지

ExoPlayer는 다음 이미지 형식을 지원합니다. 다른 형식 집합을 지원할 수 있는 외부 라이브러리와 통합하는 방법은 이미지 로드 라이브러리 를 참고하세요.

이미지 형식 지원됨 참고
BMP 예
GIF 아니요 추출기 지원 없음
JPEG 예
JPEG 모션 사진 예 정지 이미지 및 동영상 지원
JPEG 울트라 HDR 예 Android 14 이전 또는 비 HDR 디스플레이에서 SDR로 대체
PNG 예
WebP 예
HEIF/HEIC 예
HEIC 모션 사진 예
AVIF (기준) 예 Android 14 이상에서만 디코딩됨

재생목록에서 이미지 재생

재생목록의 일부로 이미지를 재생하려면 이미지 URI로 MediaItem을 만들고 플레이어에 전달합니다. MediaItem에는 이미지가 표시되는 기간을 지정하는 imageDurationMs가 있어야 합니다.

Kotlin

// Create a player instance.
val player = ExoPlayer.Builder(context).build()
// Set the media item to be played with the desired duration.
player.setMediaItem(MediaItem.Builder().setUri(imageUri).setImageDurationMs(2000).build())
// Prepare the player.
player.prepare()

Java

// Create a player instance.
ExoPlayer player = new ExoPlayer.Builder(context).build();
// Set the media item to be played with the desired duration.
player.setMediaItem(new MediaItem.Builder().setUri(imageUri).setImageDurationMs(2000).build());
// Prepare the player.
player.prepare();

모션 사진 재생

모션 사진은 정지 이미지와 짧은 동영상을 결합한 파일입니다.

  • 이미지 기간이 setImageDuration으로 정의된 경우 모션 사진은 선언된 기간 동안 정지 이미지로 표시됩니다.
  • 이미지 기간이 정의되지 않은 경우 모션 사진은 동영상으로 재생됩니다.

미디어 소스로 이미지 로드 맞춤설정

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

Kotlin

// Create a data source factory.
val dataSourceFactory: DataSource.Factory = DefaultHttpDataSource.Factory()
// Create a media item with the image URI and the desired duration.
val mediaItem = MediaItem.Builder().setUri(imageUri).setImageDurationMs(2000).build()
// Create a progressive media source for this media item.
val mediaSource = ProgressiveMediaSource.Factory(dataSourceFactory).createMediaSource(mediaItem)
// Create a player instance.
val player = ExoPlayer.Builder(context).build()
// Set the media source to be played.
player.setMediaSource(mediaSource)
// Prepare the player.
player.prepare()

Java

// Create a data source factory.
DataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory();
// Create a media item with the image URI and the desired duration.
MediaItem mediaItem = new MediaItem.Builder().setUri(imageUri).setImageDurationMs(2000).build();
// Create a progressive media source for this media item.
MediaSource mediaSource =
    new ProgressiveMediaSource.Factory(dataSourceFactory).createMediaSource(mediaItem);
// Create a player instance.
ExoPlayer player = new ExoPlayer.Builder(context).build();
// Set the media source to be played.
player.setMediaSource(mediaSource);
// Prepare the player.
player.prepare();

재생 맞춤설정

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

외부 이미지 로드 라이브러리 통합

이미지는 Glide 또는 Coil과 같은 외부 이미지 로드 라이브러리에서 관리되는 경우가 많습니다.

이러한 라이브러리를 재생 파이프라인에 통합하려면 다음 세 단계가 필요합니다.

  1. APPLICATION_EXTERNALLY_LOADED_IMAGE MIME 유형으로 MediaItem을 정의합니다.
  2. 이미지 로드 라이브러리에서 Bitmap을 가져오는 이미지 디코더를 제공합니다.
  3. 캐싱 및 프리로드를 트리거하는 외부 로더를 제공합니다.

외부 로드를 위한 미디어 항목 구성

Player에 추가된 MediaItem은 이미지 로드 라이브러리 코드 경로를 사용하기 위해 APPLICATION_EXTERNALLY_LOADED_IMAGE MIME 유형을 명시적으로 정의해야 합니다.

Kotlin

val mediaItem =
  MediaItem.Builder()
    .setUri(imageUri)
    .setMimeType(MimeTypes.APPLICATION_EXTERNALLY_LOADED_IMAGE)
    .build()

Java

MediaItem mediaItem =
    new MediaItem.Builder()
        .setUri(imageUri)
        .setMimeType(MimeTypes.APPLICATION_EXTERNALLY_LOADED_IMAGE)
        .build();

외부 라이브러리를 사용하여 이미지 디코딩

이미지 렌더러는 Uri에서 Bitmap을 가져오기 위해 ExternallyLoadedImageDecoder가 필요합니다. 이 디코더는 DefaultRenderersFactory.getImageDecoderFactory를 재정의하여 제공할 수 있습니다.

다음 예에서는 Glide를 사용하여 이미지를 로드하고 매우 큰 Bitmap 객체가 생성되지 않도록 출력을 디스플레이 크기로 제한합니다.

Kotlin

val glideImageDecoderFactory: ImageDecoder.Factory =
  ExternallyLoadedImageDecoder.Factory { request: ExternalImageRequest ->
    val displaySize = Util.getCurrentDisplayModeSize(context)
    GlideFutures.submit(
      Glide.with(context)
        .asBitmap()
        .load(request.uri)
        .override(max(displaySize.x, displaySize.y))
    )
  }
val player: Player =
  ExoPlayer.Builder(context)
    .setRenderersFactory(
      object : DefaultRenderersFactory(context) {
        override fun getImageDecoderFactory(context: Context): ImageDecoder.Factory {
          return glideImageDecoderFactory
        }
      }
    )
    .build()

Java

ImageDecoder.Factory glideImageDecoderFactory =
    new ExternallyLoadedImageDecoder.Factory(
        request -> {
          Point displaySize = Util.getCurrentDisplayModeSize(context);
          return GlideFutures.submit(
              Glide.with(context)
                  .asBitmap()
                  .load(request.uri)
                  .override(max(displaySize.x, displaySize.y)));
        });
Player player =
    new ExoPlayer.Builder(context)
        .setRenderersFactory(
            new DefaultRenderersFactory(context) {
              @Override
              protected ImageDecoder.Factory getImageDecoderFactory(Context context) {
                return glideImageDecoderFactory;
              }
            })
        .build();

외부 라이브러리를 사용하여 이미지 프리로드

재생 중에 플레이어는 재생목록의 이전 항목이 완전히 로드되면 다음 이미지를 프리로드하도록 요청합니다. 외부 이미지 로드 라이브러리를 사용하는 경우 이 프리로드를 트리거하는 ExternalLoader를 지정해야 합니다. 프리로드할 수 없거나 프리로드가 필요하지 않은 경우에도 이 로더를 제공해야 하지만 아무것도 하지 않아도 됩니다.

다음 예에서는 Glide를 사용하여 요청된 이미지가 디스크에 프리로드되도록 합니다.

Kotlin

val glidePreloader = ExternalLoader { request: LoadRequest ->
  GlideFutures.submit(
    Glide.with(context)
      .asFile()
      .apply(
        RequestOptions.diskCacheStrategyOf(DiskCacheStrategy.DATA)
          .priority(Priority.HIGH)
          .skipMemoryCache(true)
      )
      .load(request.uri)
  )
}
val player: Player =
  ExoPlayer.Builder(context)
    .setMediaSourceFactory(
      DefaultMediaSourceFactory(context).setExternalImageLoader(glidePreloader)
    )
    .build()

자바

ExternalLoader glidePreloader =
    request ->
        GlideFutures.submit(
            Glide.with(context)
                .asFile()
                .apply(
                    diskCacheStrategyOf(DiskCacheStrategy.DATA)
                        .priority(Priority.HIGH)
                        .skipMemoryCache(true))
                .load(request.uri));
Player player =
    new ExoPlayer.Builder(context)
        .setMediaSourceFactory(
            new DefaultMediaSourceFactory(context).setExternalImageLoader(glidePreloader))
        .build();