Kryen zbulimin e objekteve në imazhe.
API pret një model TFLite me Metadata të Modelit TFLite. .
API mbështet modelet me një tensor hyrjeje imazhi dhe katër tensorë daljeje. Për të qenë më specifik, këtu janë kërkesat.
- Tenzori hyrës i imazhit (
kTfLiteUInt8/kTfLiteFloat32)- futja e imazhit të madhësisë
[batch x height x width x channels]. - konkluzioni i grupit nuk mbështetet (kërkohet që
batchtë jetë 1). - mbështeten vetëm hyrjet RGB (
channelsduhet të jenë 3). - nëse lloji është
kTfLiteFloat32, NormalizationOptions kërkohet t'i bashkëngjiten meta të dhënave për normalizimin e hyrjes.
- futja e imazhit të madhësisë
DetectionPostProcess , dmth:- Tenzori i vendndodhjes (
kTfLiteFloat32):- tensori i madhësisë
[1 x num_results x 4], grupi i brendshëm që përfaqëson kutitë kufizuese në formën [lart, majtas, djathtas, poshtë]. -
BoundingBoxPropertieskërkohet t'i bashkëngjiten meta të dhënave dhe duhet të specifikojëtype=BOUNDARIESdhecoordinate_type=RATIO.
- tensori i madhësisë
kTfLiteFloat32 ):- tensor i madhësisë
[1 x num_results], secila vlerë përfaqëson indeksin e numrit të plotë të një klase. - nëse hartat e etiketave i bashkëngjiten meta të dhënave si skedarë të lidhur me
TENSOR_VALUE_LABELS, ato përdoren për të kthyer vlerat e tensorit në etiketa.
kTfLiteFloat32 ):- tensor i madhësisë
[1 x num_results], secila vlerë përfaqëson rezultatin e objektit të zbuluar.
kTfLiteFloat32 ):- numër i plotë num_rezultatet si tensor me madhësi
[1].
Një shembull i një modeli të tillë mund të gjendet në TensorFlow Hub. .
Klasat e mbivendosura
| klasës | ObjectDetector.ObjectDetectorOptions | Opsionet për konfigurimin e një ObjectDetector . | |
Metodat publike
| ObjectDetector statik | createFromBuffer (konteksti i kontekstit, ByteBuffer modelBuffer) Krijon një shembull ObjectDetector nga një tampon modeli dhe ObjectDetector.ObjectDetectorOptions . |
| ObjectDetector statik | createFromFile (konteksti i kontekstit, modeli i vargut shteg) Krijon një shembull ObjectDetector nga një skedar modeli dhe ObjectDetector.ObjectDetectorOptions . |
| ObjectDetector statik | createFromFile (konteksti i kontekstit, modeli i skedaritFile ) Krijon një shembull ObjectDetector nga një skedar modeli dhe ObjectDetector.ObjectDetectorOptions . |
| ObjectDetector statik | createFromOptions (konteksti i kontekstit, ObjectDetector.ObjectDetectorOptions detektorOptions) Krijon një shembull ObjectDetector nga një ObjectDetector.ObjectDetectorOptions . |
| Rezultati i Detektorit të Objekteve | |
| Rezultati i Detektorit të Objekteve | zbuloj (imazh MPIimage , ImageProcessingOptions imageProcessingOptions) Kryen zbulimin e objektit në imazhin e vetëm të dhënë. |
| i pavlefshëm | detectAsync (imazh MPImage , ImageProcessingOptions imageProcessingOptions, vula të gjata kohore) Dërgon të dhëna të drejtpërdrejta të imazhit për të kryer zbulimin e objekteve dhe rezultatet do të jenë të disponueshme nëpërmjet OutputHandler.ResultListener të ofruar në ObjectDetector.ObjectDetectorOptions . |
| i pavlefshëm | detectAsync (imazhi i imazhit MPI , stampat e gjata kohore) Dërgon të dhëna të drejtpërdrejta të imazhit për të kryer zbulimin e objekteve me opsionet e paracaktuara të përpunimit të imazhit, dmth |
| Rezultati i Detektorit të Objekteve | detectForVideo (imazh MPIimage , ImageProcessingOptions imageProcessingOptions, vula të gjata kohoreM) Kryen zbulimin e objekteve në kornizën e dhënë të videos. |
| Rezultati i Detektorit të Objekteve | detectForVideo (imazh MPI- imazhi, vula kohore të gjata) Kryen zbulimin e objekteve në kornizën e dhënë të videos me opsionet e paracaktuara të përpunimit të imazhit, dmth |
Metodat e trashëguara
Metodat publike
publik statik ObjectDetector createFromBuffer (konteksti i kontekstit, modeli ByteBuffer )
Krijon një shembull ObjectDetector nga një tampon modeli dhe ObjectDetector.ObjectDetectorOptions .
Parametrat
| kontekst | një ERROR(/Context) në Android. |
|---|---|
| modelBuffer | një ByteBuffer direkt ose një ERROR(/MappedByteBuffer) i modelit të zbulimit. |
Hedhjet
nëse ka një gabim gjatë krijimit të ObjectDetector . |
publik statik ObjectDetector createFromFile (konteksti i kontekstit, modeli i vargut Path)
Krijon një shembull ObjectDetector nga një skedar modeli dhe ObjectDetector.ObjectDetectorOptions .
Parametrat
| kontekst | një ERROR(/Context) në Android. |
|---|---|
| modelRruga | rruga drejt modelit të zbulimit me meta të dhëna në aktive. |
Hedhjet
nëse ka një gabim gjatë krijimit të ObjectDetector . |
publik statik ObjectDetector createFromFile (konteksti i kontekstit, modeli i skedaritFile )
Krijon një shembull ObjectDetector nga një skedar modeli dhe ObjectDetector.ObjectDetectorOptions .
Parametrat
| kontekst | një ERROR(/Context) në Android. |
|---|---|
| modelFile | modeli i zbulimit File skedarit. |
Hedhjet
| Përjashtim IO | nëse ndodh një gabim I/O kur hapet skedari i modelit tflite. |
|---|---|
nëse ka një gabim gjatë krijimit të ObjectDetector . |
publike statike ObjectDetector createFromOptions (konteksti i kontekstit, ObjectDetector.ObjectDetectorOptions detectorOptions)
Krijon një shembull ObjectDetector nga një ObjectDetector.ObjectDetectorOptions .
Parametrat
| kontekst | një ERROR(/Context) në Android. |
|---|---|
| Opsionet e detektorit | një shembull ObjectDetector.ObjectDetectorOptions . |
Hedhjet
nëse ka një gabim gjatë krijimit të ObjectDetector . |
Zbulimi publik i ObjectDetectorResult (imazhi i imazhit MPI )
Kryen zbulimin e objektit në imazhin e vetëm të dhënë me opsionet e paracaktuara të përpunimit të imazhit, dmth pa aplikuar asnjë rrotullim. Përdoreni këtë metodë vetëm kur ObjectDetector është krijuar me ERROR(/RunningMode.IMAGE) .
ObjectDetector mbështet llojet e mëposhtme të hapësirës së ngjyrave:
Parametrat
| imazh | një objekt MediaPipe MPImage për përpunim. |
|---|
Hedhjet
| nëse ka një gabim të brendshëm. |
Zbulimi publik i ObjectDetectorResult (imazhi MPImage , ImageProcessingOptions imageProcessingOptions)
Kryen zbulimin e objektit në imazhin e vetëm të dhënë. Përdoreni këtë metodë vetëm kur ObjectDetector është krijuar me ERROR(/RunningMode.IMAGE) .
ObjectDetector mbështet llojet e mëposhtme të hapësirës së ngjyrave:
Parametrat
| imazh | një objekt MediaPipe MPImage për përpunim. |
|---|---|
| imageProcessingOptions | ImageProcessingOptions duke specifikuar se si të përpunohet imazhi i hyrjes përpara se të ekzekutohet përfundimi. Vini re se rajoni i interesit nuk mbështetet nga kjo detyrë: specifikimi i ImageProcessingOptions.regionOfInterest() do të rezultojë që kjo metodë të hedhë një IllegalArgumentException. |
Hedhjet
| IllegalArgumentPërjashtim | nëse ImageProcessingOptions specifikojnë një rajon me interes. |
|---|---|
| nëse ka një gabim të brendshëm. |
publik void detectAsync (imazh MPImage , ImageProcessingOptions imageProcessingOptions, vula të gjata kohore)
Dërgon të dhëna të drejtpërdrejta të imazhit për të kryer zbulimin e objekteve dhe rezultatet do të jenë të disponueshme nëpërmjet OutputHandler.ResultListener të ofruar në ObjectDetector.ObjectDetectorOptions . Përdoreni këtë metodë vetëm kur ObjectDetector është krijuar me ERROR(/RunningMode.LIVE_STREAM) .
Kërkohet të jepet një vulë kohore (në milisekonda) për të treguar se kur imazhi i hyrjes dërgohet në detektorin e objektit. Vula kohore e hyrjes duhet të rritet në mënyrë monotone.
ObjectDetector mbështet llojet e mëposhtme të hapësirës së ngjyrave:
Parametrat
| imazh | një objekt MediaPipe MPImage për përpunim. |
|---|---|
| imageProcessingOptions | ImageProcessingOptions duke specifikuar se si të përpunohet imazhi i hyrjes përpara se të ekzekutohet përfundimi. Vini re se rajoni i interesit nuk mbështetet nga kjo detyrë: specifikimi i ImageProcessingOptions.regionOfInterest() do të rezultojë që kjo metodë të hedhë një IllegalArgumentException. |
| vula kohoreMs | vulën kohore të hyrjes (në milisekonda). |
Hedhjet
| IllegalArgumentPërjashtim | nëse ImageProcessingOptions specifikojnë një rajon me interes. |
|---|---|
| nëse ka një gabim të brendshëm. |
publik void detectAsync (imazhi i imazhit MPI , stampat e gjata kohore)
Dërgon të dhëna të drejtpërdrejta të imazhit për të kryer zbulimin e objekteve me opsionet e përpunimit të imazhit të paracaktuar, dmth pa asnjë rrotullim të aplikuar, dhe rezultatet do të jenë të disponueshme nëpërmjet OutputHandler.ResultListener të ofruar në ObjectDetector.ObjectDetectorOptions . Përdoreni këtë metodë vetëm kur ObjectDetector është krijuar me ERROR(/RunningMode.LIVE_STREAM) .
Kërkohet të jepet një vulë kohore (në milisekonda) për të treguar se kur imazhi i hyrjes dërgohet në detektorin e objektit. Vula kohore e hyrjes duhet të rritet në mënyrë monotone.
ObjectDetector mbështet llojet e mëposhtme të hapësirës së ngjyrave:
Parametrat
| imazh | një objekt MediaPipe MPImage për përpunim. |
|---|---|
| vula kohoreMs | vulën kohore të hyrjes (në milisekonda). |
Hedhjet
| nëse ka një gabim të brendshëm. |
publik ObjectDetectorResult detectForVideo (imazh MPI- imazhi, ImageProcessingOptions imageProcessingOptions, vula të gjata kohore)
Kryen zbulimin e objekteve në kornizën e dhënë të videos. Përdoreni këtë metodë vetëm kur ObjectDetector është krijuar me ERROR(/RunningMode.VIDEO) .
Kërkohet të jepet vula kohore e kornizës së videos (në milisekonda). Vula kohore e hyrjes duhet të rritet në mënyrë monotone.
ObjectDetector mbështet llojet e mëposhtme të hapësirës së ngjyrave:
Parametrat
| imazh | një objekt MediaPipe MPImage për përpunim. |
|---|---|
| imageProcessingOptions | ImageProcessingOptions duke specifikuar se si të përpunohet imazhi i hyrjes përpara se të ekzekutohet përfundimi. Vini re se rajoni i interesit nuk mbështetet nga kjo detyrë: specifikimi i ImageProcessingOptions.regionOfInterest() do të rezultojë që kjo metodë të hedhë një IllegalArgumentException. |
| vula kohoreMs | vulën kohore të hyrjes (në milisekonda). |
Hedhjet
| IllegalArgumentPërjashtim | nëse ImageProcessingOptions specifikojnë një rajon me interes. |
|---|---|
| nëse ka një gabim të brendshëm. |
publik ObjectDetectorResult detectForVideo (imazh MPI , vula kohore të gjata)
Kryen zbulimin e objekteve në kornizën e dhënë të videos me opsionet e parazgjedhura të përpunimit të imazhit, dmth pa aplikuar asnjë rrotullim. Përdoreni këtë metodë vetëm kur ObjectDetector është krijuar me ERROR(/RunningMode.VIDEO) .
Kërkohet të jepet vula kohore e kornizës së videos (në milisekonda). Vula kohore e hyrjes duhet të rritet në mënyrë monotone.
ObjectDetector mbështet llojet e mëposhtme të hapësirës së ngjyrave:
Parametrat
| imazh | një objekt MediaPipe MPImage për përpunim. |
|---|---|
| vula kohoreMs | vulën kohore të hyrjes (në milisekonda). |
Hedhjet
| nëse ka një gabim të brendshëm. |