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

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

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

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

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

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

এপিআই মডেল

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

  • কনফিগারেশন বিকল্প সহ পছন্দসই ব্যবহারের কেস।
  • শ্রোতাদের সংযুক্ত করে আউটপুট ডেটা দিয়ে কী করবেন।
  • ব্যবহারের ক্ষেত্রে Android Architecture Lifecycles এর সাথে আবদ্ধ করে, উদ্দেশ্যমূলক প্রবাহ, যেমন ক্যামেরা কখন সক্ষম করতে হবে এবং কখন ডেটা তৈরি করতে হবে।

একটি 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 নমুনা অ্যাপটি দেখুন।

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

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

Combine use cases -এ ব্যাখ্যা করা হয়েছে, আপনি কিছু ব্যবহারের ক্ষেত্রের মিশ্রণকে একটি একক জীবনচক্রের সাথে আবদ্ধ করতে পারেন। যখন আপনার অ্যাপের এমন ব্যবহারের ক্ষেত্রে সমর্থন করার প্রয়োজন হয় যা একত্রিত করা যায় না, তখন আপনি নিম্নলিখিতগুলির মধ্যে একটি করতে পারেন:

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

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

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

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

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

নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে একটি সহজ কাস্টম 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() এ একটি একক কলের মাধ্যমে সমস্ত ব্যবহারের কেসগুলিকে আবদ্ধ করা ভাল। কনফিগারেশন পরিবর্তনের জন্য সর্বোত্তম অনুশীলন সম্পর্কে আরও তথ্যের জন্য, হ্যান্ডেল কনফিগারেশন পরিবর্তনগুলি দেখুন।

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

কোটলিন

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

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

আবশ্যকতা

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

  • অ্যান্ড্রয়েড এপিআই লেভেল ২১
  • অ্যান্ড্রয়েড আর্কিটেকচার কম্পোনেন্টস 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.6.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}"
}

কোটলিন

dependencies {
    // CameraX core library using the camera2 implementation
    val camerax_version = "1.6.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}")
}

এই প্রয়োজনীয়তাগুলি মেনে চলার জন্য আপনার অ্যাপটি কনফিগার করার বিষয়ে আরও তথ্যের জন্য, নির্ভরতা ঘোষণা দেখুন।

Camera2 এর সাথে CameraX এর আন্তঃকার্যক্ষমতা

CameraX তৈরি করা হয়েছে Camera2 এর উপর, এবং CameraX Camera2 বাস্তবায়নে বৈশিষ্ট্যগুলি পড়ার এবং লেখার উপায়গুলি প্রকাশ করে। সম্পূর্ণ বিবরণের জন্য, Interop প্যাকেজটি দেখুন।

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

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

কোডল্যাব

  • ক্যামেরাএক্স দিয়ে শুরু করা
  • কোড নমুনা

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