ক্যামেরাএক্স আর্কিটেকচার

এই পৃষ্ঠায় CameraX-এর আর্কিটেকচার নিয়ে আলোচনা করা হয়েছে, যার মধ্যে রয়েছে এর কাঠামো, API-এর সাথে কীভাবে কাজ করতে হয়, লাইফসাইকেল নিয়ে কীভাবে কাজ করতে হয় এবং ইউজ কেসগুলোকে কীভাবে একত্রিত করতে হয়।

ক্যামেরাএক্স কাঠামো

আপনি ইউজ কেস নামক একটি অ্যাবস্ট্রাকশনের মাধ্যমে CameraX ব্যবহার করে কোনো ডিভাইসের ক্যামেরার সাথে ইন্টারফেস করতে পারেন। নিম্নলিখিত ইউজ কেসগুলো উপলব্ধ আছে:

  • প্রিভিউ : প্রিভিউ প্রদর্শনের জন্য একটি সারফেস গ্রহণ করে, যেমন একটি PreviewView
  • চিত্র বিশ্লেষণ : বিশ্লেষণের জন্য, যেমন মেশিন লার্নিংয়ের জন্য, সিপিইউ-অ্যাক্সেসযোগ্য বাফার সরবরাহ করে।
  • ছবি তোলা : একটি ছবি তুলে সংরক্ষণ করে।
  • ভিডিও ক্যাপচার : VideoCapture এর সাহায্যে ভিডিও এবং অডিও ক্যাপচার করুন।

ইউজ কেসগুলোকে একত্রিত করে একই সাথে সক্রিয় রাখা যেতে পারে। উদাহরণস্বরূপ, একটি অ্যাপ ব্যবহারকারীকে প্রিভিউ ইউজ কেসের মাধ্যমে ক্যামেরার তোলা ছবিটি দেখার সুযোগ দিতে পারে, ছবিতে থাকা ব্যক্তিরা হাসছেন কিনা তা নির্ধারণ করার জন্য একটি ইমেজ অ্যানালাইসিস ইউজ কেস রাখতে পারে, এবং তারা হাসলে ছবি তোলার জন্য একটি ইমেজ ক্যাপচার ইউজ কেস অন্তর্ভুক্ত করতে পারে।

এপিআই মডেল

লাইব্রেরিটি ব্যবহার করার জন্য, আপনাকে নিম্নলিখিত বিষয়গুলো নির্দিষ্ট করতে হবে:

  • কনফিগারেশন বিকল্পসহ কাঙ্ক্ষিত ব্যবহারের ক্ষেত্র।
  • লিসেনার সংযুক্ত করে আউটপুট ডেটা নিয়ে কী করতে হবে।
  • অ্যান্ড্রয়েড আর্কিটেকচার লাইফসাইকেল- এর সাথে ইউজ কেসটিকে সংযুক্ত করার মাধ্যমে উদ্দিষ্ট কার্যপ্রবাহ, যেমন কখন ক্যামেরা চালু করতে হবে এবং কখন ডেটা তৈরি করতে হবে, তা নির্ধারণ করা হয়।

CameraX অ্যাপ লেখার ২টি উপায় আছে: 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 এবং ImageAnalysisImageCapture বা 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 স্যাম্পল অ্যাপটি দেখুন।

ক্যামেরাএক্স লাইফসাইকেল

ক্যামেরাএক্স একটি জীবনচক্র পর্যবেক্ষণ করে নির্ধারণ করে কখন ক্যামেরা খুলতে হবে, কখন একটি ক্যাপচার সেশন তৈরি করতে হবে এবং কখন থামতে ও বন্ধ করতে হবে। ইউজ কেস এপিআইগুলো অগ্রগতি নিরীক্ষণের জন্য মেথড কল এবং কলব্যাক সরবরাহ করে।

'ইউজ কেস একত্রিত করুন' অংশে যেমন ব্যাখ্যা করা হয়েছে, আপনি কিছু ইউজ কেসের মিশ্রণকে একটি একক লাইফসাইকেলে সংযুক্ত করতে পারেন। যখন আপনার অ্যাপকে এমন ইউজ কেস সমর্থন করতে হয় যা একত্রিত করা যায় না, তখন আপনি নিম্নলিখিতগুলির মধ্যে একটি করতে পারেন:

  • সামঞ্জস্যপূর্ণ ব্যবহারের ক্ষেত্রগুলোকে একসাথে একাধিক খণ্ডে ভাগ করুন এবং তারপর খণ্ডগুলোর মধ্যে পরিবর্তন করুন।
  • একটি কাস্টম লাইফসাইকেল কম্পোনেন্ট তৈরি করুন এবং সেটি ব্যবহার করে ক্যামেরার লাইফসাইকেল ম্যানুয়ালি নিয়ন্ত্রণ করুন।

যদি আপনি আপনার ভিউ এবং ক্যামেরা ইউজ কেসগুলোর লাইফসাইকেল মালিকদের আলাদা করেন (উদাহরণস্বরূপ, যদি আপনি একটি কাস্টম লাইফসাইকেল বা একটি রিটেইন ফ্র্যাগমেন্ট ব্যবহার করেন), তাহলে আপনাকে অবশ্যই নিশ্চিত করতে হবে যে ProcessCameraProvider.unbindAll() ব্যবহার করে অথবা প্রতিটি ইউজ কেসকে আলাদাভাবে আনবাইন্ড করে CameraX থেকে সমস্ত ইউজ কেস আনবাইন্ড করা হয়েছে। বিকল্পভাবে, যখন আপনি কোনো লাইফসাইকেলে ইউজ কেস বাইন্ড করেন, তখন আপনি CameraX-কে ক্যাপচার সেশন খোলা ও বন্ধ করা এবং ইউজ কেসগুলো আনবাইন্ড করার কাজটি পরিচালনা করতে দিতে পারেন।

যদি আপনার ক্যামেরার সমস্ত কার্যকারিতা একটিমাত্র লাইফসাইকেল-সচেতন কম্পোনেন্ট, যেমন একটি AppCompatActivity বা একটি AppCompat fragment-এর লাইফসাইকেলের সাথে সামঞ্জস্যপূর্ণ হয়, তাহলে সমস্ত কাঙ্ক্ষিত ইউজ কেস বাইন্ডিং করার সময় সেই কম্পোনেন্টের লাইফসাইকেল ব্যবহার করলে এটি নিশ্চিত হবে যে, লাইফসাইকেল-সচেতন কম্পোনেন্টটি সক্রিয় থাকাকালীন ক্যামেরার কার্যকারিতা প্রস্তুত থাকবে এবং অন্যথায় কোনো রিসোর্স খরচ না করে নিরাপদে ডিসপোজ হয়ে যাবে।

কাস্টম লাইফসাইকেল মালিকদের

উন্নততর ক্ষেত্রগুলির জন্য, আপনি একটি স্ট্যান্ডার্ড অ্যান্ড্রয়েড LifecycleOwner সাথে সংযুক্ত করার পরিবর্তে একটি কাস্টম LifecycleOwner তৈরি করতে পারেন, যা আপনার অ্যাপকে CameraX সেশন লাইফসাইকেলকে সুস্পষ্টভাবে নিয়ন্ত্রণ করতে সক্ষম করবে।

নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে একটি সহজ কাস্টম LifecycleOwner তৈরি করতে হয়:

কোটলিন

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 ব্যবহার করে, আপনার অ্যাপ তার কোডের পছন্দসই স্থানে স্টেট ট্রানজিশন স্থাপন করতে পারে। আপনার অ্যাপে এই কার্যকারিতাটি বাস্তবায়ন করার বিষয়ে আরও জানতে, "একটি কাস্টম LifecycleOwner বাস্তবায়ন " দেখুন।

একই সাথে ব্যবহারের ক্ষেত্র

ইউজ কেসগুলো একই সাথে চলতে পারে। যদিও ইউজ কেসগুলোকে একটি লাইফসাইকেলের সাথে ক্রমানুসারে যুক্ত করা যায়, CameraProcessProvider.bindToLifecycle() -এ একটিমাত্র কলের মাধ্যমে সমস্ত ইউজ কেস যুক্ত করা শ্রেয়। কনফিগারেশন পরিবর্তনের সর্বোত্তম অনুশীলন সম্পর্কে আরও তথ্যের জন্য, “Handle configuration changes” দেখুন।

নিম্নলিখিত কোড নমুনায়, অ্যাপটি দুটি ইউজ কেস একই সাথে তৈরি ও চালানোর জন্য নির্দিষ্ট করে। এটি উভয় ইউজ কেসের জন্য ব্যবহারযোগ্য লাইফসাইকেলও নির্দিষ্ট করে, যাতে উভয়ই সেই লাইফসাইকেল অনুযায়ী শুরু ও বন্ধ হয়।

কোটলিন

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));
}

CameraX একই সাথে Preview , VideoCapture , ImageAnalysis এবং ImageCapture এর একটি করে ইনস্ট্যান্স ব্যবহারের সুযোগ দেয়। এছাড়াও,

  • প্রতিটি ব্যবহারের ক্ষেত্রই স্বাধীনভাবে কাজ করতে পারে। উদাহরণস্বরূপ, একটি অ্যাপ প্রিভিউ ব্যবহার না করেই ভিডিও রেকর্ড করতে পারে।
  • যখন এক্সটেনশনগুলি সক্রিয় করা হয়, তখন শুধুমাত্র ImageCapture এবং Preview সংমিশ্রণটিই কাজ করার নিশ্চয়তা দেয়। OEM বাস্তবায়নের উপর নির্ভর করে, ImageAnalysis যোগ করা সম্ভব নাও হতে পারে; VideoCapture ব্যবহারের ক্ষেত্রে এক্সটেনশনগুলি সক্রিয় করা যায় না। বিস্তারিত জানার জন্য এক্সটেনশন রেফারেন্স ডকুমেন্টটি দেখুন।
  • ক্যামেরার সক্ষমতার ওপর নির্ভর করে, কিছু ক্যামেরা কম রেজোলিউশন মোডে এই সমন্বয়টি সমর্থন করতে পারে, কিন্তু কিছু উচ্চ রেজোলিউশনে তা সমর্থন নাও করতে পারে।
  • FULL বা তার চেয়ে নিম্ন স্তরের ক্যামেরা হার্ডওয়্যারযুক্ত ডিভাইসগুলিতে, Preview , VideoCapture এবং ImageCapture বা ImageAnalysis একসাথে ব্যবহার করলে CameraX, Preview এবং VideoCapture জন্য ক্যামেরার PRIV স্ট্রিমটি ডুপ্লিকেট করতে বাধ্য হতে পারে। স্ট্রিম শেয়ারিং নামে পরিচিত এই ডুপ্লিকেশনটি এই ফিচারগুলোকে একই সাথে ব্যবহার করতে সক্ষম করে, কিন্তু এর ফলে প্রসেসিংয়ের চাহিদা বেড়ে যায়। এর ফলস্বরূপ আপনি কিছুটা বেশি ল্যাটেন্সি এবং কম ব্যাটারি লাইফ অনুভব করতে পারেন।

সমর্থিত হার্ডওয়্যার লেভেল 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 পারমিশন প্রয়োজন হবে। ফাইলগুলিতে ছবি সংরক্ষণ করার জন্য, অ্যান্ড্রয়েড ১০ বা তার পরবর্তী সংস্করণে চালিত ডিভাইসগুলি ছাড়া অন্য সব ডিভাইসে WRITE_EXTERNAL_STORAGE পারমিশনও লাগবে।

আপনার অ্যাপের জন্য অনুমতি কনফিগার করার বিষয়ে আরও তথ্যের জন্য, ‘অ্যাপের অনুমতি অনুরোধ করুন’ পড়ুন।

প্রয়োজনীয়তা

CameraX-এর জন্য নিম্নলিখিত ন্যূনতম সংস্করণ প্রয়োজন:

  • অ্যান্ড্রয়েড এপিআই লেভেল ২১
  • অ্যান্ড্রয়েড আর্কিটেকচারের উপাদানসমূহ ১.১.১

লাইফসাইকেল-সচেতন অ্যাক্টিভিটিগুলোর জন্য 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 ফাইলে নিম্নলিখিত বিষয়গুলো যোগ করুন:

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 ইমপ্লিমেন্টেশনের প্রোপার্টিগুলো পড়া এমনকি লেখার উপায় প্রদান করে। সম্পূর্ণ বিবরণের জন্য, Interop প্যাকেজটি দেখুন।

CameraX কীভাবে Camera2 প্রোপার্টিগুলো কনফিগার করেছে সে সম্পর্কে আরও তথ্যের জন্য, Camera2CameraInfo ব্যবহার করে অন্তর্নিহিত CameraCharacteristics পড়ুন। এছাড়াও আপনি নিম্নলিখিত দুটি পথের যেকোনো একটিতে অন্তর্নিহিত Camera2 প্রোপার্টিগুলো লিখতে পারেন:

  • Camera2CameraControl ব্যবহার করুন, যা আপনাকে অন্তর্নিহিত CaptureRequest উপর অটো-ফোকাস মোডের মতো প্রোপার্টি সেট করতে দেয়।

  • Camera2Interop.Extender ব্যবহার করে একটি CameraX UseCase প্রসারিত করুন। এটি আপনাকে Camera2CameraControl মতোই CaptureRequest-এর উপর প্রোপার্টি সেট করতে দেয়। এটি আপনাকে কিছু অতিরিক্ত নিয়ন্ত্রণও দেয়, যেমন আপনার ব্যবহারের পরিস্থিতির জন্য ক্যামেরাকে অপ্টিমাইজ করতে স্ট্রিম ইউজ কেস সেট করা। তথ্যের জন্য, "Use Stream Use Cases for better performance" দেখুন।

নিম্নলিখিত কোড নমুনাটি একটি ভিডিও কলের জন্য অপ্টিমাইজ করতে স্ট্রিম ইউজ কেস ব্যবহার করে। ভিডিও কল স্ট্রিম ইউজ কেসটি উপলব্ধ আছে কিনা তা জানতে 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 সম্পর্কে আরও জানতে, নিম্নলিখিত অতিরিক্ত উৎসগুলো দেখুন।

কোডল্যাব

  • CameraX দিয়ে শুরু করা
  • কোডের নমুনা

  • ক্যামেরাএক্স নমুনা অ্যাপস