Runtime v2.81 · Cập nhật 30 thg 9, 2026

AudioMatch

Kết quả so khớp âm thanh chỉ đọc.

Cú pháp

AudioMatch

Không thể khởi tạo trực tiếp lớp này.

Tham số

Không có

Giá trị trả về

—

Hành vi / tác động

Kết quả so khớp âm thanh chỉ đọc. Điểm là mức tương đồng, không phải xác suất chính xác. Mốc thời gian của find() tính từ đầu phiên nghe; match() dùng mốc thời gian của giá trị âm thanh được tìm kiếm. So sánh mốc thời gian để tránh xử lý lặp cùng một âm thanh. Chỉ dùng mốc thời gian làm lần phát hiện khi matched là True.

Thực thi

  • Chờ hoàn tất: Tùy điều kiện
  • An toàn khi chạy đồng thời: Không bảo đảm
  • Chạy song song: Tùy điều kiện

Chi phí thực thi và thời gian chờ tùy thao tác được mô tả. Giữ giá trị có thể thay đổi trong luồng sở hữu; việc chia sẻ đối tượng tùy ý giữa các luồng không có bảo đảm an toàn chung.

Ví dụ

# Lưu mẫu âm báo trong Trình quản lý mẫu trước khi chạy
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()

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

Không có

Thuộc tính

TênMô tả
matchedBoolean
True khi có đoạn ứng viên không im lặng đạt ngưỡng.
scoreNumber
Mức tương đồng từ 0 đến 1, không phải xác suất.
start_msNumber
Thời điểm bắt đầu đoạn ứng viên, tính bằng mili giây theo mốc của âm thanh được tìm kiếm.
end_msNumber
Thời điểm kết thúc không bao gồm, tính bằng mili giây trên cùng mốc thời gian với start_ms.