HDR 動画再生

HDR(ハイ ダイナミック レンジ)は、より広い色域と、最も明るい白と最も暗い影の間のより大きなコントラストを提供し、肉眼で認識するものにより近い動画品質を実現します。

アプリで HDR 動画の再生を設定して、HDR 動画コンテンツをプレビューして再生できます。

この記事は、アプリに基本的な動画再生サポートがすでに追加されていることを前提としています。再生について詳しくは、ExoPlayer のドキュメントをご覧ください。

デバイスの前提条件

すべての Android デバイスが HDR 再生に対応しているわけではありません。アプリで HDR 動画コンテンツを再生する前に、デバイスが次の前提条件を満たしているかどうかを確認します。

  • Android 7.0(API レイヤ 24)以降をターゲットとしている。
  • HDR 対応デコーダを搭載し、HDR 対応ディスプレイにアクセスできる。

HDR 再生のサポートを確認する

Display.getHdrCapabilities() を使用して、ディスプレイの HDR 機能をクエリします。このメソッドは、ディスプレイでサポートされている HDR プロファイルと輝度範囲に関する情報を返します。

次のコードは、デバイスが HLG10 再生をサポートしているかどうかを確認します。Android 13 以降、デバイスが HDR 再生に対応している場合、デバイス メーカーがサポートする必要がある最小標準は HLG10 です。

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

アプリで HDR 再生を設定する

アプリで ExoPlayer を使用している場合、デフォルトで HDR 再生がサポートされます。次の手順については、HDR 再生サポートを確認するを参照してください。

アプリで ExoPlayer を使用していない場合は、SurfaceView を介して MediaCodec を使用して HDR 再生を設定します。

SurfaceView を使用して MediaCodec を設定する

SurfaceView を使用して、標準の MediaCodec 再生フローを設定します。これにより、HDR 再生用の特別な処理を行わずに HDR 動画コンテンツを表示できます。

  • MediaCodec: HDR 動画コンテンツをデコードします。
  • SurfaceView: HDR 動画コンテンツを表示します。

次のコードは、コーデックが HDR プロファイルをサポートしているかどうかを確認し、SurfaceView を使用して MediaCodec を設定します。

// 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(bitstream)
    codec.queueInputBuffer(index, offset, size, timestamp, flags)
}
codec.stop()
codec.release()

SurfaceView を使用した MediaCodec の実装について詳しくは、Android カメラのサンプルをご覧ください。

リソース

HDR 再生に関する詳細については、次のリソースをご覧ください。

HDR

メディア