ดำเนินการตรวจจับวัตถุบนภาพ
API คาดว่าจะมีโมเดล TFLite พร้อมด้วย ข้อมูลเมตาของโมเดล TFLite .
API รองรับโมเดลที่มีเทนเซอร์อินพุตรูปภาพหนึ่งตัวและเทนเซอร์เอาท์พุตสี่ตัว เพื่อให้เจาะจงยิ่งขึ้น นี่คือข้อกำหนด
- อินพุตอิมเมจเทนเซอร์ (
kTfLiteUInt8
/kTfLiteFloat32
)- อินพุตรูปภาพขนาด
[batch x height x width x channels]
- ไม่รองรับการอนุมานแบบแบตช์ (
batch
ต้องเป็น 1) - รองรับเฉพาะอินพุต RGB (
channels
ต้องเป็น 3) - หากประเภทเป็น
kTfLiteFloat32
จำเป็นต้องแนบ NormalizationOptions กับข้อมูลเมตาเพื่อทำให้อินพุตเป็นมาตรฐาน
- อินพุตรูปภาพขนาด
DetectionPostProcess
op เช่น:- เทนเซอร์ตำแหน่ง (
kTfLiteFloat32
):- เทนเซอร์ขนาด
[1 x num_results x 4]
อาร์เรย์ภายในที่แสดงถึงกล่องขอบเขตในรูปแบบ [บน ซ้าย ขวา ล่าง] - จำเป็นต้องแนบ
BoundingBoxProperties
กับข้อมูลเมตา และต้องระบุtype=BOUNDARIES
และcoordinate_type=RATIO
- เทนเซอร์ขนาด
kTfLiteFloat32
):- เทนเซอร์ขนาด
[1 x num_results]
แต่ละค่าแสดงถึงดัชนีจำนวนเต็มของคลาส - หากแนบแผนผังป้ายกำกับกับข้อมูลเมตาเป็นไฟล์ที่เกี่ยวข้อง
TENSOR_VALUE_LABELS
ก็จะใช้ในการแปลงค่าเทนเซอร์ให้เป็นป้ายกำกับ
kTfLiteFloat32
):- เทนเซอร์ขนาด
[1 x num_results]
แต่ละค่าแสดงถึงคะแนนของวัตถุที่ตรวจพบ
kTfLiteFloat32
):- จำนวนเต็ม num_results เป็นเมตริกซ์ขนาด
[1]
ตัวอย่างของโมเดลดังกล่าวมีอยู่ใน TensorFlow Hub .
คลาสที่ซ้อนกัน
ระดับ | ObjectDetector.ObjectDetectorOptions | ตัวเลือกสำหรับการตั้งค่า ObjectDetector |
วิธีการสาธารณะ
วิธีการสืบทอด
วิธีการสาธารณะ
ObjectDetector แบบคงที่สาธารณะ createFromBuffer ( ByteBuffer modelBuffer)
สร้างอินสแตนซ์ ObjectDetector
ด้วยบัฟเฟอร์โมเดลและ ObjectDetector.ObjectDetectorOptions
เริ่มต้น
พารามิเตอร์
modelBuffer | ByteBuffer โดยตรงหรือ MappedByteBuffer ของโมเดลการตรวจจับ |
---|
ขว้าง
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย | หากบัฟเฟอร์โมเดลไม่ใช่ ByteBuffer โดยตรงหรือ MappedByteBuffer * @throws IllegalStateException หากมีข้อผิดพลาดภายใน |
---|---|
RuntimeException | หากมีข้อผิดพลาดที่ไม่ได้ระบุเป็นอย่างอื่น |
ObjectDetector แบบคงที่สาธารณะ createFromBufferAndOptions (ตัวเลือก ByteBuffer modelBuffer, ObjectDetector.ObjectDetectorOptions )
สร้างอินสแตนซ์ ObjectDetector
ด้วยบัฟเฟอร์โมเดลและ ObjectDetector.ObjectDetectorOptions
พารามิเตอร์
modelBuffer | ByteBuffer โดยตรงหรือ MappedByteBuffer ของโมเดลการตรวจจับ |
---|---|
ตัวเลือก |
ขว้าง
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย | หากบัฟเฟอร์โมเดลไม่ใช่ ByteBuffer โดยตรงหรือ MappedByteBuffer |
---|---|
IllegalStateException | หากมีข้อผิดพลาดภายใน |
RuntimeException | หากมีข้อผิดพลาดที่ไม่ได้ระบุเป็นอย่างอื่น |
ObjectDetector แบบคงที่สาธารณะ createFromFile (บริบทบริบท, String modelPath)
สร้างอินสแตนซ์ ObjectDetector
จาก ObjectDetector.ObjectDetectorOptions
เริ่มต้น
พารามิเตอร์
บริบท | |
---|---|
โมเดลพาธ | เส้นทางไปยังโมเดลการตรวจจับพร้อมข้อมูลเมตาในเนื้อหา |
ขว้าง
IOข้อยกเว้น | หากมีข้อผิดพลาด I/O เกิดขึ้นเมื่อโหลดโมเดล tflite |
---|---|
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย | ถ้าอาร์กิวเมนต์ไม่ถูกต้อง |
IllegalStateException | หากมีข้อผิดพลาดภายใน |
RuntimeException | หากมีข้อผิดพลาดที่ไม่ได้ระบุเป็นอย่างอื่น |
ObjectDetector แบบคงที่สาธารณะ createFromFile ( ไฟล์ modelFile)
สร้างอินสแตนซ์ ObjectDetector
จาก ObjectDetector.ObjectDetectorOptions
เริ่มต้น
พารามิเตอร์
modelFile | อินสแตนซ์ File โมเดลการตรวจจับ |
---|
ขว้าง
IOข้อยกเว้น | หากมีข้อผิดพลาด I/O เกิดขึ้นเมื่อโหลดโมเดล tflite |
---|---|
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย | ถ้าอาร์กิวเมนต์ไม่ถูกต้อง |
IllegalStateException | หากมีข้อผิดพลาดภายใน |
RuntimeException | หากมีข้อผิดพลาดที่ไม่ได้ระบุเป็นอย่างอื่น |
ObjectDetector แบบคงที่สาธารณะ createFromFileAndOptions (บริบทบริบท ตัวเลือก modelPath สตริง ตัว เลือก ObjectDetector.ObjectDetectorOptions )
สร้างอินสแตนซ์ ObjectDetector
จาก ObjectDetector.ObjectDetectorOptions
พารามิเตอร์
บริบท | |
---|---|
โมเดลพาธ | เส้นทางไปยังโมเดลการตรวจจับพร้อมข้อมูลเมตาในเนื้อหา |
ตัวเลือก |
ขว้าง
IOข้อยกเว้น | หากมีข้อผิดพลาด I/O เกิดขึ้นเมื่อโหลดโมเดล tflite |
---|---|
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย | ถ้าอาร์กิวเมนต์ไม่ถูกต้อง |
IllegalStateException | หากมีข้อผิดพลาดภายใน |
RuntimeException | หากมีข้อผิดพลาดที่ไม่ได้ระบุเป็นอย่างอื่น |
ObjectDetector แบบคงที่สาธารณะ createFromFileAndOptions (ตัวเลือก ไฟล์ modelFile, ObjectDetector.ObjectDetectorOptions )
สร้างอินสแตนซ์ ObjectDetector
จาก ObjectDetector.ObjectDetectorOptions
พารามิเตอร์
modelFile | อินสแตนซ์ File โมเดลการตรวจจับ |
---|---|
ตัวเลือก |
ขว้าง
IOข้อยกเว้น | หากมีข้อผิดพลาด I/O เกิดขึ้นเมื่อโหลดโมเดล tflite |
---|---|
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย | ถ้าอาร์กิวเมนต์ไม่ถูกต้อง |
IllegalStateException | หากมีข้อผิดพลาดภายใน |
RuntimeException | หากมีข้อผิดพลาดที่ไม่ได้ระบุเป็นอย่างอื่น |
รายการ สาธารณะ < การตรวจจับ > ตรวจจับ (ภาพ MlImage )
ดำเนินการตรวจจับจริงบน MlImage
ที่ให้มา
พารามิเตอร์
ภาพ | วัตถุ MlImage ที่แสดงถึงรูปภาพ |
---|
ขว้าง
IllegalStateException | หากมีข้อผิดพลาดภายใน |
---|---|
RuntimeException | หากมีข้อผิดพลาดที่ไม่ได้ระบุเป็นอย่างอื่น |
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย | หากไม่รองรับประเภทการจัดเก็บหรือรูปแบบของรูปภาพ |
รายการ สาธารณะ < การตรวจจับ > ตรวจจับ (รูปภาพ TensorImage , ตัวเลือก ImageProcessingOptions )
ทำการตรวจจับจริงบนภาพที่ให้มา
ObjectDetector
รองรับประเภทพื้นที่สี TensorImage
ต่อไปนี้:
ObjectDetector
รองรับตัวเลือกต่อไปนี้:
- การหมุนภาพ (ผ่าน
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
) โดยค่าเริ่มต้นจะเป็นImageProcessingOptions.Orientation.TOP_LEFT
พารามิเตอร์
ภาพ | วัตถุ UINT8 TensorImage ที่แสดงภาพ RGB หรือ YUV |
---|---|
ตัวเลือก | ตัวเลือกในการกำหนดค่าวิธีประมวลผลภาพล่วงหน้า |
ขว้าง
IllegalStateException | หากมีข้อผิดพลาดภายใน |
---|---|
RuntimeException | หากมีข้อผิดพลาดที่ไม่ได้ระบุเป็นอย่างอื่น |
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย | หากไม่รองรับประเภทปริภูมิสีของรูปภาพ |
รายการ สาธารณะ < การตรวจจับ > ตรวจจับ (รูปภาพ MlImage , ตัวเลือก ImageProcessingOptions )
ดำเนินการตรวจจับจริงบน MlImage
ที่ให้มาพร้อมกับ ImageProcessingOptions
ObjectDetector
รองรับตัวเลือกต่อไปนี้:
- การหมุนภาพ (ผ่าน
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
) โดยค่าเริ่มต้นจะเป็นImageProcessingOptions.Orientation.TOP_LEFT
MlImage.getRotation()
ไม่มีประสิทธิผล
พารามิเตอร์
ภาพ | วัตถุ MlImage ที่แสดงถึงรูปภาพ |
---|---|
ตัวเลือก | ตัวเลือกในการกำหนดค่าวิธีประมวลผลภาพล่วงหน้า |
ขว้าง
IllegalStateException | หากมีข้อผิดพลาดภายใน |
---|---|
RuntimeException | หากมีข้อผิดพลาดที่ไม่ได้ระบุเป็นอย่างอื่น |
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย | หากไม่รองรับประเภทการจัดเก็บหรือรูปแบบของรูปภาพ |
รายการ สาธารณะ < การตรวจจับ > ตรวจจับ (ภาพ TensorImage )
ทำการตรวจจับจริงบนภาพที่ให้มา
ObjectDetector
รองรับประเภทพื้นที่สี TensorImage
ต่อไปนี้:
พารามิเตอร์
ภาพ | วัตถุ UINT8 TensorImage ที่แสดงภาพ RGB หรือ YUV |
---|
ขว้าง
IllegalStateException | หากมีข้อผิดพลาดภายใน |
---|---|
RuntimeException | หากมีข้อผิดพลาดที่ไม่ได้ระบุเป็นอย่างอื่น |
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย | หากไม่รองรับประเภทปริภูมิสีของรูปภาพ |