Runtime v2.81 · Diperbarui 30 Sep 2026

AudioMatch

Hasil pencocokan audio hanya-baca.

Sintaks

AudioMatch

Kelas ini tidak dapat dibuat langsung.

Parameter

Tidak ada

Nilai yang dikembalikan

—

Perilaku / efek samping

Hasil pencocokan audio hanya-baca. Skor adalah kemiripan, bukan probabilitas ketepatan. Waktu find() memakai linimasa sesi mendengarkan; match() memakai linimasa nilai audio yang dicari. Bandingkan waktu agar satu suara tidak ditangani berulang. Gunakan waktu sebagai deteksi hanya jika matched adalah True.

Eksekusi

  • Menunggu selesai: Bersyarat
  • Keamanan akses bersamaan: Tidak dijamin
  • Eksekusi paralel: Bersyarat

Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.

Contoh

# Simpan sampel peringatan di Template Manager sebelum dijalankan
sample = Audio("alert")
Audio.start()
wait(1500)
clip = Audio.recent(1500)
result = clip.match(sample, 0.85)
print(result.matched, result.score, result.start_ms, result.end_ms)
Audio.stop()

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

Tidak ada

Field

NamaDeskripsi
matchedBoolean
True jika kandidat yang tidak hening mencapai ambang.
scoreNumber
Kemiripan dari 0 hingga 1, bukan probabilitas.
start_msNumber
Waktu mulai kandidat dalam milidetik pada linimasa audio yang dicari.
end_msNumber
Waktu akhir eksklusif dalam milidetik pada linimasa yang sama dengan start_ms.