ดูข้อมูลเพิ่มเติมเกี่ยวกับประกาศจาก I/O ของ Google AI Edge

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

FaceLandmarker

คลาสสุดท้ายสาธารณะ FaceLandmarker

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

API นี้คาดหวังแพ็กเกจเนื้อหารูปแบบจุดสังเกตของใบหน้าก่อนฝึก โปรดดู

รูปภาพอินพุต MPImage
- รูปภาพที่การตรวจจับจุดสังเกตใบหน้าทำงาน
เอาต์พุต FaceLandmarkerResult
- FaceLandmarkerผลลัพธ์ ที่มีจุดสังเกตของใบหน้า

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

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

ช่อง

สาธารณะ static สุดท้าย Set<Connection>	FACE_LANDMARKS_CONNECTORS
สาธารณะ static สุดท้าย Set<Connection>	FACE_LANDMARKS_FACE_OVAL
สาธารณะ static สุดท้าย Set<Connection>	FACE_LANDMARKS_LEFT_EYE
สาธารณะ static สุดท้าย Set<Connection>	FACE_LANDMARKS_LEFT_EYE_BROW
สาธารณะ static สุดท้าย Set<Connection>	FACE_LANDMARKS_LEFT_IRIS
สาธารณะ static สุดท้าย Set<Connection>	FACE_LANDMARKS_LIPS
สาธารณะ static สุดท้าย Set<Connection>	FACE_LANDMARKS_RIGHT_EYE
สาธารณะ static สุดท้าย Set<Connection>	FACE_LANDMARKS_RIGHT_EYE_BROW
สาธารณะ static สุดท้าย Set<Connection>	FACE_LANDMARKS_RIGHT_IRIS
สาธารณะ static สุดท้าย Set<Connection>	FACE_LANDMARKS_TESSELATION

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

ภาพนิ่ง FaceLandmarker	createFromBuffer(บริบทบริบท, ByteBuffer modelAssetBuffer) สร้างอินสแตนซ์ `FaceLandmarker` จากบัฟเฟอร์แพ็กเกจชิ้นงานโมเดลและ `FaceLandmarker.FaceLandmarkerOptions` เริ่มต้น
ภาพนิ่ง FaceLandmarker	createFromFile(บริบทบริบท, สตริง modelAssetPath) สร้างอินสแตนซ์ `FaceLandmarker` จากเส้นทางแพ็กเกจชิ้นงานโมเดลและ `FaceLandmarker.FaceLandmarkerOptions` เริ่มต้น
ภาพนิ่ง FaceLandmarker	createFromFile(บริบทบริบท, ไฟล์ modelAssetFile) สร้างอินสแตนซ์ `FaceLandmarker` จากไฟล์แพ็กเกจชิ้นงานโมเดลและ `FaceLandmarker.FaceLandmarkerOptions` เริ่มต้น
ภาพนิ่ง FaceLandmarker	createFromOptions(บริบทบริบท, FaceLandmarker.FaceLandmarkerOptionsจุดสังเกต) สร้างอินสแตนซ์ `FaceLandmarker` จาก `FaceLandmarker.FaceLandmarkerOptions`
FaceLandmarkerResult	detect(รูปภาพ MPImage) ตรวจหาจุดสังเกตของใบหน้าในรูปภาพเดียวที่ให้มาด้วยตัวเลือกการประมวลผลรูปภาพเริ่มต้น กล่าวคือ
FaceLandmarkerResult	detect(รูปภาพ MPImage, ImageProcessingOptions imageProcessingOptions) ดำเนินการตรวจหาจุดสังเกตของใบหน้าในรูปภาพเดียวที่ให้ไว้
void	detectAsync(รูปภาพ MPImage, ImageProcessingOptions imageProcessingOptions, การประทับเวลายาว) ส่งข้อมูลรูปภาพสดเพื่อตรวจจับจุดสังเกตของใบหน้า และดูผลการค้นหาผ่าน`OutputHandler.ResultListener`ซึ่งระบุไว้ที่`FaceLandmarker.FaceLandmarkerOptions`
void	detectAsync(รูปภาพ MPImage, การประทับเวลายาว Ms) ส่งข้อมูลรูปภาพสดเพื่อตรวจจับจุดสังเกตของใบหน้าด้วยตัวเลือกการประมวลผลรูปภาพเริ่มต้น เช่น
FaceLandmarkerResult	detectForVideo(รูปภาพ MPImage, ImageProcessingOptions imageProcessingOptions, การประทับเวลายาว) ดำเนินการตรวจจับจุดสังเกตของใบหน้าในเฟรมวิดีโอที่ให้มา
FaceLandmarkerResult	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()

ช่อง

สาธารณะ คงที่ สุดท้าย ตั้งค่า<การเชื่อมต่อ> FACE_LANDMARKS_CONNECTORS

สาธารณะ คงที่ สุดท้าย ตั้งค่า<การเชื่อมต่อ> FACE_LANDMARKS_FACE_OVAL

สาธารณะ คงที่ สุดท้าย ตั้งค่า<การเชื่อมต่อ> FACE_LANDMARKS_LEFT_EYE

สาธารณะ คงที่ สุดท้าย ตั้งค่า<การเชื่อมต่อ> FACE_LANDMARKS_LEFT_EYE_BROW

สาธารณะ คงที่ สุดท้าย ตั้งค่า<การเชื่อมต่อ> FACE_LANDMARKS_LEFT_IRIS

สาธารณะ คงที่ สุดท้าย ตั้งค่า<การเชื่อมต่อ> FACE_LANDMARKS_LIPS

สาธารณะ คงที่ สุดท้าย ตั้งค่า<การเชื่อมต่อ> FACE_LANDMARKS_RIGHT_EYE

สาธารณะ คงที่ สุดท้าย ตั้งค่า<การเชื่อมต่อ> FACE_LANDMARKS_RIGHT_EYE_BROW

สาธารณะ คงที่ สุดท้าย ตั้งค่า<การเชื่อมต่อ> FACE_LANDMARKS_RIGHT_IRIS

สาธารณะ คงที่ ขั้นสุดท้าย ตั้งค่า<การเชื่อมต่อ> FACE_LANDMARKS_TESSELATION

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

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

สร้างอินสแตนซ์ FaceLandmarker จากบัฟเฟอร์แพ็กเกจชิ้นงานโมเดลและ FaceLandmarker.FaceLandmarkerOptions เริ่มต้น

พารามิเตอร์

บริบท	Android `ERROR(/Context)`
modelAssetBuffer

การขว้าง

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

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

สร้างอินสแตนซ์ FaceLandmarker จากเส้นทางแพ็กเกจชิ้นงานโมเดลและ FaceLandmarker.FaceLandmarkerOptions เริ่มต้น

พารามิเตอร์

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

การขว้าง

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

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

สร้างอินสแตนซ์ FaceLandmarker จากไฟล์แพ็กเกจชิ้นงานโมเดลและ FaceLandmarker.FaceLandmarkerOptions เริ่มต้น

พารามิเตอร์

บริบท	Android `ERROR(/Context)`
modelAssetFile	อินสแตนซ์ของรูปแบบจุดสังเกต `File`

การขว้าง

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

สาธารณะ คงที่ FaceLandmarker createFromOptions (บริบทบริบท, FaceLandmarker.FaceLandmarkerOptions} mainerOptions)

สร้างอินสแตนซ์ FaceLandmarker จาก FaceLandmarker.FaceLandmarkerOptions

พารามิเตอร์

บริบท	Android `ERROR(/Context)`
landmarkerOptions	อินสแตนซ์ `FaceLandmarker.FaceLandmarkerOptions`

การขว้าง

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

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

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

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

ERROR(/Bitmap.Config.ARGB_8888)

พารามิเตอร์

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

การขว้าง

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

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

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

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

ERROR(/Bitmap.Config.ARGB_8888)

พารามิเตอร์

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

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

การขว้าง

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

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

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

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

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

ERROR(/Bitmap.Config.ARGB_8888)

พารามิเตอร์

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

การขว้าง

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

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

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

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

ERROR(/Bitmap.Config.ARGB_8888)

พารามิเตอร์

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

การขว้าง

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

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

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

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

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

ERROR(/Bitmap.Config.ARGB_8888)

พารามิเตอร์

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

การขว้าง

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

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

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

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

ERROR(/Bitmap.Config.ARGB_8888)

พารามิเตอร์

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

การขว้าง

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