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(); Listcapabilities = 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
: ถอดรหัสเนื้อหาวิดีโอ HDRSurfaceView
: แสดงเนื้อหาวิดีโอ 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
- การจับภาพวิดีโอ HDR: ดูวิธีตั้งค่าการจับภาพวิดีโอ HDR โดยใช้ Camera2 API
- ตัวอย่าง Camera2Video ใน GitHub: ดูแอปที่ใช้งานได้พร้อมฟังก์ชันการจับภาพและการเล่น HDR
สื่อ
- ข้อมูลอ้างอิงสำหรับ Media API: ดูข้อมูลเพิ่มเติมเกี่ยวกับ Media API
- ExoPlayer: ดูวิธีตั้งค่าแอปด้วยไลบรารี ExoPlayer