Odtwarzanie filmów w jakości HDR

HDR (High Dynamic Range) zapewnia szerszy zakres kolorów i lepsze kontrast między najjaśniejszymi białymi i najciemniejszymi cieniami, jakości obrazu, który bardziej przypomina to, co widzi gołym okiem.

Możesz skonfigurować odtwarzanie filmów HDR w swojej aplikacji, aby wyświetlać podgląd i odtwarzać filmy HDR treści.

W tym artykule zakładamy, że masz już dodaną podstawową obsługę odtwarzania wideo do aplikacji. Zapoznaj się z dokumentacją ExoPlayer, aby uzyskać informacje na temat o odtwarzaniu.

Wymagania wstępne dla urządzenia

Nie wszystkie urządzenia z Androidem obsługują odtwarzanie w jakości HDR. Przed odtworzeniem filmu HDR treści wideo w aplikacji, sprawdź, czy Twoje urządzenie spełnia te wymagania: wymagania wstępne:

  • Jest kierowana na Androida w wersji 7.0 lub nowszej (w warstwie interfejsów API 24).
  • Ma dekoder i wyświetlacz obsługujący HDR.

Sprawdź, czy obsługuje odtwarzanie w HDR

Użyj Display.getHdrCapabilities(), aby wysłać zapytanie o możliwości HDR wyświetlacza. Zwraca ona informacje o obsługiwanych profilach HDR i zakresie luminancji wyświetlacza.

Ten kod pozwala sprawdzić, czy urządzenie obsługuje odtwarzanie HLG10. Począwszy od Androida 13 HLG10 to minimalny standard, który producenci muszą obsługiwać, jeśli urządzenia mogą odtwarzać treści HDR:

Kotlin

// Check if display supports the HDR type
val capabilities = display?.hdrCapabilities?.supportedHdrTypes ?: intArrayOf()
if (!capabilities.contains(HDR_TYPE_HLG)) {
  throw RuntimeException("Display does not support desired HDR type");
}

Java

// Check if display supports the HDR type
int[] list = getDisplay().getHdrCapabilities().getSupportedHdrTypes();
List capabilities = Arrays.stream(list).boxed().collect(Collectors.toList());
if (!capabilities.contains(HDR_TYPE_HLG)) {
 throw new RuntimeException("Display does not support desired HDR type");
}

Konfigurowanie odtwarzania HDR w aplikacji

Jeśli Twoja aplikacja używa odtwarzacza ExoPlayer, domyślnie obsługuje on odtwarzanie w trybie HDR. Dalsze kroki znajdziesz w artykule Sprawdzanie, czy funkcja odtwarzania HDR jest dostępna.

Jeśli Twoja aplikacja nie używa ExoPlayer, skonfiguruj odtwarzanie HDR za pomocą MediaCodec przez SurfaceView.

Konfigurowanie MediaCodec za pomocą SurfaceView

Skonfiguruj standardowy proces odtwarzania MediaCodec za pomocą SurfaceView. To ustawienie pozwala na wyświetlanie filmów HDR bez specjalnej obsługi funkcji odtwarzania w tym trybie:

  • MediaCodec: dekoduje filmy HDR.
  • SurfaceView: wyświetla treści wideo HDR.

Ten kod sprawdza, czy kodek obsługuje profil HDR, a następnie konfiguruje MediaCodec przy użyciu SurfaceView:

Kotlin

// Check if there's a codec that supports the specific HDR profile
val list = MediaCodecList(MediaCodecList.REGULAR_CODECS) var format = MediaFormat() /* media format from the container */;
format.setInteger(MediaFormat.KEY_PROFILE, MediaCodecInfo.CodecProfileLevel.AV1ProfileMain10)
val codecName = list.findDecoderForFormat (format) ?: throw RuntimeException ("No codec supports the format")

// Here is a standard MediaCodec playback flow
val codec: MediaCodec = MediaCodec.createByCodecName(codecName);
val surface: Surface = surfaceView.holder.surface
val callback: MediaCodec.Callback = (object : MediaCodec.Callback() {
   override fun onInputBufferAvailable(codec: MediaCodec, index: Int) {
      queue.offer(index)
   }

   override fun onOutputBufferAvailable(
      codec: MediaCodec,
      index: Int,
      info: MediaCodec.BufferInfo
   ) {
      codec.releaseOutputBuffer(index, timestamp)
   }

   override fun onError(codec: MediaCodec, e: MediaCodec.CodecException) {
      // handle error
   }

   override fun onOutputFormatChanged(
      codec: MediaCodec, format: MediaFormat
   ) {
      // handle format change
   }
})

codec.setCallback(callback)
codec.configure(format, surface, crypto, 0 /* flags */)
codec.start()
while (/* until EOS */) {
   val index = queue.poll()
   val buffer = codec.getInputBuffer(index)
   buffer?.put(/* write bitstream */)
   codec.queueInputBuffer(index, offset, size, timestamp, flags)
}
codec.stop()
codec.release()

Java

// Check if there's a codec that supports the specific HDR profile
MediaCodecList list = new MediaCodecList(MediaCodecList.REGULAR_CODECS);
MediaFormat format = /* media format from the container */;
format.setInteger(
    MediaFormat.KEY_PROFILE, CodecProfileLevel.AV1ProfileMain10);
String codecName = list.findDecoderForFormat(format);
if (codecName == null) {
    throw new RuntimeException("No codec supports the format");
}

// Below is a standard MediaCodec playback flow
MediaCodec codec = MediaCodec.getCodecByName(codecName);
Surface surface = surfaceView.getHolder().getSurface();
MediaCodec.Callback callback = new MediaCodec.Callback() {
    @Override
    void onInputBufferAvailable(MediaCodec codec, int index) {
        queue.offer(index);
    }

    @Override
    void onOutputBufferAvailable(MediaCodec codec, int index) {
        // release the buffer for render
        codec.releaseOutputBuffer(index, timestamp);
    }

    @Override
    void onOutputFormatChanged(MediaCodec codec, MediaFormat format) {
        // handle format change
    }

    @Override
    void onError(MediaCodec codec, MediaCodec.CodecException ex) {
        // handle error
    }

};
codec.setCallback(callback);
codec.configure(format, surface, crypto, 0 /* flags */);
codec.start();
while (/* until EOS */) {
    int index = queue.poll();
    ByteBuffer buffer = codec.getInputBuffer(index);
    buffer.put(/* write bitstream */);
    codec.queueInputBuffer(index, offset, size, timestamp, flags);
}
codec.stop();
codec.release();

Więcej implementacji interfejsu MediaCodec z wykorzystaniem SurfaceView znajdziesz w przykładach Aparatu z Androidem.

Materiały

Więcej informacji o odtwarzaniu w trybie HDR znajdziesz w tych materiałach:

HDR

Multimedia

  • Dokumentacja Media API: dowiedz się więcej o interfejsach Media API.
  • ExoPlayer: dowiedz się, jak skonfigurować aplikację przy użyciu biblioteki ExoPlayer.