প্রিভিউ প্রয়োগ করুন

আপনার অ্যাপে প্রিভিউ যোগ করার সময়, PreviewView ব্যবহার করুন, যা হল একটি View এবং এটি সঠিকভাবে দেখানোর জন্য ক্রপ, স্কেল ও রোটেট করা যেতে পারে।

ক্যামেরা চালু হলে, PreviewView-এর মধ্যে থাকা সারফেসে ছবির প্রিভিউ স্ট্রিম হয়।

PreviewView ব্যবহার করুন

PreviewView ব্যবহার করে CameraX-এর জন্য প্রিভিউ প্রয়োগ করার মধ্যে নিম্নলিখিত ধাপগুলি অন্তর্ভুক্ত, যা পরবর্তী বিভাগে কভার করা হয়েছে:

1. ঐচ্ছিকভাবে একটি CameraXConfig.Provider কনফিগার করুন।
2. আপনার লেআউটে PreviewView যোগ করুন।
3. ProcessCameraProvider-এর অনুরোধ করুন।
4. View তৈরি করার সময়, ProcessCameraProvider চেক করুন।
5. ক্যামেরা বেছে নিয়ে লাইফসাইকেল ও ব্যবহারের উদাহরণ বাইন্ড করুন।

PreviewView ব্যবহার করার ক্ষেত্রে কিছু সীমাবদ্ধতা আছে। PreviewView ব্যবহার করার সময়, আপনি নিম্নলিখিত কোনও কাজ করতে পারবেন না:

• TextureView এবং Preview.SurfaceProvider-এ সেট করার জন্য SurfaceTexture তৈরি করুন।
• TextureView থেকে SurfaceTexture ফিরিয়ে আনুন এবং Preview.SurfaceProvider-এ সেট করুন।
• SurfaceView থেকে Surface নিন এবং Preview.SurfaceProvider-এ সেট করুন।

এর মধ্যে যেকোনও একটি ঘটলে, Preview, PreviewView-এ ফ্রেম স্ট্রিম করা বন্ধ করে দেয়।

আপনার লেআউটে PreviewView যোগ করুন

নিম্নলিখিত স্যাম্পেলটি লেআউটে PreviewView দেখায়:

<FrameLayout
    android:id="@+id/container">
        <androidx.camera.view.PreviewView
            android:id="@+id/previewView" />
</FrameLayout>

CameraProvider-এর জন্য অনুরোধ করুন

নিম্নলিখিত কোড থেকে জানতে পারবেন যে কীভাবে CameraProvider-এর জন্য অনুরোধ করতে হয়:

// import androidx.camera.lifecycle.ProcessCameraProvider
// import com.google.common.util.concurrent.ListenableFuture

class MainActivity : ComponentActivity() {
    private lateinit var cameraProviderFuture: ListenableFuture<ProcessCameraProvider>
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        cameraProviderFuture = ProcessCameraProvider.getInstance(this)
    }
}
Preview.kt

CameraProvider উপলভ্য কিনা তা চেক করুন

CameraProvider-এর অনুরোধ করার পরে, ভিউ তৈরি করার সময় সেটির ইনিশিয়ালাইজেশন সম্পূর্ণ হয়েছে কিনা তা যাচাই করুন। এটি কীভাবে করতে হয় তা নিম্নলিখিত কোড থেকে জানতে পারবেন:

cameraProviderFuture.addListener(
    Runnable {
        val cameraProvider = cameraProviderFuture.get()
        bindPreview(cameraProvider)
    },
    ContextCompat.getMainExecutor(this)
)
Preview.kt

এই স্যাম্পেলে ব্যবহার করা bindPreview ফাংশনের উদাহরণ দেখতে, পরবর্তী বিভাগে দেওয়া কোড দেখুন।

একটি ক্যামেরা বেছে নিন এবং লাইফসাইকেল ও ব্যবহারের কেস বাইন্ড করুন

আপনি CameraProvider তৈরি ও কনফার্ম করার পরে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:

1. Preview তৈরি করুন।
2. পছন্দসই ক্যামেরা LensFacing বিকল্প নির্দিষ্ট করুন।
3. বেছে নেওয়া ক্যামেরা এবং যেকোনও ব্যবহারের কেস লাইফসাইকেলের সাথে বাইন্ড করুন।
4. Preview-কে PreviewView-এর সাথে কানেক্ট করুন।

নিচের কোডে একটি উদাহরণ দেখানো হয়েছে:

fun bindPreview(cameraProvider: ProcessCameraProvider) {
    var preview: Preview = Preview.Builder()
        .build()

    var cameraSelector: CameraSelector = CameraSelector.Builder()
        .requireLensFacing(CameraSelector.LENS_FACING_BACK)
        .build()

    preview.setSurfaceProvider(previewView.getSurfaceProvider())

    var camera = cameraProvider.bindToLifecycle(this as LifecycleOwner, cameraSelector, preview)
}
Preview.kt

মনে রাখবেন যে bindToLifecycle(), Camera অবজেক্ট রিটার্ন করে। জুম ও এক্সপোজারের মতো ক্যামেরা আউটপুট নিয়ন্ত্রণ করার ব্যাপারে আরও তথ্যের জন্য, ক্যামেরা আউটপুট দেখুন।

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

PreviewView-এর জন্য অতিরিক্ত কন্ট্রোল

CameraX PreviewView কিছু অতিরিক্ত API প্রদান করে যার মাধ্যমে প্রপার্টি কনফিগার করা যায়, যেমন:

• প্রিভিউ স্ট্রিম রেন্ডার করার জন্য ইমপ্লিমেন্টেশন মোড।
• প্রিভিউ ছবির স্কেল টাইপ।

প্রয়োগের মোড

PreviewView টার্গেট View-এ প্রিভিউ স্ট্রিম রেন্ডার করার জন্য নিম্নলিখিত মোডগুলির মধ্যে একটি ব্যবহার করতে পারে:

• PERFORMANCE হল ডিফল্ট মোড। PreviewView ভিডিও স্ট্রিম দেখানোর জন্য SurfaceView ব্যবহার করে, কিন্তু কিছু ক্ষেত্রে TextureView-এ ফিরে যায়। SurfaceView-এর একটি ডেডিকেটেড ড্রয়িং সারফেস আছে, যা ইন্টার্নাল হার্ডওয়্যার কম্পোজিটর-এর মাধ্যমে হার্ডওয়্যার ওভারলে দিয়ে প্রয়োগ করার সম্ভাবনা বেশি, বিশেষ করে যখন প্রিভিউ ভিডিওর উপরে অন্য কোনও UI এলিমেন্ট (যেমন বোতাম) থাকে না। হার্ডওয়্যার ওভারলে দিয়ে রেন্ডার করার মাধ্যমে, ভিডিও ফ্রেম GPU পাথ এড়িয়ে যায়, যা প্ল্যাটফর্মের পাওয়ার খরচ ও লেটেন্সি কমাতে পারে।

• COMPATIBLE মোড। এই মোডে, PreviewView একটি TextureView ব্যবহার করে, যা SurfaceView-এর মতো নয়, এতে কোনও ডেডিকেটেড ড্রয়িং সারফেস নেই। এর ফলে, ভিডিও ব্লেন্ডিংয়ের সাথে রেন্ডার হয় যাতে এটি দেখানো যায়। এই অতিরিক্ত ধাপের সময়, অ্যাপ্লিকেশনটি অতিরিক্ত প্রসেসিং করতে পারে, যেমন কোনও বিধিনিষেধ ছাড়াই ভিডিও স্কেল ও রোটেট করা।

আপনার অ্যাপ্লিকেশনের জন্য উপযুক্ত ইমপ্লিমেন্টেশন মোড বেছে নিতে PreviewView.setImplementationMode() ব্যবহার করুন। ডিফল্ট PERFORMANCE মোড আপনার অ্যাপ্লিকেশনের জন্য উপযুক্ত না হলে, নিম্নলিখিত কোড স্যাম্পেল দেখায় যে কীভাবে COMPATIBLE মোড সেট করতে হয়:

// viewFinder is a PreviewView instance.
viewFinder.implementationMode = PreviewView.ImplementationMode.COMPATIBLE
Preview.kt

স্কেলের ধরন

প্রিভিউ ভিডিওর রেজোলিউশন আপনার টার্গেটের ডাইমেনশন থেকে আলাদা হলে PreviewView, ভিডিও কন্টেন্ট ক্রপ করে বা লেটারবক্সিং (আসল অ্যাস্পেক্ট রেশিও বজায় রেখে) করে ভিউতে ফিট করতে হবে। এই উদ্দেশ্যে PreviewView নিম্নলিখিত ScaleTypes প্রদান করে:

• লেটারবক্সিংয়ের জন্য FIT_CENTER, FIT_START, এবং FIT_END। টার্গেট PreviewView-এ দেখানো যেতে পারে এমন সর্বাধিক সম্ভাব্য সাইজে সম্পূর্ণ ভিডিও কন্টেন্ট স্কেল (কম বা বেশি) করা হয়। তবে, সম্পূর্ণ ভিডিও ফ্রেম দেখা গেলেও, স্ক্রিনের কিছু অংশ ফাঁকা থাকতে পারে। এই তিনটি স্কেলের মধ্যে আপনি যেটি বেছে নেবেন, তার উপর নির্ভর করে ভিডিও ফ্রেমটি টার্গেট ভিউয়ের কেন্দ্র, শুরু বা শেষের সাথে অ্যালাইন করা হয়।

• FILL_CENTER, FILL_START, FILL_END ব্যবহার করুন। কোনও ভিডিও PreviewView অ্যাস্পেক্ট রেশিওর সাথে ম্যাচ না করলে, কন্টেন্টের শুধুমাত্র একটি অংশ দেখা যায়, তবে ভিডিওটি সম্পূর্ণ PreviewView পূরণ করে।

CameraX-এর ব্যবহার করা ডিফল্ট স্কেল টাইপ হল FILL_CENTER। আপনার অ্যাপ্লিকেশনের জন্য সবচেয়ে উপযুক্ত স্কেলের ধরন সেট করতে PreviewView.setScaleType() ব্যবহার করুন। নিম্নলিখিত কোড স্যাম্পেল FIT_CENTER স্কেল টাইপ সেট করে:

// viewFinder is a PreviewView instance.
viewFinder.scaleType = PreviewView.ScaleType.FIT_CENTER
Preview.kt

ভিডিও দেখানোর প্রসেসে নিম্নলিখিত ধাপগুলি রয়েছে:

1. ভিডিও স্কেল করুন:
   • FIT_* স্কেল টাইপের জন্য, min(dst.width/src.width, dst.height/src.height) দিয়ে ভিডিও স্কেল করুন।
   • FILL_* স্কেল টাইপের জন্য, max(dst.width/src.width, dst.height/src.height) দিয়ে ভিডিও স্কেল করুন।
2. স্কেল করা ভিডিওটি গন্তব্য PreviewView-এর সাথে অ্যালাইন করুন:
   • FIT_CENTER/FILL_CENTER-এর জন্য, স্কেল করা ভিডিও এবং গন্তব্য PreviewView কেন্দ্রে সারিবদ্ধ করুন।
   • FIT_START/FILL_START-এর জন্য, স্কেল করা ভিডিও এবং গন্তব্য PreviewView-এর প্রতিটির উপরের-বাঁদিকের কোণ অনুযায়ী অ্যালাইন করুন।
   • FIT_END/FILL_END-এর জন্য, স্কেল করা ভিডিও এবং গন্তব্য PreviewView-এর প্রতিটির নিচের-ডানদিকের কোণ অনুযায়ী অ্যালাইন করুন।

যেমন, এখানে একটি 640x480 সোর্স ভিডিও এবং একটি 1920x1080 ডেস্টিনেশন PreviewView:

নিচের ছবিতে FIT_START / FIT_CENTER / FIT_END স্কেলিং প্রসেস দেখানো হয়েছে:

প্রসেসটি এইভাবে কাজ করে:

1. ১৪৪০x১০৮০-এর ইন্টারমিডিয়েট ভিডিও ফ্রেম পেতে min(1920/640, 1080/480) = 2.25-এর সাহায্যে ভিডিও ফ্রেম স্কেল করুন (আসল অ্যাস্পেক্ট রেশিও বজায় রেখে)।
2. ১৪৪০x১০৮০ ভিডিও ফ্রেমকে ১৯২০x১০৮০ PreviewView-এর সাথে অ্যালাইন করুন।
   • FIT_CENTER-এর জন্য, PreviewView উইন্ডোর কেন্দ্রের সাথে ভিডিও ফ্রেমটি সারিবদ্ধ করুন। PreviewView-এর শুরু ও শেষের ২৪০ পিক্সেল কলাম ফাঁকা আছে।
   • FIT_START-এর জন্য, PreviewView উইন্ডোর শুরু (উপরে-বাঁদিকের কোণ) অংশের সাথে ভিডিও ফ্রেম অ্যালাইন করুন। PreviewView-এর শেষ ৪৮০ পিক্সেল কলাম খালি আছে।
   • FIT_END-এর জন্য, PreviewView উইন্ডোর শেষের (নিচে ডানদিকের কোণ) সাথে ভিডিও ফ্রেম অ্যালাইন করুন। PreviewView-এর প্রথম ৪৮০ পিক্সেল কলাম ফাঁকা আছে।

নিচের ছবিতে FILL_START / FILL_CENTER / FILL_END স্কেলিং প্রসেস দেখানো হয়েছে:

প্রসেসটি এইভাবে কাজ করে:

1. max(1920/640, 1080/480) = 3-এর মাধ্যমে ভিডিও ফ্রেম স্কেল করে ১৯২০x১৪৪০ সাইজের ইন্টারমিডিয়েট ভিডিও ফ্রেম পান (যা PreviewView-এর সাইজের চেয়ে বড়)।
2. ১৯২০x১০৮০ PreviewView উইন্ডোতে ফিট করার জন্য ১৯২০x১৪৪০ ভিডিও ফ্রেম ক্রপ করুন।
   • FILL_CENTER-এর জন্য, ১৯২০x১৪৪০ স্কেল করা ভিডিওর কেন্দ্র থেকে ১৯২০x১০৮০ ক্রপ করুন। ভিডিওর উপরে ও নিচে ১৮০টি লাইন দেখা যায় না।
   • FILL_START-এর জন্য, ১৯২০x১৪৪০ স্কেল করা ভিডিওর শুরু থেকে ১৯২০x১০৮০ ক্রপ করুন। ভিডিওর নিচের ৩৬০টি লাইন দেখা যাচ্ছে না।
   • FILL_END-এর জন্য, ১৯২০x১৪৪০ স্কেল করা ভিডিওর শেষ থেকে ১৯২০x১০৮০ ক্রপ করুন। ভিডিওর উপরের ৩৬০টি লাইন দেখা যাচ্ছে না।

অতিরিক্ত রিসোর্স

CameraX সম্পর্কে আরও জানতে, নিম্নলিখিত অতিরিক্ত রিসোর্স দেখুন।

কোডল্যাব

CameraX ব্যবহার শুরু করা

কোডের স্যাম্পেল

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