HDR (High Dynamic Range) zapewnia szerszy zakres kolorów i większy kontrast między najjaśniejszymi białymi a najciemniejszymi cieniami. W rezultacie jakość filmu jest bardziej zbliżona do gołych oczu.
Możesz skonfigurować odtwarzanie filmów HDR w aplikacji, aby wyświetlić podgląd treści wideo w tej rozdzielczości.
W tym artykule zakładamy, że masz już w aplikacji włączoną podstawową obsługę odtwarzania filmów. Więcej informacji o odtwarzaniu znajdziesz w dokumentacji ExoPlayer.
Wymagania wstępne urządzenia
Nie wszystkie urządzenia z Androidem obsługują odtwarzanie w trybie HDR. Zanim zaczniesz odtwarzać w aplikacji treści wideo HDR, sprawdź, czy Twoje urządzenie spełnia te wymagania wstępne:
- Aplikacja jest kierowana na Androida 7.0 lub nowszego (warstwa interfejsu API 24).
- Ma dekoder obsługujący HDR i dostęp do wyświetlacza obsługującego tę funkcję.
Sprawdź, czy obsługuje odtwarzanie w trybie HDR
Aby przesłać zapytanie o funkcje HDR wyświetlacza, użyj Display.getHdrCapabilities()
. Zwraca ona informacje o obsługiwanych profilach HDR i zakresie luminancji wyświetlacza.
Ten kod pozwala sprawdzić, czy urządzenie obsługuje odtwarzanie HLG10. Od Androida 13 HLG10 to minimalny standard, który producenci urządzeń muszą obsługiwać, jeśli urządzenie umożliwia odtwarzanie w trybie 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(); Listcapabilities = 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 w jakości HDR w aplikacji
Jeśli Twoja aplikacja używa ExoPlayer, domyślnie obsługuje odtwarzanie w trybie HDR. Przeczytaj sekcję Sprawdzanie obsługi odtwarzania w trybie HDR, aby zapoznać się z kolejnymi krokami.
Jeśli Twoja aplikacja nie używa odtwarzacza ExoPlayer, skonfiguruj odtwarzanie w trybie HDR za pomocą MediaCodec
w usłudze SurfaceView
.
Konfigurowanie MediaCodec za pomocą SurfaceView
Skonfiguruj standardowy proces odtwarzania MediaCodec
za pomocą SurfaceView
. Dzięki temu możesz wyświetlać filmy w formacie HDR bez żadnej specjalnej obsługi:
MediaCodec
: dekoduje treści wideo 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 MediaCodec
z wykorzystaniem SurfaceView
znajdziesz w przykładach korzystania z aparatu w Androidzie.
Zasoby
Więcej informacji o odtwarzaniu w jakości HDR znajdziesz w tych materiałach:
HDR
- Nagrywanie filmów HDR: dowiedz się, jak skonfigurować nagrywanie filmów HDR za pomocą interfejsów API Camera2.
- Camera2Video sample on GitHub: Zobacz działającą aplikację z funkcją nagrywania i odtwarzania w trybie HDR.
Multimedia
- Dokumentacja interfejsu Media API: dowiedz się więcej o interfejsach Media API.
- ExoPlayer: dowiedz się, jak skonfigurować aplikację za pomocą biblioteki ExoPlayer.