CameraX আর্কিটেকচার

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

CameraX স্ট্রাকচার

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

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

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

API মডেল

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

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

CameraX অ্যাপ লেখার ২টি উপায় আছে: CameraController (আপনি যদি CameraX ব্যবহার করার সবচেয়ে সহজ উপায় চান তাহলে এটি দারুণ) অথবা 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

জাভা

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

CameraProvider এখনও ব্যবহার করা সহজ, তবে অ্যাপ ডেভেলপার যেহেতু সেট-আপের আরও বেশি কিছু ম্যানেজ করেন, তাই কনফিগারেশন কাস্টমাইজ করার আরও সুযোগ থাকে, যেমন, আউটপুট ইমেজ রোটেশন চালু করা বা ImageAnalysis-এ আউটপুট ইমেজ ফর্ম্যাট সেট করা। এছাড়াও, আপনি ক্যামেরা প্রিভিউয়ের জন্য কাস্টম Surface ব্যবহার করতে পারেন যা আরও নমনীয়তার অনুমতি দেয়, যেখানে CameraController-এর সাথে আপনাকে PreviewView ব্যবহার করতে হবে। আপনার আগে থেকে থাকা Surface কোড ব্যবহার করা উপযোগী হতে পারে যদি এটি আপনার অ্যাপের অন্যান্য অংশে আগে থেকেই ইনপুট হিসেবে থাকে।

আপনি set() পদ্ধতি ব্যবহার করে ব্যবহারের কেস কনফিগার করেন এবং build() পদ্ধতির মাধ্যমে সেগুলি চূড়ান্ত করেন। প্রতিটি ব্যবহারের কেস অবজেক্ট ব্যবহারের কেস-নির্দিষ্ট API-এর একটি সেট প্রদান করে। যেমন, ইমেজ ক্যাপচার ব্যবহারের ক্ষেত্রে takePicture() মেথড কল প্রদান করে।

onResume() এবং onPause()-এ নির্দিষ্ট স্টার্ট এবং স্টপ মেথড কল করার পরিবর্তে, অ্যাপ্লিকেশনটি cameraProvider.bindToLifecycle() ব্যবহার করে ক্যামেরার সাথে যুক্ত করার জন্য একটি লাইফসাইকেল নির্দিষ্ট করে। তারপর সেই লাইফসাইকেল CameraX-কে জানায় যে কখন ক্যামেরা ক্যাপচার সেশন কনফিগার করতে হবে এবং লাইফসাইকেল ট্রানজিশনের সাথে ম্যাচ করার জন্য ক্যামেরার স্টেট যথাযথভাবে পরিবর্তন করা হয়েছে কিনা তা নিশ্চিত করে।

প্রতিটি ব্যবহারের ক্ষেত্রে প্রয়োগের ধাপগুলির জন্য, প্রিভিউ প্রয়োগ করুন, ছবি বিশ্লেষণ করুন, ছবি ক্যাপচার করুন এবং ভিডিও ক্যাপচার করুন দেখুন

প্রিভিউ ব্যবহারের কেস দেখানোর জন্য Surface-এর সাথে ইন্টার‍্যাক্ট করে। Applications create the use case with configuration options using the following code:

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())

জাভা

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 একটি লাইফসাইকেল পর্যবেক্ষণ করে। ব্যবহারের ক্ষেত্রে API, প্রগ্রেস মনিটর করার জন্য মেথড কল ও কলব্যাক প্রদান করে।

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

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

আপনি যদি ভিউ এবং ক্যামেরা ব্যবহারের কেসের লাইফসাইকেল মালিকদের ডিকাপল করেন (যেমন, আপনি যদি কাস্টম লাইফসাইকেল বা রিটেন ফ্র্যাগমেন্ট ব্যবহার করেন), তাহলে আপনাকে অবশ্যই নিশ্চিত করতে হবে যে সব ব্যবহারের কেস 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
    }
}

জাভা

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

জাভা

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 ডিভাইস কিনা:

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
}

জাভা

@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-এর জন্য নিম্নলিখিত ন্যূনতম ভার্সন প্রয়োজন:

  • Android API লেভেল ২১
  • Android আর্কিটেকচার কম্পোনেন্ট 1.1.1

লাইফসাইকেল-অ্যাওয়ার অ্যাক্টিভিটির জন্য, FragmentActivity অথবা AppCompatActivity ব্যবহার করুন।

ডিপেন্ডেন্সি ঘোষণা করা

CameraX-এ ডিপেন্ডেন্সি যোগ করতে, আপনার প্রোজেক্টে Google Maven রিপোজিটরি যোগ করতে হবে।

আপনার প্রোজেক্টের জন্য settings.gradle ফাইল খুলুন এবং নিচে দেখানো অনুযায়ী google() রিপোজিটরি যোগ করুন:

গ্ৰুভি

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}

Kotlin

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}

Android ব্লকের শেষে নিম্নলিখিত কোড যোগ করুন:

গ্ৰুভি

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 ফাইলে নিম্নলিখিতগুলি যোগ করুন:

খাঁজকাটা

dependencies {
  // CameraX core library using the camera2 implementation
  def camerax_version = "1.7.0-alpha03"
  // 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.7.0-alpha03"
    // 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 প্রপার্টি কনফিগার করেছে সেই সম্পর্কে আরও তথ্যের জন্য, Camera2CameraInfo ব্যবহার করে অন্তর্নিহিত CameraCharacteristics পড়ুন। এছাড়াও, আপনি নিম্নলিখিত দুটি উপায়ের মধ্যে একটিতে অন্তর্নিহিত Camera2 প্রপার্টি লেখার বিকল্প বেছে নিতে পারেন:

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

জাভা

// 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 ব্যবহার শুরু করা
  • কোডের স্যাম্পেল

  • CameraX স্যাম্পেল অ্যাপ