HDR-Videowiedergabe

HDR (High Dynamic Range) bietet eine größere Farbpalette und einen höheren Kontrast zwischen den hellsten Weißtönen und den dunkelsten Schatten. Das Ergebnis ist eine Videoqualität, die der Wahrnehmung des menschlichen Auges näher kommt.

Sie können die HDR-Videowiedergabe in Ihrer App einrichten, um HDR-Videoinhalte in der Vorschau anzusehen und abzuspielen.

In diesem Artikel wird davon ausgegangen, dass Sie Ihrer App bereits grundlegende Unterstützung für die Videowiedergabe hinzugefügt haben. Weitere Informationen zur Wiedergabe finden Sie in der ExoPlayer-Dokumentation.

Gerätevoraussetzungen

Nicht alle Android-Geräte unterstützen die HDR-Wiedergabe. Bevor Sie HDR-Videoinhalte in Ihrer App wiedergeben, prüfen Sie, ob Ihr Gerät die folgenden Voraussetzungen erfüllt:

  • Die App ist auf Android 7.0 oder höher (API-Ebene 24) ausgerichtet.
  • einen HDR-fähigen Decoder und Zugriff auf ein HDR-fähiges Display hat.

HDR-Wiedergabe prüfen

Mit Display.getHdrCapabilities() können Sie die HDR-Funktionen eines Displays abfragen. Die Methode gibt Informationen zu den unterstützten HDR-Profilen und dem Leuchtdichtebereich für das Display zurück.

Im folgenden Code wird geprüft, ob das Gerät die HLG10-Wiedergabe unterstützt. Ab Android 13 ist HLG10 der Mindeststandard, den Gerätehersteller unterstützen müssen, wenn das Gerät HDR-Wiedergabe unterstützt:

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");
}

HDR-Wiedergabe in deiner App einrichten

Wenn in Ihrer App ExoPlayer verwendet wird, wird die HDR-Wiedergabe standardmäßig unterstützt. Weitere Informationen zu den nächsten Schritten findest du unter Unterstützung für die HDR-Wiedergabe prüfen.

Wenn in deiner App kein ExoPlayer verwendet wird, richte die HDR-Wiedergabe über MediaCodec über SurfaceView ein.

MediaCodec mit SurfaceView einrichten

Richte mit SurfaceView einen standardmäßigen MediaCodec-Wiedergabeablauf ein. So kannst du HDR-Videoinhalte ohne spezielle Verarbeitung für die HDR-Wiedergabe anzeigen:

  • MediaCodec: Dekodiert HDR-Videoinhalte.
  • SurfaceView: HDR-Videoinhalte werden angezeigt.

Im folgenden Code wird geprüft, ob der Codec das HDR-Profil unterstützt. Anschließend wird MediaCodec mit SurfaceView eingerichtet:

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();

Weitere MediaCodec-Implementierungen mit SurfaceView finden Sie in den Android-Kamerabeispielen.

Ressourcen

Weitere Informationen zur HDR-Wiedergabe findest du in den folgenden Ressourcen:

HDR

Medien

  • Media API-Referenz: Hier finden Sie weitere Informationen zu den Media APIs.
  • ExoPlayer: Hier erfährst du, wie du deine App mit der ExoPlayer-Bibliothek einrichtest.