FaceDetector

کلاس نهایی عمومی FaceDetector

تشخیص چهره را روی تصاویر انجام می دهد.

API انتظار دارد یک مدل TFLite با فراداده مدل TFLite باشد. .

  • تصویر ورودی MPImage
    • تصویری که آشکارساز چهره روی آن کار می کند.
  • خروجی FaceDetectorResult FaceDetectorResult
    • یک FaceDetectorResult حاوی چهره‌های شناسایی‌شده.

کلاس های تو در تو

کلاس FaceDetector.FaceDetectorOptions گزینه هایی برای راه اندازی FaceDetector .

روش های عمومی

FaceDetector استاتیک
createFromBuffer (متن زمینه، ByteBuffer modelBuffer)
یک نمونه FaceDetector از بافر مدل و FaceDetector.FaceDetectorOptions پیش‌فرض ایجاد می‌کند.
FaceDetector استاتیک
createFromFile (زمینه زمینه، رشته modelPath)
یک نمونه FaceDetector را از یک فایل مدل و FaceDetector.FaceDetectorOptions پیش‌فرض ایجاد می‌کند.
FaceDetector استاتیک
createFromFile (زمینه زمینه، فایل modelFile)
یک نمونه FaceDetector را از یک فایل مدل و FaceDetector.FaceDetectorOptions پیش‌فرض ایجاد می‌کند.
FaceDetector استاتیک
createFromOptions (متن زمینه، FaceDetector.FaceDetectorOptions detectorOptions)
یک نمونه FaceDetector از یک FaceDetector.FaceDetectorOptions ایجاد می کند.
FaceDetector Result
تشخیص (تصویر MPI )
تشخیص چهره را روی تصویر واحد ارائه شده با گزینه های پردازش تصویر پیش فرض انجام می دهد، به عنوان مثال
FaceDetector Result
تشخیص (تصویر MPImage ، ImageProcessingOptions imageProcessingOptions)
تشخیص چهره را روی تک تصویر ارائه شده انجام می دهد.
خالی
detectAsync (تصویر MPImage ، ImageProcessingOptions imageProcessingOptions، timestampMهای طولانی)
داده های تصویر زنده را برای انجام تشخیص چهره ارسال می کند و نتایج از طریق OutputHandler.ResultListener ارائه شده در FaceDetector.FaceDetectorOptions در دسترس خواهد بود.
خالی
detectAsync (تصویر MPImage ، برچسب زمانی طولانی)
داده‌های تصویر زنده را برای انجام تشخیص چهره با گزینه‌های پیش‌فرض پردازش تصویر ارسال می‌کند
FaceDetector Result
detectForVideo (تصویر MPImage ، ImageProcessingOptions imageProcessingOptions، برچسب های زمانی طولانی)
تشخیص چهره را روی قاب ویدیویی ارائه شده انجام می دهد.
FaceDetector Result
detectForVideo (تصویر MPI ، مُهر زمانی طولانی)
تشخیص چهره را روی قاب ویدیوی ارائه شده با گزینه های پردازش تصویر پیش فرض انجام می دهد، به عنوان مثال

روش های ارثی

روش های عمومی

عمومی استاتیک FaceDetector createFromBuffer (زمینه زمینه، ByteBuffer modelBuffer)

یک نمونه FaceDetector از بافر مدل و FaceDetector.FaceDetectorOptions پیش‌فرض ایجاد می‌کند.

مولفه های
متن نوشته یک ERROR(/Context) .
مدل بافر یک ByteBuffer مستقیم یا یک ERROR(/MappedByteBuffer) مدل تشخیص.
پرتاب می کند
اگر در حین ایجاد FaceDetector خطایی وجود داشته باشد.

FaceDetector استاتیک عمومی createFromFile (زمینه زمینه، رشته مدلPath)

یک نمونه FaceDetector را از یک فایل مدل و FaceDetector.FaceDetectorOptions پیش‌فرض ایجاد می‌کند.

مولفه های
متن نوشته یک ERROR(/Context) .
modelPath مسیر به مدل تشخیص با ابرداده در دارایی ها.
پرتاب می کند
اگر در حین ایجاد FaceDetector خطایی وجود داشته باشد.

FaceDetector استاتیک عمومی createFromFile (زمینه زمینه، فایل modelFile)

یک نمونه FaceDetector را از یک فایل مدل و FaceDetector.FaceDetectorOptions پیش‌فرض ایجاد می‌کند.

مولفه های
متن نوشته یک ERROR(/Context) .
modelFile نمونه File مدل تشخیص
پرتاب می کند
IOException اگر هنگام باز کردن فایل مدل tflite خطای I/O رخ دهد.
اگر در حین ایجاد FaceDetector خطایی وجود داشته باشد.

عمومی استاتیک FaceDetector createFromOptions (متن زمینه، FaceDetector.FaceDetectorOptions detectorOptions)

یک نمونه FaceDetector از یک FaceDetector.FaceDetectorOptions ایجاد می کند.

مولفه های
متن نوشته یک ERROR(/Context) .
گزینه های detector یک نمونه FaceDetector.FaceDetectorOptions .
پرتاب می کند
اگر در حین ایجاد FaceDetector خطایی وجود داشته باشد.

تشخیص عمومی FaceDetectorResult (تصویر MPImage )

تشخیص چهره را روی تک تصویر ارائه شده با گزینه های پیش فرض پردازش تصویر، یعنی بدون هیچ چرخشی انجام می دهد. فقط زمانی از این روش استفاده کنید که FaceDetector با ERROR(/RunningMode.IMAGE) ایجاد شده باشد.

FaceDetector از انواع فضای رنگی زیر پشتیبانی می کند:

مولفه های
تصویر یک شی MediaPipe MPImage برای پردازش.
پرتاب می کند
اگر یک خطای داخلی وجود داشته باشد.

تشخیص عمومی FaceDetectorResult (تصویر MPImage ، ImageProcessingOptions imageProcessingOptions)

تشخیص چهره را روی تک تصویر ارائه شده انجام می دهد. فقط زمانی از این روش استفاده کنید که FaceDetector با ERROR(/RunningMode.IMAGE) ایجاد شده باشد.

FaceDetector از انواع فضای رنگی زیر پشتیبانی می کند:

مولفه های
تصویر یک شی MediaPipe MPImage برای پردازش.
imageProcessingOptions ImageProcessingOptions نحوه پردازش تصویر ورودی را قبل از اجرای استنتاج مشخص می کند. توجه داشته باشید که منطقه مورد علاقه توسط این کار پشتیبانی نمی شود: مشخص کردن ImageProcessingOptions.regionOfInterest() منجر به پرتاب IllegalArgumentException توسط این روش می شود.
پرتاب می کند
IllegalArgumentException اگر ImageProcessingOptions منطقه مورد علاقه را مشخص کند.
اگر یک خطای داخلی وجود داشته باشد.

public void detectAsync (تصویر MPImage ، ImageProcessingOptions imageProcessingOptions، timestampM های طولانی)

داده های تصویر زنده را برای انجام تشخیص چهره ارسال می کند و نتایج از طریق OutputHandler.ResultListener ارائه شده در FaceDetector.FaceDetectorOptions در دسترس خواهد بود. فقط زمانی از این روش استفاده کنید که FaceDetector با ERROR(/RunningMode.LIVE_STREAM) ایجاد شده باشد.

برای نشان دادن زمان ارسال تصویر ورودی به آشکارساز چهره، باید یک مهر زمانی (بر حسب میلی ثانیه) ارائه شود. مُهرهای زمانی ورودی باید بطور یکنواخت در حال افزایش باشند.

FaceDetector از انواع فضای رنگی زیر پشتیبانی می کند:

مولفه های
تصویر یک شی MediaPipe MPImage برای پردازش.
imageProcessingOptions ImageProcessingOptions نحوه پردازش تصویر ورودی را قبل از اجرای استنتاج مشخص می کند. توجه داشته باشید که منطقه مورد علاقه توسط این کار پشتیبانی نمی شود: مشخص کردن ImageProcessingOptions.regionOfInterest() منجر به پرتاب IllegalArgumentException توسط این روش می شود.
timestampMs مهر زمانی ورودی (بر حسب میلی ثانیه).
پرتاب می کند
IllegalArgumentException اگر ImageProcessingOptions منطقه مورد علاقه را مشخص کند.
اگر یک خطای داخلی وجود داشته باشد.

public void detectAsync (تصویر MPImage ، timestampMs طولانی)

داده‌های تصویر زنده را برای انجام تشخیص چهره با گزینه‌های پردازش تصویر پیش‌فرض، یعنی بدون هیچ چرخشی ارسال می‌کند، و نتایج از طریق OutputHandler.ResultListener ارائه شده در FaceDetector.FaceDetectorOptions در دسترس خواهند بود. فقط زمانی از این روش استفاده کنید که FaceDetector با ERROR(/RunningMode.LIVE_STREAM) ایجاد شده باشد.

برای نشان دادن زمان ارسال تصویر ورودی به آشکارساز چهره، باید یک مهر زمانی (بر حسب میلی ثانیه) ارائه شود. مُهرهای زمانی ورودی باید بطور یکنواخت در حال افزایش باشند.

FaceDetector از انواع فضای رنگی زیر پشتیبانی می کند:

مولفه های
تصویر یک شی MediaPipe MPImage برای پردازش.
timestampMs مهر زمانی ورودی (بر حسب میلی ثانیه).
پرتاب می کند
اگر یک خطای داخلی وجود داشته باشد.

عمومی FaceDetectorResult detectForVideo (تصویر MPImage ، ImageProcessingOptions imageProcessingOptions، برچسب های زمانی طولانی)

تشخیص چهره را روی قاب ویدیویی ارائه شده انجام می دهد. فقط زمانی از این روش استفاده کنید که FaceDetector با ERROR(/RunningMode.VIDEO) ایجاد شده باشد.

لازم است مهر زمانی فریم ویدیو (در میلی ثانیه) ارائه شود. مُهرهای زمانی ورودی باید بطور یکنواخت در حال افزایش باشند.

FaceDetector از انواع فضای رنگی زیر پشتیبانی می کند:

مولفه های
تصویر یک شی MediaPipe MPImage برای پردازش.
imageProcessingOptions ImageProcessingOptions نحوه پردازش تصویر ورودی را قبل از اجرای استنتاج مشخص می کند. توجه داشته باشید که منطقه مورد علاقه توسط این کار پشتیبانی نمی شود: مشخص کردن ImageProcessingOptions.regionOfInterest() منجر به پرتاب IllegalArgumentException توسط این روش می شود.
timestampMs مهر زمانی ورودی (بر حسب میلی ثانیه).
پرتاب می کند
IllegalArgumentException اگر ImageProcessingOptions منطقه مورد علاقه را مشخص کند.
اگر یک خطای داخلی وجود داشته باشد.

عمومی FaceDetectorResult detectForVideo (تصویر MPI ، مُهر زمانی طولانی)

تشخیص چهره را روی قاب ویدیوی ارائه شده با گزینه های پیش فرض پردازش تصویر، یعنی بدون هیچ چرخشی انجام می دهد. فقط زمانی از این روش استفاده کنید که FaceDetector با ERROR(/RunningMode.VIDEO) ایجاد شده باشد.

لازم است مهر زمانی فریم ویدیو (در میلی ثانیه) ارائه شود. مُهرهای زمانی ورودی باید بطور یکنواخت در حال افزایش باشند.

FaceDetector از انواع فضای رنگی زیر پشتیبانی می کند:

مولفه های
تصویر یک شی MediaPipe MPImage برای پردازش.
timestampMs مهر زمانی ورودی (بر حسب میلی ثانیه).
پرتاب می کند
اگر یک خطای داخلی وجود داشته باشد.