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

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

HandLandmarker

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

ตรวจหาจุดสังเกตในรูปภาพ

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

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

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

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

ช่อง

สาธารณะ static สุดท้าย Set<Connection>	HAND_CONNECTIONS
สาธารณะ static สุดท้าย Set<Connection>	HAND_INDEX_FINGER_CONNECTIONS
สาธารณะ static สุดท้าย Set<Connection>	HAND_MIDDLE_FINGER_CONNECTIONS
สาธารณะ static สุดท้าย Set<Connection>	HAND_PALM_CONNECTIONS
สาธารณะ static สุดท้าย Set<Connection>	HAND_PINKY_FINGER_CONNECTIONS
สาธารณะ static สุดท้าย Set<Connection>	HAND_RING_FINGER_CONNECTIONS
สาธารณะ static สุดท้าย Set<Connection>	HAND_THUMB_CONNECTIONS

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

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

ช่อง

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

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

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

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

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

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

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

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

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

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

พารามิเตอร์

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

การขว้าง

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

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

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

พารามิเตอร์

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

การขว้าง

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

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

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

พารามิเตอร์

บริบท	Android `ERROR(/Context)`
modelFile	อินสแตนซ์ของแฮนด์แลนด์มาร์ก `File`

การขว้าง

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

สาธารณะ คงที่ HandLandmarker createFromOptions (บริบทบริบท, HandLandmarker.HandLandmarkerOptions จุดสังเกตerOptions)

สร้างอินสแตนซ์ HandLandmarker จาก HandLandmarker.HandLandmarkerOptions

พารามิเตอร์

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

การขว้าง

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

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

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

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

ERROR(/Bitmap.Config.ARGB_8888)

พารามิเตอร์

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

การขว้าง

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

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

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

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

ERROR(/Bitmap.Config.ARGB_8888)

พารามิเตอร์

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

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

การขว้าง

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

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

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

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

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

ERROR(/Bitmap.Config.ARGB_8888)

พารามิเตอร์

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

การขว้าง

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

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

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

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

ERROR(/Bitmap.Config.ARGB_8888)

พารามิเตอร์

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

การขว้าง

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

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

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

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

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

ERROR(/Bitmap.Config.ARGB_8888)

พารามิเตอร์

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

การขว้าง

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

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

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

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

ERROR(/Bitmap.Config.ARGB_8888)

พารามิเตอร์

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

การขว้าง

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