ขอแนะนํา Google AI Edge Portal: เปรียบเทียบประสิทธิภาพ AI บนอุปกรณ์ขอบในวงกว้าง ลงชื่อสมัครใช้เพื่อขอสิทธิ์เข้าถึงในช่วงเวอร์ชันตัวอย่างก่อนเปิดตัว

หน้านี้ได้รับการแปลโดย Cloud Translation API

FaceDetector

คลาสสุดท้ายแบบสาธารณะ FaceDetector

ดำเนินการตรวจจับใบหน้าในรูปภาพ

API ต้องการโมเดล TFLite ที่มีข้อมูลเมตาของโมเดล TFLite

รูปภาพอินพุต MPImage
- รูปภาพที่ตัวตรวจจับใบหน้าทำงานอยู่
เอาต์พุต FaceDetector Results FaceDetectorResult
- FaceDetector Results ที่มีใบหน้าที่ตรวจพบ

ชั้นเรียนที่ซ้อนกัน

คลาส FaceDetector.FaceDetectorOptions ตัวเลือกในการตั้งค่าFaceDetector

วิธีการสาธารณะ

ภาพนิ่ง FaceDetector	createFromBuffer(บริบทบริบท, ByteBuffer modelBuffer) สร้างอินสแตนซ์ `FaceDetector` จากบัฟเฟอร์โมเดลและ `FaceDetector.FaceDetectorOptions` เริ่มต้น
ภาพนิ่ง FaceDetector	createFromFile(บริบทบริบท, String modelPath) สร้างอินสแตนซ์ `FaceDetector` จากไฟล์โมเดลและ `FaceDetector.FaceDetectorOptions` เริ่มต้น
ภาพนิ่ง FaceDetector	createFromFile(บริบทบริบท, ไฟล์ modelFile) สร้างอินสแตนซ์ `FaceDetector` จากไฟล์โมเดลและ `FaceDetector.FaceDetectorOptions` เริ่มต้น
ภาพนิ่ง FaceDetector	createFromOptions(บริบทบริบท, FaceDetector.FaceDetectorOptions DetectorOptions) สร้างอินสแตนซ์ `FaceDetector` จาก `FaceDetector.FaceDetectorOptions`
FaceDetectorResult	detect(รูปภาพ MPImage) ดำเนินการตรวจจับใบหน้าในรูปภาพเดียวที่ให้มาด้วยตัวเลือกการประมวลผลรูปภาพเริ่มต้น เช่น
FaceDetectorResult	detect(รูปภาพ MPImage, ImageProcessingOptions imageProcessingOptions) ดำเนินการตรวจจับใบหน้าในรูปภาพเดียวที่ให้ไว้
void	detectAsync(รูปภาพ MPImage, ImageProcessingOptions imageProcessingOptions, การประทับเวลายาว) ส่งข้อมูลภาพสดเพื่อตรวจจับใบหน้า และดูผลลัพธ์ผ่าน `OutputHandler.ResultListener` ที่ให้ไว้ใน `FaceDetector.FaceDetectorOptions`
void	detectAsync(รูปภาพ MPImage, การประทับเวลายาว Ms) ส่งข้อมูลภาพสดเพื่อตรวจจับใบหน้าด้วยตัวเลือกการประมวลผลรูปภาพเริ่มต้น เช่น
FaceDetectorResult	detectForVideo(รูปภาพ MPImage, ImageProcessingOptions imageProcessingOptions, การประทับเวลายาว) ดำเนินการตรวจจับใบหน้าในเฟรมวิดีโอที่ให้มา
FaceDetectorResult	detectForVideo(รูปภาพ MPImage, timestampMs นาน) ดำเนินการตรวจจับใบหน้าในเฟรมวิดีโอที่ให้มาด้วยตัวเลือกการประมวลผลรูปภาพเริ่มต้น เช่น

วิธีการที่รับช่วงมา

จากคลาส com.google.mediapipe.tasks.vision.core.BaseVisionTaskApi

void	close() ปิดและล้างงานวิสัยทัศน์ของ MediaPipe
คงที่ ยาว	generateResultTimestampMs(RunningMode runningMode, แพ็กเก็ตแพ็กเก็ต) สร้างการประทับเวลาของออบเจ็กต์ผลลัพธ์งาน Vision จากโหมดการเรียกใช้งาน Vision และแพ็กเก็ตเอาต์พุต

จากคลาส java.lang.Object

boolean	เท่ากับ(อาร์กิวเมนต์ออบเจ็กต์)
ขั้นสุดท้าย คลาส<?>	getClass()
int	hashCode()
ขั้นสุดท้าย โมฆะ	notify()
ขั้นสุดท้าย โมฆะ	notifyAll()
String	toString()
ขั้นสุดท้าย โมฆะ	wait(long arg0, int arg1)
ขั้นสุดท้าย โมฆะ	wait(อาร์กิวเมนต์ยาว0)
ขั้นสุดท้าย โมฆะ	รอ()

จากอินเทอร์เฟซ java.lang.AutoCloseable

นามธรรม โมฆะ

close()

วิธีการสาธารณะ

สาธารณะ คงที่ FaceDetector createFromBuffer (บริบทบริบท, ByteBuffer ModelBuffer)

สร้างอินสแตนซ์ FaceDetector จากบัฟเฟอร์โมเดลและ FaceDetector.FaceDetectorOptions เริ่มต้น

พารามิเตอร์

บริบท	Android `ERROR(/Context)`
modelBuffer	`ByteBuffer` โดยตรงหรือ `ERROR(/MappedByteBuffer)` ของโมเดลการตรวจจับ

การขว้าง

	หากเกิดข้อผิดพลาดระหว่างการสร้าง `FaceDetector`

สาธารณะ คงที่ FaceDetector createFromFile (บริบทบริบท, String modelPath)

สร้างอินสแตนซ์ FaceDetector จากไฟล์โมเดลและ FaceDetector.FaceDetectorOptions เริ่มต้น

พารามิเตอร์

บริบท	Android `ERROR(/Context)`
modelPath	ไปยังโมเดลการตรวจจับที่มีข้อมูลเมตาในเนื้อหา

การขว้าง

	หากเกิดข้อผิดพลาดระหว่างการสร้าง `FaceDetector`

สาธารณะ คงที่ FaceDetector createFromFile (บริบทบริบท, ไฟล์ modelFile)

สร้างอินสแตนซ์ FaceDetector จากไฟล์โมเดลและ FaceDetector.FaceDetectorOptions เริ่มต้น

พารามิเตอร์

บริบท	Android `ERROR(/Context)`
modelFile	อินสแตนซ์โมเดลการตรวจจับ `File`

การขว้าง

IOException	หากเกิดข้อผิดพลาด I/O เมื่อเปิดไฟล์โมเดล tflite
	หากเกิดข้อผิดพลาดระหว่างการสร้าง `FaceDetector`

สาธารณะ ภาพนิ่ง FaceDetector createFromOptions (บริบทบริบท, FaceDetector.FaceDetectorOptions DetectorOptions)

สร้างอินสแตนซ์ FaceDetector จาก FaceDetector.FaceDetectorOptions

พารามิเตอร์

บริบท	Android `ERROR(/Context)`
detectorOptions	อินสแตนซ์ `FaceDetector.FaceDetectorOptions`

การขว้าง

	หากเกิดข้อผิดพลาดระหว่างการสร้าง `FaceDetector`

สาธารณะ FaceDetectorResult detect (รูปภาพ MPImage)

ดำเนินการตรวจจับใบหน้าในรูปภาพเดียวที่ให้ไว้ด้วยตัวเลือกการประมวลผลรูปภาพเริ่มต้น กล่าวคือ ไม่ใช้การหมุนใดๆ เลย ใช้วิธีนี้เมื่อมีการสร้าง FaceDetector ด้วย ERROR(/RunningMode.IMAGE) เท่านั้น

FaceDetector รองรับพื้นที่สีประเภทต่อไปนี้

ERROR(/Bitmap.Config.ARGB_8888)

พารามิเตอร์

รูปภาพ	ออบเจ็กต์ MediaPipe `MPImage` สำหรับการประมวลผล

การขว้าง

	ในกรณีที่เกิดข้อผิดพลาดภายใน

สาธารณะ FaceDetectorResult detect (รูปภาพ MPImage, ImageProcessingOptions imageProcessingOptions)

ดำเนินการตรวจจับใบหน้าในรูปภาพเดียวที่ให้ไว้ ใช้วิธีนี้เฉพาะเมื่อมีการสร้าง FaceDetector ด้วย ERROR(/RunningMode.IMAGE) เท่านั้น

FaceDetector รองรับพื้นที่สีประเภทต่อไปนี้

ERROR(/Bitmap.Config.ARGB_8888)

พารามิเตอร์

รูปภาพ ออบเจ็กต์ MediaPipe MPImage สำหรับการประมวลผล

imageProcessingOptions ImageProcessingOptions จะระบุวิธีประมวลผลรูปภาพอินพุตก่อนเรียกใช้การอนุมาน โปรดทราบว่างานนี้ไม่รองรับภูมิภาคที่สนใจ: การระบุ ImageProcessingOptions.regionOfInterest() จะส่งผลให้เมธอดนี้ส่ง IllegalArgumentException

การขว้าง

IllegalArgumentException	หาก `ImageProcessingOptions` ระบุภูมิภาคที่สนใจ
	ในกรณีที่เกิดข้อผิดพลาดภายใน

สาธารณะ void detectAsync (รูปภาพ MPImage, ImageProcessingOptions ตัวเลือกรูปภาพการประมวลผลข้อมูล, การประทับเวลายาว Ms)

ส่งข้อมูลภาพสดเพื่อตรวจจับใบหน้า และดูผลลัพธ์ผ่าน OutputHandler.ResultListener ที่ให้ไว้ใน FaceDetector.FaceDetectorOptions ใช้วิธีนี้เฉพาะเมื่อมีการสร้าง FaceDetector ด้วย ERROR(/RunningMode.LIVE_STREAM) เท่านั้น

ต้องระบุการประทับเวลา (เป็นมิลลิวินาที) เพื่อระบุว่ามีการส่งรูปภาพอินพุตไปยังตัวตรวจจับใบหน้าเมื่อใด การประทับเวลาอินพุตต้องเพิ่มขึ้นแบบโมนาเท่านั้น

FaceDetector รองรับพื้นที่สีประเภทต่อไปนี้

ERROR(/Bitmap.Config.ARGB_8888)

พารามิเตอร์

รูปภาพ	ออบเจ็กต์ MediaPipe `MPImage` สำหรับการประมวลผล
imageProcessingOptions	`ImageProcessingOptions` จะระบุวิธีประมวลผลรูปภาพอินพุตก่อนเรียกใช้การอนุมาน โปรดทราบว่างานนี้ไม่รองรับภูมิภาคที่สนใจ: การระบุ `ImageProcessingOptions.regionOfInterest()` จะส่งผลให้เมธอดนี้ส่ง IllegalArgumentException
timestampMs	การประทับเวลาอินพุต (เป็นมิลลิวินาที)

การขว้าง

IllegalArgumentException	หาก `ImageProcessingOptions` ระบุภูมิภาคที่สนใจ
	ในกรณีที่เกิดข้อผิดพลาดภายใน

สาธารณะ void detectAsync (รูปภาพ MPImage, การประทับเวลายาว Ms)

ส่งข้อมูลภาพสดเพื่อตรวจจับใบหน้าด้วยตัวเลือกการประมวลผลรูปภาพเริ่มต้น กล่าวคือ ไม่ได้ใช้การหมุน และดูผลลัพธ์ผ่าน OutputHandler.ResultListener ที่ให้ไว้ในFaceDetector.FaceDetectorOptions ใช้วิธีนี้เฉพาะเมื่อมีการสร้าง FaceDetector ด้วย ERROR(/RunningMode.LIVE_STREAM) เท่านั้น

FaceDetector รองรับพื้นที่สีประเภทต่อไปนี้

ERROR(/Bitmap.Config.ARGB_8888)

พารามิเตอร์

รูปภาพ	ออบเจ็กต์ MediaPipe `MPImage` สำหรับการประมวลผล
timestampMs	การประทับเวลาอินพุต (เป็นมิลลิวินาที)

การขว้าง

	ในกรณีที่เกิดข้อผิดพลาดภายใน

สาธารณะ FaceDetectorResult detectForVideo (รูปภาพ MPImage ImageProcessingOptions imageProcessingOptions, long timestampMs)

ดำเนินการตรวจจับใบหน้าในเฟรมวิดีโอที่ให้มา ใช้วิธีนี้เฉพาะเมื่อมีการสร้าง FaceDetector ด้วย ERROR(/RunningMode.VIDEO) เท่านั้น

และระบุการประทับเวลาของเฟรมวิดีโอ (เป็นมิลลิวินาที) การประทับเวลาอินพุตต้องเพิ่มขึ้นทีละน้อย

FaceDetector รองรับพื้นที่สีประเภทต่อไปนี้

ERROR(/Bitmap.Config.ARGB_8888)

พารามิเตอร์

รูปภาพ	ออบเจ็กต์ MediaPipe `MPImage` สำหรับการประมวลผล
imageProcessingOptions	`ImageProcessingOptions` จะระบุวิธีประมวลผลรูปภาพอินพุตก่อนเรียกใช้การอนุมาน โปรดทราบว่างานนี้ไม่รองรับภูมิภาคที่สนใจ: การระบุ `ImageProcessingOptions.regionOfInterest()` จะส่งผลให้เมธอดนี้ส่ง IllegalArgumentException
timestampMs	การประทับเวลาอินพุต (เป็นมิลลิวินาที)

การขว้าง

IllegalArgumentException	หาก `ImageProcessingOptions` ระบุภูมิภาคที่สนใจ
	ในกรณีที่เกิดข้อผิดพลาดภายใน

สาธารณะ FaceDetectorResult detectForVideo (MPImage, การประทับเวลายาว Ms)

ดำเนินการตรวจจับใบหน้าในเฟรมวิดีโอที่ระบุด้วยตัวเลือกการประมวลผลรูปภาพเริ่มต้น กล่าวคือ โดยไม่ใช้การหมุน ใช้วิธีนี้เฉพาะเมื่อมีการสร้าง FaceDetector ด้วย ERROR(/RunningMode.VIDEO) เท่านั้น

FaceDetector รองรับพื้นที่สีประเภทต่อไปนี้

ERROR(/Bitmap.Config.ARGB_8888)

พารามิเตอร์

รูปภาพ	ออบเจ็กต์ MediaPipe `MPImage` สำหรับการประมวลผล
timestampMs	การประทับเวลาอินพุต (เป็นมิลลิวินาที)

การขว้าง

	ในกรณีที่เกิดข้อผิดพลาดภายใน