FaceDetector

पब्लिक फ़ाइनल क्लास FaceDetector

इमेज पर चेहरे की पहचान करने की सुविधा इस्तेमाल की जाती है.

एपीआई को TFLite मॉडल मेटाडेटा वाले TFLite मॉडल की ज़रूरत होती है.

  • इमेज डालें MPImage
    • वह इमेज जिस पर फ़ेस डिटेक्टर चालू होता है.
  • आउटपुट FaceDetectorनतीजे FaceDetectorResult
    • FaceDetectorresults में, पहचाने गए चेहरे शामिल हैं.

नेस्ट की गई क्लास

क्लास FaceDetector.FaceDetectorOptions FaceDetector सेट अप करने के विकल्प. 

सार्वजनिक तरीके

स्टैटिक FaceDetector
createFromBuffer(कॉन्टेक्स्ट कॉन्टेक्स्ट, ByteBuffer ModelBuffer)
मॉडल बफ़र और डिफ़ॉल्ट FaceDetector.FaceDetectorOptions से FaceDetector इंस्टेंस बनाता है.
स्टैटिक FaceDetector
createFromFile(कॉन्टेक्स्ट कॉन्टेक्स्ट, स्ट्रिंग ModelPath)
मॉडल फ़ाइल और डिफ़ॉल्ट FaceDetector.FaceDetectorOptions से FaceDetector इंस्टेंस बनाता है.
स्टैटिक FaceDetector
createFromFile(कॉन्टेक्स्ट कॉन्टेक्स्ट, फ़ाइल ModelFile)
मॉडल फ़ाइल और डिफ़ॉल्ट FaceDetector.FaceDetectorOptions से FaceDetector इंस्टेंस बनाता है.
स्टैटिक FaceDetector
createFromOptions(कॉन्टेक्स्ट कॉन्टेक्स्ट, FaceDetector.FaceDetectorOptions DidiOptions)
FaceDetector.FaceDetectorOptions से FaceDetector इंस्टेंस बनाता है.
FaceDetectorResult
detect(MPImage इमेज)
डिफ़ॉल्ट इमेज प्रोसेसिंग के विकल्पों के साथ दी गई एक इमेज पर चेहरे की पहचान करता है, जैसे कि
FaceDetectorResult
detect(MPImage इमेज, ImageProcessingOptions imageprocessingOptions)
दी गई एक इमेज पर चेहरे की पहचान करता है.
void
detectAsync(MPImage इमेज, ImageProcessingOptions imageprocessingOptions, लंबे टाइमस्टैंप)
चेहरे की पहचान करने के लिए लाइव इमेज डेटा भेजता है और नतीजे, FaceDetector.FaceDetectorOptions में दिए गए OutputHandler.ResultListener के ज़रिए उपलब्ध होंगे.
void
detectAsync(MPImage इमेज, लंबा टाइमस्टैंप)
यह सुविधा, डिफ़ॉल्ट इमेज प्रोसेसिंग के विकल्पों के साथ चेहरे की पहचान करने के लिए, लाइव इमेज डेटा भेजती है.
FaceDetectorResult
detectForVideo(MPImage इमेज, ImageProcessingOptions imageProcessOptions, लंबे टाइमस्टैंप)
यह सुविधा, दिए गए वीडियो फ़्रेम पर चेहरे की पहचान करने की सुविधा इस्तेमाल करती है.
FaceDetectorResult
detectForVideo(MPImage इमेज, लंबा टाइमस्टैंप)
दिए गए वीडियो फ़्रेम पर, चेहरे की पहचान करने की सुविधा को डिफ़ॉल्ट इमेज प्रोसेसिंग के विकल्पों की मदद से पूरा करता है, जैसे कि

इनहेरिट किए गए तरीके

सार्वजनिक तरीके

सार्वजनिक स्टैटिक FaceDetector createFromBuffer (कॉन्टेक्स्ट कॉन्टेक्स्ट, ByteBuffer ModelBuffer)

मॉडल बफ़र और डिफ़ॉल्ट FaceDetector.FaceDetectorOptions से FaceDetector इंस्टेंस बनाता है.

पैरामीटर
संदर्भ Android ERROR(/Context).
modelBuffer पहचान मॉडल का डायरेक्ट ByteBuffer या ERROR(/MappedByteBuffer).
थ्रो
अगर FaceDetector बनाते समय कोई गड़बड़ी होती है.

सार्वजनिक स्टैटिक FaceDetector createFromFile (कॉन्टेक्स्ट कॉन्टेक्स्ट, स्ट्रिंग ModelPath)

मॉडल फ़ाइल और डिफ़ॉल्ट FaceDetector.FaceDetectorOptions से FaceDetector इंस्टेंस बनाता है.

पैरामीटर
संदर्भ Android ERROR(/Context).
modelPath का पाथ सेट अप करने की सुविधा मिलती है.
थ्रो
अगर FaceDetector बनाते समय कोई गड़बड़ी होती है.

सार्वजनिक स्टैटिक FaceDetector createFromFile (कॉन्टेक्स्ट कॉन्टेक्स्ट, फ़ाइल मॉडलफ़ाइल)

मॉडल फ़ाइल और डिफ़ॉल्ट FaceDetector.FaceDetectorOptions से FaceDetector इंस्टेंस बनाता है.

पैरामीटर
संदर्भ Android ERROR(/Context).
modelFile डिटेक्शन मॉडल File इंस्टेंस.
थ्रो
IOException अगर tflite मॉडल फ़ाइल को खोलते समय कोई I/O गड़बड़ी होती है.
अगर FaceDetector बनाते समय कोई गड़बड़ी होती है.

सार्वजनिक स्टैटिक FaceDetector createFromOptions (कॉन्टेक्स्ट कॉन्टेक्स्ट, FaceDetector.FaceDetectorOptions}

FaceDetector.FaceDetectorOptions से FaceDetector इंस्टेंस बनाता है.

पैरामीटर
संदर्भ Android ERROR(/Context).
detectorOptions FaceDetector.FaceDetectorOptions इंस्टेंस.
थ्रो
अगर FaceDetector बनाते समय कोई गड़बड़ी होती है.

सार्वजनिक FaceDetectorResult detect (MPImage इमेज)

दी गई एक इमेज पर, चेहरे की पहचान करने की सुविधा को डिफ़ॉल्ट इमेज प्रोसेसिंग के विकल्पों के साथ पूरा करता है. इसका मतलब है कि स्क्रीन को घुमाया नहीं जाता. इस तरीके का इस्तेमाल सिर्फ़ तब करें, जब FaceDetector को ERROR(/RunningMode.IMAGE) की मदद से बनाया गया हो.

FaceDetector पर इस तरह के कलर स्पेस इस्तेमाल किए जा सकते हैं:

पैरामीटर
इमेज प्रोसेसिंग के लिए MediaPipe MPImage ऑब्जेक्ट.
थ्रो
अगर कोई अंदरूनी गड़बड़ी होती है.

सार्वजनिक FaceDetectorResult detect (MPImage इमेज, ImageProcessingOptions imageprocessingOptions)

दी गई एक इमेज पर चेहरे की पहचान करता है. इस तरीके का इस्तेमाल सिर्फ़ तब करें, जब ERROR(/RunningMode.IMAGE) की मदद से FaceDetector बनाया गया हो.

FaceDetector पर इस तरह के कलर स्पेस इस्तेमाल किए जा सकते हैं:

पैरामीटर
इमेज प्रोसेसिंग के लिए MediaPipe MPImage ऑब्जेक्ट.
imageProcessingOptions ImageProcessingOptions में यह बताया गया है कि अनुमान चलाने से पहले, इनपुट इमेज को कैसे प्रोसेस किया जाए. ध्यान दें कि इस टास्क के लिए, पसंद का देश या इलाका काम नहीं करता: ImageProcessingOptions.regionOfInterest() को शामिल करने पर, इस तरीके से legalArgument4 की कॉपी नहीं बनाई जा सकती.
थ्रो
IllegalArgumentException अगर ImageProcessingOptions पसंद के क्षेत्र के बारे में बताता है.
अगर कोई अंदरूनी गड़बड़ी होती है.

Public void detectAsync (MPImage इमेज, ImageProcessingOptions imageprocessingOptions imageProcessOptions, लंबे timestampM)

चेहरे की पहचान करने के लिए लाइव इमेज डेटा भेजता है और नतीजे, FaceDetector.FaceDetectorOptions में दिए गए OutputHandler.ResultListener के ज़रिए उपलब्ध होंगे. इस तरीके का इस्तेमाल सिर्फ़ तब करें, जब ERROR(/RunningMode.LIVE_STREAM) की मदद से FaceDetector बनाया गया हो.

चेहरे की पहचान करने वाली सुविधा को इनपुट इमेज कब भेजी जाएगी, यह बताने के लिए टाइमस्टैंप (मिलीसेकंड में) देना ज़रूरी है. इनपुट के टाइमस्टैंप एक-दूसरे के हिसाब से बढ़ते होने चाहिए.

FaceDetector पर इस तरह के कलर स्पेस इस्तेमाल किए जा सकते हैं:

पैरामीटर
इमेज प्रोसेसिंग के लिए MediaPipe MPImage ऑब्जेक्ट.
imageProcessingOptions ImageProcessingOptions में यह बताया गया है कि अनुमान चलाने से पहले, इनपुट इमेज को कैसे प्रोसेस किया जाए. ध्यान दें कि इस टास्क के लिए, पसंद का देश या इलाका काम नहीं करता: ImageProcessingOptions.regionOfInterest() को शामिल करने पर, इस तरीके से legalArgument4 की कॉपी नहीं बनाई जा सकती.
timestampMs इनपुट टाइमस्टैंप (मिलीसेकंड में).
थ्रो
IllegalArgumentException अगर ImageProcessingOptions पसंद के क्षेत्र के बारे में बताता है.
अगर कोई अंदरूनी गड़बड़ी होती है.

Public void detectAsync (MPImage इमेज, लंबे टाइमस्टैंपM)

यह सुविधा, चेहरे की पहचान करने के लिए लाइव इमेज डेटा भेजती है, ताकि इमेज को प्रोसेस करने के डिफ़ॉल्ट विकल्प उपलब्ध हों. इसका मतलब है कि इमेज को घुमाए बिना, और नतीजे FaceDetector.FaceDetectorOptions में दिए गए OutputHandler.ResultListener के ज़रिए उपलब्ध होंगे. इस तरीके का इस्तेमाल सिर्फ़ तब करें, जब ERROR(/RunningMode.LIVE_STREAM) की मदद से FaceDetector बनाया गया हो.

चेहरे की पहचान करने वाली सुविधा को इनपुट इमेज कब भेजी जाएगी, यह बताने के लिए टाइमस्टैंप (मिलीसेकंड में) देना ज़रूरी है. इनपुट के टाइमस्टैंप एक-दूसरे के हिसाब से बढ़ते होने चाहिए.

FaceDetector पर इस तरह के कलर स्पेस इस्तेमाल किए जा सकते हैं:

पैरामीटर
इमेज प्रोसेसिंग के लिए MediaPipe MPImage ऑब्जेक्ट.
timestampMs इनपुट टाइमस्टैंप (मिलीसेकंड में).
थ्रो
अगर कोई अंदरूनी गड़बड़ी होती है.

सार्वजनिक FaceDetectorResult detectForVideo (MPImage इमेज, ImageProcessingOptions imageprocessingOptions imageprocessingOptions, ज़्यादा timestampMs

यह सुविधा, दिए गए वीडियो फ़्रेम पर चेहरे की पहचान करने की सुविधा इस्तेमाल करती है. इस तरीके का इस्तेमाल सिर्फ़ तब करें, जब ERROR(/RunningMode.VIDEO) की मदद से FaceDetector बनाया गया हो.

वीडियो फ़्रेम के टाइमस्टैंप की जानकारी, मिलीसेकंड में देना ज़रूरी है. इनपुट के टाइमस्टैंप एक-दूसरे के हिसाब से बढ़ते रहने चाहिए.

FaceDetector पर इस तरह के कलर स्पेस इस्तेमाल किए जा सकते हैं:

पैरामीटर
इमेज प्रोसेसिंग के लिए MediaPipe MPImage ऑब्जेक्ट.
imageProcessingOptions ImageProcessingOptions में यह बताया गया है कि अनुमान चलाने से पहले, इनपुट इमेज को कैसे प्रोसेस किया जाए. ध्यान दें कि इस टास्क के लिए, पसंद का देश या इलाका काम नहीं करता: ImageProcessingOptions.regionOfInterest() को शामिल करने पर, इस तरीके से legalArgument4 की कॉपी नहीं बनाई जा सकती.
timestampMs इनपुट टाइमस्टैंप (मिलीसेकंड में).
थ्रो
IllegalArgumentException अगर ImageProcessingOptions पसंद के क्षेत्र के बारे में बताता है.
अगर कोई अंदरूनी गड़बड़ी होती है.

सार्वजनिक FaceDetectorResult detectForVideo (MPImage इमेज, लंबा टाइमस्टैंप)

दिए गए वीडियो फ़्रेम पर, इमेज को प्रोसेस करने के डिफ़ॉल्ट विकल्पों के साथ चेहरे की पहचान करने की सुविधा इस्तेमाल करता है. इसका मतलब है कि स्क्रीन को घुमाने की ज़रूरत नहीं है. इस तरीके का इस्तेमाल सिर्फ़ तब करें, जब ERROR(/RunningMode.VIDEO) की मदद से FaceDetector बनाया गया हो.

वीडियो फ़्रेम के टाइमस्टैंप की जानकारी, मिलीसेकंड में देना ज़रूरी है. इनपुट के टाइमस्टैंप एक-दूसरे के हिसाब से बढ़ते रहने चाहिए.

FaceDetector पर इस तरह के कलर स्पेस इस्तेमाल किए जा सकते हैं:

पैरामीटर
इमेज प्रोसेसिंग के लिए MediaPipe MPImage ऑब्जेक्ट.
timestampMs इनपुट टाइमस्टैंप (मिलीसेकंड में).
थ्रो
अगर कोई अंदरूनी गड़बड़ी होती है.