CameraX, cihaz üreticilerinin çeşitli Android cihazlarda uyguladığı uzantılara erişmek için bir Extensions API sağlar. Desteklenen uzantı modlarının listesi için Kamera uzantıları başlıklı makaleyi inceleyin.
Uzantıları destekleyen cihazların listesi için Desteklenen cihazlar başlıklı makaleyi inceleyin.
Uzantı mimarisi
Aşağıdaki resimde kamera uzantıları mimarisi gösterilmektedir.
CameraX uygulamaları, CameraX Extensions API aracılığıyla uzantıları kullanabilir. CameraX Extensions API, mevcut uzantıları sorgulamayı, bir uzantı kamera oturumu yapılandırmayı ve Camera Extensions OEM kitaplığıyla iletişim kurmayı yönetir. Bu sayede uygulamanız Gece, HDR, Otomatik, Bokeh veya Yüz Rötuşu gibi özellikleri kullanabilir.
Resim Yakalama ve önizleme için bir uzantıyı etkinleştirme
Extensions API'yi kullanmadan önce ExtensionsManager#getInstanceAsync(Context, CameraProvider) yöntemini kullanarak bir ExtensionsManager örneği alın. Bu sayede uzantı kullanılabilirlik bilgilerini sorgulayabilirsiniz. Ardından, uzantısı etkinleştirilmiş bir CameraSelector alın. CameraSelector uzantısı etkinleştirilmiş şekilde bindToLifecycle() yöntemi çağrıldığında uzantı modu, Resim Yakalama ve önizleme kullanım alanlarına uygulanır.
Resim Yakalama ve önizleme kullanım alanları için uzantıyı uygulamak üzere aşağıdaki kod örneğine bakın:
// import androidx.camera.extensions.ExtensionMode // import androidx.camera.extensions.ExtensionsManager override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) val lifecycleOwner = this val cameraProviderFuture = ProcessCameraProvider.getInstance(applicationContext) cameraProviderFuture.addListener({ // Obtain an instance of a process camera provider. // The camera provider provides access to the set of cameras associated with the device. // The camera obtained from the provider will be bound to the activity lifecycle. val cameraProvider = cameraProviderFuture.get() val extensionsManagerFuture = ExtensionsManager.getInstanceAsync(applicationContext, cameraProvider) extensionsManagerFuture.addListener({ // Obtain an instance of the extensions manager. // The extensions manager enables a camera to use extension capabilities available on // the device. val extensionsManager = extensionsManagerFuture.get() // Select the camera. val cameraSelector = CameraSelector.DEFAULT_BACK_CAMERA // Query if extension is available. // Not all devices will support extensions or might only support a subset of // extensions. if (extensionsManager.isExtensionAvailable(cameraSelector, ExtensionMode.NIGHT)) { // Unbind all use cases before enabling different extension modes. try { cameraProvider.unbindAll() // Retrieve a night extension enabled camera selector. val nightCameraSelector = extensionsManager.getExtensionEnabledCameraSelector( cameraSelector, ExtensionMode.NIGHT ) // Bind image capture and preview use cases with the extension enabled camera // selector. val imageCapture = ImageCapture.Builder().build() val preview = Preview.Builder().build() // Connect the preview to receive the surface the camera outputs the frames // to. This will allow displaying the camera frames in either a TextureView // or SurfaceView. The SurfaceProvider can be obtained from the PreviewView. preview.setSurfaceProvider(surfaceProvider) // Returns an instance of the camera bound to the lifecycle. // Use this camera object to control various operations with the camera. // Example: flash, zoom, focus metering etc. val camera = cameraProvider.bindToLifecycle( lifecycleOwner, nightCameraSelector, imageCapture, preview ) } catch (e: Exception) { Log.e(TAG, "Use case binding failed", e) } } }, ContextCompat.getMainExecutor(this)) }, ContextCompat.getMainExecutor(this)) }
Uzantıyı devre dışı bırakma
Tedarikçi uzantılarını devre dışı bırakmak için tüm kullanım alanlarının bağlamasını kaldırın ve Resim Yakalama ile önizleme kullanım alanlarını normal bir kamera seçiciyle yeniden bağlayın. Örneğin, CameraSelector.DEFAULT_BACK_CAMERA kullanarak arka kameraya yeniden bağlayın.
Bağımlılıklar
CameraX Extensions API, camera-extensions kitaplığında uygulanır.
Uzantılar, CameraX temel modüllerine (core, camera2, lifecycle) bağlıdır.
Modern
dependencies { def camerax_version = "1.2.0-rc01" implementation "androidx.camera:camera-core:${camerax_version}" implementation "androidx.camera:camera-camera2:${camerax_version}" implementation "androidx.camera:camera-lifecycle:${camerax_version}" //the CameraX Extensions library implementation "androidx.camera:camera-extensions:${camerax_version}" ... }
Kotlin
dependencies { val camerax_version = "1.2.0-rc01" implementation("androidx.camera:camera-core:${camerax_version}") implementation("androidx.camera:camera-camera2:${camerax_version}") implementation("androidx.camera:camera-lifecycle:${camerax_version}") // the CameraX Extensions library implementation("androidx.camera:camera-extensions:${camerax_version}") ... }
Eski API'nin kaldırılması
1.0.0-alpha26 tarihinde yayınlanan yeni Extensions API ile birlikte, Ağustos 2019'da yayınlanan eski Extensions API'nin desteği sonlandırıldı. 1.0.0-alpha28 sürümünden itibaren eski Extensions API, kitaplıktan kaldırıldı. Yeni Extensions API'yi kullanan uygulamaların artık uzantı özellikli bir CameraSelector edinmesi ve kullanım alanlarını bağlamak için bunu kullanması gerekir.
Eski Extensions API'yi kullanan uygulamalar, gelecekteki CameraX sürümleriyle uyumluluğu sağlamak için yeni Extensions API'ye geçmelidir.
Ek kaynaklar
CameraX hakkında daha fazla bilgi edinmek için aşağıdaki ek kaynaklara göz atın.
Codelab
Kod örneği
CameraX Extensions Örnek Uygulaması
Diğer referanslar
CameraX Tedarikçi Firma Uzantıları
CameraX Tedarikçi Uzantıları Doğrulama Aracı