Not: Bu sayfa, Kamera2 paketiyle ilgilidir. Uygulamanız Camera2'nin belirli, alt düzey özelliklerini gerektirmiyorsa KameraX'i kullanmanızı öneririz. Hem CameraX hem de Camera2, Android 5.0 (API düzeyi 21) ve sonraki sürümleri destekler.
Kamera2 API'leri, kameranızı kullanarak HDR video içeriğini önizlemenizi ve kaydetmenizi sağlayan Yüksek Dinamik Aralıklı (HDR) video yakalamayı destekler. Standart Dinamik Aralık (SDR) ile karşılaştırıldığında, HDR daha geniş bir renk aralığı sunar ve parlaklık bileşeninin dinamik aralığını artırır (mevcut 100 cd/m2'den 1.000 cd/m2'ye kadar). Böylece daha zengin renkler, daha parlak parlak alanlar ve daha koyu gölgelerle gerçek hayattakine daha yakın video kalitesi elde edersiniz.
HDR videonun gün batımını nasıl daha canlı bir ayrıntıyla yakaladığını görün.
![](https://developer.android.com/static/images/training/camera/camera2/sdr_comparison.png?authuser=6&hl=tr)
![](https://developer.android.com/static/images/training/camera/camera2/hdr_comparison.png?authuser=6&hl=tr)
Cihaz ön koşulları
HDR video yakalama bazı Android cihazlarda desteklenmez. Uygulamanızda HDR video çekmeden önce cihazınızın aşağıdaki ön koşulları karşılayıp karşılamadığını belirleyin:
- Android 13'ü (API düzeyi 33) hedefler.
- 10 bit veya daha yüksek yetenekli bir kamera sensörüne sahip olmalıdır. HDR Desteği hakkında daha fazla bilgi için HDR desteğini kontrol etme başlıklı makaleyi inceleyin.
Tüm cihazlar ön koşulları karşılamadığından uygulamanızda HDR video yakalamayı ayarlarken ayrı bir kod yolu ekleyebilirsiniz. Bu sayede uygulamanız uyumlu olmayan cihazlarda SDR'ye geri dönebilir. Ayrıca, SDR için bir kullanıcı arayüzü seçeneği eklemeyi de düşünebilirsiniz. Kullanıcı daha sonra video kayıt ihtiyacı için SDR ve HDR arasında geçiş yapabilir.
HDR çekim mimarisi
Aşağıdaki şemada, HDR yakalama mimarisinin ana bileşenleri gösterilmektedir.
![HDR yakalama mimarisi şeması.](https://developer.android.com/static/images/training/camera/camera2/hdr_capture_architecture_diagram.png?authuser=6&hl=tr)
Bir kamera cihazı HDR kalitesinde bir kare yakaladığında Camera2 çerçevesi, işlenen kamera sensörü çıkışını depolayan bir tampon ayırır.
HDR profilinin gerektirdiği durumlarda ilgili HDR meta verilerini de ekler.
Camera2 çerçevesi daha sonra, doldurulan arabelleği şemada gösterildiği gibi CaptureRequest
'da referans verilen çıkış yüzeyi (ör. ekran veya video kodlayıcı) için sıraya alır.
HDR desteğini kontrol edin
Uygulamanızda HDR video çekmeden önce, cihazın istediğiniz HDR profilini destekleyip desteklemediğini belirleyin.
Cihazınızın HDR özelliklerini sorgulayabileceğiniz bir CameraCharacteristics
örneği almak için CameraManager
getCameraCharacteristics()
yöntemini kullanın.
Aşağıdaki adımlar, bir cihazın HLG10'u destekleyip desteklemediğini kontrol eder. HLG10, cihaz üreticilerinin 10 bit çıkışlı kameralarda desteklemesi gereken temel HDR standardıdır.
Öncelikle, cihazın 10 bit profilleri (HLG10 için bit derinliği) destekleyip desteklemediğini kontrol edin:
Kotlin
private fun isTenBitProfileSupported(cameraId: String): Boolean { val cameraCharacteristics = cameraManager.getCameraCharacteristics(cameraId) val availableCapabilities = cameraCharacteristics.get(CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES) for (capability in availableCapabilities!!) { if (capability == CameraMetadata.REQUEST_AVAILABLE_CAPABILITIES_DYNAMIC_RANGE_TEN_BIT) { return true } } return false }
Ardından, cihazın HLG10'u (veya desteklenen başka bir profili) destekleyip desteklemediğini kontrol edin:
Kotlin
@RequiresApi(api = 33) private fun isHLGSupported(cameraId: String): Boolean { if (isTenBitProfileSupported(cameraId)) { Val cameraCharacteristics = cameraManager.getCameraCharacteristics(cameraId) val availableProfiles = cameraCharacteristics .get(CameraCharacteristics.REQUEST_AVAILABLE_DYNAMIC_RANGE_PROFILES)!! .getSupportedProfiles() // Checks for the desired profile, in this case HLG10 return availableProfiles.contains(DynamicRangeProfiles.HLG10) } return false; }
Cihaz HDR'yi destekliyorsa isHLGSupported()
her zaman true
değerini döndürür.
Daha fazla bilgi için CameraCharacteristics
referans belgelerine göz atın.
HDR yakalama ayarlayın
Cihazınızın HDR'yi desteklediğinden emin olduktan sonra, uygulamanızı kameradan ham HDR video akışı yakalayacak şekilde ayarlayın.
setDynamicRangeProfile()
kullanarak yayının OutputConfiguration
özelliğini cihaz destekli bir HDR profiliyle sağlayın. Bu profil, oluşturulduktan sonra CameraCaptureSession
etiketine aktarılır.
Desteklenen HDR profillerinin listesine bakın.
Aşağıdaki kod örneğinde setupSessionDynamicRangeProfile()
, önce cihazın Android 13'ü çalıştırıp çalıştırmadığını kontrol eder.
Ardından CameraCaptureSession
cihazını desteklenen HDR profiliyle OutputConfiguration
olarak ayarlar:
Kotlin
/** * Creates a [CameraCaptureSession] with a dynamic range profile. */ private fun setupSessionWithDynamicRangeProfile( dynamicRange: Long, device: CameraDevice, targets: List, handler: Handler? = null, stateCallback: CameraCaptureSession.StateCallback ): Boolean { if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.TIRAMISU) { val outputConfigs = mutableListOf () for (target in targets) { val outputConfig = OutputConfiguration(target) //sets the dynamic range profile, for example DynamicRangeProfiles.HLG10 outputConfig.setDynamicRangeProfile(dynamicRange) outputConfigs.add(outputConfig) } device.createCaptureSessionByOutputConfigurations( outputConfigs, stateCallback, handler) return true } else { device.createCaptureSession(targets, stateCallback, handler) return false } }
}
Kamera uygulamanız kamerayı başlattığında kaydı önizlemek için tekrarlanan bir CaptureRequest
gönderir:
Kotlin
session.setRepeatingRequest(previewRequest, null, cameraHandler)
Ayrıca video kaydını başlatmak için:
Kotlin
// Start recording repeating requests, which stops the ongoing preview // repeating requests without having to explicitly call // `session.stopRepeating` session.setRepeatingRequest(recordRequest, object : CameraCaptureSession.CaptureCallback() { override fun onCaptureCompleted(session: CameraCaptureSession, request: CaptureRequest, result: TotalCaptureResult) { if (currentlyRecording) { encoder.frameAvailable() } } }, cameraHandler)
HDR kamera akışını kodlama
HDR kamera akışını kodlamak ve dosyayı diske yazmak için MediaCodec
işlevini kullanın.
Öncelikle, ham video verilerini depolayan bir arabelleğe eşlenen OutputSurface
'ı edinin.
MediaCodec
için createInputSurface()
kullanın.
MediaCodec
uygulamasını başlatmak için uygulamanın belirli bir codec profili, renk alanı, renk aralığı ve aktarım işleviyle bir MediaFormat
oluşturması gerekir:
Kotlin
val mimeType = when { dynamicRange == DynamicRangeProfiles.STANDARD -> MediaFormat.MIMETYPE_VIDEO_AVC dynamicRange < DynamicRangeProfiles.PUBLIC_MAX -> MediaFormat.MIMETYPE_VIDEO_HEVC else -> throw IllegalArgumentException("Unknown dynamic range format") } val codecProfile = when { dynamicRange == DynamicRangeProfiles.HLG10 -> MediaCodecInfo.CodecProfileLevel.HEVCProfileMain10 dynamicRange == DynamicRangeProfiles.HDR10 -> MediaCodecInfo.CodecProfileLevel.HEVCProfileMain10HDR10 dynamicRange == DynamicRangeProfiles.HDR10_PLUS -> MediaCodecInfo.CodecProfileLevel.HEVCProfileMain10HDR10Plus else -> -1 } // Failing to correctly set color transfer causes quality issues // for example, washout and color clipping val transferFunction = when (codecProfile) { MediaCodecInfo.CodecProfileLevel.HEVCProfileMain10 -> MediaFormat.COLOR_TRANSFER_HLG MediaCodecInfo.CodecProfileLevel.HEVCProfileMain10HDR10 -> MediaFormat.COLOR_TRANSFER_ST2084 MediaCodecInfo.CodecProfileLevel.HEVCProfileMain10HDR10Plus -> MediaFormat.COLOR_TRANSFER_ST2084 else -> MediaFormat.COLOR_TRANSFER_SDR_VIDEO } val format = MediaFormat.createVideoFormat(mimeType, width, height) // Set some properties. Failing to specify some of these can cause the MediaCodec // configure() call to throw an exception. format.setInteger(MediaFormat.KEY_COLOR_FORMAT, MediaCodecInfo.CodecCapabilities.COLOR_FormatSurface) format.setInteger(MediaFormat.KEY_BIT_RATE, bitRate) format.setInteger(MediaFormat.KEY_FRAME_RATE, frameRate) format.setInteger(MediaFormat.KEY_I_FRAME_INTERVAL, IFRAME_INTERVAL) if (codecProfile != -1) { format.setInteger(MediaFormat.KEY_PROFILE, codecProfile) format.setInteger(MediaFormat.KEY_COLOR_STANDARD, MediaFormat.COLOR_STANDARD_BT2020) format.setInteger(MediaFormat.KEY_COLOR_RANGE, MediaFormat.COLOR_RANGE_LIMITED) format.setInteger(MediaFormat.KEY_COLOR_TRANSFER, transferFunction) format.setFeatureEnabled(MediaCodecInfo.CodecCapabilities.FEATURE_HdrEditing, true) } mediaCodec.configure(format, null, null, MediaCodec.CONFIGURE_FLAG_ENCODE)
Uygulama hakkında daha fazla bilgi için Camera2Video örnek uygulamasının EncoderWrapper.kt
bölümüne bakın.
HDR biçimleri
10 bit çıkış özelliklerine sahip kamera cihazları, Android 13 sürümünden itibaren HDR yakalama ve oynatma için HLG10'u desteklemelidir. Buna ek olarak cihaz üreticileri, HDR yakalama mimarisini kullanarak istedikleri HDR biçimini etkinleştirebilir.
Aşağıdaki tabloda, kullanılabilir HDR biçimleri ve HDR video yakalama özellikleri özetlenmektedir.
Biçim | Aktarım İşlevi (TF) | Meta veri | Codec | Bit Derinliği |
---|---|---|---|---|
HLG10 | HLG | Hayır | HEVC | 10 Bit |
HDR10 | PQ | Statik | HEVC | 10 Bit |
HDR10+ | PQ | Dinamik | HEVC | 10 Bit |
Dolby Vision 8.4 | HLG | Dinamik | HEVC | 10 Bit |
Kaynaklar
HDR video yakalama işlevine sahip çalışan bir uygulama için GitHub'daki Kamera2Video örneğine bakın.