การเล่นวิดีโอ HDR

HDR หรือ High Dynamic Range ให้สีที่หลากหลายขึ้นและคอนทราสต์มากขึ้นระหว่างสีขาวที่สว่างที่สุดกับเงาที่มืดที่สุด ส่งผลให้วิดีโอมีคุณภาพใกล้เคียงกับสิ่งที่ตาเปล่ามองเห็นมากขึ้น

คุณสามารถตั้งค่าการเล่นวิดีโอ HDR ในแอปเพื่อแสดงตัวอย่างและเล่นเนื้อหาวิดีโอ HDR

บทความนี้ถือว่าคุณได้เพิ่มการรองรับการเล่นวิดีโอขั้นพื้นฐานลงในแอปแล้ว ดูรายละเอียดเพิ่มเติมเกี่ยวกับการเล่นได้ที่เอกสารประกอบของ ExoPlayer

ข้อกําหนดเบื้องต้นของอุปกรณ์

อุปกรณ์ Android บางรุ่นไม่รองรับการเล่น HDR ก่อนเล่นเนื้อหาวิดีโอ HDR ในแอป ให้ตรวจสอบว่าอุปกรณ์ของคุณมีคุณสมบัติตรงตามข้อกําหนดเบื้องต้นต่อไปนี้หรือไม่

  • กำหนดเป้าหมายเป็น Android 7.0 ขึ้นไป (เลเยอร์ API 24)
  • มีโปรแกรมถอดรหัสที่รองรับ HDR และเข้าถึงจอแสดงผลที่รองรับ HDR ได้

ตรวจสอบการรองรับการเล่น HDR

ใช้ Display.getHdrCapabilities() เพื่อค้นหาความสามารถ HDR ของจอแสดงผล โดยเมธอดนี้จะแสดงข้อมูลเกี่ยวกับโปรไฟล์ HDR และช่วงความสว่างที่รองรับสำหรับจอแสดงผล

รหัสต่อไปนี้จะตรวจสอบว่าอุปกรณ์รองรับการเล่น HLG10 หรือไม่ ตั้งแต่ Android 13 เป็นต้นไป HLG10 จะเป็นมาตรฐานขั้นต่ำที่ผู้ผลิตอุปกรณ์ต้องรองรับหากอุปกรณ์เล่น 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");
}

ตั้งค่าการเล่น HDR ในแอป

หากแอปใช้ ExoPlayer ก็จะรองรับการเล่น HDR โดยค่าเริ่มต้น ดูขั้นตอนถัดไปที่หัวข้อตรวจสอบการรองรับการเล่น HDR

หากแอปไม่ได้ใช้ ExoPlayer ให้ตั้งค่าการเล่น HDR โดยใช้ MediaCodec ผ่าน SurfaceView

ตั้งค่า MediaCodec โดยใช้ SurfaceView

ตั้งค่าขั้นตอนการเล่น MediaCodec มาตรฐานโดยใช้ SurfaceView ซึ่งจะช่วยให้คุณแสดงเนื้อหาวิดีโอ HDR ได้โดยไม่ต้องมีการจัดการพิเศษสำหรับการเล่น HDR

  • MediaCodec: ถอดรหัสเนื้อหาวิดีโอ HDR
  • SurfaceView: แสดงเนื้อหาวิดีโอ HDR

โค้ดต่อไปนี้จะตรวจสอบว่าตัวแปลงรหัสรองรับโปรไฟล์ HDR หรือไม่ จากนั้นตั้งค่า MediaCodec โดยใช้ 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();

ดูการใช้งาน MediaCodec เพิ่มเติมโดยใช้ SurfaceView ได้ที่ตัวอย่างกล้อง Android

แหล่งข้อมูล

ดูข้อมูลเพิ่มเติมเกี่ยวกับการเล่น HDR ได้ที่แหล่งข้อมูลต่อไปนี้

HDR

สื่อ