ObjectDetector

পাবলিক ফাইনাল ক্লাস অবজেক্ট ডিটেক্টর

ইমেজ উপর বস্তু সনাক্তকরণ সঞ্চালন.

API টিএফলাইট মডেল মেটাডেটা সহ একটি TFLite মডেল আশা করে। .

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

  • ইনপুট ইমেজ টেনসর ( kTfLiteUInt8 / kTfLiteFloat32 )
    • আকারের ইমেজ ইনপুট [batch x height x width x channels] ।
    • ব্যাচ অনুমান সমর্থিত নয় ( batch 1 হতে হবে)।
    • শুধুমাত্র RGB ইনপুট সমর্থিত ( channels 3 হতে হবে)।
    • টাইপ kTfLiteFloat32 হলে, ইনপুট স্বাভাবিককরণের জন্য মেটাডেটার সাথে স্বাভাবিককরণ বিকল্পগুলি সংযুক্ত করা প্রয়োজন।
  • আউটপুট টেনসর অবশ্যই একটি DetectionPostProcess op এর 4টি আউটপুট হতে হবে, যেমন:
    • অবস্থান টেনসর ( kTfLiteFloat32 ):
      • আকারের টেনসর [1 x num_results x 4] , অভ্যন্তরীণ বিন্যাসটি আকারে [উপরে, বাম, ডান, নীচে] বাউন্ডিং বাক্সগুলিকে প্রতিনিধিত্ব করে।
      • BoundingBoxProperties মেটাডেটার সাথে সংযুক্ত করতে হবে এবং অবশ্যই type=BOUNDARIES এবং coordinate_type=RATIO উল্লেখ করতে হবে।
    • ক্লাস টেনসর ( kTfLiteFloat32 ):
      • আকারের টেনসর [1 x num_results] , প্রতিটি মান একটি শ্রেণীর পূর্ণসংখ্যা সূচক প্রতিনিধিত্ব করে।
      • যদি লেবেল মানচিত্রগুলি মেটাডেটার সাথে TENSOR_VALUE_LABELS সম্পর্কিত ফাইল হিসাবে সংযুক্ত থাকে, সেগুলি টেনসর মানগুলিকে লেবেলে রূপান্তর করতে ব্যবহৃত হয়।
    • স্কোর টেনসর ( kTfLiteFloat32 ):
      • আকারের টেনসর [1 x num_results] , প্রতিটি মান সনাক্ত করা বস্তুর স্কোর প্রতিনিধিত্ব করে।
    • সনাক্তকরণ টেনসরের সংখ্যা ( kTfLiteFloat32 ):
      • পূর্ণসংখ্যা num_results আকারের একটি টেনসর হিসাবে [1] ।

এই ধরনের মডেলের একটি উদাহরণ টেনসরফ্লো হাবে পাওয়া যাবে। .

নেস্টেড ক্লাস

ক্লাস ObjectDetector.ObjectDetectorOptions একটি ObjectDetector সেট আপ করার জন্য বিকল্প।

পাবলিক পদ্ধতি

স্ট্যাটিক অবজেক্ট ডিটেক্টর
createFromBuffer (প্রসঙ্গ প্রসঙ্গ, বাইটবাফার মডেলবাফার)
একটি মডেল বাফার এবং ডিফল্ট ObjectDetector.ObjectDetectorOptions থেকে একটি ObjectDetector উদাহরণ তৈরি করে।
স্ট্যাটিক অবজেক্ট ডিটেক্টর
createFromFile (প্রসঙ্গ প্রসঙ্গ, স্ট্রিং মডেলপথ)
একটি মডেল ফাইল এবং ডিফল্ট ObjectDetector.ObjectDetectorOptions থেকে একটি ObjectDetector উদাহরণ তৈরি করে।
স্ট্যাটিক অবজেক্ট ডিটেক্টর
createFromFile (প্রসঙ্গ প্রসঙ্গ, ফাইল মডেল ফাইল )
একটি মডেল ফাইল এবং ডিফল্ট ObjectDetector.ObjectDetectorOptions থেকে একটি ObjectDetector উদাহরণ তৈরি করে।
স্ট্যাটিক অবজেক্ট ডিটেক্টর
createFromOptions (প্রসঙ্গ প্রসঙ্গ, ObjectDetector.ObjectDetectorOptions detectorOptions)
একটি ObjectDetector.ObjectDetectorOptions থেকে একটি ObjectDetector উদাহরণ তৈরি করে।
অবজেক্ট ডিটেক্টর ফলাফল
সনাক্ত করুন ( এমপিইমেজ ইমেজ)
ডিফল্ট ইমেজ প্রসেসিং অপশন সহ প্রদত্ত একক ছবিতে অবজেক্ট ডিটেকশন সঞ্চালন করে, যেমন
অবজেক্ট ডিটেক্টর ফলাফল
সনাক্ত করুন ( MPImage image, ImageProcessingOptions imageProcessing Options)
প্রদত্ত একক চিত্রে অবজেক্ট সনাক্তকরণ সম্পাদন করে।
অকার্যকর
detectAsync ( MPImage image, ImageProcessingOptions imageProcessing Options, long timestampMs)
অবজেক্ট ডিটেকশন সঞ্চালনের জন্য লাইভ ইমেজ ডেটা পাঠায় এবং ফলাফলগুলি OutputHandler.ResultListener এর মাধ্যমে উপলব্ধ হবে ObjectDetector.ObjectDetectorOptions এ প্রদত্ত।
অকার্যকর
detectAsync ( MPImage চিত্র, দীর্ঘ টাইমস্ট্যাম্প)
ডিফল্ট ইমেজ প্রক্রিয়াকরণ বিকল্পগুলির সাথে বস্তু সনাক্তকরণ সঞ্চালনের জন্য লাইভ ইমেজ ডেটা পাঠায়, যেমন
অবজেক্ট ডিটেক্টর ফলাফল
ডিটেক্টফরভিডিও ( MPImage ইমেজ, ImageProcessingOptions imageProcessing Options, long timestampMs)
প্রদত্ত ভিডিও ফ্রেমে অবজেক্ট ডিটেকশন করে।
অবজেক্ট ডিটেক্টর ফলাফল
ডিটেক্টফরভিডিও ( এমপিইমেজ ইমেজ, লং টাইমস্ট্যাম্প)
প্রদত্ত ভিডিও ফ্রেমে ডিফল্ট ইমেজ প্রসেসিং অপশন সহ অবজেক্ট ডিটেকশন করে

উত্তরাধিকারসূত্রে প্রাপ্ত পদ্ধতি

পাবলিক পদ্ধতি

পাবলিক স্ট্যাটিক অবজেক্ট ডিটেক্টর createFromBuffer (প্রসঙ্গ প্রসঙ্গ, বাইটবাফার মডেলবাফার)

একটি মডেল বাফার এবং ডিফল্ট ObjectDetector.ObjectDetectorOptions থেকে একটি ObjectDetector উদাহরণ তৈরি করে।

পরামিতি
প্রসঙ্গ একটি অ্যান্ড্রয়েড ERROR(/Context) ।
মডেলবাফার একটি সরাসরি ByteBuffer বা সনাক্তকরণ মডেলের একটি ERROR(/MappedByteBuffer) ।
নিক্ষেপ করে
ObjectDetector তৈরির সময় যদি কোনও ত্রুটি থাকে।

পাবলিক স্ট্যাটিক অবজেক্ট ডিটেক্টর createFromFile (প্রসঙ্গ প্রসঙ্গ, স্ট্রিং মডেলপথ)

একটি মডেল ফাইল এবং ডিফল্ট ObjectDetector.ObjectDetectorOptions থেকে একটি ObjectDetector উদাহরণ তৈরি করে।

পরামিতি
প্রসঙ্গ একটি অ্যান্ড্রয়েড ERROR(/Context) ।
মডেলপথ সম্পদে মেটাডেটা সহ সনাক্তকরণ মডেলের পথ।
নিক্ষেপ করে
ObjectDetector তৈরির সময় যদি কোনও ত্রুটি থাকে।

পাবলিক স্ট্যাটিক অবজেক্ট ডিটেক্টর createFromFile (প্রসঙ্গ প্রসঙ্গ, ফাইল মডেলফাইল)

একটি মডেল ফাইল এবং ডিফল্ট ObjectDetector.ObjectDetectorOptions থেকে একটি ObjectDetector উদাহরণ তৈরি করে।

পরামিতি
প্রসঙ্গ একটি অ্যান্ড্রয়েড ERROR(/Context) ।
মডেল ফাইল সনাক্তকরণ মডেল File উদাহরণ।
নিক্ষেপ করে
IO ব্যতিক্রম tflite মডেল ফাইল খোলার সময় যদি একটি I/O ত্রুটি ঘটে।
ObjectDetector তৈরির সময় যদি কোনও ত্রুটি থাকে।

পাবলিক স্ট্যাটিক অবজেক্ট ডিটেক্টর createFromOptions (প্রসঙ্গ প্রসঙ্গ, ObjectDetector.ObjectDetectorOptions detectorOptions)

একটি ObjectDetector.ObjectDetectorOptions থেকে একটি ObjectDetector উদাহরণ তৈরি করে।

পরামিতি
প্রসঙ্গ একটি অ্যান্ড্রয়েড ERROR(/Context) ।
আবিষ্কারক বিকল্প একটি ObjectDetector.ObjectDetectorOptions উদাহরণ।
নিক্ষেপ করে
ObjectDetector তৈরির সময় যদি কোনও ত্রুটি থাকে।

সর্বজনীন অবজেক্ট ডিটেক্টর ফলাফল সনাক্তকরণ ( এমপিইমেজ চিত্র)

ডিফল্ট ইমেজ প্রসেসিং অপশন সহ প্রদত্ত একক ছবিতে অবজেক্ট ডিটেকশন সঞ্চালন করে, যেমন কোনো ঘূর্ণন প্রয়োগ না করে। ERROR(/RunningMode.IMAGE) দিয়ে ObjectDetector তৈরি হলেই শুধুমাত্র এই পদ্ধতিটি ব্যবহার করুন।

ObjectDetector নিম্নলিখিত রঙের স্থান প্রকারগুলিকে সমর্থন করে:

পরামিতি
ইমেজ প্রক্রিয়াকরণের জন্য একটি MediaPipe MPImage অবজেক্ট।
নিক্ষেপ করে
যদি অভ্যন্তরীণ ত্রুটি থাকে।

সর্বজনীন অবজেক্ট ডিটেক্টর ফলাফল সনাক্ত করুন ( MPImage image, ImageProcessingOptions imageProcessing Options)

প্রদত্ত একক চিত্রে অবজেক্ট সনাক্তকরণ সম্পাদন করে। ERROR(/RunningMode.IMAGE) দিয়ে ObjectDetector তৈরি হলেই শুধুমাত্র এই পদ্ধতিটি ব্যবহার করুন।

ObjectDetector নিম্নলিখিত রঙের স্থান প্রকারগুলিকে সমর্থন করে:

পরামিতি
ইমেজ প্রক্রিয়াকরণের জন্য একটি MediaPipe MPImage অবজেক্ট।
ইমেজ প্রসেসিং অপশন ImageProcessingOptions উল্লেখ করে কিভাবে ইনপুট ইমেজটি ইনফারেন্স চালানোর আগে প্রক্রিয়া করতে হয়। মনে রাখবেন যে অঞ্চল-অব-আগ্রহ এই টাস্ক দ্বারা সমর্থিত নয় : ImageProcessingOptions.regionOfInterest() নির্দিষ্ট করার ফলে এই পদ্ধতিটি একটি IllegalArgumentException নিক্ষেপ করবে।
নিক্ষেপ করে
অবৈধ আর্গুমেন্ট ব্যতিক্রম যদি ImageProcessingOptions একটি আগ্রহের অঞ্চল নির্দিষ্ট করে।
যদি অভ্যন্তরীণ ত্রুটি থাকে।

পাবলিক ভ্যাইড ডিটেক্টঅ্যাসিঙ্ক ( এমপিইমেজ ইমেজ, ইমেজপ্রসেসিং অপশন ইমেজপ্রসেসিং অপশন, লং টাইমস্ট্যাম্প)

অবজেক্ট ডিটেকশন সঞ্চালনের জন্য লাইভ ইমেজ ডেটা পাঠায় এবং ফলাফলগুলি OutputHandler.ResultListener এর মাধ্যমে উপলব্ধ হবে ObjectDetector.ObjectDetectorOptions এ প্রদত্ত। ERROR(/RunningMode.LIVE_STREAM) দিয়ে ObjectDetector তৈরি হলেই শুধুমাত্র এই পদ্ধতিটি ব্যবহার করুন।

অবজেক্ট ডিটেক্টরে ইনপুট ইমেজ কখন পাঠানো হয় তা নির্দেশ করার জন্য এটি একটি টাইমস্ট্যাম্প (মিলিসেকেন্ডে) প্রদান করতে হবে। ইনপুট টাইমস্ট্যাম্প একঘেয়েভাবে বৃদ্ধি করা আবশ্যক.

ObjectDetector নিম্নলিখিত রঙের স্থান প্রকারগুলিকে সমর্থন করে:

পরামিতি
ইমেজ প্রক্রিয়াকরণের জন্য একটি MediaPipe MPImage অবজেক্ট।
ইমেজ প্রসেসিং অপশন ImageProcessingOptions উল্লেখ করে কিভাবে ইনপুট ইমেজটি ইনফারেন্স চালানোর আগে প্রক্রিয়া করতে হয়। মনে রাখবেন যে অঞ্চল-অব-আগ্রহ এই টাস্ক দ্বারা সমর্থিত নয় : ImageProcessingOptions.regionOfInterest() নির্দিষ্ট করার ফলে এই পদ্ধতিটি একটি IllegalArgumentException নিক্ষেপ করবে।
টাইমস্ট্যাম্প ইনপুট টাইমস্ট্যাম্প (মিলিসেকেন্ডে)।
নিক্ষেপ করে
অবৈধ আর্গুমেন্ট ব্যতিক্রম যদি ImageProcessingOptions একটি আগ্রহের অঞ্চল নির্দিষ্ট করে।
যদি অভ্যন্তরীণ ত্রুটি থাকে।

পাবলিক ভ্যাইড ডিটেক্টঅ্যাসিঙ্ক ( এমপিইমেজ ইমেজ, লং টাইমস্ট্যাম্পএম)

ডিফল্ট ইমেজ প্রসেসিং বিকল্পগুলির সাথে অবজেক্ট সনাক্তকরণের জন্য লাইভ ইমেজ ডেটা পাঠায়, যেমন কোনও ঘূর্ণন প্রয়োগ না করে, এবং ফলাফলগুলি OutputHandler.ResultListener এর মাধ্যমে উপলব্ধ হবে ObjectDetector.ObjectDetectorOptions এ প্রদত্ত। ERROR(/RunningMode.LIVE_STREAM) দিয়ে ObjectDetector তৈরি হলেই শুধুমাত্র এই পদ্ধতিটি ব্যবহার করুন।

অবজেক্ট ডিটেক্টরে ইনপুট ইমেজ কখন পাঠানো হয় তা নির্দেশ করার জন্য এটি একটি টাইমস্ট্যাম্প (মিলিসেকেন্ডে) প্রদান করতে হবে। ইনপুট টাইমস্ট্যাম্প একঘেয়েভাবে বৃদ্ধি করা আবশ্যক.

ObjectDetector নিম্নলিখিত রঙের স্থান প্রকারগুলিকে সমর্থন করে:

পরামিতি
ইমেজ প্রক্রিয়াকরণের জন্য একটি MediaPipe MPImage অবজেক্ট।
টাইমস্ট্যাম্প ইনপুট টাইমস্ট্যাম্প (মিলিসেকেন্ডে)।
নিক্ষেপ করে
যদি অভ্যন্তরীণ ত্রুটি থাকে।

ভিডিওর জন্য সর্বজনীন অবজেক্ট ডিটেক্টর ফলাফল সনাক্ত করুন ( MPImage image, ImageProcessing Options imageProcessing Options, long timestampMs)

প্রদত্ত ভিডিও ফ্রেমে অবজেক্ট ডিটেকশন করে। ERROR(/RunningMode.VIDEO) দিয়ে ObjectDetector তৈরি হলেই শুধুমাত্র এই পদ্ধতিটি ব্যবহার করুন।

ভিডিও ফ্রেমের টাইমস্ট্যাম্প (মিলিসেকেন্ডে) প্রদান করতে হবে। ইনপুট টাইমস্ট্যাম্প একঘেয়েভাবে বৃদ্ধি করা আবশ্যক.

ObjectDetector নিম্নলিখিত রঙের স্থান প্রকারগুলিকে সমর্থন করে:

পরামিতি
ইমেজ প্রক্রিয়াকরণের জন্য একটি MediaPipe MPImage অবজেক্ট।
ইমেজ প্রসেসিং অপশন ImageProcessingOptions উল্লেখ করে কিভাবে ইনপুট ইমেজটি ইনফারেন্স চালানোর আগে প্রক্রিয়া করতে হয়। মনে রাখবেন যে অঞ্চল-অব-আগ্রহ এই টাস্ক দ্বারা সমর্থিত নয় : ImageProcessingOptions.regionOfInterest() নির্দিষ্ট করার ফলে এই পদ্ধতিটি একটি IllegalArgumentException নিক্ষেপ করবে।
টাইমস্ট্যাম্প ইনপুট টাইমস্ট্যাম্প (মিলিসেকেন্ডে)।
নিক্ষেপ করে
অবৈধ আর্গুমেন্ট ব্যতিক্রম যদি ImageProcessingOptions একটি আগ্রহের অঞ্চল নির্দিষ্ট করে।
যদি অভ্যন্তরীণ ত্রুটি থাকে।

ভিডিওর জন্য সর্বজনীন অবজেক্ট ডিটেক্টর ফলাফল সনাক্ত করুন ( MPImage চিত্র, দীর্ঘ টাইমস্ট্যাম্প)

ডিফল্ট ইমেজ প্রসেসিং অপশন সহ প্রদত্ত ভিডিও ফ্রেমে অবজেক্ট ডিটেকশন সঞ্চালন করে, যেমন কোনো ঘূর্ণন প্রয়োগ না করে। ERROR(/RunningMode.VIDEO) দিয়ে ObjectDetector তৈরি হলেই শুধুমাত্র এই পদ্ধতিটি ব্যবহার করুন।

ভিডিও ফ্রেমের টাইমস্ট্যাম্প (মিলিসেকেন্ডে) প্রদান করতে হবে। ইনপুট টাইমস্ট্যাম্প একঘেয়েভাবে বৃদ্ধি করা আবশ্যক.

ObjectDetector নিম্নলিখিত রঙের স্থান প্রকারগুলিকে সমর্থন করে:

পরামিতি
ইমেজ প্রক্রিয়াকরণের জন্য একটি MediaPipe MPImage অবজেক্ট।
টাইমস্ট্যাম্প ইনপুট টাইমস্ট্যাম্প (মিলিসেকেন্ডে)।
নিক্ষেপ করে
যদি অভ্যন্তরীণ ত্রুটি থাকে।