Melakukan deteksi objek pada gambar.
API mengharapkan model TFLite dengan Metadata Model TFLite. .
API mendukung model dengan satu tensor masukan gambar dan empat tensor keluaran. Untuk lebih spesifiknya, berikut persyaratannya.
- Tensor gambar masukan (
kTfLiteUInt8
/kTfLiteFloat32
)- masukan gambar dengan ukuran
[batch x height x width x channels]
. - inferensi batch tidak didukung (
batch
harus 1). - hanya input RGB yang didukung (
channels
harus ada 3). - jika tipenya adalah
kTfLiteFloat32
, NormalizationOptions harus dilampirkan ke metadata untuk normalisasi input.
- masukan gambar dengan ukuran
DetectionPostProcess
, yaitu:- Tensor lokasi (
kTfLiteFloat32
):- tensor berukuran
[1 x num_results x 4]
, array bagian dalam mewakili kotak pembatas dalam bentuk [atas, kiri, kanan, bawah]. -
BoundingBoxProperties
harus dilampirkan ke metadata dan harus menentukantype=BOUNDARIES
dancoordinate_type=RATIO
.
- tensor berukuran
kTfLiteFloat32
):- tensor berukuran
[1 x num_results]
, setiap nilai mewakili indeks bilangan bulat suatu kelas. - jika peta label dilampirkan ke metadata sebagai file terkait
TENSOR_VALUE_LABELS
, peta tersebut digunakan untuk mengonversi nilai tensor menjadi label.
kTfLiteFloat32
):- tensor berukuran
[1 x num_results]
, masing-masing nilai mewakili skor objek yang terdeteksi.
kTfLiteFloat32
):- integer num_results sebagai tensor ukuran
[1]
.
Contoh model tersebut dapat ditemukan di TensorFlow Hub. .
Kelas Bersarang
kelas | ObjectDetector.ObjectDetectorOptions | Opsi untuk menyiapkan ObjectDetector. |
Metode Publik
Metode Warisan
Metode Publik
ObjectDetector statis publik createFromBuffer ( ByteBuffer modelBuffer)
Membuat instance ObjectDetector
dengan buffer model dan ObjectDetector.ObjectDetectorOptions
default.
Parameter
modelBuffer | ByteBuffer langsung atau MappedByteBuffer dari model deteksi |
---|
Melempar
Pengecualian Argumen Ilegal | jika buffer model bukan ByteBuffer langsung atau MappedByteBuffer * @throws IllegalStateException jika ada kesalahan internal |
---|---|
Pengecualian Waktu Proses | jika ada kesalahan yang tidak ditentukan |
public static ObjectDetector createFromBufferAndOptions ( Opsi ByteBuffer modelBuffer, ObjectDetector.ObjectDetectorOptions )
Membuat instance ObjectDetector
dengan buffer model dan ObjectDetector.ObjectDetectorOptions
.
Parameter
modelBuffer | ByteBuffer langsung atau MappedByteBuffer dari model deteksi |
---|---|
pilihan |
Melempar
Pengecualian Argumen Ilegal | jika buffer model bukan ByteBuffer langsung atau MappedByteBuffer |
---|---|
IlegalStateException | jika ada kesalahan internal |
Pengecualian Waktu Proses | jika ada kesalahan yang tidak ditentukan |
public static ObjectDetector createFromFile (Konteks konteks, String modelPath)
Membuat instance ObjectDetector
dari ObjectDetector.ObjectDetectorOptions
default.
Parameter
konteks | |
---|---|
modelPath | jalur ke model deteksi dengan metadata di aset |
Melempar
Pengecualian IO | jika terjadi kesalahan I/O saat memuat model tflite |
---|---|
Pengecualian Argumen Ilegal | jika suatu argumen tidak valid |
IlegalStateException | jika ada kesalahan internal |
Pengecualian Waktu Proses | jika ada kesalahan yang tidak ditentukan |
ObjectDetector statis publik createFromFile ( File modelFile)
Membuat instance ObjectDetector
dari ObjectDetector.ObjectDetectorOptions
default.
Parameter
file model | contoh File model deteksi |
---|
Melempar
Pengecualian IO | jika terjadi kesalahan I/O saat memuat model tflite |
---|---|
Pengecualian Argumen Ilegal | jika suatu argumen tidak valid |
IlegalStateException | jika ada kesalahan internal |
Pengecualian Waktu Proses | jika ada kesalahan yang tidak ditentukan |
public static ObjectDetector createFromFileAndOptions (Konteks konteks, String modelPath, opsi ObjectDetector.ObjectDetectorOptions )
Membuat instance ObjectDetector
dari ObjectDetector.ObjectDetectorOptions
.
Parameter
konteks | |
---|---|
modelPath | jalur ke model deteksi dengan metadata di aset |
pilihan |
Melempar
Pengecualian IO | jika terjadi kesalahan I/O saat memuat model tflite |
---|---|
Pengecualian Argumen Ilegal | jika suatu argumen tidak valid |
IlegalStateException | jika ada kesalahan internal |
Pengecualian Waktu Proses | jika ada kesalahan yang tidak ditentukan |
public static ObjectDetector createFromFileAndOptions ( File modelFile, opsi ObjectDetector.ObjectDetectorOptions )
Membuat instance ObjectDetector
dari ObjectDetector.ObjectDetectorOptions
.
Parameter
file model | contoh File model deteksi |
---|---|
pilihan |
Melempar
Pengecualian IO | jika terjadi kesalahan I/O saat memuat model tflite |
---|---|
Pengecualian Argumen Ilegal | jika suatu argumen tidak valid |
IlegalStateException | jika ada kesalahan internal |
Pengecualian Waktu Proses | jika ada kesalahan yang tidak ditentukan |
Daftar publik <Deteksi> deteksi (gambar MlImage )
Melakukan deteksi aktual pada MlImage
yang disediakan.
Parameter
gambar | objek MlImage yang mewakili gambar |
---|
Melempar
IlegalStateException | jika ada kesalahan internal |
---|---|
Pengecualian Waktu Proses | jika ada kesalahan yang tidak ditentukan |
Pengecualian Argumen Ilegal | jika jenis penyimpanan atau format gambar tidak didukung |
Daftar publik <Deteksi> deteksi (gambar TensorImage , opsi ImageProcessingOptions )
Melakukan deteksi aktual pada gambar yang disediakan.
ObjectDetector
mendukung tipe ruang warna TensorImage
berikut:
ObjectDetector
mendukung opsi berikut:
- rotasi gambar (melalui
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
). Standarnya adalahImageProcessingOptions.Orientation.TOP_LEFT
.
Parameter
gambar | objek TensorImage UINT8 yang mewakili gambar RGB atau YUV |
---|---|
pilihan | opsi untuk mengonfigurasi cara melakukan praproses gambar |
Melempar
IlegalStateException | jika ada kesalahan internal |
---|---|
Pengecualian Waktu Proses | jika ada kesalahan yang tidak ditentukan |
Pengecualian Argumen Ilegal | jika jenis ruang warna gambar tidak didukung |
Daftar publik <Deteksi> deteksi (gambar MlImage , opsi ImageProcessingOptions )
Melakukan deteksi aktual pada MlImage
yang disediakan dengan ImageProcessingOptions
.
ObjectDetector
mendukung opsi berikut:
- rotasi gambar (melalui
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
). Standarnya adalahImageProcessingOptions.Orientation.TOP_LEFT
.MlImage.getRotation()
tidak efektif.
Parameter
gambar | objek MlImage yang mewakili gambar |
---|---|
pilihan | opsi untuk mengonfigurasi cara melakukan praproses gambar |
Melempar
IlegalStateException | jika ada kesalahan internal |
---|---|
Pengecualian Waktu Proses | jika ada kesalahan yang tidak ditentukan |
Pengecualian Argumen Ilegal | jika jenis penyimpanan atau format gambar tidak didukung |
Daftar publik <Deteksi> deteksi (gambar TensorImage )
Melakukan deteksi aktual pada gambar yang disediakan.
ObjectDetector
mendukung tipe ruang warna TensorImage
berikut:
Parameter
gambar | objek TensorImage UINT8 yang mewakili gambar RGB atau YUV |
---|
Melempar
IlegalStateException | jika ada kesalahan internal |
---|---|
Pengecualian Waktu Proses | jika ada kesalahan yang tidak ditentukan |
Pengecualian Argumen Ilegal | jika jenis ruang warna gambar tidak didukung |