ক্যামেরা এক্সটেনশন যাচাইকরণ টুল

ক্যামেরা এক্সটেনশন যাচাইকরণ টুলটি ডিভাইস প্রস্তুতকারকদের ক্যামেরা এক্সটেনশন OEM ভেন্ডর লাইব্রেরিটি সঠিকভাবে প্রয়োগ করা হয়েছে কিনা তা যাচাই করার সুযোগ দেয়। টুলটিতে স্বয়ংক্রিয় এবং ম্যানুয়াল যাচাইকরণ পরীক্ষা অন্তর্ভুক্ত রয়েছে।

• স্বয়ংক্রিয় যাচাইকরণ পরীক্ষা: ভেন্ডর লাইব্রেরি ইন্টারফেসটি সঠিকভাবে প্রয়োগ করা হয়েছে কিনা তা যাচাই করে। উদাহরণস্বরূপ, যদি ছবি তোলার জন্য CaptureProcessor প্রয়োজন হয়, তবে এই পরীক্ষাগুলো যাচাই করে যে ImageCaptureExtenderImpl#getCaptureStages() ছবি তোলার জন্য প্রয়োজনীয় CaptureStage ইনস্ট্যান্সগুলো ফেরত দিচ্ছে কিনা।

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

ভ্যালিডেশন টুলের সোর্স কোডটি অ্যান্ড্রয়েড জেটপ্যাক রিপোজিটরিতে থাকা এক্সটেনশন টেস্ট অ্যাপের একটি অংশ।

ক্যামেরা এক্সটেনশন যাচাইকরণ টুলটি তৈরি করুন

এক্সটেনশন যাচাইকরণ টুলটি তৈরি করতে, এই ধাপগুলো অনুসরণ করুন:

1. অ্যান্ড্রয়েড জেটপ্যাক লাইব্রেরির সোর্স কোড ডাউনলোড করুন। বিস্তারিত জানতে, অ্যান্ড্রয়েড জেটপ্যাক README- এর "কোড চেক আউট করা" অংশটি দেখুন।

2. extensionstestapp APK-টি বিল্ড করুন। এর মাধ্যমে ম্যানুয়াল ভ্যালিডেশন টেস্ট চালানো যাবে।

     cd path/to/checkout/frameworks/support/
     ./gradlew camera:integration-tests:camera-testapp-extensions:assembleDebug

   APK ফাইলটি নিম্নলিখিত পাথে আউটপুট করা হয়:

     path/to/checkout/out/androidx/camera/integration-tests/camera-testapp-extensions/build/outputs/apk/debug/camera-testapp-extensions-debug.apk
   

3. androidTest APK-টি বিল্ড করুন। এই APK-টি স্বয়ংক্রিয় ভ্যালিডেশন টেস্ট চালানোর সুযোগ দেয়।

     cd path/to/checkout/frameworks/support/
     ./gradlew camera:integration-tests:camera-testapp-extensions:assembleAndroidTest

   APK ফাইলটি নিম্নলিখিত পাথে আউটপুট করা হয়:

     path/to/checkout/out/androidx/camera/integration-tests/camera-testapp-extensions/build/outputs/apk/androidTest/debug/camera-testapp-extensions-debug-androidTest.apk
   

স্বয়ংক্রিয় যাচাইকরণ পরীক্ষা চালান

স্বয়ংক্রিয় যাচাইকরণ পরীক্ষাগুলো চালানোর জন্য extensionstestapp এবং androidTest APK-গুলো ইনস্টল করুন।

• extensionstestapp এপিকে

    adb install -r path/to/checkout/out/androidx/camera/integration-tests/camera-testapp-extensions/build/outputs/apk/debug/camera-testapp-extensions-debug.apk

• androidTest এপিকে

    adb install -r path/to/checkout/out/androidx/camera/integration-tests/camera-testapp-extensions/build/outputs/apk/androidTest/debug/camera-testapp-extensions-debug-androidTest.apk

সমস্ত স্বয়ংক্রিয় পরীক্ষা চালান

APK-গুলো ইনস্টল করার পর, ভেন্ডর লাইব্রেরির বাস্তবায়ন যাচাই করার জন্য সমস্ত স্বয়ংক্রিয় পরীক্ষা চালাতে, নিম্নলিখিত কমান্ডটি চালান:

adb shell am instrument -w -r androidx.camera.integration.extensions.test/androidx.test.runner.AndroidJUnitRunner

সব পরীক্ষা সফল হলে, একটি OK ফলাফল দেখানো হয়। অন্যথায়, সমস্ত পরীক্ষা সম্পন্ন হওয়ার পর চূড়ান্ত পরীক্ষার প্রতিবেদনে টার্মিনালে ব্যর্থতাগুলো দেখানো হয়।

চিত্র ১. স্বয়ংক্রিয় পরীক্ষার ফলাফল সন্তোষজনক।

চিত্র ২. স্বয়ংক্রিয় পরীক্ষার ব্যর্থতাসহ ফলাফল

একটি নির্দিষ্ট ক্লাসের স্বয়ংক্রিয় পরীক্ষা চালান

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

adb shell am instrument -w -r -e class **androidx.camera.integration.extensions.ImageCaptureTest** androidx.camera.integration.extensions.test/androidx.test.runner.AndroidJUnitRunner

ম্যানুয়াল যাচাইকরণ পরীক্ষা চালান

ম্যানুয়াল ভ্যালিডেশন টেস্টগুলো এক্সটেনশন টেস্ট অ্যাপে পাওয়া যায়। এক্সটেনশন টেস্ট অ্যাপটি ইনস্টল ও চালু করার পর, উপরের ডানদিকের মেনু আইটেমটিতে ট্যাপ করে ভ্যালিডেশন টুল মোডে যান।

ভ্যালিডেশন টুল মোডে স্যুইচ করার পর, প্রথম পৃষ্ঠায় সেই সমস্ত ক্যামেরার তালিকা দেখানো হয় যেগুলিতে REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE ক্যাপাবিলিটি রয়েছে। যদি কোনো ক্যামেরা কোনো এক্সটেনশন মোড সমর্থন না করে, তাহলে তালিকার সংশ্লিষ্ট আইটেমটি ধূসর রঙের হয়।

চিত্র ৩. যাচাইকরণ টুল মোড

পরীক্ষার জন্য এক্সটেনশন মোডগুলো দেখতে ক্যামেরাগুলোর একটিতে ট্যাপ করুন। নির্বাচিত ক্যামেরা দ্বারা সমর্থিত নয় এমন এক্সটেনশন মোডগুলো ধূসর রঙে দেখানো হয়।

চিত্র ৪. ক্যামেরার জন্য উপলব্ধ এক্সটেনশন মোডসমূহ

প্রিভিউ ফলাফল যাচাই করুন

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

চিত্র ৫. বোকেহ সক্রিয় করা প্রিভিউ ছবি।

ছবি তোলার কার্যক্রমটি নিম্নলিখিত ফাংশনগুলো সমর্থন করে:

• জুম ইন/আউট
• ট্যাপ-টু-ফোকাস
• ফ্ল্যাশ মোড স্যুইচ বোতাম
• ইভি +/-
• এক্সটেনশন সক্রিয়/নিষ্ক্রিয় করার সুইচ বোতাম

প্রিভিউতে জুম ইন/আউট, ট্যাপ-টু-ফোকাস, ফ্ল্যাশ মোড এবং EV +/- ফাংশনগুলো প্রত্যাশিতভাবে কাজ করছে কিনা তা যাচাই করুন।

ক্যাপচার করা ছবির ফলাফল যাচাই করুন।

ছবিটি ক্যাপচার করতে, ইমেজ ক্যাপচারিং অ্যাক্টিভিটিতে থাকা ক্যাপচার বোতামে (গোল বোতামটি) ট্যাপ করুন। এটি একটি ইমেজ ভ্যালিডেশন অ্যাক্টিভিটি চালু করে, যেখানে ক্যাপচার করা ছবিটি দেখানো হয়।

চিত্র ৬. বোকেহ সক্রিয় করে তোলা ছবি।

চিত্র যাচাইকরণ কার্যক্রমে নিম্নলিখিত ফাংশনগুলো অন্তর্ভুক্ত রয়েছে:

• ছবিটির আকার পরিবর্তন করতে জুম ইন/আউট করুন।
• তোলা ছবিগুলো পরিবর্তন করতে বাম/ডানে স্লাইড করুন।
• পুনরুদ্ধার
• ছবি সংরক্ষণ মেনু আইটেম

ধারণ করা ছবিটি সঠিক কিনা এবং ছবিটি তোলার সময় সেট করা জুম ইন/আউট, ট্যাপ-টু-ফোকাস, ফ্ল্যাশ মোড এবং EV +/- সেটিংসের সাথে তা মেলে কিনা, তা যাচাই করুন।

সংগৃহীত ফলাফল সঠিক হলে, নিচের ডান কোণায় থাকা পাস ( PASS ) বোতামে (চেকমার্ক) ট্যাপ করুন। অন্যথায়, নিচের বাম কোণায় থাকা ফেইল (FAIL ) বোতামে (বিস্ময়সূচক চিহ্ন) ট্যাপ করুন।

পরীক্ষার ফলাফল দেখুন

কোনো এক্সটেনশন মোড পাস বা ফেল হিসেবে যাচাই হওয়ার পর, সেই মোডের তালিকা আইটেমটিতে একটি ভিন্ন ব্যাকগ্রাউন্ড রঙ এবং নির্দেশক দেখা যায়। সমস্ত ক্যামেরার তালিকা দৃশ্যে, আইটেমগুলি নিম্নলিখিত রঙগুলিতে প্রদর্শিত হয়:

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

চিত্র ৭. ক্যামেরা এবং এক্সটেনশন মোডের পরীক্ষার ফলাফল নির্দেশকারী রঙসমূহ

অন্যান্য যাচাইকরণ টুলের কার্যাবলী

সমস্ত পরীক্ষা সম্পন্ন হওয়ার পর, ক্যামেরা তালিকা কার্যক্রমটি নিম্নলিখিত ফাংশনগুলো প্রদান করে:

• পরীক্ষার ফলাফল রপ্তানি করুন: পরীক্ষার ফলাফল একটি CSV ফাইল হিসেবে Documents/ExtensionsValidation ফোল্ডারে রপ্তানি করে।
• রিসেট: ক্যাশে থাকা সমস্ত পরীক্ষার ফলাফল মুছে দেয়।
• এক্সটেনশন নমুনা অ্যাপ: এক্সটেনশন নমুনা অ্যাপ মোডে পরিবর্তন করে।

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