এই পৃষ্ঠাটি CameraX এর আর্কিটেকচার কভার করে, এর গঠন সহ, কিভাবে API এর সাথে কাজ করতে হয়, কিভাবে লাইফসাইকেলগুলির সাথে কাজ করতে হয় এবং কিভাবে ব্যবহারের ক্ষেত্রে একত্রিত করা যায়।
ক্যামেরাএক্স কাঠামো
আপনি একটি ডিভাইসের ক্যামেরার সাথে ইন্টারফেস করার জন্য ক্যামেরাএক্স ব্যবহার করতে পারেন একটি বিমূর্ততার মাধ্যমে যার নাম ব্যবহার কেস। নিম্নলিখিত ব্যবহারের ক্ষেত্রে উপলব্ধ:
- পূর্বরূপ : একটি পূর্বরূপ প্রদর্শনের জন্য একটি পৃষ্ঠকে গ্রহণ করে, যেমন একটি
PreviewView
। - চিত্র বিশ্লেষণ : বিশ্লেষণের জন্য CPU- অ্যাক্সেসযোগ্য বাফার প্রদান করে, যেমন মেশিন লার্নিংয়ের জন্য।
- ছবি ক্যাপচার : একটি ছবি ক্যাপচার করে এবং সংরক্ষণ করে।
- ভিডিও ক্যাপচার :
VideoCapture
দিয়ে ভিডিও এবং অডিও ক্যাপচার করুন
ব্যবহারের ক্ষেত্রে একত্রিত এবং সক্রিয় হতে পারে। উদাহরণ স্বরূপ, একটি অ্যাপ ব্যবহারকারীকে প্রিভিউ ইউজ কেস ব্যবহার করে ক্যামেরা যে ছবিটি দেখেছে তা দেখতে দিতে পারে, একটি ইমেজ অ্যানালাইসিস ইউজ কেস থাকতে পারে যা নির্ধারণ করে যে ছবির লোকেরা হাসছে কিনা এবং ছবি তোলার জন্য একটি ইমেজ ক্যাপচার ইউজ কেস অন্তর্ভুক্ত করে। তারা একবার.
API মডেল
লাইব্রেরির সাথে কাজ করতে, আপনি নিম্নলিখিত জিনিসগুলি নির্দিষ্ট করুন:
- কনফিগারেশন বিকল্পগুলির সাথে পছন্দসই ব্যবহারের ক্ষেত্রে।
- শ্রোতাদের সংযুক্ত করে আউটপুট ডেটা দিয়ে কী করবেন।
- উদ্দিষ্ট প্রবাহ, যেমন কখন ক্যামেরা সক্ষম করতে হবে এবং কখন ডেটা তৈরি করতে হবে, ব্যবহার কেসটিকে অ্যান্ড্রয়েড আর্কিটেকচার লাইফসাইকেলে আবদ্ধ করে।
একটি CameraX অ্যাপ লেখার 2টি উপায় রয়েছে: একটি CameraController
(আপনি যদি CameraX ব্যবহার করার সবচেয়ে সহজ উপায় চান তবে দুর্দান্ত) বা একটি CameraProvider
(আপনার আরও নমনীয়তার প্রয়োজন হলে দুর্দান্ত)।
ক্যামেরা কন্ট্রোলার
একটি CameraController
একটি একক শ্রেণীতে বেশিরভাগ CameraX মূল কার্যকারিতা প্রদান করে। এটির জন্য সামান্য সেটআপ কোডের প্রয়োজন, এবং এটি স্বয়ংক্রিয়ভাবে ক্যামেরা শুরু, কেস ম্যানেজমেন্ট ব্যবহার, লক্ষ্য ঘূর্ণন, ট্যাপ-টু-ফোকাস, পিঞ্চ-টু-জুম এবং আরও অনেক কিছু পরিচালনা করে। কংক্রিট ক্লাস যা CameraController
প্রসারিত করে তা হল LifecycleCameraController
।
কোটলিন
val previewView: PreviewView = viewBinding.previewView var cameraController = LifecycleCameraController(baseContext) cameraController.bindToLifecycle(this) cameraController.cameraSelector = CameraSelector.DEFAULT_BACK_CAMERA previewView.controller = cameraController
জাভা
PreviewView previewView = viewBinding.previewView; LifecycleCameraController cameraController = new LifecycleCameraController(baseContext); cameraController.bindToLifecycle(this); cameraController.setCameraSelector(CameraSelector.DEFAULT_BACK_CAMERA); previewView.setController(cameraController);
CameraController
জন্য ডিফল্ট UseCase
হল Preview
, ImageCapture
এবং ImageAnalysis
। ImageCapture
বা ImageAnalysis
বন্ধ করতে, অথবা VideoCapture
চালু করতে, setEnabledUseCases()
পদ্ধতি ব্যবহার করুন।
CameraController
এর আরও ব্যবহারের জন্য, QR কোড স্ক্যানার নমুনা বা CameraController
বেসিক ভিডিও দেখুন।
ক্যামেরা প্রদানকারী
একটি CameraProvider
এখনও ব্যবহার করা সহজ, কিন্তু যেহেতু অ্যাপ ডেভেলপার বেশি সেটআপ পরিচালনা করে, তাই কনফিগারেশন কাস্টমাইজ করার আরও সুযোগ রয়েছে, যেমন আউটপুট ইমেজ রোটেশন সক্ষম করা বা ImageAnalysis
এ আউটপুট ইমেজ ফরম্যাট সেট করা। আপনি ক্যামেরা প্রিভিউয়ের জন্য একটি কাস্টম Surface
ব্যবহার করতে পারেন যা আরও নমনীয়তার জন্য অনুমতি দেয়, যেখানে CameraController এর সাথে আপনাকে একটি PreviewView
ব্যবহার করতে হবে। আপনার বিদ্যমান Surface
কোড ব্যবহার করা উপকারী হতে পারে যদি এটি ইতিমধ্যে আপনার অ্যাপের অন্যান্য অংশে একটি ইনপুট হয়।
আপনি set()
পদ্ধতি ব্যবহার করে ব্যবহারের কেস কনফিগার করেন এবং build()
পদ্ধতির মাধ্যমে তাদের চূড়ান্ত করেন। প্রতিটি ব্যবহার কেস অবজেক্ট ব্যবহার কেস-নির্দিষ্ট API এর একটি সেট প্রদান করে। উদাহরণস্বরূপ, চিত্র ক্যাপচার ব্যবহারের ক্ষেত্রে একটি takePicture()
পদ্ধতি কল প্রদান করে।
onResume()
এবং onPause()
-এ একটি নির্দিষ্ট স্টার্ট এবং স্টপ পদ্ধতি কল করার পরিবর্তে অ্যাপ্লিকেশনটি cameraProvider.bindToLifecycle()
ব্যবহার করে ক্যামেরাটিকে সংযুক্ত করার জন্য একটি জীবনচক্র নির্দিষ্ট করে। সেই লাইফসাইকেল ক্যামেরা ক্যাপচার সেশনটি কখন কনফিগার করতে হবে তা CameraX-কে জানায় এবং লাইফসাইকেল ট্রানজিশনের সাথে সামঞ্জস্যপূর্ণভাবে ক্যামেরার অবস্থার পরিবর্তন নিশ্চিত করে।
প্রতিটি ব্যবহারের ক্ষেত্রে বাস্তবায়নের পদক্ষেপের জন্য, একটি পূর্বরূপ প্রয়োগ করুন , চিত্র বিশ্লেষণ করুন , চিত্র ক্যাপচার এবং ভিডিও ক্যাপচার দেখুন
পূর্বরূপ ব্যবহারের ক্ষেত্রে প্রদর্শনের জন্য একটি Surface
সাথে ইন্টারঅ্যাক্ট করে। অ্যাপ্লিকেশনগুলি নিম্নলিখিত কোড ব্যবহার করে কনফিগারেশন বিকল্পগুলির সাথে ব্যবহারের ক্ষেত্রে তৈরি করে:
কোটলিন
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())
জাভা
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 একটি জীবনচক্র পর্যবেক্ষণ করে। কেস API ব্যবহার করুন প্রগতি নিরীক্ষণ করতে পদ্ধতি কল এবং কলব্যাক প্রদান করে।
একত্রিত ব্যবহারের ক্ষেত্রে যেমন ব্যাখ্যা করা হয়েছে, আপনি একটি একক জীবনচক্রে ব্যবহারের ক্ষেত্রে কিছু মিশ্রণকে আবদ্ধ করতে পারেন। যখন আপনার অ্যাপ্লিকেশানের ব্যবহারের ক্ষেত্রে সমর্থন করার প্রয়োজন হয় যা একত্রিত করা যায় না, আপনি নিম্নলিখিতগুলির মধ্যে একটি করতে পারেন:
- সামঞ্জস্যপূর্ণ ব্যবহারের কেসগুলিকে একসাথে একাধিক খণ্ডে ভাগ করুন এবং তারপরে খণ্ডগুলির মধ্যে স্যুইচ করুন৷
- একটি কাস্টম লাইফসাইকেল কম্পোনেন্ট তৈরি করুন এবং ক্যামেরা লাইফসাইকেল নিয়ন্ত্রণ করতে এটি ব্যবহার করুন
আপনি যদি আপনার ভিউ এবং ক্যামেরা ব্যবহারের কেসগুলির লাইফসাইকেল মালিকদের দ্বিগুণ করেন (উদাহরণস্বরূপ, আপনি যদি একটি কাস্টম লাইফসাইকেল ব্যবহার করেন বা একটি রিটেন ফ্র্যাগমেন্ট ব্যবহার করেন), তাহলে আপনাকে অবশ্যই নিশ্চিত করতে হবে যে সমস্ত ব্যবহারের কেস ProcessCameraProvider.unbindAll()
ব্যবহার করে ক্যামেরাএক্স থেকে আনবাউন্ড বা আনবাইন্ডিং করে প্রতিটি ব্যবহারের ক্ষেত্রে পৃথকভাবে। বিকল্পভাবে, যখন আপনি একটি লাইফসাইকেলের সাথে ব্যবহারের কেসগুলি আবদ্ধ করেন, তখন আপনি CameraX কে ক্যাপচার সেশন খোলা এবং বন্ধ করার এবং ব্যবহারের ক্ষেত্রেগুলি আনবাইন্ডিং পরিচালনা করতে দিতে পারেন৷
যদি আপনার সমস্ত ক্যামেরা কার্যকারিতা একটি একক লাইফসাইকেল-সচেতন উপাদান যেমন একটি AppCompatActivity
বা একটি AppCompat
খণ্ডের জীবনচক্রের সাথে সামঞ্জস্যপূর্ণ হয়, তবে সমস্ত পছন্দসই ব্যবহারের ক্ষেত্রে বাঁধাই করার সময় সেই উপাদানটির জীবনচক্র ব্যবহার করা নিশ্চিত করবে যে ক্যামেরা কার্যকারিতা প্রস্তুত যখন জীবনচক্র-সচেতন উপাদান সক্রিয়, এবং নিরাপদে নিষ্পত্তি করা হয়, অন্যথায় কোন সম্পদ গ্রাস করে না।
কাস্টম লাইফসাইকেল মালিক
উন্নত ক্ষেত্রে, আপনি একটি কাস্টম LifecycleOwner
তৈরি করতে পারেন যাতে আপনার অ্যাপটিকে একটি আদর্শ Android LifecycleOwner
সাথে সংযুক্ত করার পরিবর্তে CameraX সেশন লাইফসাইকেলকে স্পষ্টভাবে নিয়ন্ত্রণ করতে সক্ষম করে৷
নিম্নলিখিত কোড নমুনা দেখায় কিভাবে একটি সাধারণ কাস্টম লাইফসাইকেল মালিক তৈরি করতে হয়:
কোটলিন
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 } }
জাভা
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
ব্যবহার করে, আপনার অ্যাপ তার কোডের পছন্দসই পয়েন্টে স্টেট ট্রানজিশন রাখতে পারে। আপনার অ্যাপে এই কার্যকারিতা বাস্তবায়নের বিষয়ে আরও জানতে, একটি কাস্টম লাইফসাইকেল মালিকের বাস্তবায়ন দেখুন।
সমসাময়িক ব্যবহারের ক্ষেত্রে
ব্যবহারের ক্ষেত্রে একযোগে চলতে পারে। যদিও ব্যবহারের ক্ষেত্রে ক্রমানুসারে একটি জীবনচক্রের সাথে আবদ্ধ হতে পারে, CameraProcessProvider.bindToLifecycle()
এ একক কল দিয়ে সমস্ত ব্যবহারের ক্ষেত্রে আবদ্ধ করা ভাল। কনফিগারেশন পরিবর্তনের জন্য সর্বোত্তম অনুশীলন সম্পর্কে আরও তথ্যের জন্য, কনফিগারেশন পরিবর্তনগুলি পরিচালনা করুন দেখুন।
নিম্নলিখিত কোড নমুনায়, অ্যাপটি একই সাথে তৈরি এবং চালানোর জন্য দুটি ব্যবহারের ক্ষেত্রে উল্লেখ করে। এটি উভয় ব্যবহারের ক্ষেত্রে ব্যবহার করার জন্য জীবনচক্রও নির্দিষ্ট করে, যাতে তারা উভয়ই জীবনচক্র অনুযায়ী শুরু এবং বন্ধ করে।
কোটলিন
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)) }
জাভা
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)); }
নিম্নলিখিত কনফিগারেশন সংমিশ্রণগুলি সমর্থিত হওয়ার গ্যারান্টিযুক্ত (যখন পূর্বরূপ বা ভিডিও ক্যাপচার প্রয়োজন, কিন্তু একই সময়ে উভয় নয়):
প্রিভিউ বা ভিডিও ক্যাপচার | ইমেজ ক্যাপচার | বিশ্লেষণ | বর্ণনা |
---|---|---|---|
ব্যবহারকারীকে একটি পূর্বরূপ প্রদান করুন বা ভিডিও রেকর্ড করুন, একটি ছবি তুলুন এবং চিত্র স্ট্রীম বিশ্লেষণ করুন৷ | |||
একটি ছবি তুলুন, এবং চিত্র স্ট্রিম বিশ্লেষণ করুন. | |||
ব্যবহারকারীকে একটি পূর্বরূপ প্রদান করুন বা ভিডিও রেকর্ড করুন এবং একটি ছবি তুলুন। | |||
ব্যবহারকারীকে একটি পূর্বরূপ প্রদান করুন বা ভিডিও রেকর্ড করুন এবং চিত্র স্ট্রীম বিশ্লেষণ করুন। |
যখন প্রিভিউ এবং ভিডিও ক্যাপচার উভয়েরই প্রয়োজন হয়, তখন নিম্নলিখিত ব্যবহারের কেস কম্বিনেশন শর্তসাপেক্ষে সমর্থিত:
পূর্বরূপ | ভিডিও ক্যাপচার | ইমেজ ক্যাপচার | বিশ্লেষণ | বিশেষ প্রয়োজন |
---|---|---|---|---|
সব ক্যামেরার জন্য গ্যারান্টিযুক্ত | ||||
সীমিত (বা ভাল) ক্যামেরা ডিভাইস। | ||||
LEVEL_3 (বা ভাল) ক্যামেরা ডিভাইস। |
উপরন্তু,
- প্রতিটি ব্যবহারের ক্ষেত্রে তার নিজের উপর কাজ করতে পারেন. উদাহরণস্বরূপ, একটি অ্যাপ প্রিভিউ ব্যবহার না করেই ভিডিও রেকর্ড করতে পারে।
- যখন এক্সটেনশানগুলি সক্রিয় করা হয়, শুধুমাত্র
ImageCapture
এবংPreview
সংমিশ্রণ কাজ করার গ্যারান্টিযুক্ত। OEM বাস্তবায়নের উপর নির্ভর করে,ImageAnalysis
যোগ করা সম্ভব নাও হতে পারে;VideoCapture
ব্যবহারের ক্ষেত্রে এক্সটেনশানগুলি সক্ষম করা যাবে না৷ বিস্তারিত জানার জন্য এক্সটেনশন রেফারেন্স ডক চেক করুন. - ক্যামেরার ক্ষমতার উপর নির্ভর করে, কিছু ক্যামেরা নিম্ন রেজোলিউশন মোডে সমন্বয় সমর্থন করতে পারে, কিন্তু কিছু উচ্চতর রেজোলিউশনে একই সংমিশ্রণ সমর্থন করতে পারে না।
সমর্থিত হার্ডওয়্যার স্তর Camera2CameraInfo
থেকে পুনরুদ্ধার করা যেতে পারে। উদাহরণস্বরূপ, নিচের কোডটি পরীক্ষা করে যে ডিফল্ট ব্যাক ফেসিং ক্যামেরাটি একটি LEVEL_3
ডিভাইস কিনা:
কোটলিন
@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 }
জাভা
@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
অনুমতির প্রয়োজন হবে। ফাইলগুলিতে ছবিগুলি সংরক্ষণ করতে, Android 10 বা তার পরে চলমান ডিভাইসগুলি ব্যতীত WRITE_EXTERNAL_STORAGE
অনুমতিরও প্রয়োজন হবে৷
আপনার অ্যাপের জন্য অনুমতি কনফিগার করার বিষয়ে আরও তথ্যের জন্য, অ্যাপের অনুমতির অনুরোধ পড়ুন।
প্রয়োজনীয়তা
CameraX এর নিম্নলিখিত ন্যূনতম সংস্করণের প্রয়োজনীয়তা রয়েছে:
- অ্যান্ড্রয়েড এপিআই লেভেল 21
- অ্যান্ড্রয়েড আর্কিটেকচার উপাদান 1.1.1
জীবনচক্র-সচেতন কার্যকলাপের জন্য, FragmentActivity
বা AppCompatActivity
ব্যবহার করুন।
নির্ভরতা ঘোষণা করুন
CameraX এর উপর নির্ভরতা যোগ করতে, আপনাকে অবশ্যই আপনার প্রকল্পে Google Maven সংগ্রহস্থল যোগ করতে হবে।
আপনার প্রকল্পের জন্য settings.gradle
ফাইলটি খুলুন এবং নিম্নলিখিত হিসাবে দেখানো google()
সংগ্রহস্থল যোগ করুন:
গ্রোভি
dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } }
কোটলিন
dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } }
অ্যান্ড্রয়েড ব্লকের শেষে নিম্নলিখিত যোগ করুন:
গ্রোভি
android { compileOptions { sourceCompatibility JavaVersion.VERSION_1_8 targetCompatibility JavaVersion.VERSION_1_8 } // For Kotlin projects kotlinOptions { jvmTarget = "1.8" } }
কোটলিন
android { compileOptions { sourceCompatibility = JavaVersion.VERSION_1_8 targetCompatibility = JavaVersion.VERSION_1_8 } // For Kotlin projects kotlinOptions { jvmTarget = "1.8" } }
একটি অ্যাপের জন্য প্রতিটি মডিউলের build.gradle
ফাইলে নিম্নলিখিত যোগ করুন:
গ্রোভি
dependencies { // CameraX core library using the camera2 implementation def camerax_version = "1.4.0-rc01" // 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}" }
কোটলিন
dependencies { // CameraX core library using the camera2 implementation val camerax_version = "1.4.0-rc01" // 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}") }
এই প্রয়োজনীয়তাগুলি মেনে চলার জন্য আপনার অ্যাপ কনফিগার করার বিষয়ে আরও তথ্যের জন্য, নির্ভরতা ঘোষণা করা দেখুন।
Camera2 এর সাথে CameraX ইন্টারঅপারেবিলিটি
CameraX Camera2 এর উপর নির্মিত, এবং CameraX Camera2 বাস্তবায়নে বৈশিষ্ট্যগুলি পড়ার এবং লেখার উপায়গুলি প্রকাশ করে৷ সম্পূর্ণ বিবরণের জন্য, ইন্টারপ প্যাকেজ দেখুন।
CameraX কীভাবে Camera2 বৈশিষ্ট্যগুলি কনফিগার করেছে সে সম্পর্কে আরও তথ্যের জন্য, অন্তর্নিহিত CameraCharacteristics
পড়তে Camera2CameraInfo
ব্যবহার করুন৷ আপনি নিম্নলিখিত দুটি পথের মধ্যে একটিতে অন্তর্নিহিত Camera2 বৈশিষ্ট্যগুলি লিখতেও চয়ন করতে পারেন:
Camera2CameraControl
ব্যবহার করুন, যা আপনাকে অটো-ফোকাস মোডের মতো অন্তর্নিহিতCaptureRequest
এ বৈশিষ্ট্য সেট করতে দেয়।একটি
Camera2Interop.Extender
দিয়ে একটি CameraXUseCase
প্রসারিত করুন। এটি আপনাকেCamera2CameraControl
এর মতই CaptureRequest-এ বৈশিষ্ট্য সেট করতে দেয়। এটি আপনাকে কিছু অতিরিক্ত নিয়ন্ত্রণও দেয়, যেমন আপনার ব্যবহারের দৃশ্যের জন্য ক্যামেরা অপ্টিমাইজ করতে স্ট্রিম ব্যবহারের ক্ষেত্রে সেট করা। তথ্যের জন্য, আরও ভালো পারফরম্যান্সের জন্য স্ট্রীম ব্যবহারের ক্ষেত্রে দেখুন।
নিম্নলিখিত কোড নমুনা একটি ভিডিও কলের জন্য অপ্টিমাইজ করতে স্ট্রিম ব্যবহারের ক্ষেত্রে ব্যবহার করে৷ ভিডিও কল স্ট্রিম ব্যবহারের কেস উপলব্ধ কিনা তা আনতে Camera2CameraInfo
ব্যবহার করুন৷ তারপর, অন্তর্নিহিত স্ট্রীম ব্যবহারের ক্ষেত্রে সেট করতে একটি Camera2Interop.Extender
ব্যবহার করুন৷
কোটলিন
// 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)
জাভা
// 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 সম্পর্কে আরও জানতে, নিম্নলিখিত অতিরিক্ত সংস্থানগুলি দেখুন৷