इस पेज पर, CameraX के आर्किटेक्चर के बारे में बताया गया है. इसमें इसका स्ट्रक्चर, एपीआई के साथ काम करने का तरीका, लाइफ़साइकल के साथ काम करने का तरीका, और इस्तेमाल के उदाहरणों को एक साथ इस्तेमाल करने का तरीका शामिल है.
CameraX का स्ट्रक्चर
CameraX का इस्तेमाल करके, किसी डिवाइस के कैमरे से इंटरफ़ेस किया जा सकता है. इसके लिए, इस्तेमाल के उदाहरण नाम का ऐब्स्ट्रैक्शन इस्तेमाल किया जाता है. इस्तेमाल के ये उदाहरण उपलब्ध हैं:
- झलक: यह झलक दिखाने के लिए, कोई जगह स्वीकार करता है. जैसे,
PreviewView. - इमेज का विश्लेषण: यह विश्लेषण के लिए, सीपीयू से ऐक्सेस किए जा सकने वाले बफ़र उपलब्ध कराता है. जैसे, मशीन लर्निंग के लिए.
- इमेज कैप्चर करना: यह फ़ोटो कैप्चर और सेव करता है.
- वीडियो कैप्चर करना:
VideoCaptureकी मदद से वीडियो और ऑडियो कैप्चर करना
इस्तेमाल के उदाहरणों को एक साथ इस्तेमाल किया जा सकता है और ये एक साथ चालू हो सकते हैं. उदाहरण के लिए, कोई ऐप्लिकेशन, झलक के इस्तेमाल के उदाहरण का इस्तेमाल करके, उपयोगकर्ता को वह इमेज दिखा सकता है जो कैमरे में दिख रही है. साथ ही, इमेज के विश्लेषण के इस्तेमाल के उदाहरण का इस्तेमाल करके, यह पता लगाया जा सकता है कि फ़ोटो में दिख रहे लोग मुस्कुरा रहे हैं या नहीं. इसके अलावा, इमेज कैप्चर करने के इस्तेमाल के उदाहरण का इस्तेमाल करके, उनके मुस्कुराने पर फ़ोटो ली जा सकती है.
एपीआई मॉडल
लाइब्रेरी के साथ काम करने के लिए, आपको ये चीज़ें तय करनी होंगी:
- कॉन्फ़िगरेशन के विकल्पों के साथ, इस्तेमाल का वह उदाहरण जो आपको चाहिए.
- लिसनर अटैच करके, आउटपुट डेटा के साथ क्या करना है.
- इस्तेमाल का वह तरीका जो आपको चाहिए. जैसे, कैमरे कब चालू करने हैं और डेटा कब जनरेट करना है, इसके लिए, इस्तेमाल के उदाहरण को Android आर्किटेक्चर लाइफ़साइकल से बाइंड करना होगा.
CameraX ऐप्लिकेशन को दो तरीकों से लिखा जा सकता है: a
CameraController (अगर आपको CameraX का इस्तेमाल करने का सबसे आसान तरीका चाहिए, तो यह तरीका सबसे सही है) या a
CameraProvider (अगर आपको ज़्यादा फ़्लेक्सिबिलिटी चाहिए, तो यह तरीका सबसे सही है).
CameraController
CameraController, CameraX की ज़्यादातर मुख्य सुविधाओं को एक ही क्लास में उपलब्ध कराता है. इसके लिए, सेटअप कोड की ज़रूरत कम होती है. साथ ही, यह कैमरे को शुरू करने, इस्तेमाल के उदाहरणों को मैनेज करने, टारगेट रोटेशन, टैप-टू-फ़ोकस, पिंच-टू-ज़ूम वगैरह को अपने-आप हैंडल करता है. को बढ़ाने वाली कॉन्क्रीट क्लास, CameraController है
LifecycleCameraController.
Kotlin
val previewView: PreviewView = viewBinding.previewView var cameraController = LifecycleCameraController(baseContext) cameraController.bindToLifecycle(this) cameraController.cameraSelector = CameraSelector.DEFAULT_BACK_CAMERA previewView.controller = cameraController
Java
PreviewView previewView = viewBinding.previewView; LifecycleCameraController cameraController = new LifecycleCameraController(baseContext); cameraController.bindToLifecycle(this); cameraController.setCameraSelector(CameraSelector.DEFAULT_BACK_CAMERA); previewView.setController(cameraController);
CameraController के लिए डिफ़ॉल्ट UseCases, Preview, ImageCapture, और ImageAnalysis हैं. ImageCapture या ImageAnalysis को बंद करने या
VideoCapture को चालू करने के लिए,
setEnabledUseCases()
तरीके का इस्तेमाल करें.
CameraController के अन्य इस्तेमाल के बारे में जानने के लिए, क्यूआर कोड स्कैनर का सैंपल
या
CameraController की बुनियादी जानकारी वाला वीडियो देखें.
CameraProvider
CameraProvider का इस्तेमाल करना भी आसान है. हालांकि, ऐप्लिकेशन डेवलपर को सेटअप का ज़्यादा हिस्सा हैंडल करना होता है. इसलिए, कॉन्फ़िगरेशन को पसंद के मुताबिक बनाने के ज़्यादा मौके मिलते हैं. जैसे, ImageAnalysis में आउटपुट इमेज रोटेशन चालू करना या आउटपुट इमेज फ़ॉर्मैट सेट करना. कैमरे की झलक के लिए, पसंद के मुताबिक Surface का इस्तेमाल भी किया जा सकता है. इससे ज़्यादा फ़्लेक्सिबिलिटी मिलती है. वहीं, CameraController के साथ, आपको PreviewView का इस्तेमाल करना ज़रूरी है. अगर आपका मौजूदा Surface कोड, आपके ऐप्लिकेशन के अन्य हिस्सों के लिए पहले से ही इनपुट है, तो इसका इस्तेमाल करना फ़ायदेमंद हो सकता है.
इस्तेमाल के उदाहरणों को कॉन्फ़िगर करने के लिए, set() तरीकों का इस्तेमाल करें. साथ ही, इन्हें फ़ाइनल करने के लिए, build() तरीके का इस्तेमाल करें. इस्तेमाल के हर उदाहरण का ऑब्जेक्ट, इस्तेमाल के उदाहरण के हिसाब से एपीआई का सेट उपलब्ध कराता है. उदाहरण के लिए, इमेज कैप्चर करने के इस्तेमाल का उदाहरण, takePicture() तरीके का कॉल उपलब्ध कराता है.
कोई ऐप्लिकेशन,
onResume() और onPause() में, शुरू और बंद करने के लिए खास तरीकों के कॉल करने के बजाय,
कैमरे को उससे जोड़ने के लिए लाइफ़साइकल तय करता है,
cameraProvider.bindToLifecycle() का इस्तेमाल करके.
इसके बाद, वह लाइफ़साइकल, CameraX को यह जानकारी देता है कि कैमरे से कैप्चर करने के सेशन को कब कॉन्फ़िगर करना है. साथ ही, यह पक्का करता है कि लाइफ़साइकल के ट्रांज़िशन के हिसाब से, कैमरे की स्थिति में सही बदलाव हों.
इस्तेमाल के हर उदाहरण को लागू करने के चरणों के लिए, झलक लागू करना, इमेज का विश्लेषण करना, इमेज कैप्चर करना, और वीडियो कैप्चर करना लेख पढ़ें
झलक के इस्तेमाल का उदाहरण, दिखाने के लिए
Surface के साथ इंटरैक्ट करता है. ऐप्लिकेशन, कॉन्फ़िगरेशन के विकल्पों के साथ, इस्तेमाल का उदाहरण बनाने के लिए, इस कोड का इस्तेमाल करते हैं:
Kotlin
val preview = Preview.Builder().build() val viewFinder: PreviewView = findViewById(R.id.previewView) // The use case is bound to an Android Lifecycle with the following code val camera = cameraProvider.bindToLifecycle(lifecycleOwner, cameraSelector, preview) // PreviewView creates a surface provider and is the recommended provider preview.setSurfaceProvider(viewFinder.getSurfaceProvider())
Java
Preview preview = new Preview.Builder().build(); PreviewView viewFinder = findViewById(R.id.view_finder); // The use case is bound to an Android Lifecycle with the following code Camera camera = cameraProvider.bindToLifecycle(lifecycleOwner, cameraSelector, preview); // PreviewView creates a surface provider, using a Surface from a different // kind of view will require you to implement your own surface provider. preview.previewSurfaceProvider = viewFinder.getSurfaceProvider();
कोड के ज़्यादा उदाहरणों के लिए, CameraX का आधिकारिक सैंपल ऐप्लिकेशन देखें.
CameraX के लाइफ़साइकल
CameraX, लाइफ़साइकल को देखकर यह तय करता है कि कैमरा कब खोलना है, कैप्चर सेशन कब बनाना है, और कब बंद करना है. इस्तेमाल के उदाहरणों के एपीआई, प्रोसेस की निगरानी करने के लिए, तरीके के कॉल और कॉलबैक उपलब्ध कराते हैं.
इस्तेमाल के उदाहरणों को एक साथ इस्तेमाल करना लेख में बताए गए तरीके के मुताबिक, इस्तेमाल के उदाहरणों के कुछ मिक्स को एक ही लाइफ़साइकल से बाइंड किया जा सकता है. जब आपके ऐप्लिकेशन को, इस्तेमाल के उन उदाहरणों के लिए सहायता उपलब्ध करानी हो जिन्हें एक साथ इस्तेमाल नहीं किया जा सकता, तो इनमें से कोई एक काम किया जा सकता है:
- एक से ज़्यादा फ़्रैगमेंट में, एक साथ इस्तेमाल किए जा सकने वाले इस्तेमाल के उदाहरणों को ग्रुप में रखें. इसके बाद, फ़्रैगमेंट के बीच स्विच करें
- पसंद के मुताबिक लाइफ़साइकल कॉम्पोनेंट बनाएं और इसका इस्तेमाल करके, कैमरे के लाइफ़साइकल को मैन्युअल तरीके से कंट्रोल करें
अगर आपने व्यू और कैमरे के इस्तेमाल के उदाहरणों के लाइफ़साइकल के मालिकों को अलग कर दिया है (उदाहरण के लिए,
अगर आपने पसंद के मुताबिक लाइफ़साइकल या रिटेन
फ़्रैगमेंट का इस्तेमाल किया है), तो आपको
यह पक्का करना होगा कि इस्तेमाल के सभी उदाहरणों को CameraX से अनबाउंड कर दिया गया हो. इसके लिए,
ProcessCameraProvider.unbindAll()
का इस्तेमाल करें या इस्तेमाल के हर उदाहरण को अलग-अलग अनबाउंड करें. इसके अलावा, जब इस्तेमाल के उदाहरणों को किसी लाइफ़साइकल से बाइंड किया जाता है, तो CameraX को कैप्चर सेशन को खोलने और बंद करने के साथ-साथ, इस्तेमाल के उदाहरणों को अनबाउंड करने की अनुमति दी जा सकती है.
अगर कैमरे की सभी सुविधाएं, लाइफ़साइकल के बारे में जानकारी देने वाले किसी कॉम्पोनेंट के लाइफ़साइकल से जुड़ी हैं. जैसे, AppCompatActivity या AppCompat फ़्रैगमेंट, तो इस्तेमाल के सभी उदाहरणों को बाइंड करते समय, उस कॉम्पोनेंट के लाइफ़साइकल का इस्तेमाल करने से यह पक्का होगा कि लाइफ़साइकल के बारे में जानकारी देने वाला कॉम्पोनेंट चालू होने पर, कैमरे की सुविधा इस्तेमाल के लिए तैयार हो. साथ ही, बंद होने पर, सुरक्षित तरीके से बंद हो जाए और कोई संसाधन इस्तेमाल न करे.
पसंद के मुताबिक LifecycleOwners
एडवांस मामलों के लिए, पसंद के मुताबिक
LifecycleOwner बनाया जा सकता है. इससे आपका
ऐप्लिकेशन, CameraX सेशन के लाइफ़साइकल को साफ़ तौर पर कंट्रोल कर पाएगा. इसके लिए, इसे
Android के स्टैंडर्ड LifecycleOwner से बाइंड करने की ज़रूरत नहीं होगी.
यहां दिए गए कोड सैंपल में, पसंद के मुताबिक सामान्य LifecycleOwner बनाने का तरीका बताया गया है:
Kotlin
class CustomLifecycle : LifecycleOwner { private val lifecycleRegistry: LifecycleRegistry init { lifecycleRegistry = LifecycleRegistry(this); lifecycleRegistry.markState(Lifecycle.State.CREATED) } ... fun doOnResume() { lifecycleRegistry.markState(State.RESUMED) } ... override fun getLifecycle(): Lifecycle { return lifecycleRegistry } }
Java
public class CustomLifecycle implements LifecycleOwner { private LifecycleRegistry lifecycleRegistry; public CustomLifecycle() { lifecycleRegistry = new LifecycleRegistry(this); lifecycleRegistry.markState(Lifecycle.State.CREATED); } ... public void doOnResume() { lifecycleRegistry.markState(State.RESUMED); } ... public Lifecycle getLifecycle() { return lifecycleRegistry; } }
इस LifecycleOwner का इस्तेमाल करके, आपका ऐप्लिकेशन अपने कोड में, तय की गई जगहों पर स्टेट ट्रांज़िशन कर सकता है. अपने ऐप्लिकेशन में इस सुविधा को लागू करने के बारे में ज़्यादा जानने के लिए,
देखें पसंद के मुताबिक
LifecycleOwner लागू करना.
इस्तेमाल के उदाहरणों को एक साथ इस्तेमाल करना
इस्तेमाल के उदाहरणों को एक साथ चलाया जा सकता है. इस्तेमाल के उदाहरणों को किसी लाइफ़साइकल से क्रम से बाइंड किया जा सकता है. हालांकि, इस्तेमाल के सभी उदाहरणों को CameraProcessProvider.bindToLifecycle() पर एक ही कॉल से बाइंड करना बेहतर होता है. कॉन्फ़िगरेशन में बदलावों के लिए सबसे सही
तरीकों के बारे में ज़्यादा जानने के लिए, कॉन्फ़िगरेशन में बदलावों को हैंडल करना
लेख पढ़ें.
यहां दिए गए कोड सैंपल में, ऐप्लिकेशन, इस्तेमाल के उन दो उदाहरणों के बारे में बताता है जिन्हें एक साथ बनाया और चलाया जाना है. इसमें, इस्तेमाल के दोनों उदाहरणों के लिए, इस्तेमाल किए जाने वाले लाइफ़साइकल के बारे में भी बताया गया है, ताकि दोनों लाइफ़साइकल के हिसाब से शुरू और बंद हो सकें.
Kotlin
private lateinit var imageCapture: ImageCapture override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) val cameraProviderFuture = ProcessCameraProvider.getInstance(this) cameraProviderFuture.addListener(Runnable { // Camera provider is now guaranteed to be available val cameraProvider = cameraProviderFuture.get() // Set up the preview use case to display camera preview. val preview = Preview.Builder().build() // Set up the capture use case to allow users to take photos. imageCapture = ImageCapture.Builder() .setCaptureMode(ImageCapture.CAPTURE_MODE_MINIMIZE_LATENCY) .build() // Choose the camera by requiring a lens facing val cameraSelector = CameraSelector.Builder() .requireLensFacing(CameraSelector.LENS_FACING_FRONT) .build() // Attach use cases to the camera with the same lifecycle owner val camera = cameraProvider.bindToLifecycle( this as LifecycleOwner, cameraSelector, preview, imageCapture) // Connect the preview use case to the previewView preview.setSurfaceProvider( previewView.getSurfaceProvider()) }, ContextCompat.getMainExecutor(this)) }
Java
private ImageCapture imageCapture; @Override public void onCreate(@Nullable Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); PreviewView previewView = findViewById(R.id.previewView); ListenableFuture<ProcessCameraProvider> cameraProviderFuture = ProcessCameraProvider.getInstance(this); cameraProviderFuture.addListener(() -> { try { // Camera provider is now guaranteed to be available ProcessCameraProvider cameraProvider = cameraProviderFuture.get(); // Set up the view finder use case to display camera preview Preview preview = new Preview.Builder().build(); // Set up the capture use case to allow users to take photos imageCapture = new ImageCapture.Builder() .setCaptureMode(ImageCapture.CAPTURE_MODE_MINIMIZE_LATENCY) .build(); // Choose the camera by requiring a lens facing CameraSelector cameraSelector = new CameraSelector.Builder() .requireLensFacing(lensFacing) .build(); // Attach use cases to the camera with the same lifecycle owner Camera camera = cameraProvider.bindToLifecycle( ((LifecycleOwner) this), cameraSelector, preview, imageCapture); // Connect the preview use case to the previewView preview.setSurfaceProvider( previewView.getSurfaceProvider()); } catch (InterruptedException | ExecutionException e) { // Currently no exceptions thrown. cameraProviderFuture.get() // shouldn't block since the listener is being called, so no need to // handle InterruptedException. } }, ContextCompat.getMainExecutor(this)); }
CameraX, Preview, VideoCapture, ImageAnalysis, और ImageCapture के एक-एक इंस्टेंस को एक साथ इस्तेमाल करने की अनुमति देता है. इसके अलावा,
- इस्तेमाल का हर उदाहरण अपने-आप काम कर सकता है. उदाहरण के लिए, कोई ऐप्लिकेशन, झलक का इस्तेमाल किए बिना वीडियो रिकॉर्ड कर सकता है.
- एक्सटेंशन चालू होने पर,
ImageCaptureऔरPreviewके कॉम्बिनेशन के काम करने की गारंटी होती है. ओईएम के लागू करने के तरीके के आधार पर,ImageAnalysisको भी जोड़ा नहीं जा सकता.VideoCaptureके इस्तेमाल के उदाहरण के लिए, एक्सटेंशन चालू नहीं किए जा सकते. ज़्यादा जानकारी के लिए, एक्सटेंशन के रेफ़रंस वाला दस्तावेज़ देखें. - कैमरे की क्षमता के आधार पर, कुछ कैमरे कम रिज़ॉल्यूशन वाले मोड में कॉम्बिनेशन के साथ काम कर सकते हैं. हालांकि, कुछ ज़्यादा रिज़ॉल्यूशन में, वे उसी कॉम्बिनेशन के साथ काम नहीं कर सकते.
FULLया उससे कम लेवल के कैमरा हार्डवेयर वाले डिवाइसों पर,Preview,VideoCapture, औरImageCaptureयाImageAnalysisको एक साथ इस्तेमाल करने पर, CameraX कोPreviewऔरVideoCaptureके लिए, कैमरे कीPRIVस्ट्रीम को डुप्लीकेट करना पड़ सकता है. इस डुप्लीकेशन को स्ट्रीम शेयरिंग कहा जाता है. इससे इन सुविधाओं को एक साथ इस्तेमाल किया जा सकता है. हालांकि, इसके लिए ज़्यादा प्रोसेसिंग की ज़रूरत होती है. इसकी वजह से, आपको थोड़ी ज़्यादा लेटेन्सी और बैटरी लाइफ़ कम होने की समस्या आ सकती है.
सपोर्ट किए जाने वाले हार्डवेयर लेवल को Camera2CameraInfo से वापस पाया जा सकता है. उदाहरण के लिए, यहां दिए गए कोड से यह पता चलता है कि डिफ़ॉल्ट रूप से पीछे की ओर फ़ेस करने वाला कैमरा, LEVEL_3 डिवाइस है या नहीं:
Kotlin
@androidx.annotation.OptIn(ExperimentalCamera2Interop::class) fun isBackCameraLevel3Device(cameraProvider: ProcessCameraProvider) : Boolean { if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) { return CameraSelector.DEFAULT_BACK_CAMERA .filter(cameraProvider.availableCameraInfos) .firstOrNull() ?.let { Camera2CameraInfo.from(it) } ?.getCameraCharacteristic(CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL) == CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL_3 } return false }
Java
@androidx.annotation.OptIn(markerClass = ExperimentalCamera2Interop.class) Boolean isBackCameraLevel3Device(ProcessCameraProvider cameraProvider) { if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) { List\<CameraInfo\> filteredCameraInfos = CameraSelector.DEFAULT_BACK_CAMERA .filter(cameraProvider.getAvailableCameraInfos()); if (!filteredCameraInfos.isEmpty()) { return Objects.equals( Camera2CameraInfo.from(filteredCameraInfos.get(0)).getCameraCharacteristic( CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL), CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL_3); } } return false; }
अनुमतियां
आपके ऐप्लिकेशन को
CAMERA अनुमति की ज़रूरत होगी. इमेज को फ़ाइलों में सेव करने के लिए, इसे
WRITE_EXTERNAL_STORAGE
अनुमति की भी ज़रूरत होगी. हालांकि, Android 10 या उसके बाद के वर्शन पर चलने वाले डिवाइसों पर इसकी ज़रूरत नहीं होगी.
अपने ऐप्लिकेशन के लिए अनुमतियां कॉन्फ़िगर करने के बारे में ज़्यादा जानने के लिए, अनुरोध ऐप्लिकेशन की अनुमतियां लेख पढ़ें.
ज़रूरी शर्तें
CameraX के लिए, वर्शन की ये ज़रूरी शर्तें हैं:
- Android API लेवल 21
- Android आर्किटेक्चर कॉम्पोनेंट 1.1.1
लाइफ़साइकल के बारे में जानकारी देने वाली गतिविधियों के लिए, FragmentActivity या
AppCompatActivity का इस्तेमाल करें.
डिपेंडेंसी का एलान करना
CameraX पर डिपेंडेंसी जोड़ने के लिए, आपको अपने प्रोजेक्ट में Google Maven रिपॉज़िटरी जोड़नी होगी.
अपने प्रोजेक्ट के लिए settings.gradle फ़ाइल खोलें और इसमें google() रिपॉज़िटरी जोड़ें. यह रिपॉज़िटरी, यहां दिए गए तरीके से जोड़ें:
Groovy
dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } }
Kotlin
dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } }
Android ब्लॉक के आखिर में, यह कोड जोड़ें:
Groovy
android { compileOptions { sourceCompatibility JavaVersion.VERSION_1_8 targetCompatibility JavaVersion.VERSION_1_8 } // For Kotlin projects kotlinOptions { jvmTarget = "1.8" } }
Kotlin
android { compileOptions { sourceCompatibility = JavaVersion.VERSION_1_8 targetCompatibility = JavaVersion.VERSION_1_8 } // For Kotlin projects kotlinOptions { jvmTarget = "1.8" } }
किसी ऐप्लिकेशन के लिए, हर मॉड्यूल की build.gradle फ़ाइल में यह कोड जोड़ें:
Groovy
dependencies { // CameraX core library using the camera2 implementation def camerax_version = "1.7.0-alpha01" // The following line is optional, as the core library is included indirectly by camera-camera2 implementation "androidx.camera:camera-core:${camerax_version}" implementation "androidx.camera:camera-camera2:${camerax_version}" // If you want to additionally use the CameraX Lifecycle library implementation "androidx.camera:camera-lifecycle:${camerax_version}" // If you want to additionally use the CameraX VideoCapture library implementation "androidx.camera:camera-video:${camerax_version}" // If you want to additionally use the CameraX View class implementation "androidx.camera:camera-view:${camerax_version}" // If you want to additionally add CameraX ML Kit Vision Integration implementation "androidx.camera:camera-mlkit-vision:${camerax_version}" // If you want to additionally use the CameraX Extensions library implementation "androidx.camera:camera-extensions:${camerax_version}" }
Kotlin
dependencies { // CameraX core library using the camera2 implementation val camerax_version = "1.7.0-alpha01" // The following line is optional, as the core library is included indirectly by camera-camera2 implementation("androidx.camera:camera-core:${camerax_version}") implementation("androidx.camera:camera-camera2:${camerax_version}") // If you want to additionally use the CameraX Lifecycle library implementation("androidx.camera:camera-lifecycle:${camerax_version}") // If you want to additionally use the CameraX VideoCapture library implementation("androidx.camera:camera-video:${camerax_version}") // If you want to additionally use the CameraX View class implementation("androidx.camera:camera-view:${camerax_version}") // If you want to additionally add CameraX ML Kit Vision Integration implementation("androidx.camera:camera-mlkit-vision:${camerax_version}") // If you want to additionally use the CameraX Extensions library implementation("androidx.camera:camera-extensions:${camerax_version}") }
अपने ऐप्लिकेशन को इन ज़रूरी शर्तों के मुताबिक कॉन्फ़िगर करने के बारे में ज़्यादा जानने के लिए, देखें डिपेंडेंसी का एलान करना.
CameraX और Camera2 के बीच इंटरऑपरेबिलिटी
CameraX, Camera2 पर बना है. साथ ही, CameraX, Camera2 के लागू करने के तरीके में प्रॉपर्टी पढ़ने और लिखने के तरीके उपलब्ध कराता है. ज़्यादा जानकारी के लिए, इंटरऑप पैकेज देखें.
CameraX ने Camera2 की प्रॉपर्टी को कैसे कॉन्फ़िगर किया है, इस बारे में ज़्यादा जानने के लिए,
Camera2CameraInfo
का इस्तेमाल करके, CameraCharacteristicsको पढ़ें. Camera2 की प्रॉपर्टी को लिखने के लिए, इनमें से कोई एक तरीका चुना जा सकता है:
Camera2CameraControlका इस्तेमाल करें. इससे,CaptureRequestपर प्रॉपर्टी सेट की जा सकती हैं. जैसे, ऑटो-फ़ोकस मोड.CameraX के
UseCaseकोCamera2Interop.Extenderसे बढ़ाएं. इससे,Camera2CameraControlकी तरह ही, CaptureRequest पर प्रॉपर्टी सेट की जा सकती हैं. इससे, आपको कुछ अतिरिक्त कंट्रोल भी मिलते हैं. जैसे, कैमरे को अपने इस्तेमाल के हिसाब से ऑप्टिमाइज़ करने के लिए, स्ट्रीम के इस्तेमाल का उदाहरण सेट करना. ज़्यादा जानकारी के लिए, बेहतर परफ़ॉर्मेंस के लिए, स्ट्रीम के इस्तेमाल के उदाहरण इस्तेमाल करना लेख पढ़ें.
यहां दिए गए कोड सैंपल में, वीडियो कॉल के लिए ऑप्टिमाइज़ करने के लिए, स्ट्रीम के इस्तेमाल के उदाहरणों का इस्तेमाल किया गया है.
यह पता लगाने के लिए कि वीडियो कॉल स्ट्रीम के इस्तेमाल का उदाहरण उपलब्ध है या नहीं, Camera2CameraInfo
का इस्तेमाल करें. इसके बाद, स्ट्रीम के इस्तेमाल का उदाहरण सेट करने के लिए,
Camera2Interop.Extender
का इस्तेमाल करें.
Kotlin
// Set underlying Camera2 stream use case to optimize for video calls. val videoCallStreamId = CameraMetadata.SCALER_AVAILABLE_STREAM_USE_CASES_VIDEO_CALL.toLong() // Check available CameraInfos to find the first one that supports // the video call stream use case. val frontCameraInfo = cameraProvider.getAvailableCameraInfos() .first { cameraInfo -> val isVideoCallStreamingSupported = Camera2CameraInfo.from(cameraInfo) .getCameraCharacteristic( CameraCharacteristics.SCALER_AVAILABLE_STREAM_USE_CASES )?.contains(videoCallStreamId) val isFrontFacing = (cameraInfo.getLensFacing() == CameraSelector.LENS_FACING_FRONT) (isVideoCallStreamingSupported == true) && isFrontFacing } val cameraSelector = frontCameraInfo.cameraSelector // Start with a Preview Builder. val previewBuilder = Preview.Builder() .setTargetAspectRatio(screenAspectRatio) .setTargetRotation(rotation) // Use Camera2Interop.Extender to set the video call stream use case. Camera2Interop.Extender(previewBuilder).setStreamUseCase(videoCallStreamId) // Bind the Preview UseCase and the corresponding CameraSelector. val preview = previewBuilder.build() camera = cameraProvider.bindToLifecycle(this, cameraSelector, preview)
Java
// Set underlying Camera2 stream use case to optimize for video calls. Long videoCallStreamId = CameraMetadata.SCALER_AVAILABLE_STREAM_USE_CASES_VIDEO_CALL.toLong(); // Check available CameraInfos to find the first one that supports // the video call stream use case. List<CameraInfo> cameraInfos = cameraProvider.getAvailableCameraInfos(); CameraInfo frontCameraInfo = null; for (cameraInfo in cameraInfos) { Long[] availableStreamUseCases = Camera2CameraInfo.from(cameraInfo) .getCameraCharacteristic( CameraCharacteristics.SCALER_AVAILABLE_STREAM_USE_CASES ); boolean isVideoCallStreamingSupported = Arrays.List(availableStreamUseCases) .contains(videoCallStreamId); boolean isFrontFacing = (cameraInfo.getLensFacing() == CameraSelector.LENS_FACING_FRONT); if (isVideoCallStreamingSupported && isFrontFacing) { frontCameraInfo = cameraInfo; } } if (frontCameraInfo == null) { // Handle case where video call streaming is not supported. } CameraSelector cameraSelector = frontCameraInfo.getCameraSelector(); // Start with a Preview Builder. Preview.Builder previewBuilder = Preview.Builder() .setTargetAspectRatio(screenAspectRatio) .setTargetRotation(rotation); // Use Camera2Interop.Extender to set the video call stream use case. Camera2Interop.Extender(previewBuilder).setStreamUseCase(videoCallStreamId); // Bind the Preview UseCase and the corresponding CameraSelector. Preview preview = previewBuilder.build() Camera camera = cameraProvider.bindToLifecycle(this, cameraSelector, preview)
अन्य संसाधन
CameraX के बारे में ज़्यादा जानने के लिए, ये संसाधन देखें.
कोडलैब (कोड बनाना सीखना)
कोड सैंपल