Runtime v2.81 · Na-update noong Set 30, 2026

TfliteModel

TFLite model handle for scripts.

Syntax

TfliteModel(model)

Mga parameter ng constructor

PangalanPaglalarawan
modelString
Model reference to use for inference (prefer template model name).
Kailangan · Ayon sa posisyon o pangalan
Walang default

Ibinabalik na halaga

TfliteModel

Pagkilos / epekto

TFLite model handle for scripts. The model type must be selected in Template Manager metadata. Supported outputs are YOLOv8/YOLO11 object detection [1,N,4+C]/[1,4+C,N], YOLO26 end-to-end detection [1,N,6]/[N,6], YOLO11/YOLO26 image classification [1,C], and MobileNetV3 image classification [1,C]. Runtime detects FLOAT32, INT8, or UINT8 tensor precision from the model and dequantizes quantized detection and classification outputs before applying thresholds. Classification matches return class confidence and metadata without point or bounds. Inference methods require a local model file; when local file is missing and runtime download fails, script raises a runtime error.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

# Suriin kung available ang model bago magpatakbo ng detection
if TfliteModel.exists("enemy_model"):
    detector = TfliteModel("enemy_model")
    hits = detector.inference()
    if len(hits) > 0:
        click(hits[0])

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

Wala

Mga field

PangalanPaglalarawan
modelString
Model reference in current macro (prefer template model name; legacy model id still accepted).
resize_modeString
Resolved preprocessing resize mode: LETTERBOX, STRETCH, or CROP_CENTER.
Default: LETTERBOX
color_modeString
Resolved preprocessing color mode: RGB, BGR, or GRAYSCALE.
Default: RGB
norm_modeString
Resolved preprocessing normalization: ZERO_ONE, MINUS_ONE_ONE, IMAGENET, or CUSTOM.
Default: ZERO_ONE
padding_colorInt
Padding fill value (0 -> 255) used by LETTERBOX resize mode.
Default: 114
Halimbawa ng constructor
# Mag-import ng suportadong TFLite model at piliin ang uri ng output sa Template Manager.
# Gumawa ng model handle na nakakabit sa isang pangalan ng TFLite model sa Template Manager.
model = TfliteModel("enemy_model")

Mga method

4 method

TfliteModel.exists

Suriin kung ang isang lokal na TFLite model file (nalutas sa pamamagitan ng pangalan ng modelo o legacy id) ay kasalukuyang available sa macro na ito.

Syntax

TfliteModel.exists(model)

Mga parameter

PangalanPaglalarawan
modelString
Model reference to check.
Kailangan · Ayon sa posisyon o pangalan
Walang default

Ibinabalik na halaga

Boolean — true kung handa nang gamitin ang file ng lokal na modelo.

Pagkilos / epekto

Suriin kung ang isang lokal na TFLite model file (nalutas sa pamamagitan ng pangalan ng modelo o legacy id) ay kasalukuyang available sa macro na ito.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

# Tingnan kung may model na na-import sa Template Manager
if TfliteModel.exists("enemy_detector"):
    print("Model available")

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

TfliteModel.list

Ibalik ang mga lokal na modelong reference na kasalukuyang available para sa macro (mas gusto ang mga display name).

Syntax

TfliteModel.list()

Mga parameter

Wala

Ibinabalik na halaga

list[String] — Listahan ng sanggunian ng modelo.

Pagkilos / epekto

Ibalik ang mga lokal na modelong reference na kasalukuyang available para sa macro (mas gusto ang mga display name).

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

# Ilista ang mga model na magagamit ng macro na ito
print(TfliteModel.list())

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

TfliteModel.exists

Tingnan kung available ang file ng lokal na modelo ng detector na ito.

Syntax

model.exists()

Mga parameter

Wala

Ibinabalik na halaga

Boolean — true kung magagamit kaagad ang file ng lokal na modelo.

Pagkilos / epekto

Tingnan kung available ang file ng lokal na modelo ng detector na ito.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

# Gumawa lamang kapag nakumpirmang naroon ang na-import na model
if TfliteModel.exists("enemy_detector"):
    model = TfliteModel("enemy_detector")
    print(model.exists())

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

TfliteModel.inference

Patakbuhin ang napiling modelo ng TFLite nang walang pag-filter ng klase at ibalik ang lahat ng mga tugma.

Syntax

model.inference(threshold=0.5, region=None, max_results=8, debug=False)

Mga parameter

PangalanPaglalarawan
thresholdNumber
Confidence threshold in 0 -> 1.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0.5
regionRegion?
Optional screen region. Its image is cropped before preprocessing and inference, which can reduce accuracy if the model was not trained on similarly cropped images.
Opsyonal · Ayon sa posisyon o pangalan
Default: None
max_resultsInt
Maximum number of detections returned.
Opsyonal · Ayon sa posisyon o pangalan
Default: 8
debugBoolean
In Edit mode, true saves a preprocess preview and opens the runtime debug dialog. Run-only mode ignores the debug output and performs normal inference without a dialog. Detailed model-result rows and preprocess config stay in the dialog; returned Match objects do not include debug_result. Detection previews draw bbox/class labels; classification previews show the preprocessed input plus class scores.
Opsyonal · Ayon sa posisyon o pangalan
Default: False

Ibinabalik na halaga

MatchList — Listahan ng mga tugma ng hinuha sa lahat ng klase.

Pagkilos / epekto

Patakbuhin ang napiling modelo ng TFLite nang walang pag-filter ng klase at ibalik ang lahat ng mga tugma. Kapag ang rehiyon ay ibinigay, ang screen na imahe nito ay na-crop bago ang preprocessing at inference; maaari nitong bawasan ang katumpakan ng modelo kung ang modelo ay hindi sinanay sa mga katulad na na-crop na larawan. Ang mga tugma sa pag-uuri ay walang punto o hangganan.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

# Patakbuhin ang raw model inference at tingnan ang preprocess debug output
detector = TfliteModel("enemy_model")
search = Region(100, 200, 300, 400)
hits = detector.inference(threshold=0.55, region=search, max_results=12, debug=True)
text(str(len(hits)))

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API